NAME

acl_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

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. 

SEE ALSO

acl_get_qualifier(3), acl_get_tag_type(3), acl_set_qualifier(3)

Security