acl_get_entry (3) ( Linux man: Библиотечные вызовы )
BSD mandoc
NAME
acl_get_entry
- retrieve an ACL entry from an ACL
LIBRARY
Lb libc
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
Fa entry_d
within the ACL indicated by the argument
Fa acl .
If the value of
Fa entry_id
is
ACL_FIRST_ENTRY
then the function will return in
Fa entry_p
a descriptor for the first ACL entry within
Fa acl .
If a call is made to
acl_get_entry ();
with
Fa entry_id
set to
ACL_NEXT_ENTRY
when there has not been either an initial successful call to
acl_get_entry (,);
or a previous successful 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
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
Fa 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
Fa 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
The
acl_get_entry ();
fails if:
Bq Er EINVAL
Argument
Fa acl
does not point to a valid ACL.
Argument
Fa entry_id
is neither
ACL_FIRST_ENTRY
nor
ACL_NEXT_ENTRY
