LDGETAUX(3X)                                         LDGETAUX(3X)



     NAME
          ldgetaux - retrieve an auxiliary entry, given an index

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

          pAUXU ldgetaux (ldptr, iaux)
          LDFILE ldptr;
          long iaux;

     DESCRIPTION
          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 as this routine
          cannot detect what manifestation of the AUXU union is
          retrieved. If LDAUXSWAP(ldptr, ldf) is non-zero, a further
          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), ldtbseek(3X), ldtbread(3X),
          ldfcn(4).




     Page 1                                        (last mod. 8/20/87)

     LDGETAUX(3X)                                         LDGETAUX(3X)



     ORIGIN
          MIPS Computer Systems





















































     Page 2                                        (last mod. 8/20/87)