prctl.2: ffix

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

diff --git a/man2/futimesat.2 b/man2/futimesat.2
index 6b66bd56fa5c0d9fa06bcdf23d11c5d44c6cedd6..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,37 +20,50 @@
 .\"
 .\" 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 2.6.16" "Linux Programmer's Manual"
+.TH FUTIMESAT 2 2017-09-15 "Linux" "Linux Programmer's Manual"
 .SH NAME
-futimes \- change timestamps of a file relative to a \
+futimesat \- change timestamps of a file relative to a \
 directory file descriptor
 .SH SYNOPSIS
 .nf
-.B #define _ATFILE_SOURCE
-.B #include <fcntl.h>
-.sp
+.B #include <fcntl.h>           /* Definition of AT_* constants */
+.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
 referred to by the file descriptor
-.IR dirfd
+.I dirfd
 (rather than relative to the current working directory of
 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
-.IR pathname
+.I pathname
 is absolute, then
 .I dirfd
 is ignored.
-.SH "RETURN VALUE"
+.SH RETURN VALUE
 On success,
 .BR futimesat ()
 returns a 0.
@@ -93,23 +105,29 @@ is not a valid file descriptor.
 is relative and
 .I dirfd
 is a file descriptor referring to a file other than a directory.
-.SH "CONFORMING TO"
-This system call is non-standard but is proposed
-for inclusion in a future revision of POSIX.1.
+.SH VERSIONS
+.BR futimesat ()
+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 GLIBC NOTES
+.SH NOTES
+.SS Glibc notes
 If
 .I pathname
 is NULL, then the glibc
-.BR futimes ()
+.BR futimesat ()
 wrapper function updates the times for the file referred to by
 .IR dirfd .
 .\" The Solaris futimesat() also has this strangeness.
-.SH VERSIONS
-.BR futimesat ()
-was added to Linux in kernel 2.6.16.
-.SH "SEE ALSO"
-.BR path_resolution (2),
+.SH SEE ALSO
 .BR stat (2),
+.BR utimensat (2),
 .BR utimes (2),
-.BR futimes (3)
+.BR futimes (3),
+.BR path_resolution (7)