NAME

acl_get_permset − Retrieves a pointer to the permissions for a given ACL entry

SYNOPSIS

#include <sys/acl.h>
int acl_get_permset(
        acl_entry_t entry_d,
        acl_permset_t ∗permset_p );

LIBRARY

Security Library (libpacl.a)

PARAMETERS

entry_d
Specifies the descriptor of a working storage internal representation ACL entry.

permset_p
Points to the location where the file permissions are to be stored.

DESCRIPTION

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

The acl_get_permset() function sets the permset_p parameter to point to the permission set of the designated entry. The permset_p parameter is a pointer to the permission set value which is a combination of ACL_EXECUTE, ACL_WRITE, and ACL_READ. 

RETURN VALUES

Upon successful completion, the acl_get_permset() function returns a value of 0 (zero).  Otherwise, a value of -1 is returned, and errno is set to indicate the error. 

ERRORS

If the following condition occurs, the acl_get_permset() function sets errno to the corresponding value:

[EINVAL]
The entry_d parameter does not refer to a valid ACL entry. 

SEE ALSO

acl_add_perm(3), acl_delete_perm(3), acl_set_permset(3), acl_clear_perm(3), acl_get_entry(3)

Security