Name

ldtbread − read an indexed symbol table entry of a common object file

Syntax

#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 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(,), ldgetaux(,), and ldtbread proceed normally given those indices.  Only the sym part of externals is returned.

Note that the first symbol in the symbol table has an index of zero.

See Also

ldclose(3x), ldgetname(3x), ldopen(3x), ldtbseek(3x), ldgetname(3x), ldfcn(5)