From Craig Silverstein: Add more DWARF info, add some i386 comments.
[external/binutils.git] / elfcpp / dwarf.h
1 // dwarf.h -- DWARF2 constants  -*- C++ -*-
2
3 // Copyright 2006, 2007, Free Software Foundation, Inc.
4 // Written by Ian Lance Taylor <iant@google.com>.
5
6 // This file is part of elfcpp.
7    
8 // This program is free software; you can redistribute it and/or
9 // modify it under the terms of the GNU Library General Public License
10 // as published by the Free Software Foundation; either version 2, or
11 // (at your option) any later version.
12
13 // In addition to the permissions in the GNU Library General Public
14 // License, the Free Software Foundation gives you unlimited
15 // permission to link the compiled version of this file into
16 // combinations with other programs, and to distribute those
17 // combinations without any restriction coming from the use of this
18 // file.  (The Library Public License restrictions do apply in other
19 // respects; for example, they cover modification of the file, and
20 /// distribution when not linked into a combined executable.)
21
22 // This program is distributed in the hope that it will be useful, but
23 // WITHOUT ANY WARRANTY; without even the implied warranty of
24 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
25 // Library General Public License for more details.
26
27 // You should have received a copy of the GNU Library General Public
28 // License along with this program; if not, write to the Free Software
29 // Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA
30 // 02110-1301, USA.
31
32 #ifndef ELFCPP_DWARF_H
33 #define ELFCPP_DWARF_H
34
35 namespace elfcpp
36 {
37
38 typedef unsigned char Dwarf_uint8;
39 typedef signed char Dwarf_int8;
40 typedef uint16_t Dwarf_uint16;
41 typedef int16_t Dwarf_int16;
42 typedef uint32_t Dwarf_uint32;
43 typedef int32_t Dwarf_int32;
44 typedef uint64_t Dwarf_uint64;
45 typedef int64_t Dwarf_int64;
46
47
48 // DWARF2 codes.
49
50 enum DW_TAG
51 {
52   DW_TAG_padding = 0x00,
53   DW_TAG_array_type = 0x01,
54   DW_TAG_class_type = 0x02,
55   DW_TAG_entry_point = 0x03,
56   DW_TAG_enumeration_type = 0x04,
57   DW_TAG_formal_parameter = 0x05,
58   DW_TAG_imported_declaration = 0x08,
59   DW_TAG_label = 0x0a,
60   DW_TAG_lexical_block = 0x0b,
61   DW_TAG_member = 0x0d,
62   DW_TAG_pointer_type = 0x0f,
63   DW_TAG_reference_type = 0x10,
64   DW_TAG_compile_unit = 0x11,
65   DW_TAG_string_type = 0x12,
66   DW_TAG_structure_type = 0x13,
67   DW_TAG_subroutine_type = 0x15,
68   DW_TAG_typedef = 0x16,
69   DW_TAG_union_type = 0x17,
70   DW_TAG_unspecified_parameters = 0x18,
71   DW_TAG_variant = 0x19,
72   DW_TAG_common_block = 0x1a,
73   DW_TAG_common_inclusion = 0x1b,
74   DW_TAG_inheritance = 0x1c,
75   DW_TAG_inlined_subroutine = 0x1d,
76   DW_TAG_module = 0x1e,
77   DW_TAG_ptr_to_member_type = 0x1f,
78   DW_TAG_set_type = 0x20,
79   DW_TAG_subrange_type = 0x21,
80   DW_TAG_with_stmt = 0x22,
81   DW_TAG_access_declaration = 0x23,
82   DW_TAG_base_type = 0x24,
83   DW_TAG_catch_block = 0x25,
84   DW_TAG_const_type = 0x26,
85   DW_TAG_constant = 0x27,
86   DW_TAG_enumerator = 0x28,
87   DW_TAG_file_type = 0x29,
88   DW_TAG_friend = 0x2a,
89   DW_TAG_namelist = 0x2b,
90   DW_TAG_namelist_item = 0x2c,
91   DW_TAG_packed_type = 0x2d,
92   DW_TAG_subprogram = 0x2e,
93   DW_TAG_template_type_param = 0x2f,
94   DW_TAG_template_value_param = 0x30,
95   DW_TAG_thrown_type = 0x31,
96   DW_TAG_try_block = 0x32,
97   DW_TAG_variant_part = 0x33,
98   DW_TAG_variable = 0x34,
99   DW_TAG_volatile_type = 0x35,
100
101   // DWARF3.
102   DW_TAG_dwarf_procedure = 0x36,
103   DW_TAG_restrict_type = 0x37,
104   DW_TAG_interface_type = 0x38,
105   DW_TAG_namespace = 0x39,
106   DW_TAG_imported_module = 0x3a,
107   DW_TAG_unspecified_type = 0x3b,
108   DW_TAG_partial_unit = 0x3c,
109   DW_TAG_imported_unit = 0x3d,
110   DW_TAG_condition = 0x3f,
111   DW_TAG_shared_type = 0x40,
112
113   // SGI/MIPS extensions.
114   DW_TAG_MIPS_loop = 0x4081,
115
116   // HP extensions.
117   // See: ftp://ftp.hp.com/pub/lang/tools/WDB/wdb-4.0.tar.gz.
118   DW_TAG_HP_array_descriptor = 0x4090,
119
120   // GNU extensions.
121   DW_TAG_format_label = 0x4101,         // For FORTRAN 77 and Fortran 90.
122   DW_TAG_function_template = 0x4102,    // For C++.
123   DW_TAG_class_template = 0x4103,       // For C++.
124   DW_TAG_GNU_BINCL = 0x4104,
125   DW_TAG_GNU_EINCL = 0x4105,
126
127   // Extensions for UPC.  See: http://upc.gwu.edu/~upc.
128   DW_TAG_upc_shared_type = 0x8765,
129   DW_TAG_upc_strict_type = 0x8766,
130   DW_TAG_upc_relaxed_type = 0x8767,
131
132   // PGI (STMicroelectronics) extensions.  No documentation available.
133   DW_TAG_PGI_kanji_type      = 0xA000,
134   DW_TAG_PGI_interface_block = 0xA020
135 };
136
137 // Frame unwind information.
138
139 enum DW_EH_PE
140 {
141   DW_EH_PE_absptr = 0x00,
142   DW_EH_PE_omit = 0xff,
143
144   DW_EH_PE_uleb128 = 0x01,
145   DW_EH_PE_udata2 = 0x02,
146   DW_EH_PE_udata4 = 0x03,
147   DW_EH_PE_udata8 = 0x04,
148   DW_EH_PE_signed = 0x08,
149   DW_EH_PE_sleb128 = 0x09,
150   DW_EH_PE_sdata2 = 0x0a,
151   DW_EH_PE_sdata4 = 0x0b,
152   DW_EH_PE_sdata8 = 0x0c,
153
154   DW_EH_PE_pcrel = 0x10,
155   DW_EH_PE_textrel = 0x20,
156   DW_EH_PE_datarel = 0x30,
157   DW_EH_PE_funcrel = 0x40,
158   DW_EH_PE_aligned = 0x50,
159
160   DW_EH_PE_indirect = 0x80
161 };
162
163 // Line number opcodes.
164
165 enum DW_LINE_OPS
166 {
167   DW_LNS_extended_op = 0,
168   DW_LNS_copy = 1,
169   DW_LNS_advance_pc = 2,
170   DW_LNS_advance_line = 3,
171   DW_LNS_set_file = 4,
172   DW_LNS_set_column = 5,
173   DW_LNS_negate_stmt = 6,
174   DW_LNS_set_basic_block = 7,
175   DW_LNS_const_add_pc = 8,
176   DW_LNS_fixed_advance_pc = 9,
177   // DWARF 3.
178   DW_LNS_set_prologue_end = 10,
179   DW_LNS_set_epilogue_begin = 11,
180   DW_LNS_set_isa = 12
181 };
182
183 // Line number extended opcodes.
184
185 enum DW_LINE_EXTENDED_OPS
186 {
187   DW_LNE_end_sequence = 1,
188   DW_LNE_set_address = 2,
189   DW_LNE_define_file = 3,
190   // HP extensions.
191   DW_LNE_HP_negate_is_UV_update      = 0x11,
192   DW_LNE_HP_push_context             = 0x12,
193   DW_LNE_HP_pop_context              = 0x13,
194   DW_LNE_HP_set_file_line_column     = 0x14,
195   DW_LNE_HP_set_routine_name         = 0x15,
196   DW_LNE_HP_set_sequence             = 0x16,
197   DW_LNE_HP_negate_post_semantics    = 0x17,
198   DW_LNE_HP_negate_function_exit     = 0x18,
199   DW_LNE_HP_negate_front_end_logical = 0x19,
200   DW_LNE_HP_define_proc              = 0x20
201 };
202
203 // Type encoding names and codes
204
205 enum DW_ENCODING
206 {
207   DW_ATE_address                     =0x1,
208   DW_ATE_boolean                     =0x2,
209   DW_ATE_complex_float               =0x3,
210   DW_ATE_float                       =0x4,
211   DW_ATE_signed                      =0x5,
212   DW_ATE_signed_char                 =0x6,
213   DW_ATE_unsigned                    =0x7,
214   DW_ATE_unsigned_char               =0x8,
215   // DWARF3/DWARF3f
216   DW_ATE_imaginary_float             =0x9,
217   DW_ATE_packed_decimal              =0xa,
218   DW_ATE_numeric_string              =0xb,
219   DW_ATE_edited                      =0xc,
220   DW_ATE_signed_fixed                =0xd,
221   DW_ATE_unsigned_fixed              =0xe,
222   DW_ATE_decimal_float               =0xf,
223   DW_ATE_lo_user                     =0x80,
224   DW_ATE_hi_user                     =0xff
225 };
226
227 // Location virtual machine opcodes
228
229 enum DW_OP
230 {
231   DW_OP_addr                         =0x03,
232   DW_OP_deref                        =0x06,
233   DW_OP_const1u                      =0x08,
234   DW_OP_const1s                      =0x09,
235   DW_OP_const2u                      =0x0a,
236   DW_OP_const2s                      =0x0b,
237   DW_OP_const4u                      =0x0c,
238   DW_OP_const4s                      =0x0d,
239   DW_OP_const8u                      =0x0e,
240   DW_OP_const8s                      =0x0f,
241   DW_OP_constu                       =0x10,
242   DW_OP_consts                       =0x11,
243   DW_OP_dup                          =0x12,
244   DW_OP_drop                         =0x13,
245   DW_OP_over                         =0x14,
246   DW_OP_pick                         =0x15,
247   DW_OP_swap                         =0x16,
248   DW_OP_rot                          =0x17,
249   DW_OP_xderef                       =0x18,
250   DW_OP_abs                          =0x19,
251   DW_OP_and                          =0x1a,
252   DW_OP_div                          =0x1b,
253   DW_OP_minus                        =0x1c,
254   DW_OP_mod                          =0x1d,
255   DW_OP_mul                          =0x1e,
256   DW_OP_neg                          =0x1f,
257   DW_OP_not                          =0x20,
258   DW_OP_or                           =0x21,
259   DW_OP_plus                         =0x22,
260   DW_OP_plus_uconst                  =0x23,
261   DW_OP_shl                          =0x24,
262   DW_OP_shr                          =0x25,
263   DW_OP_shra                         =0x26,
264   DW_OP_xor                          =0x27,
265   DW_OP_bra                          =0x28,
266   DW_OP_eq                           =0x29,
267   DW_OP_ge                           =0x2a,
268   DW_OP_gt                           =0x2b,
269   DW_OP_le                           =0x2c,
270   DW_OP_lt                           =0x2d,
271   DW_OP_ne                           =0x2e,
272   DW_OP_skip                         =0x2f,
273   DW_OP_lit0                         =0x30,
274   DW_OP_lit1                         =0x31,
275   DW_OP_lit2                         =0x32,
276   DW_OP_lit3                         =0x33,
277   DW_OP_lit4                         =0x34,
278   DW_OP_lit5                         =0x35,
279   DW_OP_lit6                         =0x36,
280   DW_OP_lit7                         =0x37,
281   DW_OP_lit8                         =0x38,
282   DW_OP_lit9                         =0x39,
283   DW_OP_lit10                        =0x3a,
284   DW_OP_lit11                        =0x3b,
285   DW_OP_lit12                        =0x3c,
286   DW_OP_lit13                        =0x3d,
287   DW_OP_lit14                        =0x3e,
288   DW_OP_lit15                        =0x3f,
289   DW_OP_lit16                        =0x40,
290   DW_OP_lit17                        =0x41,
291   DW_OP_lit18                        =0x42,
292   DW_OP_lit19                        =0x43,
293   DW_OP_lit20                        =0x44,
294   DW_OP_lit21                        =0x45,
295   DW_OP_lit22                        =0x46,
296   DW_OP_lit23                        =0x47,
297   DW_OP_lit24                        =0x48,
298   DW_OP_lit25                        =0x49,
299   DW_OP_lit26                        =0x4a,
300   DW_OP_lit27                        =0x4b,
301   DW_OP_lit28                        =0x4c,
302   DW_OP_lit29                        =0x4d,
303   DW_OP_lit30                        =0x4e,
304   DW_OP_lit31                        =0x4f,
305   DW_OP_reg0                         =0x50,
306   DW_OP_reg1                         =0x51,
307   DW_OP_reg2                         =0x52,
308   DW_OP_reg3                         =0x53,
309   DW_OP_reg4                         =0x54,
310   DW_OP_reg5                         =0x55,
311   DW_OP_reg6                         =0x56,
312   DW_OP_reg7                         =0x57,
313   DW_OP_reg8                         =0x58,
314   DW_OP_reg9                         =0x59,
315   DW_OP_reg10                        =0x5a,
316   DW_OP_reg11                        =0x5b,
317   DW_OP_reg12                        =0x5c,
318   DW_OP_reg13                        =0x5d,
319   DW_OP_reg14                        =0x5e,
320   DW_OP_reg15                        =0x5f,
321   DW_OP_reg16                        =0x60,
322   DW_OP_reg17                        =0x61,
323   DW_OP_reg18                        =0x62,
324   DW_OP_reg19                        =0x63,
325   DW_OP_reg20                        =0x64,
326   DW_OP_reg21                        =0x65,
327   DW_OP_reg22                        =0x66,
328   DW_OP_reg23                        =0x67,
329   DW_OP_reg24                        =0x68,
330   DW_OP_reg25                        =0x69,
331   DW_OP_reg26                        =0x6a,
332   DW_OP_reg27                        =0x6b,
333   DW_OP_reg28                        =0x6c,
334   DW_OP_reg29                        =0x6d,
335   DW_OP_reg30                        =0x6e,
336   DW_OP_reg31                        =0x6f,
337   DW_OP_breg0                        =0x70,
338   DW_OP_breg1                        =0x71,
339   DW_OP_breg2                        =0x72,
340   DW_OP_breg3                        =0x73,
341   DW_OP_breg4                        =0x74,
342   DW_OP_breg5                        =0x75,
343   DW_OP_breg6                        =0x76,
344   DW_OP_breg7                        =0x77,
345   DW_OP_breg8                        =0x78,
346   DW_OP_breg9                        =0x79,
347   DW_OP_breg10                       =0x7a,
348   DW_OP_breg11                       =0x7b,
349   DW_OP_breg12                       =0x7c,
350   DW_OP_breg13                       =0x7d,
351   DW_OP_breg14                       =0x7e,
352   DW_OP_breg15                       =0x7f,
353   DW_OP_breg16                       =0x80,
354   DW_OP_breg17                       =0x81,
355   DW_OP_breg18                       =0x82,
356   DW_OP_breg19                       =0x83,
357   DW_OP_breg20                       =0x84,
358   DW_OP_breg21                       =0x85,
359   DW_OP_breg22                       =0x86,
360   DW_OP_breg23                       =0x87,
361   DW_OP_breg24                       =0x88,
362   DW_OP_breg25                       =0x89,
363   DW_OP_breg26                       =0x8a,
364   DW_OP_breg27                       =0x8b,
365   DW_OP_breg28                       =0x8c,
366   DW_OP_breg29                       =0x8d,
367   DW_OP_breg30                       =0x8e,
368   DW_OP_breg31                       =0x8f,
369   DW_OP_regX                         =0x90,
370   DW_OP_fbreg                        =0x91,
371   DW_OP_bregX                        =0x92,
372   DW_OP_piece                        =0x93,
373   DW_OP_deref_size                   =0x94,
374   DW_OP_xderef_size                  =0x95,
375   DW_OP_nop                          =0x96,
376   // DWARF3/DWARF3f
377   DW_OP_push_object_address          =0x97,
378   DW_OP_call2                        =0x98,
379   DW_OP_call4                        =0x99,
380   DW_OP_call_ref                     =0x9a,
381   DW_OP_form_tls_address             =0x9b,
382   DW_OP_call_frame_cfa               =0x9c,
383   DW_OP_bit_piece                    =0x9d,
384   DW_OP_lo_user                      =0xe0,
385   DW_OP_hi_user                      =0xff,  
386   // GNU extensions
387   DW_OP_GNU_push_tls_address         =0xe0
388 };
389
390 } // End namespace elfcpp.
391
392 #endif // !defined(ELFCPP_DWARF_H)