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.

     Programs using this routine should be loaded with the object
     file access library libld.a.

STATUS MESSAGES AND ERRORS
     The ldlread, ldlinit, and ldlitem routines each return
     either SUCCESS or FAILURE.  The ldlread command fails if
     there are no line number entries in the object file, if



January 1992                                                    1

ldlread(3X)                                           ldlread(3X)



     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 fails 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 fails if it finds no line number
     equal to or greater than linenum.

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












































2                                                    January 1992