*** UNIX MANUAL PAGE BROWSER ***

acl_first_entry(3) Library Functions Manual acl_first_entry(3) NAME acl_first_entry - Resets the current ACL entry to be the first ACL en- try LIBRARY Security Library (libpacl.a) SYNOPSIS #include <sys/acl.h> int acl_first_entry( acl_t acl_d); 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 function may change as the P1003.6 standard is finalized. The acl_first_entry() function rewinds the internal descriptor speci- fied 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() func- tion sets errno to the corresponding value: 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 delim off acl_first_entry(3)