Annotation of GNUtools/cc/stab.def, revision 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.