acl_get_qualifier(3) Library Functions Manual acl_get_qualifier(3)
NAME
acl_get_qualifier - Retrieves the tag qualifier (ID) for an ACL entry
LIBRARY
Security Library (libpacl.a)
SYNOPSIS
#include <sys/acl.h>
void * acl_get_qualifier( acl_entry_t entry_d);
PARAMETERS
Designates the working storage internal representation ACL entry to retrieve the tag qualifier from.
DESCRIPTION
NOTE: This function is based on Draft 13 of the POSIX P1003.6 standard.
The acl_get_qualifier() function retrieves ACL entry tag qualifier, which is the user or group ID associated with the entry. If the entry
tag type is ACL_USER, a *uid_t is returned. If the tag type is ACL_GROUP, a *gid_t is returned. For all other tag types, NULL is
returned.
RETURN VALUES
Upon successful completion, the acl_get_qualifier() function returns a pointer to the ACL entry tag qualifier. Otherwise, a value of NULL
is returned and errno is set to indicate the error.
ERRORS
If any of the following conditions occur, the acl_get_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.
RELATED INFORMATION
acl_create_entry(3), acl_free_qualifier(3), acl_get_entry(3), acl_get_tag_type(3), acl_set_qualifier(3), acl_set_tag_type(3)
Security delim off
acl_get_qualifier(3)