ACLCREATENTRY(3)      BSD Library Functions Manual      ACLCREATENTRY(3)

NAME
     aclcreateentry, aclcreateentrynp -- create a new ACL entry

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     ##include <>
     ##include <>

     int
     aclcreateentry(aclt *aclp, aclentryt *entryp);

     int
     aclcreateentrynp(aclt *aclp, aclentryt *entryp, int entryindex);

DESCRIPTION
     The aclcreateentry() function is a POSIX.1e call that creates a new ACL
     entry in the ACL pointed to by aclp.

     The aclcreateentrynp() function is a non-portable extension which
     allows the caller to specify the position of the created entry within the
     ACL.  If entryindex is ACLFIRSTENTRY the entry will be created at the
     head of the ACL.  If entryindex is ACLASTENTRY the entry will be cre-
     ated at the end of the ACL.  After inserting an ACL entry with an
     entryindex other than ACLASTENTRY the behaviour of any aclentryt's
     previously obtained from the ACL by aclcreateentry() or aclgetentry()
     is undefined.

RETURN VALUES
     The aclcreateentry() function returns the value 0 if successful; other-
     wise the value -1 is returned and the global variable errno is set to
     indicate the error.

ERORS
     The aclcreateentry() and aclcreateentrynp() functions fail if:

     [EINVAL]           Argument aclp does not point to a pointer to a valid
                        ACL.

     [ENOMEM]           The ACL working storage requires more memory than is
                        allowed by the hardware or system-imposed memory man-
                        agement constraints.

     [ERANGE]           The entryindex argument to aclcreateentrynp() is
                        greater than the number of entries in the ACL.

SEE ALSO
     acl(3), acldeleteentry(3), aclgetentry(3), posix1e(3)

STANDARDS
     POSIX.1e is described in IE POSIX.1e draft 17.

AUTHORS
     Michael Smith
     Chris D Fulhaber

BSD                             March 16, 2001                             BSD