unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-4.1.3)
Page:
Section:
Apropos / Subsearch:
optional field

LDLREAD(3X)                                                        LDLREAD(3X)



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

SYNOPSIS
       #include <&lt;stdio.h>&gt;
       #include <&lt;filehdr.h>&gt;
       #include <&lt;linenum.h>&gt;
       #include <&lt;ldfcn.h>&gt;

       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;

AVAILABILITY
       Available only on Sun 386i systems running a  SunOS  4.0.x  release  or
       earlier.  Not a SunOS 4.1 release feature.

DESCRIPTION
       ldlread()  searches  the line number entries of the COFF file currently
       associated with ldptr.  ldlread() begins its search with the line  num-
       ber  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 the memory beginning at 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 the memory beginning at linent().

       ldlread(), ldlinit(), and ldlitem() each return either SUCCESS or FAIL-
       URE.  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(3X), ldfcn(3), ldopen(3X), ldtbindex(3X)



                               19 February 1988                    LDLREAD(3X)