Index for Section 3

Alphabetical listing for A

Bottom of page

acl_free_qualifier(3)
NAME
  acl_free_qualifier - Frees the storage for the qualifier for an ACL entry

LIBRARY
  Security Library (libpacl.a)

SYNOPSIS
  #include <sys/acl.h>
  int acl_free_qualifier(
	  void *tag_qualifier_p);
	  acl_tag_t tag_type_d);

PARAMETERS
  tag_qualifier_p
	    Pointer to the working storage internal representation storage
	    for a qualifier that is being freed.

  tag_type_d
	    The type of the space being freed.

DESCRIPTION
  NOTE:	 This function is based on Draft 13 of the POSIX P1003.6 standard.

  The acl_free_qualifier() function releases the storage space pointed to by
  the argument tag_qualifier_p.	 The type of this space is defined by
  tag_type_d and can be of type ACL_USER, ACL_GROUP, ACL_USER_OBJ,
  ACL_GROUP_OBJ or ACL_OTHER_OBJ.  If it is of type ACL_USER_OBJ,
  ACL_GROUP_OBJ or ACL_OTHER_OBJ, the tag_qualifier_p parameter must be NULL.

RETURN VALUES
  Upon successful completion, the acl_free_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_free_qualifier() function
  sets errno to the corresponding value:

  [EINVAL]	 The value of argument tag_type_d is not ACL_USER, ACL_GROUP,
		 ACL_USER_OBJ, ACL_GROUP_OBJ or ACL_OTHER_OBJ

		 The value of argument tag_type_d is  ACL_USER_OBJ,
		 ACL_GROUP_OBJ or ACL_OTHER_OBJ	 and the value of
		 tag_qualifier_p is not NULL.


RELATED INFORMATION
  acl_get_qualifier(3), acl_get_tag_type(3), acl_set_qualifier(3)

  Security

Index for Section 3

Alphabetical listing for A

Top of page