git: 92876ef4900b - stable/13 - acl(3): improve discoverability of acl_get_perm_np(3)

From: Kyle Evans <kevans_at_FreeBSD.org>
Date: Wed, 21 Jun 2023 02:39:33 UTC
The branch stable/13 has been updated by kevans:

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

commit 92876ef4900b0165eb4098db12f2dafa8974e37d
Author:     Kyle Evans <kevans@FreeBSD.org>
AuthorDate: 2023-05-09 03:45:12 +0000
Commit:     Kyle Evans <kevans@FreeBSD.org>
CommitDate: 2023-06-20 19:03:48 +0000

    acl(3): improve discoverability of acl_get_perm_np(3)
    
    - Mention it in acl(3) as an available function, xref
    - Mention it in acl_get_permset(3), as acl_get_perm_np(3) is a natural
        follow-up to acl_get_permset(3)
    
    Sponsored by:   Klara, Inc.
    
    (cherry picked from commit 20c61a7c518b9c2f451118913e10a1525ad0b578)
---
 lib/libc/posix1e/acl.3             | 7 ++++++-
 lib/libc/posix1e/acl_get_permset.3 | 3 ++-
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/lib/libc/posix1e/acl.3 b/lib/libc/posix1e/acl.3
index 2c7ebd63ad4e..33b4ad0f7620 100644
--- a/lib/libc/posix1e/acl.3
+++ b/lib/libc/posix1e/acl.3
@@ -27,7 +27,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd October 30, 2014
+.Dd May 8, 2023
 .Dt ACL 3
 .Os
 .Sh NAME
@@ -158,6 +158,10 @@ and may be used to retrieve an ACL type from an ACL entry.
 This function is described in
 .Xr acl_get_flagset_np 3 ,
 and may be used to retrieve a flagset from an ACL entry.
+.It Fn acl_get_perm_np
+This function is described in
+.Xr acl_get_perm_np 3 ,
+and may be used to check if a permission is set in a permset.
 .It Fn acl_get_permset
 This function is described in
 .Xr acl_get_permset 3 ,
@@ -257,6 +261,7 @@ library.
 .Xr acl_get_brand_np 3 ,
 .Xr acl_get_entry_type_np 3 ,
 .Xr acl_get_flagset_np 3 ,
+.Xr acl_get_perm_np 3 ,
 .Xr acl_get_permset 3 ,
 .Xr acl_get_qualifier 3 ,
 .Xr acl_get_tag_type 3 ,
diff --git a/lib/libc/posix1e/acl_get_permset.3 b/lib/libc/posix1e/acl_get_permset.3
index 064f71ce45bc..5971583b28fc 100644
--- a/lib/libc/posix1e/acl_get_permset.3
+++ b/lib/libc/posix1e/acl_get_permset.3
@@ -25,7 +25,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd March 10, 2001
+.Dd May 8, 2023
 .Dt ACL_GET_PERMSET 3
 .Os
 .Sh NAME
@@ -65,6 +65,7 @@ is not a valid descriptor for an ACL entry.
 .Xr acl_add_perm 3 ,
 .Xr acl_clear_perms 3 ,
 .Xr acl_delete_perm 3 ,
+.Xr acl_get_perm_np 3 ,
 .Xr acl_set_permset 3 ,
 .Xr posix1e 3
 .Sh STANDARDS