From 26b42bb4bf8ead6cdaa8282a7c12dd67fc2a786e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20Fran=E7ois?= Date: Mon, 29 Sep 2008 12:42:09 +0200 Subject: [PATCH] utimensat.2: Make various wordings a little more precise. Signed-off-by: Michael Kerrisk The times argument point to *an array of* structures, and the man-page should say that consistently. --- man2/utimensat.2 | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/man2/utimensat.2 b/man2/utimensat.2 index 3148cb875..bb2f27b94 100644 --- a/man2/utimensat.2 +++ b/man2/utimensat.2 @@ -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 ,