ldtbindex(S)                   6 January 1993                   ldtbindex(S)


 Name

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

 Syntax


    cc  . . .  -lld


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

    long ldtbindex (ldptr)
    LDFILE *ldptr;


 Description

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

    The index returned by ldtbindex may be used in subsequent calls to
    ldtbread(S).  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 returns the index of the next entry.

    The ldtbindex function fails 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.

 See also

    ldfcn(FP), ldtbread(S), ldtbseek(S)

 Standards conformance

    ldtbindex is not part of any currently supported standard; it is an
    extension of AT&T System V provided by the Santa Cruz Operation.