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 |
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 entry_d argument isn't a valid descriptor for an ACL entry, the value of the tag type in the entry isn't ACL_USER or ACL_GROUP, or the value pointed to by tag_qualifier_p isn't valid.
- 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 |
| Interrupt handler | No |
| Signal handler | No |
| Thread | Yes |