Digital

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 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(ld-ptr).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 "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 routine library libmld.a.

RELATED INFORMATION

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