NAME

acl_get_permset − Retrieves the permissions for a given ACL entry

LIBRARY

Security Library (libpacl.a)

SYNOPSIS

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

PARAMETERS

entry_dSpecifies the descriptor of a working storage internal representation ACL entry. 

permset_pPoints 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 function may change as the P1003.6 standard is finalized. 

The acl_get_permset() function retrieves the permissions from the designated entry. The permissions are stored in the location designated by the permset_p parameter.  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. 

RELATED INFORMATION

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

Security