acl_create_entry()

Updated: April 19, 2023

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 ACL entry's pointer returned by acl_create_entry() becomes invalid after calling these functions:

Returns:

0, or -1 if an error occurred (errno is set).

Errors:

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