---

---

---

001: /* Table of DBX symbol codes for the GNU system.
002:    Copyright (C) 1988, 1997 Free Software Foundation, Inc.
003:    This file is part of the GNU C Library.
004: 
005:    The GNU C Library is free software; you can redistribute it and/or
006:    modify it under the terms of the GNU Lesser General Public
007:    License as published by the Free Software Foundation; either
008:    version 2.1 of the License, or (at your option) any later version.
009: 
010:    The GNU C Library is distributed in the hope that it will be useful,
011:    but WITHOUT ANY WARRANTY; without even the implied warranty of
012:    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
013:    Lesser General Public License for more details.
014: 
015:    You should have received a copy of the GNU Lesser General Public
016:    License along with the GNU C Library; if not, write to the Free
017:    Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
018:    02111-1307 USA.  */
019: 
020: /* This contains contribution from Cygnus Support.  */
021: 
022: /* Global variable.  Only the name is significant.
023:    To find the address, look in the corresponding external symbol.  */
024: __define_stab (N_GSYM, 0x20, "GSYM")
025: 
026: /* Function name for BSD Fortran.  Only the name is significant.
027:    To find the address, look in the corresponding external symbol.  */
028: __define_stab (N_FNAME, 0x22, "FNAME")
029: 
030: /* Function name or text-segment variable for C.  Value is its address.
031:    Desc is supposedly starting line number, but GCC doesn't set it
032:    and DBX seems not to miss it.  */
033: __define_stab (N_FUN, 0x24, "FUN")
034: 
035: /* Data-segment variable with internal linkage.  Value is its address.
036:    "Static Sym".  */
037: __define_stab (N_STSYM, 0x26, "STSYM")
038: 
039: /* BSS-segment variable with internal linkage.  Value is its address.  */
040: __define_stab (N_LCSYM, 0x28, "LCSYM")
041: 
042: /* Name of main routine.  Only the name is significant.
043:    This is not used in C.  */
044: __define_stab (N_MAIN, 0x2a, "MAIN")
045: 
046: /* Global symbol in Pascal.
047:    Supposedly the value is its line number; I'm skeptical.  */
048: __define_stab (N_PC, 0x30, "PC")
049: 
050: /* Number of symbols:  0, files,,funcs,lines according to Ultrix V4.0. */
051: __define_stab (N_NSYMS, 0x32, "NSYMS")
052: 
053: /* "No DST map for sym: name, ,0,type,ignored"  according to Ultrix V4.0. */
054: __define_stab (N_NOMAP, 0x34, "NOMAP")
055: 
056: /* New stab from Solaris.  I don't know what it means, but it
057:    don't seem to contain useful information.  */
058: __define_stab (N_OBJ, 0x38, "OBJ")
059: 
060: /* New stab from Solaris.  I don't know what it means, but it
061:    don't seem to contain useful information.  Possibly related to the
062:    optimization flags used in this module.  */
063: __define_stab (N_OPT, 0x3c, "OPT")
064: 
065: /* Register variable.  Value is number of register.  */
066: __define_stab (N_RSYM, 0x40, "RSYM")
067: 
068: /* Modula-2 compilation unit.  Can someone say what info it contains?  */
069: __define_stab (N_M2C, 0x42, "M2C")
070: 
071: /* Line number in text segment.  Desc is the line number;
072:    value is corresponding address.  */
073: __define_stab (N_SLINE, 0x44, "SLINE")
074: 
075: /* Similar, for data segment.  */
076: __define_stab (N_DSLINE, 0x46, "DSLINE")
077: 
078: /* Similar, for bss segment.  */
079: __define_stab (N_BSLINE, 0x48, "BSLINE")
080: 
081: /* Sun's source-code browser stabs.  ?? Don't know what the fields are.
082:    Supposedly the field is "path to associated .cb file".  THIS VALUE
083:    OVERLAPS WITH N_BSLINE!  */
084: __define_stab (N_BROWS, 0x48, "BROWS")
085: 
086: /* GNU Modula-2 definition module dependency.  Value is the modification time
087:    of the definition file.  Other is non-zero if it is imported with the
088:    GNU M2 keyword %INITIALIZE.  Perhaps N_M2C can be used if there
089:    are enough empty fields? */
090: __define_stab(N_DEFD, 0x4a, "DEFD")
091: 
092: /* THE FOLLOWING TWO STAB VALUES CONFLICT.  Happily, one is for Modula-2
093:    and one is for C++.   Still,... */
094: /* GNU C++ exception variable.  Name is variable name.  */
095: __define_stab (N_EHDECL, 0x50, "EHDECL")
096: /* Modula2 info "for imc":  name,,0,0,0  according to Ultrix V4.0.  */
097: __define_stab (N_MOD2, 0x50, "MOD2")
098: 
099: /* GNU C++ `catch' clause.  Value is its address.  Desc is nonzero if
100:    this entry is immediately followed by a CAUGHT stab saying what exception
101:    was caught.  Multiple CAUGHT stabs means that multiple exceptions
102:    can be caught here.  If Desc is 0, it means all exceptions are caught
103:    here.  */
104: __define_stab (N_CATCH, 0x54, "CATCH")
105: 
106: /* Structure or union element.  Value is offset in the structure.  */
107: __define_stab (N_SSYM, 0x60, "SSYM")
108: 
109: /* Name of main source file.
110:    Value is starting text address of the compilation.  */
111: __define_stab (N_SO, 0x64, "SO")
112: 
113: /* Automatic variable in the stack.  Value is offset from frame pointer.
114:    Also used for type descriptions.  */
115: __define_stab (N_LSYM, 0x80, "LSYM")
116: 
117: /* Beginning of an include file.  Only Sun uses this.
118:    In an object file, only the name is significant.
119:    The Sun linker puts data into some of the other fields.  */
120: __define_stab (N_BINCL, 0x82, "BINCL")
121: 
122: /* Name of sub-source file (#include file).
123:    Value is starting text address of the compilation.  */
124: __define_stab (N_SOL, 0x84, "SOL")
125: 
126: /* Parameter variable.  Value is offset from argument pointer.
127:    (On most machines the argument pointer is the same as the frame pointer.  */
128: __define_stab (N_PSYM, 0xa0, "PSYM")
129: 
130: /* End of an include file.  No name.
131:    This and N_BINCL act as brackets around the file's output.
132:    In an object file, there is no significant data in this entry.
133:    The Sun linker puts data into some of the fields.  */
134: __define_stab (N_EINCL, 0xa2, "EINCL")
135: 
136: /* Alternate entry point.  Value is its address.  */
137: __define_stab (N_ENTRY, 0xa4, "ENTRY")
138: 
139: /* Beginning of lexical block.
140:    The desc is the nesting level in lexical blocks.
141:    The value is the address of the start of the text for the block.
142:    The variables declared inside the block *precede* the N_LBRAC symbol.  */
143: __define_stab (N_LBRAC, 0xc0, "LBRAC")
144: 
145: /* Place holder for deleted include file.  Replaces a N_BINCL and everything
146:    up to the corresponding N_EINCL.  The Sun linker generates these when
147:    it finds multiple identical copies of the symbols from an include file.
148:    This appears only in output from the Sun linker.  */
149: __define_stab (N_EXCL, 0xc2, "EXCL")
150: 
151: /* Modula-2 scope information.  Can someone say what info it contains?  */
152: __define_stab (N_SCOPE, 0xc4, "SCOPE")
153: 
154: /* End of a lexical block.  Desc matches the N_LBRAC's desc.
155:    The value is the address of the end of the text for the block.  */
156: __define_stab (N_RBRAC, 0xe0, "RBRAC")
157: 
158: /* Begin named common block.  Only the name is significant.  */
159: __define_stab (N_BCOMM, 0xe2, "BCOMM")
160: 
161: /* End named common block.  Only the name is significant
162:    (and it should match the N_BCOMM).  */
163: __define_stab (N_ECOMM, 0xe4, "ECOMM")
164: 
165: /* End common (local name): value is address.
166:    I'm not sure how this is used.  */
167: __define_stab (N_ECOML, 0xe8, "ECOML")
168: 
169: /* These STAB's are used on Gould systems for Non-Base register symbols
170:    or something like that.  FIXME.  I have assigned the values at random
171:    since I don't have a Gould here.  Fixups from Gould folk welcome... */
172: __define_stab (N_NBTEXT, 0xF0, "NBTEXT")
173: __define_stab (N_NBDATA, 0xF2, "NBDATA")
174: __define_stab (N_NBBSS,  0xF4, "NBBSS")
175: __define_stab (N_NBSTS,  0xF6, "NBSTS")
176: __define_stab (N_NBLCS,  0xF8, "NBLCS")
177: 
178: /* Second symbol entry containing a length-value for the preceding entry.
179:    The value is the length.  */
180: __define_stab (N_LENG, 0xfe, "LENG")
181: 
182: /* The above information, in matrix format.
183: 
184:                         STAB MATRIX
185:         _________________________________________________
186:         | 00 - 1F are not dbx stab symbols              |
187:         | In most cases, the low bit is the EXTernal bit|
188: 
189:         | 00 UNDEF  | 02 ABS    | 04 TEXT   | 06 DATA   |
190:         | 01  |EXT  | 03  |EXT  | 05  |EXT  | 07  |EXT  |
191: 
192:         | 08 BSS    | 0A INDR   | 0C FN_SEQ | 0E        |
193:         | 09  |EXT  | 0B        | 0D        | 0F        |
194: 
195:         | 10        | 12 COMM   | 14 SETA   | 16 SETT   |
196:         | 11        | 13        | 15        | 17        |
197: 
198:         | 18 SETD   | 1A SETB   | 1C SETV   | 1E WARNING|
199:         | 19        | 1B        | 1D        | 1F FN     |
200: 
201:         |_______________________________________________|
202:         | Debug entries with bit 01 set are unused.     |
203:         | 20 GSYM   | 22 FNAME  | 24 FUN    | 26 STSYM  |
204:         | 28 LCSYM  | 2A MAIN   | 2C        | 2E        |
205:         | 30 PC     | 32 NSYMS  | 34 NOMAP  | 36        |
206:         | 38 OBJ    | 3A        | 3C OPT    | 3E        |
207:         | 40 RSYM   | 42 M2C    | 44 SLINE  | 46 DSLINE |
208:         | 48 BSLINE*| 4A DEFD   | 4C        | 4E        |
209:         | 50 EHDECL*| 52        | 54 CATCH  | 56        |
210:         | 58        | 5A        | 5C        | 5E        |
211:         | 60 SSYM   | 62        | 64 SO     | 66        |
212:         | 68        | 6A        | 6C        | 6E        |
213:         | 70        | 72        | 74        | 76        |
214:         | 78        | 7A        | 7C        | 7E        |
215:         | 80 LSYM   | 82 BINCL  | 84 SOL    | 86        |
216:         | 88        | 8A        | 8C        | 8E        |
217:         | 90        | 92        | 94        | 96        |
218:         | 98        | 9A        | 9C        | 9E        |
219:         | A0 PSYM   | A2 EINCL  | A4 ENTRY  | A6        |
220:         | A8        | AA        | AC        | AE        |
221:         | B0        | B2        | B4        | B6        |
222:         | B8        | BA        | BC        | BE        |
223:         | C0 LBRAC  | C2 EXCL   | C4 SCOPE  | C6        |
224:         | C8        | CA        | CC        | CE        |
225:         | D0        | D2        | D4        | D6        |
226:         | D8        | DA        | DC        | DE        |
227:         | E0 RBRAC  | E2 BCOMM  | E4 ECOMM  | E6        |
228:         | E8 ECOML  | EA        | EC        | EE        |
229:         | F0        | F2        | F4        | F6        |
230:         | F8        | FA        | FC        | FE LENG   |
231:         +-----------------------------------------------+
232:  * 50 EHDECL is also MOD2.
233:  * 48 BSLINE is also BROWS.
234:  */
235: 

---

---

---