*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->FreeBSD man pages -> acl_get_entry (3)              



NAME    [Toc]    [Back]

     acl_get_entry -- retrieve an ACL entry from an ACL

LIBRARY    [Toc]    [Back]

     Standard C Library (libc, -lc)

SYNOPSIS    [Toc]    [Back]

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

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

DESCRIPTION    [Toc]    [Back]

     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 previous 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 unspecified.

RETURN VALUES    [Toc]    [Back]

     If the acl_get_entry() function successfully obtains an ACL entry, a
     value of 1 is returned.  If the ACL has no ACL entries, the
     acl_get_entry() returns a value of 0.  If 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(), a value of 0 will be
     returned until a successful call with entry_id of ACL_FIRST_ENTRY is
     made.  Otherwise, a value of -1 will be returned and the global variable
     errno will be set to indicate the error.

ERRORS    [Toc]    [Back]

     The acl_get_entry() fails if:

     [EINVAL]		Argument acl does not point to a valid ACL.  Argument
			entry_id is neither ACL_FIRST_ENTRY nor

SEE ALSO    [Toc]    [Back]

     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    [Toc]    [Back]

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

HISTORY    [Toc]    [Back]

     POSIX.1e support was introduced in FreeBSD 4.0.  The acl_get_entry()
     function was added in FreeBSD 5.0.

AUTHORS    [Toc]    [Back]

     The acl_get_entry() function was written by Chris D. Faulhaber

FreeBSD 5.2.1			April 13, 2001			 FreeBSD 5.2.1
[ Back ]
 Similar pages
Name OS Title
acl_get_tag_type FreeBSD retrieve the tag type from an ACL entry
acl_get_qualifier FreeBSD retrieve the qualifier from an ACL entry
acl_get_permset FreeBSD retrieve permission set from an ACL entry
ldgetaux IRIX retrieve an auxiliary entry, given an index
ldgetname IRIX retrieve symbol name for object file symbol table entry
ldgetname Tru64 retrieve symbol name for object file symbol table entry
rpccp_add_member HP-UX Adds a member to a group in a name service entry; if the specified entry does not exist, creates the entry
rpccp_add_element HP-UX Adds an element to a profile in a name service entry; if the specified entry does not exist, creates the entry
DXmSvnFlushEntry Tru64 Displays the specified entry on the screen if it is the next logically displayed entry.
DXmSvnGetEntryNumber Tru64 Retrieves (returns) an entry number for a specified entry tag value.
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service