acl_copy_int(3)

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

NAME

4     acl_copy_int — copy an ACL from external to internal representation
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_copy_int(const void *buf_p);
15

DESCRIPTION

17     The acl_copy_int() function copies an exportable, contiguous, persistent
18     form of an ACL, pointed to by buf_p, to the internal representation.
19
20     This function may cause memory to be allocated.  The caller should free
21     any releasable memory, when the new ACL is no longer required, by calling
22     acl_free(3) with the (void*)acl_t returned by acl_copy_int() as an argu‐
23     ment.
24

RETURN VALUE

26     Upon success, the acl_copy_int() function returns a pointer that refer‐
27     ences the ACL in working storage.  On error, a value of (acl_t)NULL is
28     returned, and errno is set appropriately.
29

ERRORS

31     If any of the following conditions occur, the acl_copy_int() function
32     returns a value of (acl_t)NULL and sets errno to the corresponding value:
33
34     [EINVAL]           The buffer pointed to by the argument buf_p does not
35                        contain a valid external form ACL.
36
37     [ENOMEM]           The ACL working storage requires more memory than is
38                        allowed by the hardware or system-imposed memory man‐
39                        agement constraints.
40

STANDARDS

42     IEEE Std 1003.1e draft 17 (“POSIX.1e”, abandoned)
43

AUTHOR

48     Derived from the FreeBSD manual pages written by Robert N M Watson
49     <rwatson@FreeBSD.org>, and adapted for Linux by Andreas Gruenbacher
50     <a.gruenbacher@bestbits.at>.
51
52Linux ACL                       March 23, 2002                       Linux ACL