intro.1, _exit.2, access.2, alarm.2, alloc_hugepages.2, arch_prctl.2, bind.2, chdir...

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

diff --git a/man2/futimesat.2 b/man2/futimesat.2
index ae16b2b490c1033db37ed2026abd07c8aa9956c4..2017c1e60acedbf4e22c859880688f241547bef3 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,15 +20,17 @@
 .\"
 .\" 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 2009-12-13 "Linux" "Linux Programmer's Manual"
+.TH FUTIMESAT 2 2012-05-10 "Linux" "Linux Programmer's Manual"
 .SH NAME
 futimesat \- change timestamps of a file relative to a \
 directory file descriptor
 .SH SYNOPSIS
 .nf
 .B #include <fcntl.h>           /* Definition of AT_* constants */
+.B #include <sys/time.h>
 .sp
 .BI "int futimesat(int " dirfd ", const char *" pathname ,
 .BI "              const struct timeval " times [2]);
@@ -41,18 +42,7 @@ Feature Test Macro Requirements for glibc (see
 .in
 .sp
 .BR futimesat ():
-.PD 0
-.ad l
-.RS 4
-.TP 4
-Since glibc 2.10:
-_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L
-.TP
-Before glibc 2.10:
-_ATFILE_SOURCE
-.RE
-.ad
-.PD
+_GNU_SOURCE
 .SH DESCRIPTION
 This system call is obsolete.
 Use
@@ -92,7 +82,7 @@ If
 is absolute, then
 .I dirfd
 is ignored.
-.SH "RETURN VALUE"
+.SH RETURN VALUE
 On success,
 .BR futimesat ()
 returns a 0.
@@ -118,8 +108,9 @@ 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"
+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
@@ -127,7 +118,7 @@ but that specification was replaced by the one for
 
 A similar system call exists on Solaris.
 .SH NOTES
-.SS Glibc Notes
+.SS Glibc notes
 If
 .I pathname
 is NULL, then the glibc
@@ -135,7 +126,7 @@ 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),