ldtbindex(3X)                                       ldtbindex(3X)



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

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

          long ldtbindex (ldptr)
          LDFILE *ldptr;

     DESCRIPTION
          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 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 returns the the index of the next entry.

          ldtbindex 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.

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

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

















     Page 1                                        (last mod. 1/14/87)