Home | History | Annotate | Download | only in bits
      1 /* Table of DBX symbol codes for the GNU system.
      2    Copyright (C) 1988, 1997 Free Software Foundation, Inc.
      3    This file is part of the GNU C Library.
      4 
      5    The GNU C Library is free software; you can redistribute it and/or
      6    modify it under the terms of the GNU Lesser General Public
      7    License as published by the Free Software Foundation; either
      8    version 2.1 of the License, or (at your option) any later version.
      9 
     10    The GNU C Library is distributed in the hope that it will be useful,
     11    but WITHOUT ANY WARRANTY; without even the implied warranty of
     12    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
     13    Lesser General Public License for more details.
     14 
     15    You should have received a copy of the GNU Lesser General Public
     16    License along with the GNU C Library; if not, write to the Free
     17    Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
     18    02111-1307 USA.  */
     19 
     20 /* This contains contribution from Cygnus Support.  */
     21 
     22 /* Global variable.  Only the name is significant.
     24    To find the address, look in the corresponding external symbol.  */
     25 __define_stab (N_GSYM, 0x20, "GSYM")
     26 
     27 /* Function name for BSD Fortran.  Only the name is significant.
     28    To find the address, look in the corresponding external symbol.  */
     29 __define_stab (N_FNAME, 0x22, "FNAME")
     30 
     31 /* Function name or text-segment variable for C.  Value is its address.
     32    Desc is supposedly starting line number, but GCC doesn't set it
     33    and DBX seems not to miss it.  */
     34 __define_stab (N_FUN, 0x24, "FUN")
     35 
     36 /* Data-segment variable with internal linkage.  Value is its address.
     37    "Static Sym".  */
     38 __define_stab (N_STSYM, 0x26, "STSYM")
     39 
     40 /* BSS-segment variable with internal linkage.  Value is its address.  */
     41 __define_stab (N_LCSYM, 0x28, "LCSYM")
     42 
     43 /* Name of main routine.  Only the name is significant.
     44    This is not used in C.  */
     45 __define_stab (N_MAIN, 0x2a, "MAIN")
     46 
     47 /* Global symbol in Pascal.
     48    Supposedly the value is its line number; I'm skeptical.  */
     49 __define_stab (N_PC, 0x30, "PC")
     50 
     51 /* Number of symbols:  0, files,,funcs,lines according to Ultrix V4.0. */
     52 __define_stab (N_NSYMS, 0x32, "NSYMS")
     53 
     54 /* "No DST map for sym: name, ,0,type,ignored"  according to Ultrix V4.0. */
     55 __define_stab (N_NOMAP, 0x34, "NOMAP")
     56 
     57 /* New stab from Solaris.  I don't know what it means, but it
     58    don't seem to contain useful information.  */
     59 __define_stab (N_OBJ, 0x38, "OBJ")
     60 
     61 /* New stab from Solaris.  I don't know what it means, but it
     62    don't seem to contain useful information.  Possibly related to the
     63    optimization flags used in this module.  */
     64 __define_stab (N_OPT, 0x3c, "OPT")
     65 
     66 /* Register variable.  Value is number of register.  */
     67 __define_stab (N_RSYM, 0x40, "RSYM")
     68 
     69 /* Modula-2 compilation unit.  Can someone say what info it contains?  */
     70 __define_stab (N_M2C, 0x42, "M2C")
     71 
     72 /* Line number in text segment.  Desc is the line number;
     73    value is corresponding address.  */
     74 __define_stab (N_SLINE, 0x44, "SLINE")
     75 
     76 /* Similar, for data segment.  */
     77 __define_stab (N_DSLINE, 0x46, "DSLINE")
     78 
     79 /* Similar, for bss segment.  */
     80 __define_stab (N_BSLINE, 0x48, "BSLINE")
     81 
     82 /* Sun's source-code browser stabs.  ?? Don't know what the fields are.
     83    Supposedly the field is "path to associated .cb file".  THIS VALUE
     84    OVERLAPS WITH N_BSLINE!  */
     85 __define_stab (N_BROWS, 0x48, "BROWS")
     86 
     87 /* GNU Modula-2 definition module dependency.  Value is the modification time
     88    of the definition file.  Other is non-zero if it is imported with the
     89    GNU M2 keyword %INITIALIZE.  Perhaps N_M2C can be used if there
     90    are enough empty fields? */
     91 __define_stab(N_DEFD, 0x4a, "DEFD")
     92 
     93 /* THE FOLLOWING TWO STAB VALUES CONFLICT.  Happily, one is for Modula-2
     94    and one is for C++.   Still,... */
     95 /* GNU C++ exception variable.  Name is variable name.  */
     96 __define_stab (N_EHDECL, 0x50, "EHDECL")
     97 /* Modula2 info "for imc":  name,,0,0,0  according to Ultrix V4.0.  */
     98 __define_stab (N_MOD2, 0x50, "MOD2")
     99 
    100 /* GNU C++ `catch' clause.  Value is its address.  Desc is nonzero if
    101    this entry is immediately followed by a CAUGHT stab saying what exception
    102    was caught.  Multiple CAUGHT stabs means that multiple exceptions
    103    can be caught here.  If Desc is 0, it means all exceptions are caught
    104    here.  */
    105 __define_stab (N_CATCH, 0x54, "CATCH")
    106 
    107 /* Structure or union element.  Value is offset in the structure.  */
    108 __define_stab (N_SSYM, 0x60, "SSYM")
    109 
    110 /* Name of main source file.
    111    Value is starting text address of the compilation.  */
    112 __define_stab (N_SO, 0x64, "SO")
    113 
    114 /* Automatic variable in the stack.  Value is offset from frame pointer.
    115    Also used for type descriptions.  */
    116 __define_stab (N_LSYM, 0x80, "LSYM")
    117 
    118 /* Beginning of an include file.  Only Sun uses this.
    119    In an object file, only the name is significant.
    120    The Sun linker puts data into some of the other fields.  */
    121 __define_stab (N_BINCL, 0x82, "BINCL")
    122 
    123 /* Name of sub-source file (#include file).
    124    Value is starting text address of the compilation.  */
    125 __define_stab (N_SOL, 0x84, "SOL")
    126 
    127 /* Parameter variable.  Value is offset from argument pointer.
    128    (On most machines the argument pointer is the same as the frame pointer.  */
    129 __define_stab (N_PSYM, 0xa0, "PSYM")
    130 
    131 /* End of an include file.  No name.
    132    This and N_BINCL act as brackets around the file's output.
    133    In an object file, there is no significant data in this entry.
    134    The Sun linker puts data into some of the fields.  */
    135 __define_stab (N_EINCL, 0xa2, "EINCL")
    136 
    137 /* Alternate entry point.  Value is its address.  */
    138 __define_stab (N_ENTRY, 0xa4, "ENTRY")
    139 
    140 /* Beginning of lexical block.
    141    The desc is the nesting level in lexical blocks.
    142    The value is the address of the start of the text for the block.
    143    The variables declared inside the block *precede* the N_LBRAC symbol.  */
    144 __define_stab (N_LBRAC, 0xc0, "LBRAC")
    145 
    146 /* Place holder for deleted include file.  Replaces a N_BINCL and everything
    147    up to the corresponding N_EINCL.  The Sun linker generates these when
    148    it finds multiple identical copies of the symbols from an include file.
    149    This appears only in output from the Sun linker.  */
    150 __define_stab (N_EXCL, 0xc2, "EXCL")
    151 
    152 /* Modula-2 scope information.  Can someone say what info it contains?  */
    153 __define_stab (N_SCOPE, 0xc4, "SCOPE")
    154 
    155 /* End of a lexical block.  Desc matches the N_LBRAC's desc.
    156    The value is the address of the end of the text for the block.  */
    157 __define_stab (N_RBRAC, 0xe0, "RBRAC")
    158 
    159 /* Begin named common block.  Only the name is significant.  */
    160 __define_stab (N_BCOMM, 0xe2, "BCOMM")
    161 
    162 /* End named common block.  Only the name is significant
    163    (and it should match the N_BCOMM).  */
    164 __define_stab (N_ECOMM, 0xe4, "ECOMM")
    165 
    166 /* End common (local name): value is address.
    167    I'm not sure how this is used.  */
    168 __define_stab (N_ECOML, 0xe8, "ECOML")
    169 
    170 /* These STAB's are used on Gould systems for Non-Base register symbols
    171    or something like that.  FIXME.  I have assigned the values at random
    172    since I don't have a Gould here.  Fixups from Gould folk welcome... */
    173 __define_stab (N_NBTEXT, 0xF0, "NBTEXT")
    174 __define_stab (N_NBDATA, 0xF2, "NBDATA")
    175 __define_stab (N_NBBSS,  0xF4, "NBBSS")
    176 __define_stab (N_NBSTS,  0xF6, "NBSTS")
    177 __define_stab (N_NBLCS,  0xF8, "NBLCS")
    178 
    179 /* Second symbol entry containing a length-value for the preceding entry.
    180    The value is the length.  */
    181 __define_stab (N_LENG, 0xfe, "LENG")
    182 
    183 /* The above information, in matrix format.
    185 
    186 			STAB MATRIX
    187 	_________________________________________________
    188 	| 00 - 1F are not dbx stab symbols		|
    189 	| In most cases, the low bit is the EXTernal bit|
    190 
    191 	| 00 UNDEF  | 02 ABS	| 04 TEXT   | 06 DATA	|
    192 	| 01  |EXT  | 03  |EXT	| 05  |EXT  | 07  |EXT	|
    193 
    194 	| 08 BSS    | 0A INDR	| 0C FN_SEQ | 0E   	|
    195 	| 09  |EXT  | 0B 	| 0D	    | 0F	|
    196 
    197 	| 10 	    | 12 COMM	| 14 SETA   | 16 SETT	|
    198 	| 11	    | 13	| 15 	    | 17	|
    199 
    200 	| 18 SETD   | 1A SETB	| 1C SETV   | 1E WARNING|
    201 	| 19	    | 1B	| 1D 	    | 1F FN	|
    202 
    203 	|_______________________________________________|
    204 	| Debug entries with bit 01 set are unused.	|
    205 	| 20 GSYM   | 22 FNAME	| 24 FUN    | 26 STSYM	|
    206 	| 28 LCSYM  | 2A MAIN	| 2C	    | 2E	|
    207 	| 30 PC	    | 32 NSYMS	| 34 NOMAP  | 36	|
    208 	| 38 OBJ    | 3A	| 3C OPT    | 3E	|
    209 	| 40 RSYM   | 42 M2C	| 44 SLINE  | 46 DSLINE |
    210 	| 48 BSLINE*| 4A DEFD	| 4C        | 4E	|
    211 	| 50 EHDECL*| 52	| 54 CATCH  | 56        |
    212 	| 58        | 5A        | 5C        | 5E	|
    213 	| 60 SSYM   | 62	| 64 SO	    | 66 	|
    214 	| 68 	    | 6A	| 6C	    | 6E	|
    215 	| 70	    | 72	| 74	    | 76	|
    216 	| 78	    | 7A	| 7C	    | 7E	|
    217 	| 80 LSYM   | 82 BINCL	| 84 SOL    | 86	|
    218 	| 88	    | 8A	| 8C	    | 8E	|
    219 	| 90	    | 92	| 94	    | 96	|
    220 	| 98	    | 9A	| 9C	    | 9E	|
    221 	| A0 PSYM   | A2 EINCL	| A4 ENTRY  | A6	|
    222 	| A8	    | AA	| AC	    | AE	|
    223 	| B0	    | B2	| B4	    | B6	|
    224 	| B8	    | BA	| BC	    | BE	|
    225 	| C0 LBRAC  | C2 EXCL	| C4 SCOPE  | C6	|
    226 	| C8	    | CA	| CC	    | CE	|
    227 	| D0	    | D2	| D4	    | D6	|
    228 	| D8	    | DA	| DC	    | DE	|
    229 	| E0 RBRAC  | E2 BCOMM	| E4 ECOMM  | E6	|
    230 	| E8 ECOML  | EA	| EC	    | EE	|
    231 	| F0	    | F2	| F4	    | F6	|
    232 	| F8	    | FA	| FC	    | FE LENG	|
    233 	+-----------------------------------------------+
    234  * 50 EHDECL is also MOD2.
    235  * 48 BSLINE is also BROWS.
    236  */
    237