Manual Page Result
0
Command: acl_add_perm | Section: 3 | Source: Digital UNIX | File: acl_add_perm.3.gz
acl_add_perm(3) Library Functions Manual acl_add_perm(3)
NAME
acl_add_perm - Adds a permission to a set of permissions belonging to
an ACL entry
LIBRARY
Security Library (libpacl.a)
SYNOPSIS
#include <sys/acl.h>
int acl_add_perm( acl_permset_t permset_d acl_perm_t perm_d);
PARAMETERS
Specifies the permission set of the working storage internal represen-
tation of an ACL entry. Specifies the permission to be added to the
permission set (a combination of ACL_EXECUTE, ACL_WRITE, and ACL_READ).
DESCRIPTION
NOTE: This function is based on Draft 13 of the POSIX P1003.6 stan-
dard. The function may change as the P1003.6 standard is finalized.
The acl_add_perm() function adds the permission specified by perm_dcon-
tained in the perms parameter to the permission set referred to by the
permset_d parameter. Any permissions not designated in the perm_d pa-
rameter are left unchanged in the ACL entry. An attempt to add a per-
mission already in the permission set is not treated as an error.
RETURN VALUES
Upon successful completion, the acl_add_perm() function returns a value
of 0 (zero). Otherwise a value of -1 is returned, and errno is set.
ERRORS
If any of the following conditions occur, the acl_add_perm() function
sets errno to the corresponding value: The perm_d parameter does not
refer to a valid ACL entry.
The permset_d parameter does not contain valid file permission bits.
SH RELATED INFORMATION
acl_clear_perm(3),acl_delete_perm(3), acl_get_permset(3),
acl_set_permset(3),acl_get_entry(3)
Security delim off
acl_add_perm(3)