git: c81417289606 - main - open.2: update description for O_PATH

From: Mark Johnston <markj_at_FreeBSD.org>
Date: Fri, 24 Jan 2025 20:17:05 UTC
The branch main has been updated by markj:

URL: https://cgit.FreeBSD.org/src/commit/?id=c81417289606ca9c808417672c603b5e233856de

commit c81417289606ca9c808417672c603b5e233856de
Author:     CismonX <admin@cismon.net>
AuthorDate: 2025-01-03 10:52:34 +0000
Commit:     Mark Johnston <markj@FreeBSD.org>
CommitDate: 2025-01-24 20:15:09 +0000

    open.2: update description for O_PATH
    
    - Add fstatfs(), fchdir(), fchroot(), extattr_*_fd(), cap_*_get(),
      cap_*_limit() to the list of syscalls that can take an O_PATH fd.
    - Remove readlinkat() from the list, since it is already discussed
      in the first few lines of the paragraph.  It was originally added
      to the list when readlinkat() adds support for non-dir fd with
      an empty relative path (as if with AT_EMPTY_PATH), however,
      such use case is also discussed in the next paragraph.
    - Add funlinkat() to the list, since it accepts an extra fd
      (of the file to be unlinked), which is worth extra mentioning.
    - Fix a syntax issue which causes a bogus space to be rendered
      before a closing parentheses.
    
    Signed-off-by: CismonX <admin@cismon.net>
    
    Reviewed by:    markj, jhb
    MFC after:      2 weeks
    Pull Request:   https://github.com/freebsd/freebsd-src/pull/1564
---
 lib/libsys/open.2 | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/lib/libsys/open.2 b/lib/libsys/open.2
index fe1ad757b5b0..9ad5440bf239 100644
--- a/lib/libsys/open.2
+++ b/lib/libsys/open.2
@@ -393,7 +393,12 @@ but advisory locking is not allowed
 .It Xr dup 2
 .It Xr close 2
 .It Xr fstat 2
+.It Xr fstatfs 2
+.It Xr fchdir 2
+.It Xr fchroot 2
 .It Xr fexecve 2
+.It Xr funlinkat 2
+can be passed as the third argument
 .It Dv SCM_RIGHTS
 can be passed over a
 .Xr unix 4
@@ -403,16 +408,23 @@ message
 .It Xr kqueue 2
 only with
 .Dv EVFILT_VNODE
-.It Xr readlinkat 2
 .It Xr __acl_get_fd 2
 .It Xr __acl_aclcheck_fd 2
+.It Xr extattr 2
+.It Xr capsicum 4
+can be passed to
+.Fn cap_*_limit
+and
+.Fn cap_*_get
+system calls (such as
+.Xr cap_rights_limit 2 ) .
 .El
 .Pp
 Other operations like
 .Xr read 2 ,
 .Xr ftruncate 2 ,
 and any other that operate on file and not on file descriptor (except
-.Xr fstat 2 ),
+.Xr fstat 2 ) ,
 are not allowed.
 .Pp
 A file descriptor created with the