acl_get_entry()
Get an entry in an access control list (ACL)
Synopsis:
#include <sys/acl.h> int acl_get_entry( acl_t acl, int entry_id, acl_entry_t *entry_p );
Arguments:
- acl
- A point to the access control list that you want to get an entry from.
- entry_id
- The ID of the entry you want to get; one of the following:
- ACL_FIRST_ENTRY — get the first entry in the ACL.
- ACL_NEXT_ENTRY — get the next entry in the ACL.
- entry_p
- A pointer to a location where the function can store a pointer to the entry.
Library:
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
Description:
The acl_get_entry() function gets an entry from an access control list. Each ACL remembers which entry is the current one.
Returns:
- 1
- An entry was found.
- 0
- The ACL has no entries, or the last entry was returned by a previous call to acl_get_entry().
- -1
- An error occurred (errno is set).
Errors:
- EINVAL
- The acl argument doesn't point to a valid ACL, or entry_id isn't ACL_FIRST_ENTRY or ACL_NEXT_ENTRY.
Classification:
This function is based on the withdrawn POSIX draft P1003.1e.
| Safety: | |
|---|---|
| Cancellation point | No |
| Interrupt handler | No |
| Signal handler | No |
| Thread | Yes |