osf1 man page for acl_free_qualifier

acl_free_qualifier(3)					     Library Functions Manual					     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
       Pointer to the working storage internal representation storage for a qualifier that is being freed.  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:

       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 delim off

															     acl_free_qualifier(3)