acl_get_entry(3)acl_get_entry(3)NAMEacl_get_entry - Returns a descriptor to an ACL entry
SYNOPSIS
#include <sys/acl.h>
acl_entry_t acl_get_entry(
acl_t acl_d );
LIBRARY
Security Library (libpacl.a)
PARAMETERS
Specifies the working storage internal representation ACL descriptor.
DESCRIPTION
NOTE: This function is based on Draft 13 of the POSIX P1003.6 stan‐
dard.
The acl_get_entry() function returns a pointer to the next entry in the
specified ACL.
Following a call to the acl_get_fd(), acl_get_file(), acl_from_text(),
or acl_first_entry() function, the first call to the acl_get_entry()
function obtains the first entry in the ACL. Subsequent calls obtain
successive entries in the ACL, until the last entry is obtained. After
the last entry has been obtained, the value 0 (zero) is returned.
RETURN VALUES
Upon successful completion, the acl_get_entry() function returns a
pointer to the ACL entry descriptor. If the last ACL has already been
returned by a previous call to this function, or the ACL has no ACL
entries, the function returns a value of 0 (zero). Otherwise, a value
of NULL is returned and errno is set to indicate the error.
ERRORS
The acl_d parameter does not refer to a valid ACL structure. The posi‐
tion of the ACL entry must be reset using the acl_first_entry() library
routine.
SEE ALSOacl_init(3), acl_copy_entry(3), acl_delete_entry(3), acl_get_file(3),
acl_get_fd(3), acl_first_entry(3)
Security
acl_get_entry(3)