ldtbread(3X)            LIBRARY FUNCTIONS            ldtbread(3X)



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
     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 can-
     not 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.

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

     The program must be loaded with the object file access  rou-
     tine library libmld.a.

SEE ALSO
     ldclose(3X),   ldgetname(3X),   ldopen(3X),    ldtbseek(3X),
     ldgetname(3X), ldfcn(4).













                                                                1