acl_get_qualifier()
QNX SDP8.0C Library ReferenceAPIDeveloper
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 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:
This function is based on the withdrawn POSIX draft P1003.1e.
| Safety: | |
|---|---|
| Cancellation point | No |
| Signal handler | No |
| Thread | Yes |
Page updated: