acl_to_text(3)acl_to_text(3)NAMEacl_to_text - Converts an ACL to an ASCII string
SYNOPSIS
#include <sys/acl.h>
char * acl_to_text(
acl_t acl_d,
ssize_t *len_p );
LIBRARY
Security Library (libpacl.a)
PARAMETERS
Designates the working storage internal representation of an ACL to
convert to text external representation. Pointer to location to hold
the length of the returned string or NULL.
DESCRIPTION
NOTE: This function is based on Draft 13 of the POSIX P1003.6 stan‐
dard.
Given an ACL the acl_to_text() function converts it into a NULL termi‐
nated ASCII character string. The acl_to_text() function allocates any
memory necessary and places the length of the string returned at len_p.
RETURN VALUES
Upon successful completion, the acl_to_text() function returns an
address pointing to the text external representation of the ACL. Oth‐
erwise, a value of NULL is returned and errno is set to indicate the
error.
ERRORS
If any of the following conditions occur, the acl_to_text() function
sets errno to the corresponding value:
The argument acl_d is not in a recognized format.
The argument acl_d contains one or more improperly formatted ACL
entries. There is not enough memory available to the process to
allocate the character string.
SEE ALSOacl_size(3), acl_from_text(3)
Security
acl_to_text(3)