ldgetaux(3x) [ultrix man page]

ldgetaux(3x)															      ldgetaux(3x)

Name
       ldgetaux - retrieve an auxiliary entry, given an index

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

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

Description
       The  function  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 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, returns null (defined in <stdio.h>) for an object file.  This occurs in the following instances:

       o    The auxiliary table cannot be found

       o    The iaux offset into the auxiliary table is beyond the end of the table

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

See Also
       intro(3x), ldclose(3x), ldopen(3x), ldtbseek(3x), ldtbread(3x), ldfcn(5).

								       RISC							      ldgetaux(3x)

Check Out this Related Man Page

ldtbread(3)						     Library Functions Manual						       ldtbread(3)

NAME

       ldtbread - Read an indexed symbol table entry of a common object file

SYNOPSIS

       #include <stdio.h> #include <filehdr.h> #include <syms.h> #include <ldfcn.h>

       int ldtbread (ldptr, symindex, symbol) LDFILE *ldptr ; long symindex ; pSYMR *symbol ;

DESCRIPTION

       The  ldtbread routine reads the symbol table entry specified by symindex of the common object file currently associated with ldptr into the
       area of memory beginning at symbol.

       It returns SUCCESS or FAILURE.  If symindex is greater than the number of symbols in the object file or if it  cannot  read  the  specified
       symbol table entry, ldtbread fails.

       The  local  and	external  symbols  are	concatenated  into  a  linear  list.   Symbols	are  accessible  from  symbol  index  zero to SYM-
       HEADER(ldptr).isymMax + SYMHEADER(ldptr).iextMax.  The index and iss fields of the SYMR are made absolute (rather than  file  relative)	so
       that  the routines ldgetname(3), ldgetaux(3), and ldtbread proceed normally given those indices.  Only the SYMR part of the external symbol
       structure is returned.

       NOTE: The first symbol in the symbol table has an index of zero.

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

RELATED INFORMATION

       ldclose(3), ldgetname(3), ldopen(3), ldtbseek(3), ldgetname(3), ldfcn(4).  delim off

																       ldtbread(3)

Linux and UNIX Man Pages

ldgetaux(3x) [ultrix man page]

Check Out this Related Man Page