acl_set_qualifier()

Set the qualifier for an ACL entry

Synopsis:

#include <sys/acl.h>

int acl_set_qualifier( acl_entry_t entry_d,
                       const void *tag_qualifier_p );

Arguments:

entry_d: The descriptor of the entry whose qualifier you want to set.
tag_qualifier_p: A pointer to the qualifier (see below).

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The acl_set_qualifier() function sets the qualifier in an ACL entry. The data type of the value refered to by the tag_qualifier_p argument depends on the entry type:

Entry type	Data type
ACL_USER	uid_t
ACL_GROUP	gid_t
Other types	Invalid; the function fails

Note: The uid_t and gid_t data types are defined in <sys/types.h>.

Returns:

0, or -1 if an error occurred (errno is set).

Errors:

EINVAL: The value of the tag type in the entry isn't ACL_USER or ACL_GROUP.
ENOMEM: There wasn't enough memory to create a copy of the qualifier.

Classification:

QNX Neutrino

This function is based on the withdrawn POSIX draft P1003.1e.

Safety:
Cancellation point	No
Interrupt handler	No
Signal handler	No
Thread	Yes