Create an entry in an access control list
#include <sys/acl.h> int acl_create_entry( acl_t *acl_p, acl_entry_t *entry_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.
- A pointer to a location where the function can store a pointer to the new entry.
Use the -l c option to qcc to link against this library. This library is usually included automatically.
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.
0, or -1 if an error occurred (errno is set).
- The acl_p argument doesn't point to a valid ACL.
- There wasn't enough memory to allocate the new entry.
This function is based on the withdrawn POSIX draft P1003.1e.