Syscall BSD#529
svc · unix #529
os_fault_with_payload
Signale un os_fault non fatal avec une charge structurée à ReportCrash.
Prototype
int os_fault_with_payload(uint32_t reason_namespace, uint64_t reason_code, void *payload, uint32_t payload_size, const char *reason_string, uint64_t reason_flags);Retour: int
Arguments
| Name | Type | Dir | Description |
|---|---|---|---|
| reason_namespace | uint32_t | - | |
| reason_code | uint64_t | - | |
| payload | void | - | |
| payload_size | uint32_t | - | |
| reason_string | const char | - | |
| reason_flags | uint64_t | - |
Historique des versions
| XNU tag | macOS | # |
|---|---|---|
| xnu-4570.1.46 | macOS 10.13 High Sierra | 529 |
| xnu-4903.221.2 | macOS 10.14 Mojave | 529 |
| xnu-6153.11.26 | macOS 10.15 Catalina | 529 |
| xnu-7195.50.7.100.1 | macOS 11.0 Big Sur | 529 |
| xnu-8019.41.5 | macOS 12.0 Monterey | 529 |
| xnu-8792.41.9 | macOS 13.0 Ventura | 529 |
| xnu-10002.1.13 | macOS 14.0 Sonoma | 529 |
| xnu-11215.1.10 | macOS 15.0 Sequoia | 529 |
| xnu-11417.101.15 | macOS 15.4 Sequoia | 529 |
| xnu-12377.1.9 | macOS 26.0 Tahoe | 529 |
| xnu-10002.41.9 | — | 529 |
| xnu-10002.61.3 | — | 529 |
| xnu-10002.81.5 | — | 529 |
| xnu-10063.101.15 | — | 529 |
| xnu-10063.121.3 | — | 529 |
| xnu-10063.141.1 | — | 529 |
| xnu-11215.41.3 | — | 529 |
| xnu-11215.61.5 | — | 529 |
| xnu-11215.81.4 | — | 529 |
| xnu-11417.121.6 | — | 529 |
| xnu-11417.140.69 | — | 529 |
| xnu-12377.101.15 | — | 529 |
| xnu-12377.41.6 | — | 529 |
| xnu-12377.61.12 | — | 529 |
| xnu-12377.81.4 | — | 529 |
| xnu-4570.20.62 | — | 529 |
| xnu-4570.31.3 | — | 529 |
| xnu-4570.41.2 | — | 529 |
| xnu-4570.51.1 | — | 529 |
| xnu-4570.61.1 | — | 529 |
| xnu-4570.71.2 | — | 529 |
| xnu-4903.231.4 | — | 529 |
| xnu-4903.241.1 | — | 529 |
| xnu-4903.270.47 | — | 529 |
| xnu-6153.101.6 | — | 529 |
| xnu-6153.121.1 | — | 529 |
| xnu-6153.141.1 | — | 529 |
| xnu-6153.41.3 | — | 529 |
| xnu-6153.61.1 | — | 529 |
| xnu-6153.81.5 | — | 529 |
| xnu-7195.101.1 | — | 529 |
| xnu-7195.121.3 | — | 529 |
| xnu-7195.141.2 | — | 529 |
| xnu-7195.60.75 | — | 529 |
| xnu-7195.81.3 | — | 529 |
| xnu-8019.61.5 | — | 529 |
| xnu-8019.80.24 | — | 529 |
| xnu-8020.101.4 | — | 529 |
| xnu-8020.121.3 | — | 529 |
| xnu-8020.140.41 | — | 529 |
| xnu-8792.61.2 | — | 529 |
| xnu-8792.81.2 | — | 529 |
| xnu-8796.101.5 | — | 529 |
| xnu-8796.121.2 | — | 529 |
| xnu-8796.141.3 | — | 529 |
Notes
Syscall sous-jacent à os_fault_with_payload(3) et aux APIs os_log fault. Le noyau transmet la charge, le descripteur de position source et la chaîne de raison à ReportCrash via exception Mach, produisant un rapport .ips sans terminer le processus. Largement utilisé dans les frameworks système pour signaler des assertions à investiguer mais non fatales.
Détection
Les .ips résultants sont routinièrement envoyés à Apple via crash-reporting ; sur un endpoint d'entreprise, surveiller DiagnosticReports pour des émetteurs non-Apple émettant des vagues d'os_faults est un signal d'anomalie utile.
API associées
os_log_faultabort_with_payloadproc_trace_logsys_panic_with_data