Thread (2 messages) 2 messages, 2 authors, 2025-06-19

Re: [PATCH v2] man/man2/chmod.2: Document AT_SYMLINK_NOFOLLOW support

From: Alejandro Colomar <alx@kernel.org>
Date: 2025-06-19 01:06:54

Hi Benjamin,

On Wed, Jun 11, 2025 at 08:11:58AM -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()").
Please format the commit message to use only 72 columns.
Signed-off-by: Benjamin Peterson <redacted>
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
+glibc 2.32,
+Linux 6.5.
 .SH SEE ALSO
 .BR chmod (1),
 .BR chown (2),
Range-diff against v1:
1:  6a1171eb1 ! 1:  f234de5b8 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 6b89c385d8bd0700b25bac2c2d0bebe68d5cc05d ("io: Implement lchmod using fchmodat [BZ #14578]") and linux.git 09da082b07bbae1c11d9560c8502800039aebcea ("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]
     
    @@ man/man2/chmod.2: POSIX.1-2008.
      POSIX.1-2008.
      Linux 2.6.16,
      glibc 2.4.
    ++.TP
     +.BR AT_SYMLINK_NOFOLLOW
     +glibc 2.32,
     +Linux 6.5.
-- 
2.48.1
-- 
<https://www.alejandro-colomar.es/>

Attachments

Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help