summaryrefslogtreecommitdiffstats
path: root/lib/libc/posix1e/acl_to_text.3
diff options
context:
space:
mode:
Diffstat (limited to 'lib/libc/posix1e/acl_to_text.3')
-rw-r--r--lib/libc/posix1e/acl_to_text.326
1 files changed, 22 insertions, 4 deletions
diff --git a/lib/libc/posix1e/acl_to_text.3 b/lib/libc/posix1e/acl_to_text.3
index 833a6d2..38c588b 100644
--- a/lib/libc/posix1e/acl_to_text.3
+++ b/lib/libc/posix1e/acl_to_text.3
@@ -31,7 +31,8 @@
.Dt ACL_TO_TEXT 3
.Os
.Sh NAME
-.Nm acl_to_text
+.Nm acl_to_text ,
+.Nm acl_to_text_np
.Nd convert an ACL to text
.Sh LIBRARY
.Lb libc
@@ -40,10 +41,14 @@
.In sys/acl.h
.Ft char *
.Fn acl_to_text "acl_t acl" "ssize_t *len_p"
+.Ft char *
+.Fn acl_to_text_np "acl_t acl" "ssize_t *len_p" "int flags"
.Sh DESCRIPTION
The
.Fn acl_to_text
-function translates the ACL pointed to by argument
+and
+.Fn acl_to_text_np
+functions translate the ACL pointed to by argument
.Va acl
into a NULL terminated character string.
If the pointer
@@ -51,9 +56,22 @@ If the pointer
is not NULL, then the function shall return the length of the string (not
including the NULL terminator) in the location pointed to by
.Va len_p .
-The format of the text string returned by
+If the ACL is POSIX.1e, the format of the text string returned by
.Fn acl_to_text
-shall be the POSIX.1e long ACL form.
+shall be the POSIX.1e long ACL form. If the ACL is NFSv4, the format
+of the text string shall be the compact form, unless the
+.Va ACL_TEXT_VERBOSE
+flag is given.
+.Pp
+The flags specified are formed by
+.Em or Ns 'ing
+the following values
+.Pp
+.Bl -column -offset 3n "ACL_TEXT_NUMERIC_IDS"
+.It ACL_TEXT_VERBOSE Format ACL using verbose form
+.It ACL_TEXT_NUMERIC_IDS Do not resolve IDs into user or group names
+.It ACL_TEXT_APPEND_ID In addition to user and group names, append numeric IDs
+.El
.Pp
This function allocates any memory necessary to contain the string and
returns a pointer to the string.
OpenPOWER on IntegriCloud