aclsort(3c) [hpux man page]

aclsort(3C)															       aclsort(3C)

NAME

       aclsort() - sort an Access Control List (JFS File Systems only)

SYNOPSIS

DESCRIPTION

       The routine sorts JFS Access Control List (ACL) entries into the correct order to be accepted by the acl(2) system call.

       points  to a buffer containing ACL entries; if non-zero, indicates that the permissions should be recalculated; and specifies the number of
       ACL entries in the buffer.

       sorts the contents of the ACL buffer as follows:

	      Entries will be in order and

	      Entries of type and will be sorted in increasing order by numeric ID.

       The call will succeed if all of the following are true:

	      There is exactly one entry each of type and

	      There is at most one entry each of type and

	      Entries of type or may not contain duplicate entries.  A duplicate entry is one of the same type containing  the	same  numeric  id,
	      irrespective of permission bits.

	      If the argument is zero and there are no entries of type and no entries of type the permissions of the and entries must be the same.

	      If  there  are  no entries of type and no entries of type and the entry is specified, then the entry must also be specified, and the
	      permissions of the and entries must be the same.

RETURN VALUE

       Upon successful completion, the return value is 0.  If there are duplicate entries, the return value is the position of the first duplicate
       entry.  If there is more than one entry of type or they are treated as duplicate entries, and the return value is the position of the first
       duplicate entry.  For all other errors, the return value is -1.

NOTICES

       The buffer is sorted by type and ID before checking for any failures.  Therefore the buffer is always sorted, even if there is a failure.

       The position of a duplicate entry returned on failure is not the byte offset of the duplicate entry from its base; rather it refers to  the
       entry number of the duplicate entry within the sorted buffer.

       Checks  will  be performed in order of entry type.  If there are multiple failures, the failure returned will be the first encountered, for
       example, if the ACL buffer contains a duplicate entry and does not contain an entry, the return value will be the first duplicate entry.

       ACLs do not have to be sorted with prior to passing them to acl(2).

DEPENDENCIES

       is supported only on JFS file systems on the standard HP-UX operating system.

AUTHOR

       was developed by AT&T.

SEE ALSO

       acl(2), aclv(5).

																       aclsort(3C)

Check Out this Related Man Page

aclsort(3SEC)					       File Access Control Library Functions					     aclsort(3SEC)

NAME

       aclsort - sort an ACL

SYNOPSIS

       cc [ flag ... ] file ... -lsec [ library ... ]
       #include <sys/acl.h>

       int aclsort(int nentries, int calclass, aclent_t *aclbufp);

DESCRIPTION

       The  aclbufp  argument  points to a buffer containing ACL entries. The nentries argument specifies the number of ACL entries in the buffer.
       The calclass argument, if non-zero, indicates that the CLASS_OBJ (ACL mask) permissions should be recalculated. The union of the permission
       bits associated with all ACL entries in the buffer other than CLASS_OBJ, OTHER_OBJ, and USER_OBJ is calculated. The result is copied to the
       permission bits associated with the CLASS_OBJ entry.

       The aclsort() function sorts the contents of the ACL buffer as follows:

	 o  Entries will be in the order USER_OBJ, USER, GROUP_OBJ, GROUP, CLASS_OBJ (ACL mask), OTHER_OBJ, DEF_USER_OBJ, DEF_USER, DEF_GROUP_OBJ,
	    DEF_GROUP, DEF_CLASS_OBJ (default ACL mask), and DEF_OTHER_OBJ.

	 o  Entries of type USER, GROUP, DEF_USER, and DEF_GROUP will be sorted in increasing order by ID.

       The aclsort() function will succeed if all of the following are true:

	 o  There is exactly one entry each of type USER_OBJ, GROUP_OBJ, CLASS_OBJ (ACL mask), and OTHER_OBJ.

	 o  There  is exactly one entry each of type DEF_USER_OBJ, DEF_GROUP_OBJ, DEF_CLASS_OBJ (default ACL mask), and DEF_OTHER_OBJ if there are
	    any default entries.

	 o  Entries of type USER, GROUP, DEF_USER, or DEF_GROUP may not contain duplicate entries. A duplicate entry is one of the same type  con-
	    taining the same numeric ID.

RETURN VALUES

       Upon successful completion, the function returns 0. Otherwise, it returns -1.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Unsafe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       acl(2), aclcheck(3SEC), attributes(5)

SunOS 5.10							    10 Dec 2001 						     aclsort(3SEC)

Linux and UNIX Man Pages

aclsort(3c) [hpux man page]

Check Out this Related Man Page