mirror of https://github.com/mkerrisk/man-pages
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:
parent
2dd5352dae
commit
26b42bb4bf
|
@ -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 ,
|
||||
|
|
Loading…
Reference in New Issue