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_dThe type of the space being freed. 

DESCRIPTION

NOTE:  This function is based on Draft 13 of the POSIX P1003.6 standard. The function may change as the P1003.6 standard is finalized. 

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 or ACL_GROUP.  If it is of type ACL_USER_OBJ, ACL_GROUP_OBJ or ACL_OTHER_OBJ and tag_qualifier_p is NULL a success is returned, otherwise an error is returned. 

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