]> git.ipfire.org Git - thirdparty/man-pages.git/commitdiff
utime.2, utimensat.2: explicitly mention ctime changing.
authorNeilBrown <neilb@suse.de>
Wed, 24 Aug 2022 01:21:34 +0000 (11:21 +1000)
committerAlejandro Colomar <alx.manpages@gmail.com>
Wed, 24 Aug 2022 11:47:35 +0000 (13:47 +0200)
utime and related calls always change the ctime.  It is worth making
this explicit.
This is clear from the code (vfs_utimes() in fs/utimes.c always sets
ATTR_CTIME) and is documented in
  <https://pubs.opengroup.org/onlinepubs/007904875/functions/utimes.html>

Signed-off-by: NeilBrown <neilb@suse.de>
Reviewed-by: Jeff Layton <jlayton@kernel.org>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
man2/utime.2
man2/utimensat.2

index 5338723574e2f0268996ea1bd76d1d6cc24872d8..7557d680afa3f1c6859a777fb67e5777a50da1fa 100644 (file)
@@ -39,6 +39,8 @@ to the
 fields of
 .I times
 respectively.
+The status change time (ctime) will be set to the current time, even if the
+other time stamps don't actually change.
 .PP
 If
 .I times
index 11cf3ee241291bcd1ffdb37b49a56e571c786606..2abf8e196ee1c12b2d8e774b8773325ba3019245 100644 (file)
@@ -101,6 +101,9 @@ If
 .I times
 is NULL, then both timestamps are set to the current time.
 .\"
+.PP
+The status change time (ctime) will be set to the current time, even if the
+other time stamps don't actually change.
 .SS Permissions requirements
 To set both file timestamps to the current time (i.e.,
 .I times