svc · unix #525
net_qos_guideline
Asks the kernel for a recommendation on whether a given network operation should run now under current QoS policy.
Prototype
int net_qos_guideline(struct net_qos_param *param, uint32_t param_len);Returns: int
Arguments
| Name | Type | Dir | Description |
|---|---|---|---|
| param | struct net_qos_param | - | |
| param_len | uint32_t | - |
Version history
| XNU tag | macOS | # |
|---|---|---|
| xnu-4570.1.46 | macOS 10.13 High Sierra | 525 |
| xnu-4903.221.2 | macOS 10.14 Mojave | 525 |
| xnu-6153.11.26 | macOS 10.15 Catalina | 525 |
| xnu-7195.50.7.100.1 | macOS 11.0 Big Sur | 525 |
| xnu-8019.41.5 | macOS 12.0 Monterey | 525 |
| xnu-8792.41.9 | macOS 13.0 Ventura | 525 |
| xnu-10002.1.13 | macOS 14.0 Sonoma | 525 |
| xnu-11215.1.10 | macOS 15.0 Sequoia | 525 |
| xnu-11417.101.15 | macOS 15.4 Sequoia | 525 |
| xnu-12377.1.9 | macOS 26.0 Tahoe | 525 |
| xnu-10002.41.9 | — | 525 |
| xnu-10002.61.3 | — | 525 |
| xnu-10002.81.5 | — | 525 |
| xnu-10063.101.15 | — | 525 |
| xnu-10063.121.3 | — | 525 |
| xnu-10063.141.1 | — | 525 |
| xnu-11215.41.3 | — | 525 |
| xnu-11215.61.5 | — | 525 |
| xnu-11215.81.4 | — | 525 |
| xnu-11417.121.6 | — | 525 |
| xnu-11417.140.69 | — | 525 |
| xnu-12377.101.15 | — | 525 |
| xnu-12377.41.6 | — | 525 |
| xnu-12377.61.12 | — | 525 |
| xnu-12377.81.4 | — | 525 |
| xnu-4570.20.62 | — | 525 |
| xnu-4570.31.3 | — | 525 |
| xnu-4570.41.2 | — | 525 |
| xnu-4570.51.1 | — | 525 |
| xnu-4570.61.1 | — | 525 |
| xnu-4570.71.2 | — | 525 |
| xnu-4903.231.4 | — | 525 |
| xnu-4903.241.1 | — | 525 |
| xnu-4903.270.47 | — | 525 |
| xnu-6153.101.6 | — | 525 |
| xnu-6153.121.1 | — | 525 |
| xnu-6153.141.1 | — | 525 |
| xnu-6153.41.3 | — | 525 |
| xnu-6153.61.1 | — | 525 |
| xnu-6153.81.5 | — | 525 |
| xnu-7195.101.1 | — | 525 |
| xnu-7195.121.3 | — | 525 |
| xnu-7195.141.2 | — | 525 |
| xnu-7195.60.75 | — | 525 |
| xnu-7195.81.3 | — | 525 |
| xnu-8019.61.5 | — | 525 |
| xnu-8019.80.24 | — | 525 |
| xnu-8020.101.4 | — | 525 |
| xnu-8020.121.3 | — | 525 |
| xnu-8020.140.41 | — | 525 |
| xnu-8792.61.2 | — | 525 |
| xnu-8792.81.2 | — | 525 |
| xnu-8796.101.5 | — | 525 |
| xnu-8796.121.2 | — | 525 |
| xnu-8796.141.3 | — | 525 |
Notes
Backs the public NWAdvisor and Network.framework APIs that let apps cooperate with macOS's responsiveness goals — for example, background sync code can ask 'is the network currently being used for an interactive task?'. The kernel evaluates the request against the active QoS class (background, utility, default, user-initiated, user-interactive), recent foreground app activity, and Low Data Mode. Returns a verdict that callers honor voluntarily; it is advisory, not enforced.
Detection
Read-only and uninteresting to ES. Useful as a signal that an app is well-behaved; well-written networking code calls it before kicking off bulk transfers.