NAME

acl_to_text − Converts an ACL to an ASCII string

LIBRARY

Security Library (libpacl.a)

SYNOPSIS

#include <sys/acl.h> char ∗ acl_to_text(
acl_t acl_d
ssize_t ∗len_p);

PARAMETERS

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

len_pPointer 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. The function may change as the P1003.6 standard is finalized. 

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. 

RELATED INFORMATION

acl_size(3), acl_from_text(3)

Security