The acl_create_entry() function creates a new ACL entry in the ACL
pointed to by the contents of the pointer argument acl_p. On success,
the function returns a descriptor for the new ACL entry via entry_p.
This function may cause memory to be allocated. The caller should free
any releasable memory, when the new ACL is no longer required, by call‐
ing acl_free(3) with (void*)*acl_p as an argument. If the ACL working
storage cannot be increased in the current location, then the working
storage for the ACL pointed to by acl_p may be relocated and the previ‐
ous working storage is released. A pointer to the new working storage
is returned via acl_p.
The components of the new ACL entry are initialized in the following
ways: the ACL tag type component contains ACL_UNDEFINED_TAG, the quali‐
fier component contains ACL_UNDEFINED_ID, and the set of permissions
has no permissions enabled. Any existing ACL entry descriptors that
refer to entries in the ACL continue to refer to those entries.
If any of the following conditions occur, the acl_create_entry() func‐
tion returns -1 and sets errno to the corresponding value:
[EINVAL] The argument acl_p is not a valid pointer to an ACL.
[ENOMEM] The ACL working storage requires more memory than is
allowed by the hardware or system-imposed memory
This page is part of the acl (manipulating access control lists)
project. Information about the project can be found at
http://savannah.nongnu.org/projects/acl. If you have a bug report for
this manual page, see http://savannah.nongnu.org/bugs/?group=acl. This
page was obtained from the project's upstream Git repository
git://git.savannah.nongnu.org/acl.git on 2017-03-13. If you discover
any rendering problems in this HTML version of the page, or you believe
there is a better or more up-to-date source for the page, or you have
corrections or improvements to the information in this COLOPHON (which
is not part of the original manual page), send a mail to
Linux ACL March 23, 2002 Linux ACL