linenum(4) Kernel Interfaces Manual linenum(4)NAME
linenum - Line number entries in an object file
DESCRIPTION
When invoked with the -g option, the cc(1) command generates an entry in the object file for each C source line on which a breakpoint is
possible. Users can then reference line numbers when debugging. (See dbx(1).)
RELATED INFORMATION a.out(4), cc(1), dbx(1), syms(4) delim off
linenum(4)
Check Out this Related Man Page
ldlread(3x)ldlread(3x)Name
ldlread, ldlinit, ldlitem - manipulate line number entries of a common object file function
Syntax
#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
The function searches the line number entries of the common object file currently associated with ldptr. The 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 function.
The function is identified by fcnindx, which is the index of its local symbols entry in the object file symbol table. The function reads
the entry with the smallest line number equal to or greater than linenum into linent.
The and functions provide the same behavior as After an initial call to or can be used to retrieve a series of line number entries associ-
ated with a single function. The function simply finds the line number entries for the function identified by fcnindx. The function finds
and reads the entry with the smallest line number equal to or greater than linenum into linent.
The functions and each return either success or failure. The function fails if one of the following occurs:
o If line number entries do not exist in the object file.
o If fcnindx does not index a function entry in the symbol table.
o If it does not find a line number equal to or greater than linenum.
The fails if it does not find a line number equal to or greater than linenum.
See Alsoldclose(3x), ldopen(3x), ldtbindex(3x), ldfcn(5)
RISC ldlread(3x)