futimes(3) - Linux man page

Name

futimes - change access and/or modification times of an open file

Synopsis

#include <sys/time.h>
int futimes(int fd, const struct timeval tv[2]);

Description

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.

Return Value

On success, zero is returned. On error, -1 is returned, and errno is set appropriately.

Errors

Errors are as for utimes(2), with the following additions:

EBADF: fd is not a valid file descriptor.
ENOSYS: The /proc file system could not be accessed.

Versions

futimes() is available since glibc 2.3.

Conforming to

4.2BSD. Other than Linux, this function is only available on the BSDs.