utimensat.2: Make various wordings a little more precise.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

The times argument point to *an array of* structures, and the
man-page should say that consistently.
This commit is contained in:
Nicolas Franois 2008-09-29 12:42:09 +02:00 committed by Michael Kerrisk
parent 2dd5352dae
commit 26b42bb4bf
1 changed files with 7 additions and 6 deletions

View File

@ -46,7 +46,8 @@ _ATFILE_SOURCE
.br
.BR futimens ():
.\" FIXME . Fix the FTM after next POSIX.1 is released.
_GNU_SOURCE /* Will change after next POSIX.1 revision */
_GNU_SOURCE /* Will likely change after POSIX.1-2008 changes are
incorporated into glibc */
.SH DESCRIPTION
.BR utimensat ()
and
@ -479,7 +480,7 @@ and the other is
.B UTIME_OMIT
isn't treated the same as specifying
.I times
as a pointer to a structure containing arbitrary time values.
as a pointer to an array of structures containing arbitrary time values.
As a result, in some cases:
a) file timestamps can be updated by a process that shouldn't have
permission to perform updates;
@ -513,7 +514,7 @@ value is returned in case of an error.
.\" results.
.\" This error should also occur if
.\" .I times
.\" points to a structure in which both
.\" points to an array of structures in which both
.\" .I tv_nsec
.\" fields are
.\" .BR UTIME_NOW .
@ -534,7 +535,7 @@ value is returned in case of an error.
.\" .BR futimens ()
.\" should also produce the same result when given a
.\" .I times
.\" argument that points to a structure in which both
.\" argument that points to an array of structures in which both
.\" .I tv_nsec
.\" fields are
.\" .BR UTIME_NOW .
@ -558,7 +559,7 @@ value is returned in case of an error.
.\" .BR futimens ()
.\" should also produce the same result when given a
.\" .I times
.\" that points to a structure in which both
.\" that points to an array of structures in which both
.\" .I tv_nsec
.\" fields are
.\" .BR UTIME_NOW .
@ -570,7 +571,7 @@ can make a call with
.I times
as NULL, or with
.I times
pointing to a structure in which both
pointing to an array of structures in which both
.I tv_nsec
fields are
.BR UTIME_NOW ,