OLD | NEW |
| (Empty) |
1 // Copyright 2009 The Native Client Authors. All rights reserved. | |
2 // Use of this source code is governed by a BSD-style license that can | |
3 // be found in the LICENSE file. | |
4 | |
5 #pragma once | |
6 | |
7 #include <dwarf_reader/dwarf_parse.h> | |
8 #include <dwarf_reader/dwarf_reader.h> | |
9 | |
10 /// <summary> | |
11 /// The items in this file provide definitions that can be used inside C# | |
12 /// classes. They need to be kept in sync with the corresponding definitions | |
13 /// in breakpad dwarf2enums. Both are an implementation of version 2 of the | |
14 /// DWARF spec: http://dwarfstd.org/doc/dwarf-2.0.0.pdf | |
15 /// The nomenclature used throughout this file corresponds with the spec and | |
16 /// thus will not follow the google style guide. | |
17 /// </summary> | |
18 namespace NaClVsx { | |
19 | |
20 // These enums do not follow the google3 style only because they are | |
21 // known universally (specs, other implementations) by the names in | |
22 // exactly this capitalization. | |
23 // Tag names and codes. | |
24 public enum class DwarfTag { | |
25 DW_TAG_padding = 0x00, | |
26 DW_TAG_array_type = 0x01, | |
27 DW_TAG_class_type = 0x02, | |
28 DW_TAG_entry_point = 0x03, | |
29 DW_TAG_enumeration_type = 0x04, | |
30 DW_TAG_formal_parameter = 0x05, | |
31 DW_TAG_imported_declaration = 0x08, | |
32 DW_TAG_label = 0x0a, | |
33 DW_TAG_lexical_block = 0x0b, | |
34 DW_TAG_member = 0x0d, | |
35 DW_TAG_pointer_type = 0x0f, | |
36 DW_TAG_reference_type = 0x10, | |
37 DW_TAG_compile_unit = 0x11, | |
38 DW_TAG_string_type = 0x12, | |
39 DW_TAG_structure_type = 0x13, | |
40 DW_TAG_subroutine_type = 0x15, | |
41 DW_TAG_typedef = 0x16, | |
42 DW_TAG_union_type = 0x17, | |
43 DW_TAG_unspecified_parameters = 0x18, | |
44 DW_TAG_variant = 0x19, | |
45 DW_TAG_common_block = 0x1a, | |
46 DW_TAG_common_inclusion = 0x1b, | |
47 DW_TAG_inheritance = 0x1c, | |
48 DW_TAG_inlined_subroutine = 0x1d, | |
49 DW_TAG_module = 0x1e, | |
50 DW_TAG_ptr_to_member_type = 0x1f, | |
51 DW_TAG_set_type = 0x20, | |
52 DW_TAG_subrange_type = 0x21, | |
53 DW_TAG_with_stmt = 0x22, | |
54 DW_TAG_access_declaration = 0x23, | |
55 DW_TAG_base_type = 0x24, | |
56 DW_TAG_catch_block = 0x25, | |
57 DW_TAG_const_type = 0x26, | |
58 DW_TAG_constant = 0x27, | |
59 DW_TAG_enumerator = 0x28, | |
60 DW_TAG_file_type = 0x29, | |
61 DW_TAG_friend = 0x2a, | |
62 DW_TAG_namelist = 0x2b, | |
63 DW_TAG_namelist_item = 0x2c, | |
64 DW_TAG_packed_type = 0x2d, | |
65 DW_TAG_subprogram = 0x2e, | |
66 DW_TAG_template_type_param = 0x2f, | |
67 DW_TAG_template_value_param = 0x30, | |
68 DW_TAG_thrown_type = 0x31, | |
69 DW_TAG_try_block = 0x32, | |
70 DW_TAG_variant_part = 0x33, | |
71 DW_TAG_variable = 0x34, | |
72 DW_TAG_volatile_type = 0x35, | |
73 // DWARF 3. | |
74 DW_TAG_dwarf_procedure = 0x36, | |
75 DW_TAG_restrict_type = 0x37, | |
76 DW_TAG_interface_type = 0x38, | |
77 DW_TAG_namespace = 0x39, | |
78 DW_TAG_imported_module = 0x3a, | |
79 DW_TAG_unspecified_type = 0x3b, | |
80 DW_TAG_partial_unit = 0x3c, | |
81 DW_TAG_imported_unit = 0x3d, | |
82 // SGI/MIPS Extensions. | |
83 DW_TAG_MIPS_loop = 0x4081, | |
84 // HP extensions. See: | |
85 // ftp://ftp.hp.com/pub/lang/tools/WDB/wdb-4.0.tar.gz | |
86 DW_TAG_HP_array_descriptor = 0x4090, | |
87 // GNU extensions. | |
88 DW_TAG_format_label = 0x4101, // For FORTRAN 77 and Fortran 90. | |
89 DW_TAG_function_template = 0x4102, // For C++. | |
90 DW_TAG_class_template = 0x4103, // For C++. | |
91 DW_TAG_GNU_BINCL = 0x4104, | |
92 DW_TAG_GNU_EINCL = 0x4105, | |
93 // Extensions for UPC. See: http://upc.gwu.edu/~upc. | |
94 DW_TAG_upc_shared_type = 0x8765, | |
95 DW_TAG_upc_strict_type = 0x8766, | |
96 DW_TAG_upc_relaxed_type = 0x8767, | |
97 // PGI (STMicroelectronics) extensions. No documentation available. | |
98 DW_TAG_PGI_kanji_type = 0xA000, | |
99 DW_TAG_PGI_interface_block = 0xA020 | |
100 }; | |
101 | |
102 | |
103 public enum class DwarfHasChild { | |
104 DW_children_no = 0, | |
105 DW_children_yes = 1 | |
106 }; | |
107 | |
108 // Form names and codes. | |
109 public enum class DwarfForm { | |
110 DW_FORM_addr = 0x01, | |
111 DW_FORM_block2 = 0x03, | |
112 DW_FORM_block4 = 0x04, | |
113 DW_FORM_data2 = 0x05, | |
114 DW_FORM_data4 = 0x06, | |
115 DW_FORM_data8 = 0x07, | |
116 DW_FORM_string = 0x08, | |
117 DW_FORM_block = 0x09, | |
118 DW_FORM_block1 = 0x0a, | |
119 DW_FORM_data1 = 0x0b, | |
120 DW_FORM_flag = 0x0c, | |
121 DW_FORM_sdata = 0x0d, | |
122 DW_FORM_strp = 0x0e, | |
123 DW_FORM_udata = 0x0f, | |
124 DW_FORM_ref_addr = 0x10, | |
125 DW_FORM_ref1 = 0x11, | |
126 DW_FORM_ref2 = 0x12, | |
127 DW_FORM_ref4 = 0x13, | |
128 DW_FORM_ref8 = 0x14, | |
129 DW_FORM_ref_udata = 0x15, | |
130 DW_FORM_indirect = 0x16 | |
131 }; | |
132 | |
133 // Attribute names and codes | |
134 public enum class DwarfAttribute { | |
135 DW_AT_sibling = 0x01, | |
136 DW_AT_location = 0x02, | |
137 DW_AT_name = 0x03, | |
138 DW_AT_ordering = 0x09, | |
139 DW_AT_subscr_data = 0x0a, | |
140 DW_AT_byte_size = 0x0b, | |
141 DW_AT_bit_offset = 0x0c, | |
142 DW_AT_bit_size = 0x0d, | |
143 DW_AT_element_list = 0x0f, | |
144 DW_AT_stmt_list = 0x10, | |
145 DW_AT_low_pc = 0x11, | |
146 DW_AT_high_pc = 0x12, | |
147 DW_AT_language = 0x13, | |
148 DW_AT_member = 0x14, | |
149 DW_AT_discr = 0x15, | |
150 DW_AT_discr_value = 0x16, | |
151 DW_AT_visibility = 0x17, | |
152 DW_AT_import = 0x18, | |
153 DW_AT_string_length = 0x19, | |
154 DW_AT_common_reference = 0x1a, | |
155 DW_AT_comp_dir = 0x1b, | |
156 DW_AT_const_value = 0x1c, | |
157 DW_AT_containing_type = 0x1d, | |
158 DW_AT_default_value = 0x1e, | |
159 DW_AT_inline = 0x20, | |
160 DW_AT_is_optional = 0x21, | |
161 DW_AT_lower_bound = 0x22, | |
162 DW_AT_producer = 0x25, | |
163 DW_AT_prototyped = 0x27, | |
164 DW_AT_return_addr = 0x2a, | |
165 DW_AT_start_scope = 0x2c, | |
166 DW_AT_stride_size = 0x2e, | |
167 DW_AT_upper_bound = 0x2f, | |
168 DW_AT_abstract_origin = 0x31, | |
169 DW_AT_accessibility = 0x32, | |
170 DW_AT_address_class = 0x33, | |
171 DW_AT_artificial = 0x34, | |
172 DW_AT_base_types = 0x35, | |
173 DW_AT_calling_convention = 0x36, | |
174 DW_AT_count = 0x37, | |
175 DW_AT_data_member_location = 0x38, | |
176 DW_AT_decl_column = 0x39, | |
177 DW_AT_decl_file = 0x3a, | |
178 DW_AT_decl_line = 0x3b, | |
179 DW_AT_declaration = 0x3c, | |
180 DW_AT_discr_list = 0x3d, | |
181 DW_AT_encoding = 0x3e, | |
182 DW_AT_external = 0x3f, | |
183 DW_AT_frame_base = 0x40, | |
184 DW_AT_friend = 0x41, | |
185 DW_AT_identifier_case = 0x42, | |
186 DW_AT_macro_info = 0x43, | |
187 DW_AT_namelist_items = 0x44, | |
188 DW_AT_priority = 0x45, | |
189 DW_AT_segment = 0x46, | |
190 DW_AT_specification = 0x47, | |
191 DW_AT_static_link = 0x48, | |
192 DW_AT_type = 0x49, | |
193 DW_AT_use_location = 0x4a, | |
194 DW_AT_variable_parameter = 0x4b, | |
195 DW_AT_virtuality = 0x4c, | |
196 DW_AT_vtable_elem_location = 0x4d, | |
197 // DWARF 3 values. | |
198 DW_AT_allocated = 0x4e, | |
199 DW_AT_associated = 0x4f, | |
200 DW_AT_data_location = 0x50, | |
201 DW_AT_stride = 0x51, | |
202 DW_AT_entry_pc = 0x52, | |
203 DW_AT_use_UTF8 = 0x53, | |
204 DW_AT_extension = 0x54, | |
205 DW_AT_ranges = 0x55, | |
206 DW_AT_trampoline = 0x56, | |
207 DW_AT_call_column = 0x57, | |
208 DW_AT_call_file = 0x58, | |
209 DW_AT_call_line = 0x59, | |
210 // SGI/MIPS extensions. | |
211 DW_AT_MIPS_fde = 0x2001, | |
212 DW_AT_MIPS_loop_begin = 0x2002, | |
213 DW_AT_MIPS_tail_loop_begin = 0x2003, | |
214 DW_AT_MIPS_epilog_begin = 0x2004, | |
215 DW_AT_MIPS_loop_unroll_factor = 0x2005, | |
216 DW_AT_MIPS_software_pipeline_depth = 0x2006, | |
217 DW_AT_MIPS_linkage_name = 0x2007, | |
218 DW_AT_MIPS_stride = 0x2008, | |
219 DW_AT_MIPS_abstract_name = 0x2009, | |
220 DW_AT_MIPS_clone_origin = 0x200a, | |
221 DW_AT_MIPS_has_inlines = 0x200b, | |
222 // HP extensions. | |
223 DW_AT_HP_block_index = 0x2000, | |
224 DW_AT_HP_unmodifiable = 0x2001, // Same as DW_AT_MIPS_fde. | |
225 DW_AT_HP_actuals_stmt_list = 0x2010, | |
226 DW_AT_HP_proc_per_section = 0x2011, | |
227 DW_AT_HP_raw_data_ptr = 0x2012, | |
228 DW_AT_HP_pass_by_reference = 0x2013, | |
229 DW_AT_HP_opt_level = 0x2014, | |
230 DW_AT_HP_prof_version_id = 0x2015, | |
231 DW_AT_HP_opt_flags = 0x2016, | |
232 DW_AT_HP_cold_region_low_pc = 0x2017, | |
233 DW_AT_HP_cold_region_high_pc = 0x2018, | |
234 DW_AT_HP_all_variables_modifiable = 0x2019, | |
235 DW_AT_HP_linkage_name = 0x201a, | |
236 DW_AT_HP_prof_flags = 0x201b, // In comp unit of procs_info for -g. | |
237 // GNU extensions. | |
238 DW_AT_sf_names = 0x2101, | |
239 DW_AT_src_info = 0x2102, | |
240 DW_AT_mac_info = 0x2103, | |
241 DW_AT_src_coords = 0x2104, | |
242 DW_AT_body_begin = 0x2105, | |
243 DW_AT_body_end = 0x2106, | |
244 DW_AT_GNU_vector = 0x2107, | |
245 // VMS extensions. | |
246 DW_AT_VMS_rtnbeg_pd_address = 0x2201, | |
247 // UPC extension. | |
248 DW_AT_upc_threads_scaled = 0x3210, | |
249 // PGI (STMicroelectronics) extensions. | |
250 DW_AT_PGI_lbase = 0x3a00, | |
251 DW_AT_PGI_soffset = 0x3a01, | |
252 DW_AT_PGI_lstride = 0x3a02 | |
253 }; | |
254 | |
255 | |
256 // Line number opcodes. | |
257 public enum class DwarfLineNumberOps { | |
258 DW_LNS_extended_op = 0, | |
259 DW_LNS_copy = 1, | |
260 DW_LNS_advance_pc = 2, | |
261 DW_LNS_advance_line = 3, | |
262 DW_LNS_set_file = 4, | |
263 DW_LNS_set_column = 5, | |
264 DW_LNS_negate_stmt = 6, | |
265 DW_LNS_set_basic_block = 7, | |
266 DW_LNS_const_add_pc = 8, | |
267 DW_LNS_fixed_advance_pc = 9, | |
268 // DWARF 3. | |
269 DW_LNS_set_prologue_end = 10, | |
270 DW_LNS_set_epilogue_begin = 11, | |
271 DW_LNS_set_isa = 12 | |
272 }; | |
273 | |
274 // Line number extended opcodes. | |
275 public enum class DwarfLineNumberExtendedOps { | |
276 DW_LNE_end_sequence = 1, | |
277 DW_LNE_set_address = 2, | |
278 DW_LNE_define_file = 3, | |
279 // HP extensions. | |
280 DW_LNE_HP_negate_is_UV_update = 0x11, | |
281 DW_LNE_HP_push_context = 0x12, | |
282 DW_LNE_HP_pop_context = 0x13, | |
283 DW_LNE_HP_set_file_line_column = 0x14, | |
284 DW_LNE_HP_set_routine_name = 0x15, | |
285 DW_LNE_HP_set_sequence = 0x16, | |
286 DW_LNE_HP_negate_post_semantics = 0x17, | |
287 DW_LNE_HP_negate_function_exit = 0x18, | |
288 DW_LNE_HP_negate_front_end_logical = 0x19, | |
289 DW_LNE_HP_define_proc = 0x20 | |
290 }; | |
291 | |
292 // Type encoding names and codes | |
293 public enum class DwarfEncoding { | |
294 DW_ATE_address =0x1, | |
295 DW_ATE_boolean =0x2, | |
296 DW_ATE_complex_float =0x3, | |
297 DW_ATE_float =0x4, | |
298 DW_ATE_signed =0x5, | |
299 DW_ATE_signed_char =0x6, | |
300 DW_ATE_unsigned =0x7, | |
301 DW_ATE_unsigned_char =0x8, | |
302 // DWARF3/DWARF3f | |
303 DW_ATE_imaginary_float =0x9, | |
304 DW_ATE_packed_decimal =0xa, | |
305 DW_ATE_numeric_string =0xb, | |
306 DW_ATE_edited =0xc, | |
307 DW_ATE_signed_fixed =0xd, | |
308 DW_ATE_unsigned_fixed =0xe, | |
309 DW_ATE_decimal_float =0xf, | |
310 DW_ATE_lo_user =0x80, | |
311 DW_ATE_hi_user =0xff | |
312 }; | |
313 | |
314 // Location virtual machine opcodes | |
315 public enum class DwarfOpcode { | |
316 DW_OP_addr =0x03, | |
317 DW_OP_deref =0x06, | |
318 DW_OP_const1u =0x08, | |
319 DW_OP_const1s =0x09, | |
320 DW_OP_const2u =0x0a, | |
321 DW_OP_const2s =0x0b, | |
322 DW_OP_const4u =0x0c, | |
323 DW_OP_const4s =0x0d, | |
324 DW_OP_const8u =0x0e, | |
325 DW_OP_const8s =0x0f, | |
326 DW_OP_constu =0x10, | |
327 DW_OP_consts =0x11, | |
328 DW_OP_dup =0x12, | |
329 DW_OP_drop =0x13, | |
330 DW_OP_over =0x14, | |
331 DW_OP_pick =0x15, | |
332 DW_OP_swap =0x16, | |
333 DW_OP_rot =0x17, | |
334 DW_OP_xderef =0x18, | |
335 DW_OP_abs =0x19, | |
336 DW_OP_and =0x1a, | |
337 DW_OP_div =0x1b, | |
338 DW_OP_minus =0x1c, | |
339 DW_OP_mod =0x1d, | |
340 DW_OP_mul =0x1e, | |
341 DW_OP_neg =0x1f, | |
342 DW_OP_not =0x20, | |
343 DW_OP_or =0x21, | |
344 DW_OP_plus =0x22, | |
345 DW_OP_plus_uconst =0x23, | |
346 DW_OP_shl =0x24, | |
347 DW_OP_shr =0x25, | |
348 DW_OP_shra =0x26, | |
349 DW_OP_xor =0x27, | |
350 DW_OP_bra =0x28, | |
351 DW_OP_eq =0x29, | |
352 DW_OP_ge =0x2a, | |
353 DW_OP_gt =0x2b, | |
354 DW_OP_le =0x2c, | |
355 DW_OP_lt =0x2d, | |
356 DW_OP_ne =0x2e, | |
357 DW_OP_skip =0x2f, | |
358 DW_OP_lit0 =0x30, | |
359 DW_OP_lit1 =0x31, | |
360 DW_OP_lit2 =0x32, | |
361 DW_OP_lit3 =0x33, | |
362 DW_OP_lit4 =0x34, | |
363 DW_OP_lit5 =0x35, | |
364 DW_OP_lit6 =0x36, | |
365 DW_OP_lit7 =0x37, | |
366 DW_OP_lit8 =0x38, | |
367 DW_OP_lit9 =0x39, | |
368 DW_OP_lit10 =0x3a, | |
369 DW_OP_lit11 =0x3b, | |
370 DW_OP_lit12 =0x3c, | |
371 DW_OP_lit13 =0x3d, | |
372 DW_OP_lit14 =0x3e, | |
373 DW_OP_lit15 =0x3f, | |
374 DW_OP_lit16 =0x40, | |
375 DW_OP_lit17 =0x41, | |
376 DW_OP_lit18 =0x42, | |
377 DW_OP_lit19 =0x43, | |
378 DW_OP_lit20 =0x44, | |
379 DW_OP_lit21 =0x45, | |
380 DW_OP_lit22 =0x46, | |
381 DW_OP_lit23 =0x47, | |
382 DW_OP_lit24 =0x48, | |
383 DW_OP_lit25 =0x49, | |
384 DW_OP_lit26 =0x4a, | |
385 DW_OP_lit27 =0x4b, | |
386 DW_OP_lit28 =0x4c, | |
387 DW_OP_lit29 =0x4d, | |
388 DW_OP_lit30 =0x4e, | |
389 DW_OP_lit31 =0x4f, | |
390 DW_OP_reg0 =0x50, | |
391 DW_OP_reg1 =0x51, | |
392 DW_OP_reg2 =0x52, | |
393 DW_OP_reg3 =0x53, | |
394 DW_OP_reg4 =0x54, | |
395 DW_OP_reg5 =0x55, | |
396 DW_OP_reg6 =0x56, | |
397 DW_OP_reg7 =0x57, | |
398 DW_OP_reg8 =0x58, | |
399 DW_OP_reg9 =0x59, | |
400 DW_OP_reg10 =0x5a, | |
401 DW_OP_reg11 =0x5b, | |
402 DW_OP_reg12 =0x5c, | |
403 DW_OP_reg13 =0x5d, | |
404 DW_OP_reg14 =0x5e, | |
405 DW_OP_reg15 =0x5f, | |
406 DW_OP_reg16 =0x60, | |
407 DW_OP_reg17 =0x61, | |
408 DW_OP_reg18 =0x62, | |
409 DW_OP_reg19 =0x63, | |
410 DW_OP_reg20 =0x64, | |
411 DW_OP_reg21 =0x65, | |
412 DW_OP_reg22 =0x66, | |
413 DW_OP_reg23 =0x67, | |
414 DW_OP_reg24 =0x68, | |
415 DW_OP_reg25 =0x69, | |
416 DW_OP_reg26 =0x6a, | |
417 DW_OP_reg27 =0x6b, | |
418 DW_OP_reg28 =0x6c, | |
419 DW_OP_reg29 =0x6d, | |
420 DW_OP_reg30 =0x6e, | |
421 DW_OP_reg31 =0x6f, | |
422 DW_OP_breg0 =0x70, | |
423 DW_OP_breg1 =0x71, | |
424 DW_OP_breg2 =0x72, | |
425 DW_OP_breg3 =0x73, | |
426 DW_OP_breg4 =0x74, | |
427 DW_OP_breg5 =0x75, | |
428 DW_OP_breg6 =0x76, | |
429 DW_OP_breg7 =0x77, | |
430 DW_OP_breg8 =0x78, | |
431 DW_OP_breg9 =0x79, | |
432 DW_OP_breg10 =0x7a, | |
433 DW_OP_breg11 =0x7b, | |
434 DW_OP_breg12 =0x7c, | |
435 DW_OP_breg13 =0x7d, | |
436 DW_OP_breg14 =0x7e, | |
437 DW_OP_breg15 =0x7f, | |
438 DW_OP_breg16 =0x80, | |
439 DW_OP_breg17 =0x81, | |
440 DW_OP_breg18 =0x82, | |
441 DW_OP_breg19 =0x83, | |
442 DW_OP_breg20 =0x84, | |
443 DW_OP_breg21 =0x85, | |
444 DW_OP_breg22 =0x86, | |
445 DW_OP_breg23 =0x87, | |
446 DW_OP_breg24 =0x88, | |
447 DW_OP_breg25 =0x89, | |
448 DW_OP_breg26 =0x8a, | |
449 DW_OP_breg27 =0x8b, | |
450 DW_OP_breg28 =0x8c, | |
451 DW_OP_breg29 =0x8d, | |
452 DW_OP_breg30 =0x8e, | |
453 DW_OP_breg31 =0x8f, | |
454 DW_OP_regX =0x90, | |
455 DW_OP_fbreg =0x91, | |
456 DW_OP_bregX =0x92, | |
457 DW_OP_piece =0x93, | |
458 DW_OP_deref_size =0x94, | |
459 DW_OP_xderef_size =0x95, | |
460 DW_OP_nop =0x96, | |
461 // DWARF3/DWARF3f | |
462 DW_OP_push_object_address =0x97, | |
463 DW_OP_call2 =0x98, | |
464 DW_OP_call4 =0x99, | |
465 DW_OP_call_ref =0x9a, | |
466 DW_OP_form_tls_address =0x9b, | |
467 DW_OP_call_frame_cfa =0x9c, | |
468 DW_OP_bit_piece =0x9d, | |
469 DW_OP_lo_user =0xe0, | |
470 DW_OP_hi_user =0xff, | |
471 // GNU extensions | |
472 DW_OP_GNU_push_tls_address =0xe0 | |
473 }; | |
474 | |
475 // Source languages. These are values for DW_AT_language. | |
476 public enum class DwarfLanguage { | |
477 DW_LANG_none =0x0000, | |
478 DW_LANG_C89 =0x0001, | |
479 DW_LANG_C =0x0002, | |
480 DW_LANG_Ada83 =0x0003, | |
481 DW_LANG_C_plus_plus =0x0004, | |
482 DW_LANG_Cobol74 =0x0005, | |
483 DW_LANG_Cobol85 =0x0006, | |
484 DW_LANG_Fortran77 =0x0007, | |
485 DW_LANG_Fortran90 =0x0008, | |
486 DW_LANG_Pascal83 =0x0009, | |
487 DW_LANG_Modula2 =0x000a, | |
488 DW_LANG_Java =0x000b, | |
489 DW_LANG_C99 =0x000c, | |
490 DW_LANG_Ada95 =0x000d, | |
491 DW_LANG_Fortran95 =0x000e, | |
492 DW_LANG_PLI =0x000f, | |
493 DW_LANG_ObjC =0x0010, | |
494 DW_LANG_ObjC_plus_plus =0x0011, | |
495 DW_LANG_UPC =0x0012, | |
496 DW_LANG_D =0x0013, | |
497 // Implementation-defined language code range. | |
498 DW_LANG_lo_user = 0x8000, | |
499 DW_LANG_hi_user = 0xffff, | |
500 | |
501 // Extensions. | |
502 | |
503 // MIPS assembly language. The GNU toolchain uses this for all | |
504 // assembly languages, since there's no generic DW_LANG_ value for that. | |
505 // See include/dwarf2.h in the binutils, gdb, or gcc source trees. | |
506 DW_LANG_Mips_Assembler =0x8001, | |
507 DW_LANG_Upc =0x8765 // Unified Parallel C | |
508 }; | |
509 | |
510 // Inline codes. These are values for DW_AT_inline. | |
511 public enum class DwarfInline { | |
512 DW_INL_not_inlined =0x0, | |
513 DW_INL_inlined =0x1, | |
514 DW_INL_declared_not_inlined =0x2, | |
515 DW_INL_declared_inlined =0x3, | |
516 }; | |
517 | |
518 // Call Frame Info instructions. | |
519 public enum class DwarfCFI { | |
520 DW_CFA_advance_loc = 0x40, | |
521 DW_CFA_offset = 0x80, | |
522 DW_CFA_restore = 0xc0, | |
523 DW_CFA_nop = 0x00, | |
524 DW_CFA_set_loc = 0x01, | |
525 DW_CFA_advance_loc1 = 0x02, | |
526 DW_CFA_advance_loc2 = 0x03, | |
527 DW_CFA_advance_loc4 = 0x04, | |
528 DW_CFA_offset_extended = 0x05, | |
529 DW_CFA_restore_extended = 0x06, | |
530 DW_CFA_undefined = 0x07, | |
531 DW_CFA_same_value = 0x08, | |
532 DW_CFA_register = 0x09, | |
533 DW_CFA_remember_state = 0x0a, | |
534 DW_CFA_restore_state = 0x0b, | |
535 DW_CFA_def_cfa = 0x0c, | |
536 DW_CFA_def_cfa_register = 0x0d, | |
537 DW_CFA_def_cfa_offset = 0x0e, | |
538 DW_CFA_def_cfa_expression = 0x0f, | |
539 DW_CFA_expression = 0x10, | |
540 DW_CFA_offset_extended_sf = 0x11, | |
541 DW_CFA_def_cfa_sf = 0x12, | |
542 DW_CFA_def_cfa_offset_sf = 0x13, | |
543 DW_CFA_val_offset = 0x14, | |
544 DW_CFA_val_offset_sf = 0x15, | |
545 DW_CFA_val_expression = 0x16, | |
546 | |
547 // Opcodes in this range are reserved for user extensions. | |
548 DW_CFA_lo_user = 0x1c, | |
549 DW_CFA_hi_user = 0x3f, | |
550 | |
551 // SGI/MIPS specific. | |
552 DW_CFA_MIPS_advance_loc8 = 0x1d, | |
553 | |
554 // GNU extensions. | |
555 DW_CFA_GNU_window_save = 0x2d, | |
556 DW_CFA_GNU_args_size = 0x2e, | |
557 DW_CFA_GNU_negative_offset_extended = 0x2f | |
558 }; | |
559 | |
560 // Exception handling 'z' augmentation letters. | |
561 public enum class DwarfZAugmentationCodes { | |
562 // If the CFI augmentation string begins with 'z', then the CIE and FDE | |
563 // have an augmentation data area just before the instructions, whose | |
564 // contents are determined by the subsequent augmentation letters. | |
565 DW_Z_augmentation_start = 'z', | |
566 | |
567 // If this letter is present in a 'z' augmentation string, the CIE | |
568 // augmentation data includes a pointer encoding, and the FDE | |
569 // augmentation data includes a language-specific data area pointer, | |
570 // represented using that encoding. | |
571 DW_Z_has_LSDA = 'L', | |
572 | |
573 // If this letter is present in a 'z' augmentation string, the CIE | |
574 // augmentation data includes a pointer encoding, followed by a pointer | |
575 // to a personality routine, represented using that encoding. | |
576 DW_Z_has_personality_routine = 'P', | |
577 | |
578 // If this letter is present in a 'z' augmentation string, the CIE | |
579 // augmentation data includes a pointer encoding describing how the FDE's | |
580 // initial location, address range, and DW_CFA_set_loc operands are | |
581 // encoded. | |
582 DW_Z_has_FDE_address_encoding = 'R', | |
583 | |
584 // If this letter is present in a 'z' augmentation string, then code | |
585 // addresses covered by FDEs that cite this CIE are signal delivery | |
586 // trampolines. Return addresses of frames in trampolines should not be | |
587 // adjusted as described in section 6.4.4 of the DWARF 3 spec. | |
588 DW_Z_is_signal_trampoline = 'S' | |
589 }; | |
590 | |
591 // Exception handling frame description pointer formats, as described | |
592 // by the Linux Standard Base Core Specification 4.0, section 11.5, | |
593 // DWARF Extensions. | |
594 public enum class DwarfPointerEncoding { | |
595 DW_EH_PE_absptr = 0x00, | |
596 DW_EH_PE_omit = 0xff, | |
597 DW_EH_PE_uleb128 = 0x01, | |
598 DW_EH_PE_udata2 = 0x02, | |
599 DW_EH_PE_udata4 = 0x03, | |
600 DW_EH_PE_udata8 = 0x04, | |
601 DW_EH_PE_sleb128 = 0x09, | |
602 DW_EH_PE_sdata2 = 0x0A, | |
603 DW_EH_PE_sdata4 = 0x0B, | |
604 DW_EH_PE_sdata8 = 0x0C, | |
605 DW_EH_PE_pcrel = 0x10, | |
606 DW_EH_PE_textrel = 0x20, | |
607 DW_EH_PE_datarel = 0x30, | |
608 DW_EH_PE_funcrel = 0x40, | |
609 DW_EH_PE_aligned = 0x50, | |
610 | |
611 // The GNU toolchain sources define this public enum value as well, | |
612 // simply to help classify the lower nybble values into signed and | |
613 // unsigned groups. | |
614 DW_EH_PE_signed = 0x08, | |
615 | |
616 // This is not documented in LSB 4.0, but it is used in both the | |
617 // Linux and OS X toolchains. It can be added to any other | |
618 // encoding (except DW_EH_PE_aligned), and indicates that the | |
619 // encoded value represents the address at which the true address | |
620 // is stored, not the true address itself. | |
621 DW_EH_PE_indirect = 0x80 | |
622 }; | |
623 | |
624 public ref struct DwarfReference { | |
625 DwarfReference(uint64 offs) : offset(offs) {} | |
626 uint64 offset; | |
627 | |
628 virtual System::String^ ToString() override { | |
629 return System::String::Format("[{0}]", offset); } | |
630 }; | |
631 | |
632 /// <summary> | |
633 /// This class is responsible for assisting in parsing of the DWARF | |
634 /// information in a single compilation unit. The terminology, used | |
635 /// throughout the class, corresponds with the terminology found in | |
636 /// pre-existing DWARF documentation, particularly the spec: | |
637 /// http://dwarfstd.org/doc/dwarf-2.0.0.pdf | |
638 /// The DwarfReader's job is to build up the SymbolDatabase to be | |
639 /// referenced while debugging as the parser is readig the debugging | |
640 /// information out of the binary. | |
641 /// </summary> | |
642 public interface class IDwarfReader { | |
643 /// <summary> | |
644 /// Called when the DWARF parser encounters the start of a new | |
645 /// compilation unit. A compilation unit has at least one debugging | |
646 /// information entry (DIE) which indicates whether the compilation unit | |
647 /// is a normal or a partial compilation unit. In the code, a compilation | |
648 /// unit is something like a class, scope, function or template (partial). | |
649 /// </summary> | |
650 void StartCompilationUnit(); | |
651 | |
652 /// <summary> | |
653 /// Called when the DWARF parser encounters the end of a compilation unit. | |
654 /// </summary> | |
655 void EndCompilationUnit(); | |
656 | |
657 /// <summary> | |
658 /// This function is called by the parser when a new Debugging Information | |
659 /// Entry (DIE) is encountered in the debuggee. It adds an entry | |
660 /// to the SymbolDatabase, so that its attribute information can be added | |
661 /// as it is being parsed. | |
662 /// </summary> | |
663 /// <param name="parent"> | |
664 /// The key of the parent DIE, could be an outer scope, owning class, | |
665 /// etc... | |
666 /// </param> | |
667 /// <param name="offset"> | |
668 /// The address that denotes the start of this DIE and its lookup key from | |
669 /// this point onward. | |
670 /// </param> | |
671 /// <param name="tag"> | |
672 /// An enumeration defining the type of the DIE value. | |
673 /// </param> | |
674 void StartDIE(uint64 parent, uint64 offset, DwarfTag tag); | |
675 | |
676 /// <summary> | |
677 /// Ensure that the end of DIE is handled properly. | |
678 /// </summary> | |
679 /// <param name="offset"> | |
680 /// The offset (relative code address) of the DIE whose end has been | |
681 /// encountered. | |
682 /// </param> | |
683 void EndDIE(uint64 offset); | |
684 | |
685 /// <summary> | |
686 /// Associates the given attribute with the correct DIE's record. | |
687 /// </summary> | |
688 /// <param name="offset"> | |
689 /// The containing DIE's lookup key. | |
690 /// </param> | |
691 /// <param name="parent"> | |
692 /// The attribute's parent's key. In many cases the same as the | |
693 /// containing DIE. | |
694 /// </param> | |
695 /// <param name="attr"> | |
696 /// The attribute's type as defined by the DWARF spec. | |
697 /// </param> | |
698 /// <param name="data"> | |
699 /// The value of the attribute. | |
700 /// </param> | |
701 void ProcessAttribute( | |
702 uint64 offset, | |
703 uint64 parent, | |
704 DwarfAttribute attr, | |
705 System::Object^ data); | |
706 | |
707 /// <summary> | |
708 /// Adds knowledge of a source code directory. This will be used to create | |
709 /// file entries. | |
710 /// </summary> | |
711 /// <param name="name"> | |
712 /// The path of the dir, relative to the top of the project that is being | |
713 /// debugged. | |
714 /// </param> | |
715 /// <param name="dir_num"> | |
716 /// The directory will be indexed according to this parameter. | |
717 /// </param> | |
718 void DefineDir(System::String^ name, uint32 dir_num); | |
719 | |
720 /// <summary> | |
721 /// Adds knowledge of a source code file. | |
722 /// </summary> | |
723 /// <param name="name">The file's name.</param> | |
724 /// <param name="file_num"> | |
725 /// The file's will be indexed according to this parameter. | |
726 /// </param> | |
727 /// <param name="dir_num">The index of the parent directory.</param> | |
728 void DefineFile(System::String^ name, int32 file_num, | |
729 uint32 dir_num); | |
730 | |
731 /// <summary> | |
732 /// Called to add knowledge of a line of source code. The line ends up | |
733 /// being indexed by its code address. | |
734 /// </summary> | |
735 /// <param name="address">The code address of the line.</param> | |
736 /// <param name="length">The number of characters in the line.</param> | |
737 /// <param name="file_num">The key of the file that contains the line. | |
738 /// </param> | |
739 /// <param name="line_num">The number of the line in its code file.</param> | |
740 /// <param name="column_num">Indicates the column of the first character in | |
741 /// the line. | |
742 /// </param> | |
743 void AddLine(uint64 address, uint64 length, uint32 file_num, | |
744 uint32 line_num, uint32 column_num); | |
745 | |
746 /// <summary> | |
747 /// Adds a location of a particular piece of data to the code. Note that | |
748 /// there is a many to one mapping between code locations and data. For | |
749 /// example, a variable can be referenced multiple times. | |
750 /// </summary> | |
751 /// <param name="offset">The address of the data, which is used as an index | |
752 /// into the code.</param> | |
753 /// <param name="is_first_entry">Whether this is the first time this data | |
754 /// has been encountered in the code. | |
755 /// </param> | |
756 /// <param name="low_pc"> | |
757 /// The beginning of the code that references the data.</param> | |
758 /// <param name="high_pc"> | |
759 /// The end of the code that references the data.</param> | |
760 /// <param name="data">The data itself.</param> | |
761 void AddLocListEntry( | |
762 uint64 offset, | |
763 bool is_first_entry, | |
764 uint64 low_pc, | |
765 uint64 high_pc, | |
766 array<System::Byte>^ data); | |
767 | |
768 /// <summary> | |
769 /// There are various implementations of Call Frames in different | |
770 /// architectures. DWARF uses a single table type for its call frame | |
771 /// information descriptor, but allows the exact implementation to be | |
772 /// specified by call frame rules, that specify how any given register is | |
773 /// used/modified by the call frame. | |
774 /// IMPORTANT: this enum MUST be kept in sync with the unmanaged | |
775 /// CFI_RuleType enum in dwarf_reader.h!! | |
776 /// </summary> | |
777 enum class CfiRuleType { | |
778 Undefined, | |
779 SameValue, | |
780 Offset, | |
781 ValOffset, | |
782 Register, | |
783 Expression, | |
784 ValExpression, | |
785 }; | |
786 | |
787 /// <summary> | |
788 /// Starts a new call frame information (CFI) entry. This may be populated | |
789 /// with CFI Rules, until EndCfiEntry is called. | |
790 /// </summary> | |
791 /// <param name="address">The location of the CFI in the binary.</param> | |
792 /// <returns> | |
793 /// True if the call frame has been successfully registered. | |
794 /// </returns> | |
795 virtual bool BeginCfiEntry(uint64 address); | |
796 | |
797 /// <summary> | |
798 /// Adds a rule to the currently active CFI. | |
799 /// </summary> | |
800 /// <param name="address">The rule's address on the call stack.</param> | |
801 /// <param name="register_id">The rule's register id.</param> | |
802 /// <param name="rule_type"> | |
803 /// See description for rule_type and the DWARF spec. This determines how | |
804 /// the other argumets can be used to determine call frame state. | |
805 /// </param> | |
806 /// <param name="base_register"> | |
807 /// The index of the base_register (for example 15 for Native Client) | |
808 /// </param> | |
809 /// <param name="offset"> | |
810 /// When the rule_type is "Offset" the previous frame address at runtime can | |
811 /// be calculated by adding this offset to the value of the base_register. | |
812 /// </param> | |
813 /// <param name="expression"> | |
814 /// The rule_type determines how this data field is to be used. | |
815 /// </param> | |
816 /// <returns> True if the rule has been added to the call frame information | |
817 /// entry that is currently being parsed. | |
818 /// </returns> | |
819 virtual bool AddCfiRule( | |
820 uint64 address, | |
821 int register_id, | |
822 CfiRuleType rule_type, | |
823 int base_register, | |
824 int32 offset, | |
825 array<System::Byte>^ expression); | |
826 | |
827 /// <summary> | |
828 /// Called to notify the DwarfReader that the end of a CFI has been reached. | |
829 /// </summary> | |
830 virtual bool EndCfiEntry(); | |
831 | |
832 virtual void AddRangeListEntry(uint64 offset, | |
833 uint64 base_address, | |
834 uint64 low_pc, | |
835 uint64 high_pc); | |
836 }; | |
837 | |
838 public interface class IDwarfVM { | |
839 uint32_t BitWidth(); | |
840 bool IsLSB(); | |
841 void ErrorString(System::String^ str); | |
842 | |
843 uint64_t ReadRegister(int reg_number); | |
844 uint64_t ReadMemory(uint64_t address, int count); | |
845 uint64_t ReadFrameBase(); | |
846 }; | |
847 | |
848 public ref class DwarfParser { | |
849 public: | |
850 static void DwarfParseElf(System::String^ filename, IDwarfReader^ reader); | |
851 static uint64_t DwarfParseVM(IDwarfVM^ vm, array<System::Byte>^ data); | |
852 }; | |
853 | |
854 } // namespace NaClVsx | |
855 | |
OLD | NEW |