access

Tests permissions of a path against the calling process's real uid and gid.

Prototype

int access(user_addr_t path, int flags);

Returns: int

Arguments

Name	Type	Dir	Description
path	user_addr_t	-
flags	int	-

Version history

XNU tag	macOS	#
xnu-1456.1.26	macOS 10.6 Snow Leopard	33
xnu-1699.24.8	macOS 10.7 Lion	33
xnu-2050.18.24	macOS 10.8 Mountain Lion	33
xnu-2422.115.4	macOS 10.9 Mavericks	33
xnu-2782.40.9	macOS 10.10 Yosemite	33
xnu-3247.1.106	macOS 10.11 El Capitan	33
xnu-3789.1.32	macOS 10.12 Sierra	33
xnu-4570.1.46	macOS 10.13 High Sierra	33
xnu-4903.221.2	macOS 10.14 Mojave	33
xnu-6153.11.26	macOS 10.15 Catalina	33
xnu-7195.50.7.100.1	macOS 11.0 Big Sur	33
xnu-8019.41.5	macOS 12.0 Monterey	33
xnu-8792.41.9	macOS 13.0 Ventura	33
xnu-10002.1.13	macOS 14.0 Sonoma	33
xnu-11215.1.10	macOS 15.0 Sequoia	33
xnu-11417.101.15	macOS 15.4 Sequoia	33
xnu-12377.1.9	macOS 26.0 Tahoe	33
xnu-10002.41.9	—	33
xnu-10002.61.3	—	33
xnu-10002.81.5	—	33
xnu-10063.101.15	—	33
xnu-10063.121.3	—	33
xnu-10063.141.1	—	33
xnu-11215.41.3	—	33
xnu-11215.61.5	—	33
xnu-11215.81.4	—	33
xnu-11417.121.6	—	33
xnu-11417.140.69	—	33
xnu-12377.101.15	—	33
xnu-12377.41.6	—	33
xnu-12377.61.12	—	33
xnu-12377.81.4	—	33
xnu-1486.2.11	—	33
xnu-1504.15.3	—	33
xnu-1504.3.12	—	33
xnu-1504.7.4	—	33
xnu-1504.9.17	—	33
xnu-1504.9.26	—	33
xnu-1504.9.37	—	33
xnu-1699.22.73	—	33
xnu-1699.22.81	—	33
xnu-1699.24.23	—	33
xnu-1699.26.8	—	33
xnu-1699.32.7	—	33
xnu-2050.22.13	—	33
xnu-2050.24.15	—	33
xnu-2050.48.11	—	33
xnu-2050.7.9	—	33
xnu-2050.9.2	—	33
xnu-2422.1.72	—	33
xnu-2422.100.13	—	33
xnu-2422.110.17	—	33
xnu-2422.90.20	—	33
xnu-2782.1.97	—	33
xnu-2782.10.72	—	33
xnu-2782.20.48	—	33
xnu-2782.30.5	—	33
xnu-3247.10.11	—	33
xnu-3248.20.55	—	33
xnu-3248.30.4	—	33
xnu-3248.40.184	—	33
xnu-3248.50.21	—	33
xnu-3248.60.10	—	33
xnu-3789.21.4	—	33
xnu-3789.31.2	—	33
xnu-3789.41.3	—	33
xnu-3789.51.2	—	33
xnu-3789.60.24	—	33
xnu-3789.70.16	—	33
xnu-4570.20.62	—	33
xnu-4570.31.3	—	33
xnu-4570.41.2	—	33
xnu-4570.51.1	—	33
xnu-4570.61.1	—	33
xnu-4570.71.2	—	33
xnu-4903.231.4	—	33
xnu-4903.241.1	—	33
xnu-4903.270.47	—	33
xnu-6153.101.6	—	33
xnu-6153.121.1	—	33
xnu-6153.141.1	—	33
xnu-6153.41.3	—	33
xnu-6153.61.1	—	33
xnu-6153.81.5	—	33
xnu-7195.101.1	—	33
xnu-7195.121.3	—	33
xnu-7195.141.2	—	33
xnu-7195.60.75	—	33
xnu-7195.81.3	—	33
xnu-8019.61.5	—	33
xnu-8019.80.24	—	33
xnu-8020.101.4	—	33
xnu-8020.121.3	—	33
xnu-8020.140.41	—	33
xnu-8792.61.2	—	33
xnu-8792.81.2	—	33
xnu-8796.101.5	—	33
xnu-8796.121.2	—	33
xnu-8796.141.3	—	33

Notes

access is inherently racy: by the time the caller acts on the answer, permissions may have changed. Prefer attempting the operation directly and handling EACCES. F_OK only checks existence.

Detection

ES emits ES_EVENT_TYPE_NOTIFY_ACCESS on supported macOS versions. syscall::access:entry in DTrace.

Related APIs

faccessatstatopenatchmod