Mac Developer Library Developer


This manual page is part of Xcode Tools version 5.0

To obtain these tools:

If you are running a version of Xcode Tools other than 5.0, view the documentation locally:

  • In Xcode

  • In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

  • To learn how the manual is organized or to learn about command syntax, read the manual page for manpages(5).

  • For more information about this technology, look for other documentation in the Apple Developer Library.

  • For general information about writing shell scripts, read Shell Scripting Primer.

ACL_CREATE_ENTRY(3)      BSD Library Functions Manual      ACL_CREATE_ENTRY(3)

     acl_create_entry, acl_create_entry_np -- create a new ACL entry

     Standard C Library (libc, -lc)

     #include <sys/types.h>
     #include <sys/acl.h>

     acl_create_entry(acl_t *acl_p, acl_entry_t *entry_p);

     acl_create_entry_np(acl_t *acl_p, acl_entry_t *entry_p, int entry_index);

     The acl_create_entry() function is a POSIX.1e call that creates a new ACL entry in the ACL pointed to
     by acl_p.  The function will return in entry_p a descriptor for this ACL entry.

     The acl_create_entry_np() function is a non-portable extension which allows the caller to specify the
     position of the created entry within the ACL.  If entry_index is ACL_FIRST_ENTRY the entry will be cre-ated created
     ated at the head of the ACL.  If entry_index is ACL_LAST_ENTRY the entry will be created at the end of
     the ACL.  After inserting an ACL entry with an entry_index other than ACL_LAST_ENTRY the behaviour of
     any acl_entry_t's previously obtained from the ACL by acl_create_entry() or acl_get_entry() is unde-fined. undefined.

     The acl_create_entry() function returns the value 0 if successful; otherwise the value -1 is returned
     and the global variable errno is set to indicate the error.

     The acl_create_entry() and acl_create_entry_np() functions fail if:

     [EINVAL]           Argument acl_p does not point to a pointer to a valid ACL.

     [ENOMEM]           The ACL working storage requires more memory than is allowed by the hardware or sys-tem-imposed system-imposed
                        tem-imposed memory management constraints.

     [ERANGE]           The entry_index argument to acl_create_entry_np() is greater than the number of
                        entries in the ACL.

     acl(3), acl_delete_entry(3), acl_get_entry(3), posix1e(3)

     POSIX.1e is described in IEEE POSIX.1e draft 17.

     Michael Smith
     Chris D Fulhaber

BSD                             March 16, 2001                             BSD

Reporting Problems

The way to report a problem with this manual page depends on the type of problem:

Content errors
Report errors in the content of this documentation with the feedback links below.
Bug reports
Report bugs in the functionality of the described tool or API through Bug Reporter.
Formatting problems
Report formatting mistakes in the online version of these pages with the feedback links below.