Index Index for
Section 3
Index Alphabetical
listing for A
Bottom of page Bottom of
page

acl_create_entry(3)

NAME

acl_create_entry - Create a new ACL entry

SYNOPSIS

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

LIBRARY

Security Library (libpacl.a)

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.

SEE ALSO

acl_delete_entry(3) Security

Index Index for
Section 3
Index Alphabetical
listing for A
Top of page Top of
page