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 doesn't point 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

Last modified: 2013-12-23

comments powered by Disqus