From: NeilBrown <neilb@suse.de>
Date: Wed, 24 Aug 2022 01:21:34 +0000 (+1000)
Subject: utime.2, utimensat.2: explicitly mention ctime changing.
X-Git-Tag: man-pages-6.0-rc1~5
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=cdbf35fff3f3b2ac28fa951626fa880d133e5807;p=thirdparty%2Fman-pages.git

utime.2, utimensat.2: explicitly mention ctime changing.

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>
---

diff --git a/man2/utime.2 b/man2/utime.2
index 5338723574..7557d680af 100644
--- a/man2/utime.2
+++ b/man2/utime.2
@@ -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
diff --git a/man2/utimensat.2 b/man2/utimensat.2
index 11cf3ee241..2abf8e196e 100644
--- a/man2/utimensat.2
+++ b/man2/utimensat.2
@@ -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