mirror of
https://github.com/azenla/MacHack.git
synced 2026-02-13 09:02:46 +00:00
nscurl, taskinfo, taskpolicy
This commit is contained in:
Kenneth Endfinger
184
README.md
184
README.md
@@ -26,6 +26,9 @@ A list of built-in tools in macOS that you probably didn't know about.
|
||||
- [kmutil](#kmutil)
|
||||
- [profiles](#profiles)
|
||||
- [bputil](#bputil)
|
||||
- [nscurl](#nscurl)
|
||||
- [taskinfo](#taskinfo)
|
||||
- [taskpolicy](#taskpolicy)
|
||||
|
||||
## Commands
|
||||
|
||||
@@ -1454,3 +1457,184 @@ bputil v0.1.3 - a tool to modify boot policies
|
||||
Automatically downgrades to Permissive Security mode if not already true
|
||||
NOTE: SSV cannot be disabled while FileVault is enabled
|
||||
```
|
||||
|
||||
### nscurl
|
||||
|
||||
nscurl is similar to curl but using macOS APIs.
|
||||
|
||||
```text
|
||||
$ nscurl -h
|
||||
Usage: nscurl [options...] <URL>
|
||||
Options:
|
||||
-h --help Display help message
|
||||
-bg --background Use the background transfer
|
||||
API to execute the request
|
||||
--discretionary Marks the transfer as
|
||||
discretionary (only has an
|
||||
effect if --background is
|
||||
passed)
|
||||
-D --dump-header [ARG] Write the response headers to
|
||||
the specified file (pass '-'
|
||||
for stdout)
|
||||
-o --output [ARG] Write the response data to
|
||||
the specified file (pass '-'
|
||||
for stdout)
|
||||
-i --include Include response headers in
|
||||
output
|
||||
-L --location Instruct nscurl to follow
|
||||
redirects (this is the
|
||||
default behavior)
|
||||
--ignore-location Instruct nscurl to ignore
|
||||
redirects
|
||||
-H --header [ARG] Specify an additional HTTP
|
||||
Header ("X-Header-Name:
|
||||
Value")
|
||||
-A --user-agent [ARG] Specify the User-Agent string
|
||||
-u --user [ARG] Specify a username and
|
||||
password <user:password>
|
||||
-dl --download Download the resource using a
|
||||
download task
|
||||
-dir --download-directory [ARG] Download the resource into
|
||||
the specified directory
|
||||
-T --upload [ARG] Upload the specified file
|
||||
(with HTTP PUT request
|
||||
-SU --streamed Use a streamed upload instead
|
||||
of a file upload, when
|
||||
--upload is passed
|
||||
-k --insecure Disable cert checking when
|
||||
using TLS
|
||||
-ld --large-download Use 'large-download'
|
||||
properties
|
||||
--bg-traffic-class Use SO_TC_BK traffic class
|
||||
-m --max-time [ARG] Timeout in seconds for the
|
||||
entire request
|
||||
--window-delay [ARG] Conditional connection window
|
||||
delay for request
|
||||
--window-duration [ARG] Conditional connection window
|
||||
duration for request
|
||||
-M --method [ARG] Set the HTTP method for the
|
||||
request
|
||||
-G --get Send a GET request
|
||||
-I --head Send a HEAD request
|
||||
--post Send a POST request
|
||||
--put Send a PUT request
|
||||
-r --range [ARG] Specify a byte range
|
||||
--no-expensive Disallow the use of expensive
|
||||
networks
|
||||
--no-constrained Disallow the use of
|
||||
constrained networks
|
||||
--start-timeout [ARG] Sets a timeout on starting
|
||||
the request (expressed in
|
||||
seconds from now)
|
||||
--fast-connect-timeout Fail quickly if the server is
|
||||
unreachable
|
||||
--payload-transmission-timeout [ARG] Sets a timeout on payload
|
||||
transmission
|
||||
|
||||
post-connection-establishment
|
||||
-v --verbose Verbose output
|
||||
--ats-diagnostics Display ATS diagnostic
|
||||
information for URL
|
||||
--fingerprint Display fingerprint of URL
|
||||
TLS configuration
|
||||
--ats-tls-version [ARG] Minimum TLS version used for
|
||||
ATS configuration. Allowed
|
||||
values: TLSv1.0, TLSv1.1,
|
||||
TLSv1.2, or TLSv1.3
|
||||
--ats-disable-pfs Do not require Perfect
|
||||
Forward Secrecy for ATS
|
||||
configuration
|
||||
-ec --effective-configuration Exercise effective
|
||||
configuration
|
||||
--effective-configuration-dump [ARG] Write effective configuration
|
||||
to plist
|
||||
--effective-configuration-read [ARG] Read effective configuration
|
||||
from plist
|
||||
--http3 Enable HTTP/3
|
||||
--http3-prior-knowledge Enable HTTP/3 racing without
|
||||
service discovery
|
||||
```
|
||||
|
||||
An example of using nscurl is fetching your external IP from ipify.org:
|
||||
|
||||
```text
|
||||
$ nscurl 'https://api.ipify.org?format=json'
|
||||
{"ip":"10.25.0.1"}
|
||||
```
|
||||
|
||||
### taskinfo
|
||||
|
||||
taskinfo is a tool for viewing detailed information about a process.
|
||||
|
||||
```text
|
||||
$ taskinfo -h
|
||||
usage:
|
||||
taskinfo [-h|--help] [--threads] [--dq] [--boosts] [process-name|pid]
|
||||
```
|
||||
|
||||
An example of using taskinfo is fetching information about the taskinfo process itself.
|
||||
|
||||
```text
|
||||
$ sudo taskinfo taskinfo
|
||||
process: "taskinfo" [76355] [unique ID: 773167]
|
||||
architecture: arm64e
|
||||
coalition (type 0) ID: 30994
|
||||
coalition (type 1) ID: 30995
|
||||
suspend count: 0
|
||||
virtual bytes: 389.20 GB; phys_footprint bytes: 832.69 kB; phys_footprint lifetime maximum bytes: 832.69 kB
|
||||
run time: 0 s
|
||||
user/system time (current threads): 0.000781 s / 0.011651 s
|
||||
user/system time (terminated threads): 0.000000 s / 0.000000 s
|
||||
interrupt wakeups: 0 (0 / nan% from platform idle)
|
||||
default sched policy: POLICY_TIMESHARE
|
||||
CPU usage monitor: none
|
||||
CPU wakes monitor: 150 wakes per second (over system-default time period)
|
||||
dirty tracking: untracked dirty
|
||||
boosts: 0 (0 externalized)
|
||||
requested policy
|
||||
req apptype: TASK_APPTYPE_DAEMON_INTERACTIVE
|
||||
req role: TASK_UNSPECIFIED (PRIO_DARWIN_ROLE_DEFAULT)
|
||||
req qos clamp: THREAD_QOS_UNSPECIFIED
|
||||
req base/override latency qos: LATENCY_QOS_TIER_UNSPECIFIED / LATENCY_QOS_TIER_UNSPECIFIED
|
||||
req base/override thruput qos: THROUGHPUT_QOS_TIER_UNSPECIFIED / THROUGHPUT_QOS_TIER_UNSPECIFIED
|
||||
req darwin BG: NO
|
||||
req internal/external iotier: THROTTLE_LEVEL_TIER0 (IMPORTANT) / THROTTLE_LEVEL_TIER0 (IMPORTANT)
|
||||
req darwin BG iotier: THROTTLE_LEVEL_TIER2 (UTILITY)
|
||||
req managed: NO
|
||||
req other:
|
||||
req suppression (App Nap) behaviors:
|
||||
effective policy
|
||||
eff role: TASK_UNSPECIFIED (PRIO_DARWIN_ROLE_DEFAULT)
|
||||
eff latency qos: LATENCY_QOS_TIER_UNSPECIFIED
|
||||
eff thruput qos: THROUGHPUT_QOS_TIER_UNSPECIFIED
|
||||
eff darwin BG: NO
|
||||
eff iotier: THROTTLE_LEVEL_TIER0 (IMPORTANT)
|
||||
eff managed: NO
|
||||
eff qos ceiling: THREAD_QOS_USER_INITIATED
|
||||
eff qos clamp: THREAD_QOS_UNSPECIFIED
|
||||
eff other:
|
||||
imp_donor: YES
|
||||
imp_receiver: NO
|
||||
pid suspended: NO
|
||||
adaptive daemon: NO (boosted: NO)
|
||||
```
|
||||
|
||||
### taskpolicy
|
||||
|
||||
taskpolicy can be used to adjust certain policies for running programs, and can additionally be used for running programs with a particular policy.
|
||||
|
||||
```$text
|
||||
$ taskpolicy
|
||||
Usage: taskpolicy [-x|-X] [-d <policy>] [-g policy] [-c clamp] [-b] [-t <tier>]
|
||||
[-l <tier>] [-a] <program> [<pargs> [...]]
|
||||
taskpolicy [-b|-B] [-t <tier>] [-l <tier>] -p pid
|
||||
```
|
||||
|
||||
An example of using taskpolicy is clamping a command to a particular task QoS:
|
||||
|
||||
```text
|
||||
$ taskpolicy -c background sw_vers
|
||||
ProductName: macOS
|
||||
ProductVersion: 11.0
|
||||
BuildVersion: 20A2411
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user