This is an automated email from the ASF dual-hosted git repository.

xiaoxiang781216 pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/nuttx.git

commit 1e6d30aaee997166fd5ca69da45d6d1030d7b489
Author: Marco Casaroli <[email protected]>
AuthorDate: Mon Oct 19 17:38:53 2026 +0200

    Documentation: Describe CH_STAT_NOFOLLOW for the chstat() method.
    
    lchown(), lchmod() and lutimens() now set CH_STAT_NOFOLLOW in the flags
    of the chstat() method of a file system.  Say what it means.
    
    Assisted-by: Claude Code:claude-opus-5-5
    Signed-off-by: Marco Casaroli <[email protected]>
---
 Documentation/os/filesystem/index.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/Documentation/os/filesystem/index.rst 
b/Documentation/os/filesystem/index.rst
index 6d26a45ad98..3df0b6b0b29 100644
--- a/Documentation/os/filesystem/index.rst
+++ b/Documentation/os/filesystem/index.rst
@@ -494,7 +494,9 @@ belonging to a unified interface:
     only the ones that are required according to the flags.
   :param int flags: A bit field that can have values including ``CH_STAT_MODE``
     , ``CH_STAT_UID``, ``CH_STAT_GID``, ``CH_STAT_ATIME`` or ``CH_STAT_MTIME``
-    which are or-ed together.
+    which are or-ed together. ``lchown()``, ``lchmod()`` and ``lutimens()``
+    also set ``CH_STAT_NOFOLLOW``: if ``relpath`` names a symbolic link, the
+    file system must change the link itself, not the file that it points to.
 
 .. c:function:: int syncfs(FAR struct inode *mountpt)
 

Reply via email to