futimes

Sets access and modification timestamps on a file referenced by an open descriptor.

Prototype

int futimes(int fd, struct timeval *tptr);

Returns: int

Arguments

Name	Type	Dir	Description
fd	int	-
tptr	struct timeval	-

Version history

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

Notes

Counterpart of utimes for fds. Required by archive tools that open a file, write its content, then restore timestamps without re-resolving the path.

Detection

ES NOTIFY_SETTIME with the underlying vnode.

Related APIs

utimesutimensatfutimensfstat