CINXE.COM
futimes
<html> <head> <title>futimes</title> <META NAME="KEYWORDS" CONTENT="futimes"> </head> <body BGCOLOR="#ffffff" LINK="#0000ff" VLINK="#0000ff" ALINK="#0000ff" TEXT="#000000"> <center> <h1><b>futimes</b></h1></center> <PRE> <STRONG><A HREF="/man3/FUTIMES">FUTIMES(3)</A></STRONG> Linux Programmer's Manual <STRONG><A HREF="/man3/FUTIMES">FUTIMES(3)</A></STRONG> NAME futimes, lutimes - change file timestamps SYNOPSIS #include <sys/time.h> int futimes(int fd, const struct timeval tv[2]); int lutimes(const char *filename, const struct timeval tv[2]); Feature Test Macro Requirements for glibc (see <STRONG><A HREF="/man7/feature_test_macros">feature_test_macros(7)</A></STRONG>): futimes(), lutimes(): Since glibc 2.19: _DEFAULT_SOURCE Glibc 2.19 and earlier: _BSD_SOURCE DESCRIPTION futimes() changes the access and modification times of a file in the same way as <STRONG><A HREF="/man2/utimes">utimes(2)</A></STRONG>, with the difference that the file whose time- stamps 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 <STRONG><A HREF="/man2/utimes">utimes(2)</A></STRONG>, with the difference that if filename refers to a symbolic link, then the link is not dereferenced: instead, the time- stamps of the symbolic link are changed. RETURN VALUE On success, zero is returned. On error, -1 is returned, and errno is set appropriately. ERRORS Errors are as for <STRONG><A HREF="/man2/utimes">utimes(2)</A></STRONG>, with the following additions for fu- times(): EBADF fd is not a valid file descriptor. ENOSYS The /proc filesystem could not be accessed. The following additional error may occur for lutimes(): ENOSYS The kernel does not support this call; Linux 2.6.22 or later is required. VERSIONS futimes() is available since glibc 2.3. lutimes() is available since glibc 2.6, and is implemented using the <STRONG><A HREF="/man2/utimensat">utimensat(2)</A></STRONG> system call, which is supported since kernel 2.6.22. ATTRIBUTES For an explanation of the terms used in this section, see at- <STRONG><A HREF="/man7/tributes">tributes(7)</A></STRONG>. +---------------------+---------------+---------+ |Interface | Attribute | Value | +---------------------+---------------+---------+ |futimes(), lutimes() | Thread safety | MT-Safe | +---------------------+---------------+---------+ CONFORMING TO These functions are not specified in any standard. Other than Linux, they are available only on the BSDs. SEE ALSO <STRONG><A HREF="/man2/utime">utime(2)</A></STRONG>, <STRONG><A HREF="/man2/utimensat">utimensat(2)</A></STRONG>, <STRONG><A HREF="/man7/symlink">symlink(7)</A></STRONG> COLOPHON This page is part of release 5.05 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/. Linux 2017-09-15 <STRONG><A HREF="/man3/FUTIMES">FUTIMES(3)</A></STRONG></PRE> <center> <h6>Man Pages Copyright Respective Owners. Site Copyright (C) 1994 - 2025 <a href="http://www.he.net">Hurricane Electric</a>. All Rights Reserved.</h6></center> </body> </html>