Index for Section 3

Alphabetical listing for A

Bottom of page

acl_add_perm(3)
NAME
  acl_add_perm - Adds a permission to a set of permissions belonging to an
  ACL entry

SYNOPSIS
  #include <sys/acl.h>

  int acl_add_perm(
	  acl_permset_t permset_d,
	  acl_perm_t perm_d );

LIBRARY
  Security Library (libpacl.a)

PARAMETERS
  permset_d
      Specifies the permissions 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 acl_add_perm() function adds the permission specified by perm_d 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 contain a valid acl_perm_t value.

      The permset_d parameter does not contain valid file permission bits.

SEE ALSO
  acl_clear_perm(3), acl_delete_perm(3), acl_get_permset(3),
  acl_set_permset(3), acl_get_entry(3)

  Security

Index for Section 3

Alphabetical listing for A

Top of page