osf1 man page for acl_set_qualifier

acl_set_qualifier(3)					     Library Functions Manual					      acl_set_qualifier(3)

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

       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:

       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

															      acl_set_qualifier(3)