Index for Section 3

Alphabetical listing for A

Bottom of page

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
  entry_d   Designates the working storage internal representation ACL entry
	    to set the tag qualifier in.

  tag_qualifier_p
	    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:

  [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.

			   The value of the entry in tag_qualifier_p is not
			   valid.

  [ENOMEM]		   There is not enough memory available	 to allocate
			   the ACL uid/gid storage.



RELATED INFORMATION
  acl_free_qualifier(3), acl_get_qualifier(3)

  Security

Index for Section 3

Alphabetical listing for A

Top of page