futimes, lutimes - change file timestamps
#include <sys/time.h> int futimes(int fd, const struct timeval tv); int lutimes(const char *filename, const struct timeval tv);
Feature Test Macro Requirements for glibc (see feature_test_macros(7)):
futimes() changes the access and modification times of a file in the same way as utimes(2), with the difference that the file whose timestamps are to be changed is specified via a file descriptor,
fd, rather than via a pathname.
lutimes() changes the access and modification times of a file in the same way as utimes(2), with the difference that if
filename refers to a symbolic link, then the link is not dereferenced: instead, the timestamps of the symbolic link are changed.
On success, zero is returned. On error, -1 is returned, and
errno is set appropriately.
Errors are as for utimes(2), with the following additions for futimes():
fd is not a valid file descriptor.
/proc filesystem could not be accessed.
The following additional error may occur for lutimes():
The kernel does not support this call; Linux 2.6.22 or later is required.
For an explanation of the terms used in this section, see attributes(7).
|futimes(), lutimes()||Thread safety||MT-Safe|
These functions are not specified in any standard. Other than Linux, they are available only on the BSDs.
This page is part of release 5.10 of the Linux
man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at https://www.kernel.org/doc/man-pages/.