ldtbindex(3)                        CLIX                        ldtbindex(3)



  NAME

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

  LIBRARY

    COFF Object File Manipulation Library (libld.a)

  SYNOPSIS

    #include <stdio.h>

    #include <filehdr.h>

    #include <syms.h>

    #include <ldfcn.h>

    #include INCDIR/filehdr.h

    #include INCDIR/syms.h

    #include INCDIR/ldfcn.h

    long ldtbindex(
      LDFILE (ldptr );

  DESCRIPTION

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

    The index returned by the ldtbindex() function may be used in subsequent
    calls to the ldtbread() function.

    INCDIR is the standard directory list for #include files, usually
    /usr/include.  LIBDIR is the set of standard library files, usually /lib.

  CAUTIONS

    The ldtbindex() function 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 0.

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

  RETURN VALUES



  2/94 - Intergraph Corporation                                              1

  ldtbindex(3)                        CLIX                        ldtbindex(3)



    If the ldtbindex() function is called immediately after a particular
    symbol table entry has been read, it will return the index of the next
    entry since the ldtbindex() function returns the index of the symbol table
    entry that begins at the current position of the object file.

  RELATED INFORMATION

    Functions:  ldclose(3), ldopen(3), ldtbread(3), ldtbseek(3)

    Files:  intro(0), ldfcn(0)












































  2                                              Intergraph Corporation - 2/94