BSD syscall#57
svc · unix #57
symlink
Creates a symbolic link whose target is an arbitrary string interpreted at lookup time.
Prototype
int symlink(char *path, char *link);Returns: int
Arguments
| Name | Type | Dir | Description |
|---|---|---|---|
| path | char | - | |
| link | char | - |
Version history
| XNU tag | macOS | # |
|---|---|---|
| xnu-1456.1.26 | macOS 10.6 Snow Leopard | 57 |
| xnu-1699.24.8 | macOS 10.7 Lion | 57 |
| xnu-2050.18.24 | macOS 10.8 Mountain Lion | 57 |
| xnu-2422.115.4 | macOS 10.9 Mavericks | 57 |
| xnu-2782.40.9 | macOS 10.10 Yosemite | 57 |
| xnu-3247.1.106 | macOS 10.11 El Capitan | 57 |
| xnu-3789.1.32 | macOS 10.12 Sierra | 57 |
| xnu-4570.1.46 | macOS 10.13 High Sierra | 57 |
| xnu-4903.221.2 | macOS 10.14 Mojave | 57 |
| xnu-6153.11.26 | macOS 10.15 Catalina | 57 |
| xnu-7195.50.7.100.1 | macOS 11.0 Big Sur | 57 |
| xnu-8019.41.5 | macOS 12.0 Monterey | 57 |
| xnu-8792.41.9 | macOS 13.0 Ventura | 57 |
| xnu-10002.1.13 | macOS 14.0 Sonoma | 57 |
| xnu-11215.1.10 | macOS 15.0 Sequoia | 57 |
| xnu-11417.101.15 | macOS 15.4 Sequoia | 57 |
| xnu-12377.1.9 | macOS 26.0 Tahoe | 57 |
| xnu-10002.41.9 | — | 57 |
| xnu-10002.61.3 | — | 57 |
| xnu-10002.81.5 | — | 57 |
| xnu-10063.101.15 | — | 57 |
| xnu-10063.121.3 | — | 57 |
| xnu-10063.141.1 | — | 57 |
| xnu-11215.41.3 | — | 57 |
| xnu-11215.61.5 | — | 57 |
| xnu-11215.81.4 | — | 57 |
| xnu-11417.121.6 | — | 57 |
| xnu-11417.140.69 | — | 57 |
| xnu-12377.101.15 | — | 57 |
| xnu-12377.41.6 | — | 57 |
| xnu-12377.61.12 | — | 57 |
| xnu-12377.81.4 | — | 57 |
| xnu-1486.2.11 | — | 57 |
| xnu-1504.15.3 | — | 57 |
| xnu-1504.3.12 | — | 57 |
| xnu-1504.7.4 | — | 57 |
| xnu-1504.9.17 | — | 57 |
| xnu-1504.9.26 | — | 57 |
| xnu-1504.9.37 | — | 57 |
| xnu-1699.22.73 | — | 57 |
| xnu-1699.22.81 | — | 57 |
| xnu-1699.24.23 | — | 57 |
| xnu-1699.26.8 | — | 57 |
| xnu-1699.32.7 | — | 57 |
| xnu-2050.22.13 | — | 57 |
| xnu-2050.24.15 | — | 57 |
| xnu-2050.48.11 | — | 57 |
| xnu-2050.7.9 | — | 57 |
| xnu-2050.9.2 | — | 57 |
| xnu-2422.1.72 | — | 57 |
| xnu-2422.100.13 | — | 57 |
| xnu-2422.110.17 | — | 57 |
| xnu-2422.90.20 | — | 57 |
| xnu-2782.1.97 | — | 57 |
| xnu-2782.10.72 | — | 57 |
| xnu-2782.20.48 | — | 57 |
| xnu-2782.30.5 | — | 57 |
| xnu-3247.10.11 | — | 57 |
| xnu-3248.20.55 | — | 57 |
| xnu-3248.30.4 | — | 57 |
| xnu-3248.40.184 | — | 57 |
| xnu-3248.50.21 | — | 57 |
| xnu-3248.60.10 | — | 57 |
| xnu-3789.21.4 | — | 57 |
| xnu-3789.31.2 | — | 57 |
| xnu-3789.41.3 | — | 57 |
| xnu-3789.51.2 | — | 57 |
| xnu-3789.60.24 | — | 57 |
| xnu-3789.70.16 | — | 57 |
| xnu-4570.20.62 | — | 57 |
| xnu-4570.31.3 | — | 57 |
| xnu-4570.41.2 | — | 57 |
| xnu-4570.51.1 | — | 57 |
| xnu-4570.61.1 | — | 57 |
| xnu-4570.71.2 | — | 57 |
| xnu-4903.231.4 | — | 57 |
| xnu-4903.241.1 | — | 57 |
| xnu-4903.270.47 | — | 57 |
| xnu-6153.101.6 | — | 57 |
| xnu-6153.121.1 | — | 57 |
| xnu-6153.141.1 | — | 57 |
| xnu-6153.41.3 | — | 57 |
| xnu-6153.61.1 | — | 57 |
| xnu-6153.81.5 | — | 57 |
| xnu-7195.101.1 | — | 57 |
| xnu-7195.121.3 | — | 57 |
| xnu-7195.141.2 | — | 57 |
| xnu-7195.60.75 | — | 57 |
| xnu-7195.81.3 | — | 57 |
| xnu-8019.61.5 | — | 57 |
| xnu-8019.80.24 | — | 57 |
| xnu-8020.101.4 | — | 57 |
| xnu-8020.121.3 | — | 57 |
| xnu-8020.140.41 | — | 57 |
| xnu-8792.61.2 | — | 57 |
| xnu-8792.81.2 | — | 57 |
| xnu-8796.101.5 | — | 57 |
| xnu-8796.121.2 | — | 57 |
| xnu-8796.141.3 | — | 57 |
Notes
The target string is stored verbatim and is not validated at creation. Sandboxed processes may have symlink creation blocked by the sandbox profile even when the underlying filesystem would allow it.
Detection
ES emits ES_EVENT_TYPE_NOTIFY_CREATE for the new symlink vnode and may emit ES_EVENT_TYPE_NOTIFY_LOOKUP later when the link is dereferenced.
Related APIs
symlinkatreadlinklinkunlink