Index for Section 3

Alphabetical listing for A

Bottom of page

acl_create_entry(3)
NAME
  acl_create_entry - Create a new ACL entry

LIBRARY
  Security Library (libpacl.a)

SYNOPSIS
  #include <sys/acl.h>
  acl_entry_t acl_create_entry(
	  acl_t *acl_p);

PARAMETERS
  acl_p	    Points to the working storage internal representation ACL to
	    create the new entry in.

DESCRIPTION
  NOTE:	 This function is based on Draft 13 of the POSIX P1003.6 standard.

  The acl_create_entry() function creates a new ACL entry in the ACL pointed
  to by the acl_p argument.  If there is insufficient space in the ACL for
  creating a new entry, then additional memory is allocated.

  The components of the new ACL entry are initialized as follows:

       The ACL tag type component does not contain a possible ACL tag type

       The tag qualifier component does not refer to any possible user ID or
       group ID

       The set of permissions does not have any permissions specified.

RETURN VALUES
  Upon successful completion, the acl_create_entry() function returns the
  descriptor for the new entry.	 Otherwise, a value of NULL is returned, and
  errno is set to indicate the error.

ERRORS
  If any of the following conditions occur, the acl_create_entry() function
  sets errno to the corresponding value:

  [EINVAL]		   The acl_p argument does not refer to a valid ACL.

  [ENOMEM]		   The new ACL entry requires more memory than the
			   system is able to provide.


RELATED INFORMATION
  acl_delete_entry(3)

  Security

Index for Section 3

Alphabetical listing for A

Top of page