Skip to contentSkip to conversation

man/man2/chmod.2: Document AT_SYMLINK_NOFOLLOW support

PATCH In review Benjamin Peterson 2 participants 2 messages Jun 19, 2025 – Jun 23, 2025 Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore
#0 lore raw

PATCH v3 1/1 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()").

---
 man/man2/chmod.2 | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)
man/man2/chmod.2 +4 -1
index 307589481..24b9b0dbd 100644
@@ -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
+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()").

Signature · 1 line
2.48.1
#1 lore raw

Hi Benjamin,

Quoted 7 lines · Benjamin Peterson

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()").

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 17 lines
---
 man/man2/chmod.2 | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)
man/man2/chmod.2 +0 -1
index 307589481..24b9b0dbd 100644
@@ -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)

man/man2/chmod.2 POSIX.1-2008. · line 332

Quoted 5 lines
man/man2/chmod.2 +2 -0
@@ -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/

Quoted 24 lines
man/man2/chmod.2 +2 -0
+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()").

Signature · 1 line
2.48.1
Signature · 1 line
<https://www.alejandro-colomar.es/>