From: Benjamin Peterson <benjamin@locrian.net>
Date: Thu, 19 Jun 2025 05:13:42 +0000 (-0700)
Subject: man/man2/chmod.2: Document AT_SYMLINK_NOFOLLOW support in fchmodat(2)
X-Git-Tag: man-pages-6.15~16
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=aefbd603d14612032c5a296746125e30b4ee696e;p=thirdparty%2Fman-pages.git

man/man2/chmod.2: Document AT_SYMLINK_NOFOLLOW support in fchmodat(2)

Historically, Linux systems did not support the AT_SYMLINK_NOFOLLOW flag
to fchmodat(2).  glibc added userspace emulation support in glibc 2.32,
and Linux gained native support in 6.5.  See glibc.git 6b89c385d8bd
(2020-02-12; "io: Implement lchmod using fchmodat [BZ #14578]") and
linux.git 09da082b07bb (2023-07-27; "fs: Add fchmodat2()").

Signed-off-by: Benjamin Peterson <benjamin@locrian.net>
Message-ID: <20250619051342.145412-2-benjamin@locrian.net>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
---

diff --git a/man/man2/chmod.2 b/man/man2/chmod.2
index 671e256ba..d2d91b7d8 100644
--- a/man/man2/chmod.2
+++ b/man/man2/chmod.2
@@ -220,7 +220,6 @@ If
 .I path
 is a symbolic link, do not dereference it:
 instead operate on the link itself.
-This flag is not currently implemented.
 .P
 See
 .BR openat (2)
@@ -352,6 +351,10 @@ POSIX.1-2008.
 POSIX.1-2008.
 Linux 2.6.16,
 glibc 2.4.
+.TP
+.B AT_SYMLINK_NOFOLLOW
+glibc 2.32,
+Linux 6.5.
 .SH SEE ALSO
 .BR chmod (1),
 .BR chown (2),