LDTBINDEX(3X)

NAME
ldtbindex - compute the index of a symbol table entry of a COFF file

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

long ldtbindex (ldptr)
LDFILE *ldptr;

AVAILABILITY

Available only on Sun 386i systems running a SunOS 4.0.x release or earlier. Not a SunOS 4.1 release feature.

DESCRIPTION

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

The index returned by ldtbindex() may be used in subsequent calls to ldtbread(3X). However, since ldtbindex () returns the index of the symbol table entry that begins at the current position of the object file, if ldtbindex() is called immediately after a particular symbol table entry has been read, it will return the index of the next entry.

ldtbindex() will fail 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.

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

The program must be loaded with the object file access routine library libld.a.

SEE ALSO
ldclose(3X), ldfcn(3), ldopen(3X), ldtbread(3X), ldtbseek(3X)