LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity

Change description in NAME line ("or" is not correct: these calls 

always change *both* timestamps).
Other minor wording fixes.
This commit is contained in:
Michael Kerrisk 2008-03-18 09:50:51 +00:00
parent 063a2574dc
commit c18c014112
1 changed files with 10 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
man2/utime.2
View File

@ -28,9 +28,9 @@
.\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com>
.\" Modified 2004-10-10 by Andries Brouwer <aeb@cwi.nl>
.\"
.TH UTIME 2 2007-07-27 "Linux" "Linux Programmer's Manual"
.TH UTIME 2 2008-03-18 "Linux" "Linux Programmer's Manual"
.SH NAME
utime, utimes \- change access and/or modification times of an inode
utime, utimes \- change file last access and modification times
.SH SYNOPSIS
.nf
.B #include <sys/types.h>
@ -58,7 +58,7 @@ If
is NULL, then the access and modification times of the file are set
to the current time.
Changing time stamps is permitted when: either
Changing timestamps is permitted when: either
the process has appropriate privileges (Linux: has the
.B CAP_FOWNER
capability), or the effective user ID equals the user ID
@ -81,7 +81,7 @@ struct utimbuf {
The function
.BR utime ()
allows specification of time stamps with a resolution of 1 second.
allows specification of timestamps with a resolution of 1 second.
.SS utimes()
The function
.BR utimes ()
@ -126,7 +126,7 @@ the path prefix of
.BR path_resolution (7)),
or
.I buf
is NULL and the process does not have permission to change the time stamps
is NULL and the process does not have permission to change the timestamps
(see above).
.TP
.B ENOENT
@ -135,7 +135,7 @@ does not exist.
.TP
.B EPERM
.I buf
is not NULL and the process does not have permission to change the time stamps.
is not NULL and the process does not have permission to change the timestamps.
.TP
.B EROFS
.I path
@ -149,8 +149,8 @@ SVr4, POSIX.1-2001.
.BR utimes ():
4.3BSD
.SH NOTES
Linux does not allow changing the time stamps on an immutable file,
or setting the time stamps to something other than the current time
Linux does not allow changing the timestamps on an immutable file,
or setting the timestamps to something other than the current time
on an append-only file.
In libc4 and libc5,
@ -164,6 +164,8 @@ POSIX.1-2001 marks
legacy, which is strange since it provides more functionality than
.BR utime ().
.\" FIXME . SUSv4 may remove the legacy marking.
.\" POSIX.1-2008 reverses things, removing the LEGACY marking for
.\" utimes() and marking utime() OBSOLESCENT.
.SH BUGS
Linux is not careful to distinguish between the
.B EACCES