acl_free_qualifier(3)acl_free_qualifier(3)NAMEacl_free_qualifier - Frees the storage for the qualifier for an ACL
entry
SYNOPSIS
#include <sys/acl.h>
int acl_free_qualifier(
void *tag_qualifier_p,
acl_tag_t tag_type_d );
LIBRARY
Security Library (libpacl.a)
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 stan‐
dard.
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.
SEE ALSOacl_get_qualifier(3), acl_get_tag_type(3), acl_set_qualifier(3)
Security
acl_free_qualifier(3)