Annotation of gcc/stab.def, revision 1.1.1.1

1.1       root        1: /* Table of DBX symbol codes for the GNU system.
                      2:    Copyright (C) 1988 Free Software Foundation, Inc.
                      3: 
                      4:    This program is free software; you can redistribute it and/or modify
                      5:    it under the terms of the GNU General Public License as published by
                      6:    the Free Software Foundation; either version 1, or (at your option)
                      7:    any later version.
                      8: 
                      9:    This program is distributed in the hope that it will be useful,
                     10:    but WITHOUT ANY WARRANTY; without even the implied warranty of
                     11:    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
                     12:    GNU General Public License for more details.
                     13: 
                     14:    You should have received a copy of the GNU General Public License
                     15:    along with this program; if not, write to the Free Software
                     16:    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.  */
                     17: 
                     18: /* This contains contribution from Cygnus Support.  */
                     19: 
                     20: /* Global variable.  Only the name is significant.
                     21:    To find the address, look in the corresponding external symbol.  */
                     22: __define_stab (N_GSYM, 0x20, "GSYM")
                     23: 
                     24: /* Function name for BSD Fortran.  Only the name is significant.
                     25:    To find the address, look in the corresponding external symbol.  */
                     26: __define_stab (N_FNAME, 0x22, "FNAME")
                     27: 
                     28: /* Function name or text-segment variable for C.  Value is its address.
                     29:    Desc is supposedly starting line number, but GCC doesn't set it
                     30:    and DBX seems not to miss it.  */
                     31: __define_stab (N_FUN, 0x24, "FUN")
                     32: 
                     33: /* Data-segment variable with internal linkage.  Value is its address.  */
                     34: __define_stab (N_STSYM, 0x26, "STSYM")
                     35: 
                     36: /* BSS-segment variable with internal linkage.  Value is its address.  */
                     37: __define_stab (N_LCSYM, 0x28, "LCSYM")
                     38: 
                     39: /* Name of main routine.  Only the name is significant.
                     40:    This is not used in C.  */
                     41: __define_stab (N_MAIN, 0x2a, "MAIN")
                     42: 
                     43: /* Register variable.  Value is number of register.  */
                     44: __define_stab (N_RSYM, 0x40, "RSYM")
                     45: 
                     46: /* Structure or union element.  Value is offset in the structure.  */
                     47: __define_stab (N_SSYM, 0x60, "SSYM")
                     48: 
                     49: /* Parameter variable.  Value is offset from argument pointer.
                     50:    (On most machines the argument pointer is the same as the frame pointer.  */
                     51: __define_stab (N_PSYM, 0xa0, "PSYM")
                     52: 
                     53: /* Automatic variable in the stack.  Value is offset from frame pointer.
                     54:    Also used for type descriptions.  */
                     55: __define_stab (N_LSYM, 0x80, "LSYM")
                     56: 
                     57: /* Alternate entry point.  Value is its address.  */
                     58: __define_stab (N_ENTRY, 0xa4, "ENTRY")
                     59: 
                     60: /* Name of main source file.
                     61:    Value is starting text address of the compilation.  */
                     62: __define_stab (N_SO, 0x64, "SO")
                     63: 
                     64: /* Name of sub-source file.
                     65:    Value is starting text address of the compilation.  */
                     66: __define_stab (N_SOL, 0x84, "SOL")
                     67: 
                     68: /* Line number in text segment.  Desc is the line number;
                     69:    value is corresponding address.  */
                     70: __define_stab (N_SLINE, 0x44, "SLINE")
                     71: /* Similar, for data segment.  */
                     72: __define_stab (N_DSLINE, 0x46, "DSLINE")
                     73: /* Similar, for bss segment.  */
                     74: __define_stab (N_BSLINE, 0x48, "BSLINE")
                     75: 
                     76: /* Beginning of an include file.  Only Sun uses this.
                     77:    In an object file, only the name is significant.
                     78:    The Sun linker puts data into some of the other fields.  */
                     79: __define_stab (N_BINCL, 0x82, "BINCL")
                     80: /* End of an include file.  No name.
                     81:    These two act as brackets around the file's output.
                     82:    In an object file, there is no significant data in this entry.
                     83:    The Sun linker puts data into some of the fields.  */
                     84: __define_stab (N_EINCL, 0xa2, "EINCL")
                     85: /* Place holder for deleted include file.
                     86:    This appears only in output from the Sun linker.  */
                     87: __define_stab (N_EXCL, 0xc2, "EXCL")
                     88: 
                     89: /* Beginning of lexical block.
                     90:    The desc is the nesting level in lexical blocks.
                     91:    The value is the address of the start of the text for the block.
                     92:    The variables declared inside the block *precede* the N_LBRAC symbol.  */
                     93: __define_stab (N_LBRAC, 0xc0, "LBRAC")
                     94: /* End of a lexical block.  Desc matches the N_LBRAC's desc.
                     95:    The value is the address of the end of the text for the block.  */
                     96: __define_stab (N_RBRAC, 0xe0, "RBRAC")
                     97: 
                     98: /* Begin named common block.  Only the name is significant.  */
                     99: __define_stab (N_BCOMM, 0xe2, "BCOMM")
                    100: /* Begin named common block.  Only the name is significant
                    101:    (and it should match the N_BCOMM).  */
                    102: __define_stab (N_ECOMM, 0xe4, "ECOMM")
                    103: /* End common (local name): value is address.
                    104:    I'm not sure how this is used.  */
                    105: __define_stab (N_ECOML, 0xe8, "ECOML")
                    106: /* Second symbol entry containing a length-value for the preceding entry.
                    107:    The value is the length.  */
                    108: __define_stab (N_LENG, 0xfe, "LENG")
                    109: 
                    110: /* Global symbol in Pascal.
                    111:    Supposedly the value is its line number; I'm skeptical.  */
                    112: __define_stab (N_PC, 0x30, "PC")
                    113: 
                    114: /* Modula-2 compilation unit.  Can someone say what info it contains?  */
                    115: __define_stab (N_M2C, 0x42, "M2C")
                    116: /* Modula-2 scope information.  Can someone say what info it contains?  */
                    117: __define_stab (N_SCOPE, 0xc4, "SCOPE")
                    118: 
                    119: /* Sun's source-code browser stabs.  ?? Don't know what the fields are.
                    120:    Supposedly the field is "path to associated .cb file".  */
                    121: /* This conflicts with the definition of N_BSLINE.  */
                    122: __define_stab (N_BROWS, 0x48, "BROWS")
                    123: 
                    124: /* GNU C++ exception stabs.  */
                    125: 
                    126: /* GNU C++ `catch' clause.  Value is its address.  Desc is nonzero if
                    127:    this entry is immediately followed by a CAUGHT stab saying what exception
                    128:    was caught.  Multiple CAUGHT stabs means that multiple exceptions
                    129:    can be caught here.  If Desc is 0, it means all exceptions are caught
                    130:    here.  */
                    131: __define_stab (N_CATCH, 0x54, "CATCH")
                    132: 
                    133: /* The above information, in matrix format.
                    134: 
                    135:                        STAB MATRIX
                    136:        _________________________________________________
                    137:        | 00 - 1F are not dbx stab symbols              |
                    138:        | Entries with bits 01 set are external symbols |
                    139:        | N_UNDEF   | N_ABS     | N_TEXT    | N_DATA    |
                    140:        | N_BSS     | N_COMM    |           | N_FN      |
                    141:        |_______________________________________________|
                    142:        | 20 GSYM   | 22 FNAME  | 24 FUN    | 26 STSYM  |
                    143:        | 28 LCSYM  | 2A MAIN   | 2C        | 2E        |
                    144:        | 30 PC     | 32        | 34        | 36        |
                    145:        | 38        | 3A        | 3C        | 3E        |
                    146:        | 40 RSYM   | 42 M2C    | 44 SLINE  | 46 DSLINE |
                    147:        | 48 BROWS/BSLINE | 4A  | 4C        | 4E        |
                    148:        | 50 EHDECL | 52        | 54 CATCH  | 56        |
                    149:        | 58        | 5A        | 5C        | 5E        |
                    150:        | 60 SSYM   | 62        | 64 SO     | 66        |
                    151:        | 68        | 6A        | 6C        | 6E        |
                    152:        | 70        | 72        | 74        | 76        |
                    153:        | 78        | 7A        | 7C        | 7E        |
                    154:        | 80 LSYM   | 82 BINCL  | 84 SOL    | 86        |
                    155:        | 88        | 8A        | 8C        | 8E        |
                    156:        | 90        | 92        | 94        | 96        |
                    157:        | 98        | 9A        | 9C        | 9E        |
                    158:        | A0 PSYM   | A2 EINCL  | A4 ENTRY  | A6        |
                    159:        | A8        | AA        | AC        | AE        |
                    160:        | B0        | B2        | B4        | B6        |
                    161:        | B8        | BA        | BC        | BE        |
                    162:        | C0 LBRAC  | C2 EXCL   | C4 SCOPE  | C6        |
                    163:        | C8        | CA        | CC        | CE        |
                    164:        | D0        | D2        | D4        | D6        |
                    165:        | D8        | DA        | DC        | DE        |
                    166:        | E0 RBRAC  | E2 BCOMM  | E4 ECOMM  | E6        |
                    167:        | E8 ECOML  | EA        | EC        | EE        |
                    168:        | F0        | F2        | F4        | F6        |
                    169:        | F8        | FA        | FC        | FE LENG   |
                    170:        +-----------------------------------------------+
                    171: 
                    172: */

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.