NAME
LIBRARY
Linux Access Control Lists library (libacl, -lacl).
SYNOPSIS
n sys/types.h
n sys/acl.h
DESCRIPTION
The
function copies an exportable, contiguous, persistent form of an ACL, pointed to by
to the internal representation.
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
returned by
as an argument.
RETURN VALUE
Upon success,
the
function returns a pointer that references the ACL in working storage.
On error, a value of
is returned, and
is set appropriately.
ERRORS
If any of the following conditions occur, the
function returns a value of
and sets
to the corresponding value:
- EINVAL
The buffer pointed to by the argument
does not contain a valid external form ACL.
- ENOMEM
The ACL working storage requires more memory than is allowed by the hardware or system-imposed memory management constraints.
STANDARDS
IEEE Std 1003.1e draft 17 (POSIX.1e, abandoned)
SEE ALSO
AUTHOR
Derived from the FreeBSD manual pages written by
and adapted for Linux by
