linenum(4)                       DG/UX R4.11                      linenum(4)


NAME
       linenum - line number entries in a common object file

SYNOPSIS
       #include  <linenum.h>

DESCRIPTION
       When invoked with the -g option, the cc command generates an entry in
       the object file for each C source line on which a breakpoint is
       possible.  Some debuggers may use this information to reference line
       numbers in the source.  Data General debuggers no longer use this
       information.  The structure of the line number entries appears below.

       struct  lineno
       {
               union
               {
                      long     l_symndx ;
                      long     l_paddr ;
               }               l_addr ;
               union
               {
                      struct
                      {
                               unsigned short _l_lnno;
                               unsigned short _l_pad;
                      }        _l_l;
                      long     _l_lnno;
               }               _l;
       } ;

       Numbering starts with 1 for each function.  The initial line number
       entry for a function has llnno equal to zero, and the symbol table
       index of the function's entry is in lsymndx.  Otherwise, llnno is
       non-zero, and lpaddr is the physical address of the code for the
       referenced line.  Thus the overall structure is the following:

                 laddr                   llnno

                 function symtab index    0
                 physical address         line
                 physical address         line
                 ...

                 function symtab index    0
                 physical address         line
                 physical address         line
                 ...

SEE ALSO
       cc(1), a.out(4).


Licensed material--property of copyright holder(s)