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 <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
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.
Page 1
LDLREAD(3X)LDLREAD(3X)
The programs must be loaded with the object file access routine library
libmld.a.
SEE ALSOldclose(3X), ldopen(3X), ldtbindex(3X), ldfcn(4).
Page 2
