NAME

acl_set_qualifier − Sets the tag qualifier (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

entry_dDesignates the working storage internal representation ACL entry to set the tag qualifier in. 

tag_qualifier_p
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. 

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

[EINVAL]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.

[ENOMEM]There is not enough memory available  to allocate the ACL uid/gid storage. 

RELATED INFORMATION

acl_free_qualifier(3), acl_get_qualifier(3)

Security