Museum

     LDLREAD(S)                UNIX System V                LDLREAD(S)



     Name
          ldlread, ldlinit, ldlitem - manipulate line number entries
          of a common object file function

     Syntax
          #include <stdio.h>
          #include <filehdr.h>
          #include <linenum.h>
          #include <ldfcn.h>


          int ldlread(ldptr, fcnindx, linenum, linent)
          LDFILE *ldptr;
          long fcnindx;
          unsigned short linenum;
          LINENO *linent;

          int ldlinit(ldptr, fcnindx)
          LDFILE *ldptr;
          long fcnindx;

          int ldlitem(ldptr, linenum, linent)
          LDFILE *ldptr;
          unsigned short linenum;
          LINENO *linent;

     Description
          The ldlread function searches the line number entries of the
          common object file currently associated with ldptr.  The
          ldlread function begins its search with the line number
          entry for the beginning of a function and confines its
          search to the line numbers associated with a single
          function.  The function is identified by fcnindx, the index
          of its entry in the object file symbol table.  The ldlread
          function reads the entry with the smallest line number equal
          to or greater than linenum into the memory beginning at
          linent.

          The ldlinit and ldlitem functions together perform exactly
          the same function as ldlread.  After an initial call to
          ldlread or ldlinit, ldlitem may be used to retrieve a series
          of line number entries associated with a single function.
          ldlinit simply locates the line number entries for the
          function identified by fcnindx.  ldlitem finds and reads the
          entry with the smallest line number equal to or greater than
          linenum into the memory beginning at linent.

          The ldlread, ldlinit, and ldlitem functions each return
          either SUCCESS or FAILURE.  ldlread will fail if there are
          no line number entries in the object file, if fcnindx does
          not index a function entry in the symbol table, or if it
          finds no line number equal to or greater than linenum.
          ldlinit will fail if there are no line number entries in the
          object file or if fcnindx does not index a function entry in
          the symbol table.  ldlitem will fail if it finds no line
          number equal to or greater than linenum.

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

     See Also
          ldclose(S), ldopen(S), ldtbindex(S), ldfcn(F)


                                             (printed 6/20/89)