acl_create_entry()
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.
Returns:
0, or -1 if an error occurred
(errno
is set).
Errors:
- EINVAL
- The acl_p argument isn't the address of a pointer to a valid ACL.
- ENOMEM
- There wasn't enough memory to allocate the new entry.
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 |