.\" This manpage is Copyright (C) 2006, Michael Kerrisk
.\"
-.\" %%%LICENSE_START(verbatim)
+.\" %%%LICENSE_START(VERBATIM)
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\" the source, must acknowledge the copyright and authors of this work.
.\" %%%LICENSE_END
.\"
-.\"
-.TH FUTIMESAT 2 2012-05-10 "Linux" "Linux Programmer's Manual"
+.TH FUTIMESAT 2 2017-09-15 "Linux" "Linux Programmer's Manual"
.SH NAME
futimesat \- change timestamps of a file relative to a \
directory file descriptor
.nf
.B #include <fcntl.h> /* Definition of AT_* constants */
.B #include <sys/time.h>
-.sp
+.PP
.BI "int futimesat(int " dirfd ", const char *" pathname ,
.BI " const struct timeval " times [2]);
.fi
-.sp
+.PP
.in -4n
Feature Test Macro Requirements for glibc (see
.BR feature_test_macros (7)):
.in
-.sp
+.PP
.BR futimesat ():
_GNU_SOURCE
.SH DESCRIPTION
Use
.BR utimensat (2)
instead.
-
+.PP
The
.BR futimesat ()
system call operates in exactly the same way as
.BR utimes (2),
except for the differences described in this manual page.
-
+.PP
If the pathname given in
.I pathname
is relative, then it is interpreted relative to the directory
the calling process, as is done by
.BR utimes (2)
for a relative pathname).
-
+.PP
If
.I pathname
is relative and
is interpreted relative to the current working
directory of the calling process (like
.BR utimes (2)).
-
+.PP
If
.I pathname
is absolute, then
It was implemented from a specification that was proposed for POSIX.1,
but that specification was replaced by the one for
.BR utimensat (2).
-
+.PP
A similar system call exists on Solaris.
.SH NOTES
.SS Glibc notes