Click this button to go to the index for this section.

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
  permset_d Specifies the permission set of the working storage internal
	    representation of an ACL entry.

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

  The acl_add_perm() function adds the permission specified by
  perm_dcontained in the perms parameter to the permission set referred to by
  the permset_d parameter.  Any permissions not designated in the perm_d
  parameter are left unchanged in the ACL entry.  An attempt to add a
  permission 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:

  [EINVAL]		   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