 |
Index for Section 3 |
|
 |
Alphabetical listing for A |
|
acl_first_entry(3)
NAME
acl_first_entry - Resets the current ACL entry to be the first ACL entry
LIBRARY
Security Library (libpacl.a)
SYNOPSIS
#include <sys/acl.h>
int acl_first_entry(
acl_t acl_d);
PARAMETERS
acl_d Specifies the working storage internal representation ACL
descriptor.
DESCRIPTION
NOTE: This function is based on Draft 13 of the POSIX P1003.6 standard.
The function may change as the P1003.6 standard is finalized.
The acl_first_entry() function rewinds the internal descriptor specified by
the acl_d parameter such that a subsequent call to the acl_get_entry()
function, will access the first entry in the ACL.
RETURN VALUES
Upon successful completion, the acl_first_entry() function returns a value
of 0 (zero). Otherwise, a value of -1 is returned, and the errno global
variable is set to indicate the error.
ERRORS
If any of the following conditions occur, the acl_first_entry() function
sets errno to the corresponding value:
[EINVAL] The acl_d parameter does not refer to a valid ACL entry.
RELATED INFORMATION
acl_get_entry(3), acl_copy_entry(3), acl_create_entry(3),
acl_delete_entry(3), acl(4)
Security