Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

a.out(4)

cc(1)

sdb(1)

linenum(4)

NAME

linenum − line number entries in a common object file

SYNOPSIS

#include  <linenum.h>

DESCRIPTION

Compilers based on pcc generate an entry in the object file for each C source line on which a breakpoint is possible (when invoked with the −g option; see cc(1)).  Users can then reference line numbers when using the appropriate software test system (see sdb(1)).  The structure of these line number entries appears below. 

structlineno
{
union
{
longl_symndx ;
longl_paddr ;
}l_addr ;
unsigned short l_lnno ;
} ;

Numbering starts with one for each function.  The initial line number entry for a function has l_lnno equal to zero, and the symbol table index of the function’s entry is in l_symndx. Otherwise, l_lnno is non-zero, and l_paddr is the physical address of the code for the referenced line.  Thus the overall structure is the following:

l_addrl_lnno
function symtab index0
physical addressline
physical addressline
...
 function symtab index0
physical addressline
physical addressline
...

SEE ALSO

a.out(4). 
cc(1), sdb(1) in the CX/UX User’s Reference Manual. 

CX/UX Programmer’s Reference Manual

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026