ACL_FROM_TEXT(3C)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
Page 1
ACL_FROM_TEXT(3C)ACL_FROM_TEXT(3C)SEE ALSOacl(4).
Page 2
