ACLGETQUALIFIER(3) BSD Library Functions Manual ACLGETQUALIFIER(3)

NAME
     aaccllggeettqquuaalliiffiieerr - retrieve the qualifier from an ACL entry

LLIIBBRRAARRYY
     Standard C Library (libc, -lc)

SYNOPSIS
     ##iinncclluuddee <>
     ##iinncclluuddee <>

     void *
     aaccllggeettqquuaalliiffiieerr(aclentryt entryd);

DESCRIPTION
     The aaccllggeettqquuaalliiffiieerr() function is a POSIX.1e call that retrieves the
     qualifier of the tag for the ACL entry indicated by the argument entryd
     into working storage and returns a pointer to that storage.

     If the value of the tag type in the ACL entry referred to by entryd is
     ACLEXTENDEDALLOW or ACLEXTENDEDDENY The value returned by
     aaccllggeettqquuaalliiffiieerr() will be a pointer to type guidt.

     If the value of the tag type in the ACL entry referred to by entryd is
     ACLUNDEFINEDTAG, a tag type specified by POSIX.1e but not supported or
     an implementation-defined value for which a qualifier is not supported,
     then aaccllggeettqquuaalliiffiieerr() will return a value of (void *)NULL and the
     function will fail.

     This function may cause memory to be allocated.  The caller should free
     any releasable memory, when the new qualifier is no longer required, by
     calling aaccllffrreeee() with void * as the argument.

RETURN VALUES
     The aaccllggeettqquuaalliiffiieerr() function returns a pointer to the allocated stor-
     age if successful; otherwise a NULL pointer is returned and the global
     variable errno is set to indicate the error.

EERRRROORRSS
     The aaccllggeettqquuaalliiffiieerr() fails if:

     [EINVAL]           Argument entryd does not point to a valid descriptor
                        for an ACL entry.  The value of the tag type in the
                        ACL entry referenced by argument entryd is not
                        ACLEXTENDEDALLOW or ACLEXTENDEDDENY.

     [ENOMEM]           The value to be returned requires more memory than is
                        allowed by the hardware or system-imposed memory man-
                        agement constraints.

SEE ALSO
     acl(3), aclcreateentry(3), aclfree(3), aclgetentry(3),
     aclgettagtype(3), aclsetqualifier(3), aclsettagtype(3),
     posix1e(3)

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

AUTHORS     Michael Smith
     Chris D. Faulhaber

BSD                             March 13, 2001                             BSD