LDTBREAD(3X)        RISC/os Reference Manual         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(ld-ptr).iextMax.  The
     index and iss fields of the SYMR are made absolute (rather
     than file relative) so that the routines ldgetname(3X),
     ldgetaux(3X), and ldtbread 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).














                        Printed 11/19/92                   Page 1