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)