| Standards / Extensions | C or C++ | Dependencies |
|---|---|---|
z/OS UNIX |
both | z/OS V1R3 |
#define _OPEN_SYS 1
#include <sys/acl.h>
int acl_first_entry (lacl_t acl_d);Use access control lists (ACLs) in conjunction with permission bits to control access to files and directories. Currently, ACLs are supported by the HFS, TFS, and zFS file systems. You must know whether your security product supports ACLs and what rules are used when determining file access. See z/OS UNIX System Services Planning for details.
A call to acl_first_entry() sets the internal ACL entry offset descriptor for the acl_d argument such that a subsequent call to acl_get_entry() using the same acl_d argument obtains the first extended ACL entry in the ACL.
Upon successful completion, the function returns a value of zero.
If any of the following conditions occur, the acl_init() function returns -1 and sets errno to the corresponding value: