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 xfs_acl(1)) to/from struct acl, which is the internal format for an Access Control List.

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(3).

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(3). 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_to_short_text:

	EINVAL ENOMEM acl_to_text:		input acl is invalid could not allocate space for the return string
	EINVAL ENOMEM		input acl is invalid could not allocate space for the return string