BSD syscall#221
svc · unix #221
setattrlist
Writes a selected set of file attributes in a single syscall using a packed attrlist.
Prototype
int setattrlist(const char *path, struct attrlist *alist, void *attributeBuffer, size_t bufferSize, u_long options);Returns: int
Arguments
| Name | Type | Dir | Description |
|---|---|---|---|
| path | const char | - | |
| alist | struct attrlist | - | |
| attributeBuffer | void | - | |
| bufferSize | size_t | - | |
| options | u_long | - |
Version history
| XNU tag | macOS | # |
|---|---|---|
| xnu-1456.1.26 | macOS 10.6 Snow Leopard | 221 |
| xnu-1486.2.11 | — | 221 |
| xnu-1504.15.3 | — | 221 |
| xnu-1504.3.12 | — | 221 |
| xnu-1504.7.4 | — | 221 |
| xnu-1504.9.17 | — | 221 |
| xnu-1504.9.26 | — | 221 |
| xnu-1504.9.37 | — | 221 |
Notes
Used to set timestamps, BSD flags, Finder info and APFS firmlink/dataless properties atomically. Many writable attributes require root or specific entitlements; the kernel rejects bits it does not understand with EINVAL.
Detection
ES emits multiple specific events (SETTIME, SETFLAGS, etc.) depending on which attribute bits are written.
Related APIs
fsetattrlistsetattrlistatgetattrlistchflags