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

  man pages->Tru64 Unix man pages -> acl_get_entry (3)              



NAME    [Toc]    [Back]

       acl_get_entry - Returns a descriptor to an ACL entry

SYNOPSIS    [Toc]    [Back]

       #include <sys/acl.h>

       acl_entry_t acl_get_entry(
               acl_t acl_d );

LIBRARY    [Toc]    [Back]

       Security Library (libpacl.a)

PARAMETERS    [Toc]    [Back]

       Specifies  the working storage internal representation ACL

DESCRIPTION    [Toc]    [Back]

       NOTE:  This function is based on Draft  13  of  the  POSIX
       P1003.6 standard.

       The acl_get_entry() function returns a pointer to the next
       entry in the specified ACL.

       Following a  call  to  the  acl_get_fd(),  acl_get_file(),
       acl_from_text(),  or acl_first_entry() function, the first
       call to the acl_get_entry()  function  obtains  the  first
       entry  in  the  ACL.  Subsequent  calls  obtain successive
       entries in the ACL, until  the  last  entry  is  obtained.
       After the last entry has been obtained, the value 0 (zero)
       is returned.

RETURN VALUES    [Toc]    [Back]

       Upon successful completion, the  acl_get_entry()  function
       returns a pointer to the ACL entry descriptor. If the last
       ACL has already been returned by a previous call  to  this
       function,  or  the  ACL  has  no ACL entries, the function
       returns a value of 0 (zero).  Otherwise, a value  of  NULL
       is returned and errno is set to indicate the error.

ERRORS    [Toc]    [Back]

       The  acl_d  parameter does not refer to a valid ACL structure.
  The position of the ACL entry must be  reset  using
       the acl_first_entry() library routine.

SEE ALSO    [Toc]    [Back]

       acl_init(3),    acl_copy_entry(3),    acl_delete_entry(3),
       acl_get_file(3), acl_get_fd(3), acl_first_entry(3)


[ Back ]
 Similar pages
Name OS Title
DXmSvnGetEntryNumber Tru64 Retrieves (returns) an entry number for a specified entry tag value.
pxffileno IRIX Returns the file descriptor for a specified unit
maplun IRIX returns the integer file descriptor for a Fortran logical unit number
DXmSvnGetEntryTag Tru64 Retrieves (returns) an entry's tag for a specified entry number.
DXmSvnGetEntryLevel Tru64 Retrieves (returns) the level of an entry in the display.
DXmSvnGetEntrySensitivity Tru64 Retrieves (returns) the sensitivity of an entry in the display.
DXmSvnGetEntryPosition Tru64 Retrieves (returns) the position of an entry in the display.
DXmSvnGetSelections Tru64 Retrieves (returns) a list of selected entry numbers.
DXmSvnGetDisplayed Tru64 Retrieves (returns) displayed entry numbers and related information necessary to draw a correspondin...
endfsent OpenBSD get file system descriptor file entry
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service