acl_from_text(3C)

NAME
     acl_from_text, acl_to_short_text, acl_to_text - convert a POSIX ACL
     string to a struct acl or a struct acl to a POSIX ACL string

SYNOPSIS
     #include <sys/acl.h>

     acl_t acl_from_text(const char *argp);
     char * acl_to_short_text(struct acl * aclp, ssize_t *len_p);
     char * acl_to_text(struct acl * aclp, ssize_t *len_p);

DESCRIPTION
     These routines convert strings defined by the POSIX P1003.1e
     specifications (see chacl(1) acl(4)) to/from struct acl, which is the
     internal format for an Access Control List (see acl(4)).

RETURN VALUES
     acl_from_text returns a pointer to a struct acl allocated by the routine
     or a NULL pointer in the case of a failure.  The acl should be freed when
     no longer needed by calling acl_free(3c).

     acl_to_text returns a pointer to a null terminated character string
     allocated by the routine which is a long form representation of the ACL,
     or a NULL pointer if an error occurred.  This string should be freed when
     no longer needed by calling acl_free(3c).  If the len_p argument is not
     NULL, then the length of the string is returned in ssize_t pointed to by
     len_p.

     acl_to_short_text is identical to acl_to_text, except that a short form
     representation of the ACL is returned.

ERRORS
     acl_from_text:

     EINVAL          input text is invalid

     ENOMEM          could not allocate space for new acl

     acl_to_short_text:

     EINVAL          input acl is invalid

     ENOMEM          could not allocate space for the return string

     acl_to_text:

     EINVAL          input acl is invalid

     ENOMEM          could not allocate space for the return string
SEE ALSO
     acl(4).