ldlread(3X)

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

SYNOPSIS
     #include <stdio.h>
     #include <filehdr.h>
     #include <syms.h>
     #include <ldfcn.h>

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

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

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

DESCRIPTION
     This routine is available for o32 ABI programs only.

     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, which is the index of its local
     symbols 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 do exactly the same function as ldlread.
     After an initial call to ldlread or ldlinit, ldlitem can be used to
     retrieve a series of line number entries associated with a single
     function.  ldlinit simply finds 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.
     If no line number entries exist 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, ldlread fails.  If no line
     number entries exist in the object file or if fcnindx does not index a
     function entry in the symbol table, ldlinit fails.  If it finds no
     line number equal to or greater than linenum, ldlitem fails.

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

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

     ldfcn(4), paths.h(4)