LDLREAD(3X)          INTERACTIVE UNIX System          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
               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 func-
               tion.  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 func-
               tion 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


          Rev. C Software Development Set                            Page 1

          LDLREAD(3X)          INTERACTIVE UNIX System          LDLREAD(3X)



               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 rou-
               tine library libld.a.

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














































          Rev. C Software Development Set                            Page 2