NAME

acl_set_permset − Sets permissions in a given ACL entry

LIBRARY

Security Library (libpacl.a)

SYNOPSIS

#include <sys/acl.h> int acl_set_permset(
acl_entry_t entry_d;
acl_permset_t permset_d);

PARAMETERS

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

permsPoints to a working storage internal representation of file permission bits. 

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. 

Given a pointer to an ACL entry, the acl_set_permset() function sets the permissions. Any permissions in the ACL entry before the call to acl_set_permset() are replaced with the new set of permissions.

RETURN VALUES

Upon successful completion, the acl_set_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_set_permset() function sets errno to the corresponding value:

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

The permset_d parameter does not contain valid file permission bits. 

RELATED INFORMATION

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

Security