Index Index for Section 3
Index Alphabetical listing for A 

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