acl_add_perm(3) BSD Library Functions Manual acl_add_perm(3)
NAME
acl_add_perm -- add permissions to a permission set
LIBRARY
Standard C Library (libc, -lc)
SYNOPSIS
#include <sys/types.h>
#include <sys/acl.h>
int
acl_add_perm(acl_permset_t permset_d, acl_perm_t perm);
DESCRIPTION
The acl_add_perm() function is a POSIX.1e call that adds the permission
contained in perm to the permission set permset_d.
Note: it is not considered an error to attempt to add permissions that
already exist in the permission set.
RETURN VALUES
The acl_add_perm() function returns the value 0 if successful; otherwise
the value -1 is returned and the global variable errno is set to indicate
the error.
ERRORS
The acl_add_perm() function fails if:
[EINVAL] Argument permset_d is not a valid descriptor for a
permission set within an ACL entry. Argument perm
does not contain a valid acl_perm_t value.
SEE ALSO
acl(3), acl_clear_perms(3), acl_delete_perm(3), acl_get_permset(3),
acl_set_permset(3), posix1e(3)
STANDARDS
POSIX.1e is described in IEEE POSIX.1e draft 17.
AUTHORS
Michael Smith
Chris D Fulhaber
BSD March 10, 2001 BSD
Mac OS X 10.8 - Generated Sun Aug 26 09:07:59 CDT 2012