acl_sort() — Sort the extended ACL entries

Standards

Standards / Extensions	C or C++	Dependencies
z/OS UNIX	both	z/OS V1R3

Format

#define _OPEN_SYS	1
#include <sys/acl.h>

int acl_sort(lacl_t acl_d);

General description

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.

The acl_sort() function sorts the extended ACL entries in the following orders:

ACL_USER lowest to highest uid
ACL_GROUP lowest to highest gid

Returned value

Upon successful completion, the function returns a value of zero.

If any of the following conditions occur, the acl_sort() returns -1 and sets errno to the corresponding value:

Error Code: Description
EINVAL: Argument acl_d does not point to a valid ACL structure.

Related information

sys/acl.h