Note that this system is made obsolete by utimensat(2).

This commit is contained in:
Michael Kerrisk 2008-06-02 14:12:37 +00:00
parent 04527fe52c
commit 25fddfcd83
1 changed files with 12 additions and 3 deletions

View File

@ -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)