ldgetaux(3X)

NAME
     ldgetaux - Retrieves an auxiliary entry, given an index

SYNOPSIS
     #include <stdio.h>
     #include <filehdr.h>
     #include <sym.h>
     #include <ldfcn.h>

     pAUXU ldgetaux(LDFILE * ldptr, int iaux

DESCRIPTION
     This routine is available for o32 ABI only.

     ldgetaux returns a pointer to an auxiliary table entry associated with
     iaux.  The AUXU is contained in a static buffer.  Because the buffer
     can be overwritten by later calls to ldgetaux, it must be copied by
     the caller if the aux is to be saved or changed.

     Note that auxiliary entries are not swapped because this routine
     cannot detect what manifestation of the AUXU union is retrieved.  If
     LDAUXSWAP(ldptr, ldf) is non-zero, another call to swap_aux is
     required.  Before calling the swap_aux routine, the caller should copy
     the aux.

     If the auxiliary cannot be retrieved, ldgetaux returns NULL (defined
     in <stdio.h>) for an object file.  This occurs when:

     * The auxiliary table cannot be found.

     * The iaux offset into the auxiliary table is beyond the end of the
       table.

     Typically, ldgetaux is called immediately after a successful call to
     ldtbread to retrieve the data type information associated with the
     symbol table entry filled by ldtbread.  The index field of the symbol,
     pSYMR, is the iaux when data type information is required.  If the
     data type information for a symbol is not present, the index field is
     indexNil and ldgetaux should not be called.

     The program must be loaded with the object file access routine library
     libmld.a.

SEE ALSO
     ldclose(3X), ldopen(3X), ldtbread(3X) ldtbseek(3X),

     ldfcn(4)