BSD syscall#556
svc · unix #556
sys_coalition_policy_set
Writes policy bits onto a coalition (jetsam band, focal status, resource role).
Prototype
int sys_coalition_policy_set(uint64_t cid, uint32_t flavor, uint32_t value);Returns: int
Arguments
| Name | Type | Dir | Description |
|---|---|---|---|
| cid | uint64_t | - | |
| flavor | uint32_t | - | |
| value | uint32_t | - |
Version history
| XNU tag | macOS | # |
|---|---|---|
| xnu-11215.1.10 | macOS 15.0 Sequoia | 556 |
| xnu-11417.101.15 | macOS 15.4 Sequoia | 556 |
| xnu-12377.1.9 | macOS 26.0 Tahoe | 556 |
| xnu-11215.41.3 | — | 556 |
| xnu-11215.61.5 | — | 556 |
| xnu-11215.81.4 | — | 556 |
| xnu-11417.121.6 | — | 556 |
| xnu-11417.140.69 | — | 556 |
| xnu-12377.101.15 | — | 556 |
| xnu-12377.41.6 | — | 556 |
| xnu-12377.61.12 | — | 556 |
| xnu-12377.81.4 | — | 556 |
Notes
Mutating counterpart of sys_coalition_policy_get. Used by runningboardd to promote a coalition to foreground or by FrontBoard to mark a coalition as eligible to do work in the background. Requires the com.apple.private.coalition entitlement; arbitrary callers cannot influence scheduling this way.
Detection
Same DTrace probe as the get variant; mutating calls from non-Apple binaries should be treated as privilege-bypass attempts.
Related APIs
sys_coalition_policy_getcoalition_infomemorystatus_controlledger