BSD syscall#557
svc · unix #557
sys_coalition_policy_get
Reads the policy attached to a coalition (a kernel grouping of related tasks).
Prototype
int sys_coalition_policy_get(uint64_t cid, uint32_t flavor);Returns: int
Arguments
| Name | Type | Dir | Description |
|---|---|---|---|
| cid | uint64_t | - | |
| flavor | uint32_t | - |
Version history
| XNU tag | macOS | # |
|---|---|---|
| xnu-11215.1.10 | macOS 15.0 Sequoia | 557 |
| xnu-11417.101.15 | macOS 15.4 Sequoia | 557 |
| xnu-12377.1.9 | macOS 26.0 Tahoe | 557 |
| xnu-11215.41.3 | — | 557 |
| xnu-11215.61.5 | — | 557 |
| xnu-11215.81.4 | — | 557 |
| xnu-11417.121.6 | — | 557 |
| xnu-11417.140.69 | — | 557 |
| xnu-12377.101.15 | — | 557 |
| xnu-12377.41.6 | — | 557 |
| xnu-12377.61.12 | — | 557 |
| xnu-12377.81.4 | — | 557 |
Notes
Coalitions group an app with its XPC helpers, daemons and extensions so that scheduling, jetsam and resource accounting can be applied to the whole. sys_coalition_policy_get returns the current policy bits (e.g. coalition jetsam priority, focal/non-focal status). runningboardd, dasd and frontboardd consume this; non-Apple use is unusual.
Detection
DTrace fbt::sys_coalition_policy_get:entry. Combine with coalition_info(2) and ledger(2) calls to map an EDR's view of process families to the kernel's view.
Related APIs
sys_coalition_policy_setcoalition_infoledgermemorystatus_control