FUTIMES(3) Linux Programmer's Manual FUTIMES(3)

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

#include <sys/time.h>

int futimes(int fd, const struct timeval tv[2]);


Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

futimes(): _BSD_SOURCE

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.

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:

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

futimes() is available since glibc 2.3.

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

futimesat(2), utime(2)

2007-07-26 Linux

Different Versions of this Page: