git: dedbb972d294 - main - fhopen.2: Update man page for O_NAMEDATTR flag

From: Rick Macklem <rmacklem_at_FreeBSD.org>
Date: Thu, 10 Apr 2025 00:51:54 UTC
The branch main has been updated by rmacklem:

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

commit dedbb972d2942ca45eadbdc22f5b139ea417f5b5
Author:     Rick Macklem <rmacklem@FreeBSD.org>
AuthorDate: 2025-04-10 00:50:36 +0000
Commit:     Rick Macklem <rmacklem@FreeBSD.org>
CommitDate: 2025-04-10 00:50:36 +0000

    fhopen.2: Update man page for O_NAMEDATTR flag
    
    This patch updates the man page for the O_NAMEDATTR flag.
    
    Another man page that explains named attributes will
    be introduced in a future commit.
    
    This is a content change.
    
    Reviewed by:    manpages (zaiee)
    Fixes:  2ec2ba7e ("Add support for Solaris style extended attr")
    Differential Revision:  https://reviews.freebsd.org/D49718
---
 lib/libsys/fhopen.2 | 19 +++++++++++++++++--
 1 file changed, 17 insertions(+), 2 deletions(-)

diff --git a/lib/libsys/fhopen.2 b/lib/libsys/fhopen.2
index 5bd1e9f8d90b..aba53f1dd907 100644
--- a/lib/libsys/fhopen.2
+++ b/lib/libsys/fhopen.2
@@ -31,7 +31,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd June 29, 1999
+.Dd April 6, 2025
 .Dt FHOPEN 2
 .Os
 .Sh NAME
@@ -75,6 +75,10 @@ together the flags used for the
 system call.
 All said flags are valid except for
 .Dv O_CREAT .
+If the file handle refers to a named attribute or named attribute
+directory, the
+.Dv O_NAMEDATTR
+flag must be specified.
 .Pp
 The
 .Fn fhstat
@@ -116,6 +120,16 @@ Calling
 with
 .Dv O_CREAT
 set.
+.It Bq Er ENOATTR
+The file handle does not refer to a named attribute or named attribute
+directory although the
+.Dv O_NAMEDATTR
+flag was specified.
+.It Bq Er ENOATTR
+The file handle refers to a named attribute or named attribute directory
+although the
+.Dv O_NAMEDATTR
+flag was not specified.
 .It Bq Er ESTALE
 The file handle
 .Fa fhp
@@ -125,7 +139,8 @@ is no longer valid.
 .Xr fstat 2 ,
 .Xr fstatfs 2 ,
 .Xr getfh 2 ,
-.Xr open 2
+.Xr open 2 ,
+.Xr named_attribute 9
 .Sh HISTORY
 The
 .Fn fhopen ,