diff options
Diffstat (limited to 'man2/utimensat.2')
-rw-r--r-- | man2/utimensat.2 | 48 |
1 files changed, 24 insertions, 24 deletions
diff --git a/man2/utimensat.2 b/man2/utimensat.2 index d58b4d82e..23f2b627b 100644 --- a/man2/utimensat.2 +++ b/man2/utimensat.2 @@ -22,7 +22,7 @@ Standard C library .P .RS -4 Feature Test Macro Requirements for glibc (see -.BR feature_test_macros (7)): +.MR feature_test_macros 7 ): .RE .P .BR utimensat (): @@ -46,9 +46,9 @@ and .BR futimens () update the timestamps of a file with nanosecond precision. This contrasts with the historical -.BR utime (2) +.MR utime 2 and -.BR utimes (2), +.MR utimes 2 , which permit only second and microsecond precision, respectively, when setting file timestamps. .P @@ -73,7 +73,7 @@ Each of the elements of specifies a time as the number of seconds and nanoseconds since the Epoch, 1970-01-01 00:00:00 +0000 (UTC). This information is conveyed in a -.BR timespec (3) +.MR timespec 3 structure. .P Updated file timestamps are set to the greatest value @@ -156,10 +156,10 @@ directory referred to by the open file descriptor, .I dirfd (rather than relative to the current working directory of the calling process, as is done by -.BR utimes (2) +.MR utimes 2 for a relative pathname). See -.BR openat (2) +.MR openat 2 for an explanation of why this can be useful. .P If @@ -172,7 +172,7 @@ then .I pathname is interpreted relative to the current working directory of the calling process (like -.BR utimes (2)). +.MR utimes 2 ). .P If .I pathname @@ -192,7 +192,7 @@ If is an empty string, operate on the file referred to by .I dirfd (which may have been obtained using the -.BR open (2) +.MR open 2 .B O_PATH flag). In this case, @@ -373,7 +373,7 @@ capability); or, .\" since the case when both tv_nsec fields are UTIME_NOW, was not .\" treated like the (times == NULL) case. the file is marked append-only or immutable (see -.BR chattr (1)). +.MR chattr 1 ). .\" EXT2_IMMUTABLE_FL EXT_APPEND_FL and similar flags for .\" other filesystems. .\" @@ -391,7 +391,7 @@ Search permission is denied for one of the prefix components of .IR pathname . .SH ATTRIBUTES For an explanation of the terms used in this section, see -.BR attributes (7). +.MR attributes 7 . .TS allbox; lbx lb lb @@ -451,15 +451,15 @@ POSIX.1-2008. .SH NOTES .BR utimensat () obsoletes -.BR futimesat (2). +.MR futimesat 2 . .P On Linux, timestamps cannot be changed for a file marked immutable, and the only change permitted for files marked append-only is to set the timestamps to the current time. (This is consistent with the historical behavior of -.BR utime (2) +.MR utime 2 and -.BR utimes (2) +.MR utimes 2 on Linux.) .P If both @@ -620,14 +620,14 @@ instead checks whether the .\" be able to update the timestamps of a file, .\" even if it has write permission on the file. .SH SEE ALSO -.BR chattr (1), -.BR touch (1), -.BR futimesat (2), -.BR openat (2), -.BR stat (2), -.BR utimes (2), -.BR futimes (3), -.BR timespec (3), -.BR inode (7), -.BR path_resolution (7), -.BR symlink (7) +.MR chattr 1 , +.MR touch 1 , +.MR futimesat 2 , +.MR openat 2 , +.MR stat 2 , +.MR utimes 2 , +.MR futimes 3 , +.MR timespec 3 , +.MR inode 7 , +.MR path_resolution 7 , +.MR symlink 7 |