aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMichael Kerrisk <mtk.manpages@gmail.com>2008-06-02 14:12:37 +0000
committerMichael Kerrisk <mtk.manpages@gmail.com>2008-06-02 14:12:37 +0000
commit25fddfcd83e32bb8a768051a17ed088929913fab (patch)
treefd1559c7489c33e2deed33cfb24144c0d82d275c
parent04527fe52c6d839fad18cf1067ae66b9b144165a (diff)
downloadman-pages-25fddfcd83e32bb8a768051a17ed088929913fab.tar.gz
Note that this system is made obsolete by utimensat(2).
-rw-r--r--man2/futimesat.215
1 files changed, 12 insertions, 3 deletions
diff --git a/man2/futimesat.2 b/man2/futimesat.2
index 8297fb0e3d..0df2cb3acf 100644
--- a/man2/futimesat.2
+++ b/man2/futimesat.2
@@ -23,7 +23,7 @@
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\"
-.TH FUTIMESAT 2 2006-05-05 "Linux" "Linux Programmer's Manual"
+.TH FUTIMESAT 2 2008-06-05 "Linux" "Linux Programmer's Manual"
.SH NAME
futimesat \- change timestamps of a file relative to a \
directory file descriptor
@@ -36,6 +36,11 @@ directory file descriptor
.BI " const struct timeval " times [2]);
.fi
.SH DESCRIPTION
+This system call is obsolete.
+Use
+.BR utimensat (2)
+instead.
+
The
.BR futimesat ()
system call operates in exactly the same way as
@@ -97,8 +102,11 @@ is a file descriptor referring to a file other than a directory.
.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.
+This system call is non-standard.
+It was implemented from a specification that was proposed POSIX.1,
+but that specification was replaced by the one for
+.BR utimensat(2).
+
A similar system call exists on Solaris.
.SH NOTES
.SS Glibc Notes
@@ -111,6 +119,7 @@ wrapper function updates the times for the file referred to by
.\" The Solaris futimesat() also has this strangeness.
.SH "SEE ALSO"
.BR stat (2),
+.BR utimensat (2),
.BR utimes (2),
.BR futimes (3),
.BR path_resolution (7)