ACLCREATEENTRY(3) BSD Library Functions Manual ACLCREATEENTRY(3)

NAME
     aaccllccrreeaatteeeennttrryy, aaccllccrreeaatteeeennttrryynnpp - create a new ACL entry

LLIIBBRRAARRYY
     Standard C Library (libc, -lc)

SYNOPSIS
     ##iinncclluuddee <>
     ##iinncclluuddee <>

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

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

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

     The aaccllccrreeaatteeeennttrryynnpp() 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 ACLLASTENTRY the entry will be cre-
     ated at the end of the ACL.  After inserting an ACL entry with an
     entryindex other than ACLLASTENTRY the behaviour of any aclentryt's
     previously obtained from the ACL by aaccllccrreeaatteeeennttrryy() or aaccllggeetteennttrryy()
     is undefined.

RETURN VALUES
     The aaccllccrreeaatteeeennttrryy() 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.

EERRRROORRSS
     The aaccllccrreeaatteeeennttrryy() and aaccllccrreeaatteeeennttrryynnpp() 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 aaccllccrreeaatteeeennttrryynnpp() 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 IEEE POSIX.1e draft 17.

AUTHORS     Michael Smith
     Chris D Fulhaber

BSD                             March 16, 2001                             BSD