Mac Developer Library Developer
Search

 

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_GET_ENTRY(3)         BSD Library Functions Manual         ACL_GET_ENTRY(3)

NAME
     acl_get_entry -- retrieve an ACL entry from an ACL

LIBRARY
     Standard C Library (libc, -lc)

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

     int
     acl_get_entry(acl_t acl, int entry_id, acl_entry_t *entry_p);

DESCRIPTION
     The acl_get_entry() function is a POSIX.1e call that retrieves a descriptor for an ACL entry specified
     by the argument entry_d within the ACL indicated by the argument acl.

     If the value of entry_id is ACL_FIRST_ENTRY, then the function will return in entry_p a descriptor for
     the first ACL entry within acl.  If a call is made to acl_get_entry() with entry_id set to
     ACL_NEXT_ENTRY when there has not been either an initial successful call to acl_get_entry(), or a pre-vious previous
     vious successfull call to acl_create_entry(), acl_delete_entry(), acl_dup(), acl_from_text(),
     acl_get_fd(), acl_get_file(), acl_set_fd(), acl_set_file(), or acl_valid(), then the result is unspeci-fied. unspecified.
     fied.

     The caller may also set entry_id to the index of the desired entry within the ACL.  This is a non-por-table non-portable
     table extension.  A subsequent call with entry_id set to ACL_NEXT_ENTRY will return the entry following
     the previously nominated entry and so forth.

RETURN VALUES
     If the acl_get_entry() function successfully obtains an ACL entry, a value of 0 is returned.  Other-wise, Otherwise,
     wise, a value of -1 will be returned and the global variable errno will be set to indicate the error.

ERRORS
     The acl_get_entry() fails if:

     [EINVAL]           Argument acl does not point to a valid ACL.  Argument entry_id is neither
                        ACL_FIRST_ENTRY, ACL_NEXT_ENTRY or a valid entry index.

     [EINVAL]           The value of entry_id is ACL_NEXT_ENTRY and the last ACL entry in the ACL has
                        already been returned by a previous call to acl_get_entry().

SEE ALSO
     acl(3), acl_calc_mask(3), acl_create_entry(3), acl_delete_entry(3), acl_dup(3), acl_from_text(3),
     acl_get_fd(3), acl_get_file(3), acl_init(3), acl_set_fd(3), acl_set_file(3), acl_valid(3), posix1e(3)

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

AUTHORS
     Michael Smith
     Chris D. Faulhaber

BSD                             April 13, 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.

Feedback