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

unix.superglobalmegacorp.com

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