taskpolicy8
Execute a program with an altered i/o or scheduling policy or change settings of already running process
Usage
taskpolicy [-d
policy]
[-g
policy]
[-c
clamp]
[-b]
[-t
thruput_tier]
[-l
latency_tier]
[-a]
[-s]
[-S
shims]
[-m
limit]
[-j
pri]
program
[arg1
[]]
taskpolicy [{-b | -B}]
[-t
thruput_tier]
[-l
latency_tier]
[-p
pid]
Overview
The taskpolicy program uses the setiopolicy_np(3) and setpriority(2) APIs to execute a program with altered I/O or scheduling policies. All children of the specified program also inherit these policies.
taskpolicy accepts the following flags and arguments:
-
-d policy -
Run the program after calling setiopolicy_np(3) with an iotype of IOPOL_TYPE_DISK, a scope of IOPOL_SCOPE_PROCESS, and the specified policy. The argument can either be an integer, or a symbolic string like "default" or "throttle", which is interpreted case-insensitively.
-
-g policy -
Run the program after calling setiopolicy_np(3) with an iotype of IOPOL_TYPE_DISK, a scope of IOPOL_SCOPE_DARWIN_BG, and the specified policy. The argument is interpreted in the same manner as
-d. -
-c clamp -
Run the program using the specified QoS clamp. The argument can be either "utility", "background", or "maintenance", which is interpreted case-insensitively.
-
-p pid -
Change settings for the process specified by pid.
-
-m limit -
Run the program with specified memory limit (in MiB).
-
-j pri -
Run the program at the specified jetsam priority.
-
-P pcontrol -
Run the program with the specified process control action, which may be invoked by the system upon resource exhaustion. Valid options include "kill", "throttle", and "suspend".
-
-S shims -
Run the program with security transition shims in effect.
-
-b -
Run the program after calling setpriority(2) with a priority of PRIO_DARWIN_BG.
-
-B -
Move target process out of PRIO_DARWIN_BG.
-
-t -
Set throughput tier of the process to thruput_tier.
-
-l -
Set latency tier of the process to latency_tier.
-
-a -
Run the program with the resource management policies given to applications.
-
-s -
Run the program with an initial suspended state by calling posix_spawnattr_setflags(3) with POSIX_SPAWN_START_SUSPENDED.
Releases
85 releases since OS X 10.9; the text changed 7 times.
-B since OS X 10.10;
-P since macOS 26.4;
-S since macOS 15.4;
-a since macOS 10.13;
-c since OS X 10.10;
-j since macOS 26.0;
-l since OS X 10.10;
-m since macOS 26.0;
-p since OS X 10.10;
-s since macOS 12.0.1;
-t since OS X 10.10.
- until macOS 11.5.