ldlread(3X)                                           ldlread(3X)



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

     SYNOPSIS
          #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
          ldlread searches the line number entries of the common
          object file currently associated with ldptr.  ldlread 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.  ldlread reads the entry with the
          smallest line number equal to or greater than linenum into
          linent.

          ldlinit and ldlitem 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 linent.

          ldlread, ldlinit, and ldlitem each return either SUCCESS or
          FAILURE.  ldlread fails 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.  LINEFEED.B ldlinit fails
          if there are no line number entries in the object file or if



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

     ldlread(3X)                                           ldlread(3X)



          fcnindx does not index a function entry in the symbol table.
          ldlitem fails 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(3X), ldopen(3X), ldtbindex(3X), ldfcn(4).














































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