NAME    [Toc]    [Back]

       acl_free_qualifier  -  Frees the storage for the qualifier
       for an ACL entry

SYNOPSIS    [Toc]    [Back]

       #include <sys/acl.h>

       int acl_free_qualifier(
               void *tag_qualifier_p,
               acl_tag_t tag_type_d );

LIBRARY    [Toc]    [Back]

       Security Library (libpacl.a)

PARAMETERS    [Toc]    [Back]

       Pointer to the  working  storage  internal  representation
       storage  for a qualifier that is being freed.  The type of
       the space being freed.

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       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 ALSO    [Toc]    [Back]

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

       Security



                                            acl_free_qualifier(3)