Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

aclsort(3) OSS Library Calls Reference Manual
NAME
aclsort - Sorts an access control list (ACL)
LIBRARY
G-series native OSS processes: /G/system/sysnn/zossfsrl
32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zossfdll |
64-bit H-series and J-series OSS processes: /G/system/zdllnnn/yossfdll |
SYNOPSIS
#include <sys/types.h>
#include <sys/acl.h>
int aclsort(
int nentries,
int calclass,
struct acl *aclbufp);
PARAMETERS
nentries Specifies the number of ACL entries in the buffer aclbufp.
calclass If nonzero, specifies that the class permissions be recalculated.
aclbufp Points to a buffer containing ACL entries.
DESCRIPTION
The aclsort function sorts ACL entry objects into the order required by the acl( ) function:
USER_OBJ
USER
GROUP_OBJ
GROUP
CLASS_OBJ
OTHER_OBJ
DEF_USER_OBJ
DEF_USER
DEF_GROUP_OBJ
DEF_GROUP
DEF_CLASS_OBJ
DEF_OTHER_OBJ
Entries of type USER, GROUP, DEF_USER, and DEF_GROUP are sorted in increasing order
by numeric ID.
This function succeeds if all of these conditions are true:
• The ACL contains exactly one entry each of type USER_OBJ, GROUP_OBJ,
CLASS_OBJ, and OTHER_OBJ.
• If pathp points to a directory, the ACL contains at most one entry each of type
DEF_USER_OBJ, DEF_GROUP_OBJ, DEF_CLASS_OBJ, and
DEF_OTHER_OBJ.
• Entries of type USER, GROUP, DEF_USER,orDEF_GROUP do not contain dupli-
cate entries. A duplicate entry is one of the same type containing the same numeric ID.
1−6 Hewlett-Packard Company 527187-017