ldtbread(3X)

NAME
     ldtbread - Reads 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;

IMPLEMENTATION
     IRIX systems (o32 ABI only)

DESCRIPTION
     ldtbread 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.

     ldtbread 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 symnum zero to
     SYMHEADER(ldptr).isymMax+SYMHEADER(ldptr).iextMax. The index and iss
     fields of the SYMR are made absolute (rather than file relative) so
     that routines ldgetname(3X), ldgetaux(3X), and ldtbread (this routine)
     proceed normally given those indices.  Only the sym part of externals
     is returned.

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

     The program must allocate space big enough for a SYMR and point the
     pSYMR argument at the space before calling ldtbread.

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

     intro(5) describes INCDIR and LIBDIR.

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

     intro(4), ldfcn(4)

     This man page is available only online.