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

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

commit 00ab0e17b09d7d328cb5973f1d9089276fc4ca41
Author: Marco Casaroli <[email protected]>
AuthorDate: Sat Oct 17 19:53:23 2026 +0200

    Documentation: Describe mkfifo() errors for a mount point path.
    
    Describe that a FIFO can exist only in the pseudo file system.
    mkfifo() of a path inside a mounted file system fails with EPERM when
    no file exists at that path, and with EEXIST when a file exists.
    
    Assisted-by: Claude Code:claude-opus-5-5
    Signed-off-by: Marco Casaroli <[email protected]>
---
 Documentation/reference/user/10_filesystem.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/Documentation/reference/user/10_filesystem.rst 
b/Documentation/reference/user/10_filesystem.rst
index 58ddc19a888..4cc5627d433 100644
--- a/Documentation/reference/user/10_filesystem.rst
+++ b/Documentation/reference/user/10_filesystem.rst
@@ -439,6 +439,10 @@ Pipes and FIFOs
   If all threads that write to the FIFO have closed, subsequent calls to
   read() on the FIFO will return 0 (end-of-file).
 
+  A FIFO can exist only in the pseudo file system. If ``pathname`` is inside
+  a mounted file system and no file exists at that path, mkfifo() fails with
+  ``EPERM``. If a file exists at that path, it fails with ``EEXIST``.
+
   :param pathname: The full path to the FIFO instance to attach to or to
     create (if not already created).
   :param mode: Ignored for now

Reply via email to