Content-type: text/html Man page of acl_set_qualifier

acl_set_qualifier

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

NAME

acl_set_qualifier - Sets the uid or gid on an ACL entry  

LIBRARY

Security Library (libpacl.a)  

SYNOPSIS

#include <sys/acl.h>

int acl_set_qualifier(        acl_entry_t entry_d;
       void *tag_qualifier_p);
 

PARAMETERS

Designates the working storage internal representation ACL entry to set the tag qualifier in. Designates the uid or gid to set the tag qualifier to.  

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.

Given an ACL entry, the acl_set_qualifier() function sets the id in the ACL entry. If the tag type of the given ACL entry is ACL_USER then tag_qualifier_p is evaluated as a pointer of type *uid_t. If the tag type of the given ACL entry is ACL_GROUP then tag_qualifier_p is evaluated as a pointer of type *gid_t. Any other ACL tag types results in an error.  

RETURN VALUES

Upon successful completion, the acl_set_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_set_qualifier() function sets errno to the corresponding value:

Argument entry_d does not refer to a valid ACL entry.

The value of the tag type in ACL entry referred to by entry_d is ACL_USER_OBJ, ACL_GROUP_OBJ, or ACL_OTHER_OBJ.

The value of the entry in tag_qualifier_p is not valid. There is not enough memory available to allocate the ACL uid/gid storage.  

RELATED INFORMATION

acl_free_qualifier(3), acl_get_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:41:57 GMT, October 02, 2010