Content-type: text/html Man page of acl_add_perm

acl_add_perm

Section: C Library Functions (3)
Index Return to Main Contents
 

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 representation 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 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: 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


 

Index

NAME
LIBRARY
SYNOPSIS
PARAMETERS
DESCRIPTION
RETURN VALUES
ERRORS

This document was created by man2html, using the manual pages.
Time: 02:41:31 GMT, October 02, 2010