Content-type: text/html Man page of acl_free_qualifier

acl_free_qualifier

Section: C Library Functions (3)
Index Return to Main Contents
 

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 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:

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


 

Index

NAME
LIBRARY
SYNOPSIS
PARAMETERS
DESCRIPTION
RETURN VALUES
ERRORS
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:42:13 GMT, October 02, 2010