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)
