Manual Page Result
0
Command: acl_to_text | Section: 3 | Source: Digital UNIX | File: acl_to_text.3.gz
acl_to_text(3) Library Functions Manual acl_to_text(3)
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
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. The function may change as the P1003.6 standard is finalized.
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 ad-
dress pointing to the text external representation of the ACL. Other-
wise, a value of NULL is returned and errno is set to indicate the er-
ror.
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.
RELATED INFORMATION
acl_size(3), acl_from_text(3)
Security delim off
acl_to_text(3)