acl_create_entry()
QNX SDP8.0C Library ReferenceAPIDeveloper
Create an entry in an access control list
Synopsis:
#include <sys/acl.h>
int acl_create_entry( acl_t *acl_p,
acl_entry_t *entry_p );
Arguments:
- acl_p
- The address of a pointer to the ACL that you want to add an entry to. If acl_create_entry() needs to reallocate the entry, it updates this argument.
- entry_p
- A pointer to a location where the function can store a pointer to the new entry.
Library:
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
Description:
The acl_create_entry() function creates a new entry in an access control list. The new entry is initialized as follows:
- The tag type is set to ACL_UNDEFINED_TAG.
- The qualifier is set to ACL_UNDEFINED_ID.
- No permissions are enabled.
The ACL entry's pointer returned by acl_create_entry() becomes invalid after calling these functions:
- acl_valid()
- acl_create_entry()
- acl_calc_mask()
- acl_delete_entry()
- acl_set_file()
- acl_set_fd()
Returns:
0, or -1 if an error occurred (errno is set).
Errors:
- ENOMEM
- There wasn't enough memory to allocate the new entry.
Classification:
This function is based on the withdrawn POSIX draft P1003.1e.
| Safety: | |
|---|---|
| Cancellation point | No |
| Signal handler | No |
| Thread | Yes |
Page updated: