Name

ldtbindex − compute the index of a symbol table entry of a common object file

Syntax

#include <stdio.h>
#include <filehdr.h>
#include <syms.h>
#include <ldfcn.h>

long ldtbindex (ldptr)
LDFILE ∗ldptr;

Description

The ldtbindex returns the (long) index of the symbol table entry at the current position of the common object file associated with ldptr.

The index returned by ldtbindex can be used in later calls to ldtbread(.). ldtbindex returns the index of the symbol table entry that begins at the current position of the object file; therefore, if ldtbindex is called immediately after a particular symbol table entry has been read, it returns the the index of the next entry.

If there are no symbols in the object file or if the object file is not positioned at the beginning of a symbol table entry, ldtbindex fails and returns BADINDEX (−1).

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

See Also

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