prctl.2: ffix

[thirdparty/man-pages.git] / man2 / futimesat.2

diff --git a/man2/futimesat.2 b/man2/futimesat.2
index 8297fb0e3d6a541fa124a82a570960402078571d..a5ed2862b887f9b0601eae5350cb0c021085ab77 100644 (file)
--- a/man2/futimesat.2
+++ b/man2/futimesat.2
@@ -1,7 +1,6 @@
-.\" Hey Emacs! This file is -*- nroff -*- source.
-.\"
 .\" This manpage is Copyright (C) 2006, Michael Kerrisk
 .\"
+.\" %%%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.
@@ -21,27 +20,40 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
-.\"
-.TH FUTIMESAT 2 2006-05-05 "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
 .SH SYNOPSIS
 .nf
-.B #define _ATFILE_SOURCE
 .B #include <fcntl.h>           /* Definition of AT_* constants */
-.sp
+.B #include <sys/time.h>
+.PP
 .BI "int futimesat(int " dirfd ", const char *" pathname ,
 .BI "              const struct timeval " times [2]);
 .fi
+.PP
+.in -4n
+Feature Test Macro Requirements for glibc (see
+.BR feature_test_macros (7)):
+.in
+.PP
+.BR futimesat ():
+_GNU_SOURCE
 .SH DESCRIPTION
+This system call is obsolete.
+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
@@ -51,7 +63,7 @@ referred to by the file descriptor
 the calling process, as is done by
 .BR utimes (2)
 for a relative pathname).
-
+.PP
 If
 .I pathname
 is relative and
@@ -63,13 +75,13 @@ then
 is interpreted relative to the current working
 directory of the calling process (like
 .BR utimes (2)).
-
+.PP
 If
 .I pathname
 is absolute, then
 .I dirfd
 is ignored.
-.SH "RETURN VALUE"
+.SH RETURN VALUE
 On success,
 .BR futimesat ()
 returns a 0.
@@ -95,13 +107,17 @@ is relative and
 is a file descriptor referring to a file other than a directory.
 .SH VERSIONS
 .BR futimesat ()
-was added to Linux in kernel 2.6.16.
-.SH "CONFORMING TO"
-This system call is non-standard but is proposed
-for inclusion in a future revision of POSIX.1.
+was added to Linux in kernel 2.6.16;
+library support was added to glibc in version 2.4.
+.SH CONFORMING TO
+This system call is nonstandard.
+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
+.SS Glibc notes
 If
 .I pathname
 is NULL, then the glibc
@@ -109,8 +125,9 @@ is NULL, then the glibc
 wrapper function updates the times for the file referred to by
 .IR dirfd .
 .\" The Solaris futimesat() also has this strangeness.
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR stat (2),
+.BR utimensat (2),
 .BR utimes (2),
 .BR futimes (3),
 .BR path_resolution (7)