x SuSE Linux 13.1-RELEASE x
x SuSE Linux 13.1-RELEASEx
ACL_FROM_TEXT(3) BSD Library Functions Manual ACL_FROM_TEXT(3)
NAME
acl_from_text -- create an ACL from text
LIBRARY
Linux Access Control Lists library (libacl, -lacl).
SYNOPSIS
#include <sys/types.h>
#include <sys/acl.h>
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
On success, this function returns a pointer to the working storage. On
error, a value of (acl_t)NULL is returned, and errno is set appropri-
ately.
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
allowed by the hardware or system-imposed memory man-
agement 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@bestbits.at>.
Linux ACL March 23, 2002 Linux ACL
Want to link to this manual page? Use this URL:
<http://star2.abcm.com/cgi-bin/bsdi-man?query=acl_from_text&sektion=3&manpath=>