NAME    [Toc]    [Back]

       acl_to_text - Converts an ACL to an ASCII string

SYNOPSIS    [Toc]    [Back]

       #include <sys/acl.h>

       char * acl_to_text(
               acl_t acl_d,
               ssize_t *len_p );

LIBRARY    [Toc]    [Back]

       Security Library (libpacl.a)

PARAMETERS    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       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 ALSO    [Toc]    [Back]

       acl_size(3), acl_from_text(3)

       Security



                                                   acl_to_text(3)