NAME

acl_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

acl_d
Designates the working storage internal representation of an ACL to convert to text external representation.

len_p
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 standard. 

Given an ACL the acl_to_text() function converts it into a NULL terminated 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.  Otherwise, 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:

[EINVAL]
The argument acl_d is not in a recognized format. 

The argument acl_d contains one or more improperly formatted ACL entries. 

[ENOMEM]
There is not enough memory available to the process to allocate the character string.

SEE ALSO

acl_size(3), acl_from_text(3)

Security