Linux Access Control Lists library (libacl, -lacl).


SYNOPSIS

     acl_t
     acl_from_text(const char *buf_p)


DESCRIPTION

     The acl_from_text() function converts the text form of the ACL referred
     to by buf_p into the internal form of an ACL and returns a pointer to the
     working storage that contains the ACL. The acl_from_text() function ac­
     cepts as input the long text form and short text form of an ACL as de­
     scribed in acl(5).

     This function may cause memory to be allocated.  The caller should free
     any releasable memory, when the new ACL is no longer required, by calling
     acl_free(3) with the (void*)acl_t returned by acl_from_text() as an argu­
     ment.


RETURN VALUE

     Upon successful completion, this function returns a pointer to the work­
     ing storage.  Otherwise, a value of (acl_t)NULL is returned, and errno is
     set to indicate the error.


ERRORS

     If any of the following conditions occur, the acl_from_text() function
     returns a value of (acl_t)NULL and sets errno to the corresponding value:

     [EINVAL]      The argument buf_p cannot be translated into an ACL.

     [ENOMEM]      The acl_t to be returned requires more memory than is al­
                   lowed by the hardware or system-imposed memory management
                   constraints.


STANDARDS

     IEEE Std 1003.1e draft 17 ("POSIX.1e", abandoned)


SEE ALSO

     acl_free(3),  acl_get_entry(3),  acl(5)


AUTHOR

     Derived from the FreeBSD manual pages written by Robert N M Watson
     <rwatson@FreeBSD.org>, and adapted for Linux by Andreas Gruenbacher
     <a.gruenbacher@computer.org>.

 Linux ACL                      March 23, 2002                               1

Man(1) output converted with man2html