Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(230)

Side by Side Diff: experimental/visual_studio_plugin/src/NaClVsx.DebugHelpers/DwarfParser.h

Issue 10928195: First round of dead file removal (Closed) Base URL: https://github.com/samclegg/nativeclient-sdk.git@master
Patch Set: Created 8 years, 3 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
OLDNEW
(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
OLDNEW

Powered by Google App Engine
This is Rietveld 408576698