acl_set_qualifier(3) Library Functions Manual acl_set_qualifier(3)
NAME
acl_set_qualifier - Sets the tag qualifier (UID or GID) on an ACL entry
LIBRARY
Security Library (libpacl.a)
SYNOPSIS
#include <sys/acl.h>
int acl_set_qualifier( acl_entry_t entry_d; void *tag_qualifier_p);
PARAMETERS
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.
DESCRIPTION
NOTE: This function is based on Draft 13 of the POSIX P1003.6 standard.
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 type results in an error.
RETURN VALUES
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.
ERRORS
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.
RELATED INFORMATION
acl_free_qualifier(3), acl_get_qualifier(3)
Security delim off
acl_set_qualifier(3)