acl_set_qualifier - Sets the uid or gid on an ACL entry
Security Library (libpacl.a)
Designates the working storage internal representation ACL entry to set the tag qualifier in. Designates the uid or gid to set the tag qualifier to.
NOTE: This function is based on Draft 13 of the POSIX P1003.6 standard. The function may change as the P1003.6 standard is finalized.
Given an ACL entry, the acl_set_qualifier() function sets the id in the ACL entry. If the tag type of the given ACL entry is ACL_USER then tag_qualifier_p is evaluated as a pointer of type *uid_t. If the tag type of the given ACL entry is ACL_GROUP then tag_qualifier_p is evaluated as a pointer of type *gid_t. Any other ACL tag types results in an error.
Upon successful completion, the acl_set_qualifier() function returns a value of 0 (zero). Otherwise, a value of -1 is returned and errno is set to indicate the error.
If any of the following conditions occur, the acl_set_qualifier() function sets errno to the corresponding value:
Argument entry_d does not refer to a valid ACL entry.
The value of the tag type in ACL entry referred to by entry_d is ACL_USER_OBJ, ACL_GROUP_OBJ, or ACL_OTHER_OBJ.
The value of the entry in tag_qualifier_p is not valid. There is not enough memory available to allocate the ACL uid/gid storage.
Security delim off