acl_from_text(3)

1ACL_FROM_TEXT(3)         BSD Library Functions Manual         ACL_FROM_TEXT(3)
2

NAME

4     acl_from_text — create an ACL from text
5

LIBRARY

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

SYNOPSIS

10     #include <sys/types.h>
11     #include <sys/acl.h>
12
13     acl_t
14     acl_from_text(const char *buf_p);
15

DESCRIPTION

17     The acl_from_text() function converts the text form of the ACL referred
18     to by buf_p into the internal form of an ACL and returns a pointer to the
19     working storage that contains the ACL. The acl_from_text() function ac‐
20     cepts as input the long text form and short text form of an ACL as de‐
21     scribed in acl(5).
22
23     This function may cause memory to be allocated.  The caller should free
24     any releasable memory, when the new ACL is no longer required, by calling
25     acl_free(3) with the (void*)acl_t returned by acl_from_text() as an argu‐
26     ment.
27

RETURN VALUE

29     On success, this function returns a pointer to the working storage.  On
30     error, a value of (acl_t)NULL is returned, and errno is set appropri‐
31     ately.
32

ERRORS

34     If any of the following conditions occur, the acl_from_text() function
35     returns a value of (acl_t)NULL and sets errno to the corresponding value:
36
37     [EINVAL]           The argument buf_p cannot be translated into an ACL.
38
39     [ENOMEM]           The acl_t to be returned requires more memory than is
40                        allowed by the hardware or system-imposed memory man‐
41                        agement constraints.
42

STANDARDS

44     IEEE Std 1003.1e draft 17 (“POSIX.1e”, abandoned)
45

AUTHOR

50     Derived from the FreeBSD manual pages written by Robert N M Watson
51     <rwatson@FreeBSD.org>, and adapted for Linux by Andreas Gruenbacher
52     <andreas.gruenbacher@gmail.com>.
53
54Linux ACL                       March 23, 2002                       Linux ACL