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