taskpolicy

Execute a program with an altered I/O or scheduling policy or change settings of already running process.

Syntax
      taskpolicy [-d policy] [-g policy] [-c clamp] [-b] [-t thruput_tier] [-l latency_tier] [-a] [-s] program [arg1 [...]]
      taskpolicy [-b|-B] [-t thruput_tier] [-l latency_tier] [-p pid]

Key
   -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.

   -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.

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.

There are two types of CPU core in Apple’s M1 chips which are used by different types of software:

• Efficiency (E) cores are predominantly used to run services and background processes in macOS.
• Performance (P) cores for most User initiated app threads, these consume more power to complete interactively.

taskpolicy has some limitations in its ability to promote or demote the type of core processes your threads will run on, read more about this here.

Examples

Promote pid #64 to run on both E and P cores:

$ taskpolicy -B -p 64

Demote pid #64 to run only on E cores:

$ taskpolicy -b -p 64

“Money will buy a pretty good dog, but it won’t buy the wag of his tail” ~ Henry Wheeler Shaw

Related macOS commands

bg - Send to background.
fg - Send job to foreground.
jobs - List active jobs.