Annotation of GNUtools/debug/gdb/include/aout/stab.def, revision 1.1

1.1     ! root        1: /* Table of DBX symbol codes for the GNU system.
        !             2:    Copyright (C) 1988, 1991 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 2 of the License, or
        !             7: (at your option) 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: /* New stab from Solaris 2.  This uses an n_type of 0, which in a.out files
        !            19:    overlaps the N_UNDF used for ordinary symbols.  In ELF files, the
        !            20:    debug information is in a different file section, so there is no conflict.
        !            21:    This symbol's n_value gives the size of the string section associated
        !            22:    with this file.  The symbol's n_strx (relative to the just-updated
        !            23:    string section start address) gives the name of the source file,
        !            24:    e.g. "foo.c", without any path information.  The symbol's n_desc gives
        !            25:    the count of upcoming symbols associated with this file (not including
        !            26:    this one).  */
        !            27: /* __define_stab (N_UNDF, 0x00, "UNDF")  */
        !            28: 
        !            29: /* Global variable.  Only the name is significant.
        !            30:    To find the address, look in the corresponding external symbol.  */
        !            31: __define_stab (N_GSYM, 0x20, "GSYM")
        !            32: 
        !            33: /* Function name for BSD Fortran.  Only the name is significant.
        !            34:    To find the address, look in the corresponding external symbol.  */
        !            35: __define_stab (N_FNAME, 0x22, "FNAME")
        !            36: 
        !            37: /* Function name or text-segment variable for C.  Value is its address.
        !            38:    Desc is supposedly starting line number, but GCC doesn't set it
        !            39:    and DBX seems not to miss it.
        !            40:    N_FUN entries can now contain an argument type list after the function's
        !            41:    return type, with a ';' preceding each argument type.  An argument type
        !            42:    of 0 means "...".  Also, function prototypes (as opposed to definitions)
        !            43:    are described as N_FUN with a 'P' type after the name ("printf:P1;"etc).  */
        !            44: __define_stab (N_FUN, 0x24, "FUN")
        !            45: 
        !            46: /* Data-segment variable with internal linkage.  Value is its address.
        !            47:    "Static Sym".  */
        !            48: __define_stab (N_STSYM, 0x26, "STSYM")
        !            49: 
        !            50: /* BSS-segment variable with internal linkage.  Value is its address.  */
        !            51: __define_stab (N_LCSYM, 0x28, "LCSYM")
        !            52: 
        !            53: /* Name of main routine.  Only the name is significant.  */
        !            54: __define_stab (N_MAIN, 0x2a, "MAIN")
        !            55: 
        !            56: /* Solaris2:  Read-only data symbols.  */
        !            57: __define_stab (N_ROSYM, 0x2c, "ROSYM")
        !            58: 
        !            59: /* Global symbol in Pascal.
        !            60:    Supposedly the value is its line number; I'm skeptical.  */
        !            61: __define_stab (N_PC, 0x30, "PC")
        !            62: 
        !            63: /* Number of symbols:  0, files,,funcs,lines according to Ultrix V4.0. */
        !            64: __define_stab (N_NSYMS, 0x32, "NSYMS")
        !            65: 
        !            66: /* "No DST map for sym: name, ,0,type,ignored"  according to Ultrix V4.0. */
        !            67: __define_stab (N_NOMAP, 0x34, "NOMAP")
        !            68: 
        !            69: /* New stab from Solaris 2.  Like N_SO, but for the object file.  Two in
        !            70:    a row provide the build directory and the relative path of the .o from it.
        !            71:    Solaris2 uses this to avoid putting the stabs info into the linked
        !            72:    executable; this stab goes into the ".stab.index" section, and the debugger
        !            73:    reads the real stabs directly from the .o files instead.  */
        !            74: __define_stab (N_OBJ, 0x38, "OBJ")
        !            75: 
        !            76: /* New stab from Solaris 2.  Options for the debugger, related to the
        !            77:    source language for this module.  E.g. whether to use ANSI
        !            78:    integral promotions or traditional integral promotions.  */
        !            79: __define_stab (N_OPT, 0x3c, "OPT")
        !            80: 
        !            81: /* Register variable.  Value is number of register.  */
        !            82: __define_stab (N_RSYM, 0x40, "RSYM")
        !            83: 
        !            84: /* Modula-2 compilation unit.  Can someone say what info it contains?  */
        !            85: __define_stab (N_M2C, 0x42, "M2C")
        !            86: 
        !            87: /* Line number in text segment.  Desc is the line number;
        !            88:    value is corresponding address.  On Solaris2, the line number is
        !            89:    relative to the start of the current function.  */
        !            90: __define_stab (N_SLINE, 0x44, "SLINE")
        !            91: 
        !            92: /* Similar, for data segment.  */
        !            93: __define_stab (N_DSLINE, 0x46, "DSLINE")
        !            94: 
        !            95: /* Similar, for bss segment.  */
        !            96: __define_stab (N_BSLINE, 0x48, "BSLINE")
        !            97: 
        !            98: /* Sun's source-code browser stabs.  ?? Don't know what the fields are.
        !            99:    Supposedly the field is "path to associated .cb file".  THIS VALUE
        !           100:    OVERLAPS WITH N_BSLINE!  */
        !           101: __define_stab (N_BROWS, 0x48, "BROWS")
        !           102: 
        !           103: /* GNU Modula-2 definition module dependency.  Value is the modification time
        !           104:    of the definition file.  Other is non-zero if it is imported with the
        !           105:    GNU M2 keyword %INITIALIZE.  Perhaps N_M2C can be used if there
        !           106:    are enough empty fields? */
        !           107: __define_stab(N_DEFD, 0x4a, "DEFD")
        !           108: 
        !           109: /* New in Solaris2.  Function start/body/end line numbers.  */
        !           110: __define_stab(N_FLINE, 0x4C, "FLINE")
        !           111: 
        !           112: /* THE FOLLOWING TWO STAB VALUES CONFLICT.  Happily, one is for Modula-2
        !           113:    and one is for C++.   Still,... */
        !           114: /* GNU C++ exception variable.  Name is variable name.  */
        !           115: __define_stab (N_EHDECL, 0x50, "EHDECL")
        !           116: /* Modula2 info "for imc":  name,,0,0,0  according to Ultrix V4.0.  */
        !           117: __define_stab (N_MOD2, 0x50, "MOD2")
        !           118: 
        !           119: /* GNU C++ `catch' clause.  Value is its address.  Desc is nonzero if
        !           120:    this entry is immediately followed by a CAUGHT stab saying what exception
        !           121:    was caught.  Multiple CAUGHT stabs means that multiple exceptions
        !           122:    can be caught here.  If Desc is 0, it means all exceptions are caught
        !           123:    here.  */
        !           124: __define_stab (N_CATCH, 0x54, "CATCH")
        !           125: 
        !           126: /* Structure or union element.  Value is offset in the structure.  */
        !           127: __define_stab (N_SSYM, 0x60, "SSYM")
        !           128: 
        !           129: /* Solaris2:  Last stab emitted for module.  */
        !           130: __define_stab (N_ENDM, 0x62, "ENDM")
        !           131: 
        !           132: /* Name of main source file.
        !           133:    Value is starting text address of the compilation.
        !           134:    If multiple N_SO's appear, the first to contain a trailing / is the
        !           135:    compilation directory.  The first to not contain a trailing / is the
        !           136:    source file name, relative to the compilation directory.  Others (perhaps
        !           137:    resulting from cfront) are ignored.
        !           138:    On Solaris2, value is undefined, but desc is a source-language code.  */
        !           139: 
        !           140: __define_stab (N_SO, 0x64, "SO")
        !           141: 
        !           142: /* Automatic variable in the stack.  Value is offset from frame pointer.
        !           143:    Also used for type descriptions.  */
        !           144: __define_stab (N_LSYM, 0x80, "LSYM")
        !           145: 
        !           146: /* Beginning of an include file.  Only Sun uses this.
        !           147:    In an object file, only the name is significant.
        !           148:    The Sun linker puts data into some of the other fields.  */
        !           149: __define_stab (N_BINCL, 0x82, "BINCL")
        !           150: 
        !           151: /* Name of sub-source file (#include file).
        !           152:    Value is starting text address of the compilation.  */
        !           153: __define_stab (N_SOL, 0x84, "SOL")
        !           154: 
        !           155: /* Parameter variable.  Value is offset from argument pointer.
        !           156:    (On most machines the argument pointer is the same as the frame pointer.  */
        !           157: __define_stab (N_PSYM, 0xa0, "PSYM")
        !           158: 
        !           159: /* End of an include file.  No name.
        !           160:    This and N_BINCL act as brackets around the file's output.
        !           161:    In an object file, there is no significant data in this entry.
        !           162:    The Sun linker puts data into some of the fields.  */
        !           163: __define_stab (N_EINCL, 0xa2, "EINCL")
        !           164: 
        !           165: /* Alternate entry point.  Value is its address.  */
        !           166: __define_stab (N_ENTRY, 0xa4, "ENTRY")
        !           167: 
        !           168: /* Beginning of lexical block.
        !           169:    The desc is the nesting level in lexical blocks.
        !           170:    The value is the address of the start of the text for the block.
        !           171:    The variables declared inside the block *precede* the N_LBRAC symbol.
        !           172:    On Solaris2, the value is relative to the start of the current function.  */
        !           173: __define_stab (N_LBRAC, 0xc0, "LBRAC")
        !           174: 
        !           175: /* Place holder for deleted include file.  Replaces a N_BINCL and everything
        !           176:    up to the corresponding N_EINCL.  The Sun linker generates these when
        !           177:    it finds multiple identical copies of the symbols from an include file.
        !           178:    This appears only in output from the Sun linker.  */
        !           179: __define_stab (N_EXCL, 0xc2, "EXCL")
        !           180: 
        !           181: /* Modula-2 scope information.  Can someone say what info it contains?  */
        !           182: __define_stab (N_SCOPE, 0xc4, "SCOPE")
        !           183: 
        !           184: /* End of a lexical block.  Desc matches the N_LBRAC's desc.
        !           185:    The value is the address of the end of the text for the block.
        !           186:    On Solaris2, the value is relative to the start of the current function.  */
        !           187: __define_stab (N_RBRAC, 0xe0, "RBRAC")
        !           188: 
        !           189: /* Begin named common block.  Only the name is significant.  */
        !           190: __define_stab (N_BCOMM, 0xe2, "BCOMM")
        !           191: 
        !           192: /* End named common block.  Only the name is significant
        !           193:    (and it should match the N_BCOMM).  */
        !           194: __define_stab (N_ECOMM, 0xe4, "ECOMM")
        !           195: 
        !           196: /* End common (local name): value is address.
        !           197:    I'm not sure how this is used.  */
        !           198: __define_stab (N_ECOML, 0xe8, "ECOML")
        !           199: 
        !           200: /* Solaris2: Pascal "with" statement: type,,0,0,offset */
        !           201: __define_stab (N_WITH, 0xea, "WITH")
        !           202: 
        !           203: /* These STAB's are used on Gould systems for Non-Base register symbols
        !           204:    or something like that.  FIXME.  I have assigned the values at random
        !           205:    since I don't have a Gould here.  Fixups from Gould folk welcome... */
        !           206: __define_stab (N_NBTEXT, 0xF0, "NBTEXT")
        !           207: __define_stab (N_NBDATA, 0xF2, "NBDATA")
        !           208: __define_stab (N_NBBSS,  0xF4, "NBBSS")
        !           209: __define_stab (N_NBSTS,  0xF6, "NBSTS")
        !           210: __define_stab (N_NBLCS,  0xF8, "NBLCS")
        !           211: 
        !           212: /* Second symbol entry containing a length-value for the preceding entry.
        !           213:    The value is the length.  */
        !           214: __define_stab (N_LENG, 0xfe, "LENG")
        !           215: 
        !           216: /* The above information, in matrix format.
        !           217: 
        !           218:                        STAB MATRIX
        !           219:        _________________________________________________
        !           220:        | 00 - 1F are not dbx stab symbols              |
        !           221:        | In most cases, the low bit is the EXTernal bit|
        !           222: 
        !           223:        | 00 UNDEF  | 02 ABS    | 04 TEXT   | 06 DATA   |
        !           224:        | 01  |EXT  | 03  |EXT  | 05  |EXT  | 07  |EXT  |
        !           225: 
        !           226:        | 08 BSS    | 0A INDR   | 0C FN_SEQ | 0E        |
        !           227:        | 09  |EXT  | 0B        | 0D        | 0F        |
        !           228: 
        !           229:        | 10        | 12 COMM   | 14 SETA   | 16 SETT   |
        !           230:        | 11        | 13        | 15        | 17        |
        !           231: 
        !           232:        | 18 SETD   | 1A SETB   | 1C SETV   | 1E WARNING|
        !           233:        | 19        | 1B        | 1D        | 1F FN     |
        !           234: 
        !           235:        |_______________________________________________|
        !           236:        | Debug entries with bit 01 set are unused.     |
        !           237:        | 20 GSYM   | 22 FNAME  | 24 FUN    | 26 STSYM  |
        !           238:        | 28 LCSYM  | 2A MAIN   | 2C ROSYM  | 2E        |
        !           239:        | 30 PC     | 32 NSYMS  | 34 NOMAP  | 36        |
        !           240:        | 38 OBJ    | 3A        | 3C OPT    | 3E        |
        !           241:        | 40 RSYM   | 42 M2C    | 44 SLINE  | 46 DSLINE |
        !           242:        | 48 BSLINE*| 4A DEFD   | 4C FLINE  | 4E        |
        !           243:        | 50 EHDECL*| 52        | 54 CATCH  | 56        |
        !           244:        | 58        | 5A        | 5C        | 5E        |
        !           245:        | 60 SSYM   | 62 ENDM   | 64 SO     | 66        |
        !           246:        | 68        | 6A        | 6C        | 6E        |
        !           247:        | 70        | 72        | 74        | 76        |
        !           248:        | 78        | 7A        | 7C        | 7E        |
        !           249:        | 80 LSYM   | 82 BINCL  | 84 SOL    | 86        |
        !           250:        | 88        | 8A        | 8C        | 8E        |
        !           251:        | 90        | 92        | 94        | 96        |
        !           252:        | 98        | 9A        | 9C        | 9E        |
        !           253:        | A0 PSYM   | A2 EINCL  | A4 ENTRY  | A6        |
        !           254:        | A8        | AA        | AC        | AE        |
        !           255:        | B0        | B2        | B4        | B6        |
        !           256:        | B8        | BA        | BC        | BE        |
        !           257:        | C0 LBRAC  | C2 EXCL   | C4 SCOPE  | C6        |
        !           258:        | C8        | CA        | CC        | CE        |
        !           259:        | D0        | D2        | D4        | D6        |
        !           260:        | D8        | DA        | DC        | DE        |
        !           261:        | E0 RBRAC  | E2 BCOMM  | E4 ECOMM  | E6        |
        !           262:        | E8 ECOML  | EA WITH   | EC        | EE        |
        !           263:        | F0        | F2        | F4        | F6        |
        !           264:        | F8        | FA        | FC        | FE LENG   |
        !           265:        +-----------------------------------------------+
        !           266:  * 50 EHDECL is also MOD2.
        !           267:  * 48 BSLINE is also BROWS.
        !           268:  */

unix.superglobalmegacorp.com

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