acl_get_qualifier()

Get the qualifier from an ACL entry

Synopsis:

#include <sys/acl.h>

void *acl_get_qualifier( acl_entry_t entry_d );

Arguments:

entry_d: The entry that you want to get the qualifier from.

Library:

libc

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

Description:

The acl_get_qualifier() function gets the qualifier from an ACL entry and returns a pointer to a copy of it. The data type of the pointer depends on the type of the entry:

Entry type	Pointer type
ACL_USER	uid_t *
ACL_GROUP	gid_t *
Other types	(void *)NULL, and the function fails

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

When you're finished with the copy of the qualifier, use acl_free() to release it.

Returns:

A pointer to a copy of the qualifier, or NULL if an error occurred (errno is set).

Errors:

EINVAL: The entry_d argument isn't a valid descriptor for an ACL entry, or 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