diff --git a/man2/utime.2 b/man2/utime.2 index 413a6a24c..5fcd87269 100644 --- a/man2/utime.2 +++ b/man2/utime.2 @@ -28,9 +28,9 @@ .\" Modified 2004-06-23 by Michael Kerrisk .\" Modified 2004-10-10 by Andries Brouwer .\" -.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 @@ -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