Index Click this button to go to the index for this section.


acl_get_qualifier(3)

NAME

acl_get_qualifier - Retrieves the qualifier for an ACL entry

LIBRARY

Security Library (libpacl.a)

SYNOPSIS

#include <sys/acl.h> void * acl_get_qualifier( acl_entry_t entry_d);

PARAMETERS

entry_d Designates the working storage internal representation ACL entry to retrieve the qualifier from.

DESCRIPTION

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. The acl_get_qualifier() function retrieves qualifier which is the numerical id associated with the entry. If the entry tag type is ACL_USER *uid_t is returned, if the type is ACL_GROUP a *gid_t is returned, for all other types NULL is returned.

RETURN VALUES

Upon successful completion, the acl_get_qualifier function returns a pointer to the ACL entry qualifier retrieved. 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: [EINVAL] 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