![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to stab.def CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Apple XNU] / GNUtools / debug / gdb / include / aout|
Return to stab.def CVS log | Up to [Apple XNU] / GNUtools / debug / gdb / include / aout |
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: */
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.