Re: [PATCH v3] man/man2/chmod.2: Document AT_SYMLINK_NOFOLLOW support
From: Alejandro Colomar <alx@kernel.org>
Date: 2025-06-23 01:08:02
Hi Benjamin, On Wed, Jun 18, 2025 at 10:13:42PM -0700, Benjamin Peterson wrote:
Historically, Linux systems did not support the AT_SYMLINK_NOFOLLOW flag to fchmodat. glibc added userspace emulation support in version 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 <redacted>
Thanks! I've applied the patch, with an amendment mentioned below. <https://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git/commit/?h=contrib&id=4044e31a053f6c370b2188deba583797018f04a2> Have a lovely day! Alex
quoted hunk ↗ jump to hunk
--- man/man2/chmod.2 | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-)diff --git a/man/man2/chmod.2 b/man/man2/chmod.2 index 307589481..24b9b0dbd 100644 --- a/man/man2/chmod.2 +++ b/man/man2/chmod.2@@ -197,7 +197,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)@@ -329,6 +328,10 @@ POSIX.1-2008. POSIX.1-2008. Linux 2.6.16, glibc 2.4. +.TP +.BR AT_SYMLINK_NOFOLLOW
I've amended this s/BR/B/
+glibc 2.32,
+Linux 6.5.
.SH SEE ALSO
.BR chmod (1),
.BR chown (2),
Range-diff against v2:
1: f234de5b8 ! 1: ea0fbaf94 man/man2/chmod.2: Document AT_SYMLINK_NOFOLLOW support
@@ Metadata
## Commit message ##
man/man2/chmod.2: Document AT_SYMLINK_NOFOLLOW support
- Historically, Linux systems did not support the AT_SYMLINK_NOFOLLOW flag to fchmodat. glibc added userspace emulation support in version 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()").
+ Historically, Linux systems did not support the AT_SYMLINK_NOFOLLOW flag
+ to fchmodat. glibc added userspace emulation support in version 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 [off-list ref]
--
2.48.1-- <https://www.alejandro-colomar.es/>
Attachments
- signature.asc [application/pgp-signature] 833 bytes