ACL_FROM_TEXT(3C)					     ACL_FROM_TEXT(3C)

NAME    [Toc]    [Back]

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

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

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

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

     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






									Page 1






ACL_FROM_TEXT(3C)					     ACL_FROM_TEXT(3C)

SEE ALSO    [Toc]    [Back]

     acl(4).


									PPPPaaaaggggeeee 2222