1 // This file originally from https://github.com/philipc/rust-dwarf/ and
2 // distributed under either MIT or Apache 2.0 licenses.
3 //
4 // Copyright 2016 The rust-dwarf Developers
5 //
6 // Licensed under the Apache License, Version 2.0 (the "License");
7 // you may not use this file except in compliance with the License.
8 // You may obtain a copy of the License at
9 //
10 //     https://www.apache.org/licenses/LICENSE-2.0
11 //
12 // Unless required by applicable law or agreed to in writing, software
13 // distributed under the License is distributed on an "AS IS" BASIS,
14 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 // See the License for the specific language governing permissions and
16 // limitations under the License.
17 
18 //! Constant definitions.
19 //!
20 //! The DWARF spec's `DW_AT_*` type is represented as `struct DwAt(u16)`,
21 //! `DW_FORM_*` as `DwForm(u16)`, etc.
22 //!
23 //! There are also exported const definitions for each constant.
24 
25 #![allow(non_upper_case_globals)]
26 #![allow(missing_docs)]
27 
28 use core::fmt;
29 
30 // The `dw!` macro turns this:
31 //
32 //     dw!(DwFoo(u32) {
33 //         DW_FOO_bar = 0,
34 //         DW_FOO_baz = 1,
35 //         DW_FOO_bang = 2,
36 //     });
37 //
38 // into this:
39 //
40 //     #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, PartialOrd, Ord)]
41 //     pub struct DwFoo(pub u32);
42 //
43 //     pub const DW_FOO_bar: DwFoo = DwFoo(0);
44 //     pub const DW_FOO_baz: DwFoo = DwFoo(1);
45 //     pub const DW_FOO_bang: DwFoo = DwFoo(2);
46 //
47 //     impl DwFoo {
48 //         pub fn static_string(&self) -> Option<&'static str> {
49 //             ...
50 //         }
51 //     }
52 //
53 //     impl fmt::Display for DwFoo {
54 //         fn fmt(&self, f: &mut fmt::Formatter) -> Result<(), fmt::Error> {
55 //             ...
56 //         }
57 //     }
58 macro_rules! dw {
59     ($(#[$meta:meta])* $struct_name:ident($struct_type:ty) { $($name:ident = $val:expr),+ $(,)? }) => {
60         $(#[$meta])*
61         #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, PartialOrd, Ord)]
62         pub struct $struct_name(pub $struct_type);
63 
64         $(
65             pub const $name: $struct_name = $struct_name($val);
66         )+
67 
68         impl $struct_name {
69             pub fn static_string(&self) -> Option<&'static str> {
70                 Some(match *self {
71                     $(
72                         $name => stringify!($name),
73                     )+
74                     _ => return None,
75                 })
76             }
77         }
78 
79         impl fmt::Display for $struct_name {
80             fn fmt(&self, f: &mut fmt::Formatter) -> Result<(), fmt::Error> {
81                 if let Some(s) = self.static_string() {
82                     f.pad(s)
83                 } else {
84                     #[cfg(feature = "read")]
85                     {
86                         f.pad(&format!("Unknown {}: {}", stringify!($struct_name), self.0))
87                     }
88                     #[cfg(not(feature = "read"))]
89                     {
90                         write!(f, "Unknown {}: {}", stringify!($struct_name), self.0)
91                     }
92                 }
93             }
94         }
95     };
96 }
97 
98 dw!(
99 /// The section type field in a `.dwp` unit index.
100 ///
101 /// This is used for version 5 and later.
102 ///
103 /// See Section 7.3.5.
104 DwSect(u32) {
105     DW_SECT_INFO = 1,
106     DW_SECT_ABBREV = 3,
107     DW_SECT_LINE = 4,
108     DW_SECT_LOCLISTS = 5,
109     DW_SECT_STR_OFFSETS = 6,
110     DW_SECT_MACRO = 7,
111     DW_SECT_RNGLISTS = 8,
112 });
113 
114 dw!(
115 /// The section type field in a `.dwp` unit index with version 2.
116 DwSectV2(u32) {
117     DW_SECT_V2_INFO = 1,
118     DW_SECT_V2_TYPES = 2,
119     DW_SECT_V2_ABBREV = 3,
120     DW_SECT_V2_LINE = 4,
121     DW_SECT_V2_LOC = 5,
122     DW_SECT_V2_STR_OFFSETS = 6,
123     DW_SECT_V2_MACINFO = 7,
124     DW_SECT_V2_MACRO = 8,
125 });
126 
127 dw!(
128 /// The unit type field in a unit header.
129 ///
130 /// See Section 7.5.1, Table 7.2.
131 DwUt(u8) {
132     DW_UT_compile = 0x01,
133     DW_UT_type = 0x02,
134     DW_UT_partial = 0x03,
135     DW_UT_skeleton = 0x04,
136     DW_UT_split_compile = 0x05,
137     DW_UT_split_type = 0x06,
138     DW_UT_lo_user = 0x80,
139     DW_UT_hi_user = 0xff,
140 });
141 
142 dw!(
143 /// The opcode for a call frame instruction.
144 ///
145 /// Section 7.24:
146 /// > Call frame instructions are encoded in one or more bytes. The primary
147 /// > opcode is encoded in the high order two bits of the first byte (that is,
148 /// > opcode = byte >> 6). An operand or extended opcode may be encoded in the
149 /// > low order 6 bits. Additional operands are encoded in subsequent bytes.
150 DwCfa(u8) {
151     DW_CFA_advance_loc = 0x01 << 6,
152     DW_CFA_offset = 0x02 << 6,
153     DW_CFA_restore = 0x03 << 6,
154     DW_CFA_nop = 0,
155     DW_CFA_set_loc = 0x01,
156     DW_CFA_advance_loc1 = 0x02,
157     DW_CFA_advance_loc2 = 0x03,
158     DW_CFA_advance_loc4 = 0x04,
159     DW_CFA_offset_extended = 0x05,
160     DW_CFA_restore_extended = 0x06,
161     DW_CFA_undefined = 0x07,
162     DW_CFA_same_value = 0x08,
163     DW_CFA_register = 0x09,
164     DW_CFA_remember_state = 0x0a,
165     DW_CFA_restore_state = 0x0b,
166     DW_CFA_def_cfa = 0x0c,
167     DW_CFA_def_cfa_register = 0x0d,
168     DW_CFA_def_cfa_offset = 0x0e,
169     DW_CFA_def_cfa_expression = 0x0f,
170     DW_CFA_expression = 0x10,
171     DW_CFA_offset_extended_sf = 0x11,
172     DW_CFA_def_cfa_sf = 0x12,
173     DW_CFA_def_cfa_offset_sf = 0x13,
174     DW_CFA_val_offset = 0x14,
175     DW_CFA_val_offset_sf = 0x15,
176     DW_CFA_val_expression = 0x16,
177 
178     DW_CFA_lo_user = 0x1c,
179     DW_CFA_hi_user = 0x3f,
180 
181     DW_CFA_MIPS_advance_loc8 = 0x1d,
182     DW_CFA_GNU_window_save = 0x2d,
183     DW_CFA_GNU_args_size = 0x2e,
184     DW_CFA_GNU_negative_offset_extended = 0x2f,
185 });
186 
187 dw!(
188 /// The child determination encodings for DIE attributes.
189 ///
190 /// See Section 7.5.3, Table 7.4.
191 DwChildren(u8) {
192     DW_CHILDREN_no = 0,
193     DW_CHILDREN_yes = 1,
194 });
195 
196 dw!(
197 /// The tag encodings for DIE attributes.
198 ///
199 /// See Section 7.5.3, Table 7.3.
200 DwTag(u16) {
201     DW_TAG_null = 0x00,
202 
203     DW_TAG_array_type = 0x01,
204     DW_TAG_class_type = 0x02,
205     DW_TAG_entry_point = 0x03,
206     DW_TAG_enumeration_type = 0x04,
207     DW_TAG_formal_parameter = 0x05,
208     DW_TAG_imported_declaration = 0x08,
209     DW_TAG_label = 0x0a,
210     DW_TAG_lexical_block = 0x0b,
211     DW_TAG_member = 0x0d,
212     DW_TAG_pointer_type = 0x0f,
213     DW_TAG_reference_type = 0x10,
214     DW_TAG_compile_unit = 0x11,
215     DW_TAG_string_type = 0x12,
216     DW_TAG_structure_type = 0x13,
217     DW_TAG_subroutine_type = 0x15,
218     DW_TAG_typedef = 0x16,
219     DW_TAG_union_type = 0x17,
220     DW_TAG_unspecified_parameters = 0x18,
221     DW_TAG_variant = 0x19,
222     DW_TAG_common_block = 0x1a,
223     DW_TAG_common_inclusion = 0x1b,
224     DW_TAG_inheritance = 0x1c,
225     DW_TAG_inlined_subroutine = 0x1d,
226     DW_TAG_module = 0x1e,
227     DW_TAG_ptr_to_member_type = 0x1f,
228     DW_TAG_set_type = 0x20,
229     DW_TAG_subrange_type = 0x21,
230     DW_TAG_with_stmt = 0x22,
231     DW_TAG_access_declaration = 0x23,
232     DW_TAG_base_type = 0x24,
233     DW_TAG_catch_block = 0x25,
234     DW_TAG_const_type = 0x26,
235     DW_TAG_constant = 0x27,
236     DW_TAG_enumerator = 0x28,
237     DW_TAG_file_type = 0x29,
238     DW_TAG_friend = 0x2a,
239     DW_TAG_namelist = 0x2b,
240     DW_TAG_namelist_item = 0x2c,
241     DW_TAG_packed_type = 0x2d,
242     DW_TAG_subprogram = 0x2e,
243     DW_TAG_template_type_parameter = 0x2f,
244     DW_TAG_template_value_parameter = 0x30,
245     DW_TAG_thrown_type = 0x31,
246     DW_TAG_try_block = 0x32,
247     DW_TAG_variant_part = 0x33,
248     DW_TAG_variable = 0x34,
249     DW_TAG_volatile_type = 0x35,
250 
251 // DWARF 3.
252     DW_TAG_dwarf_procedure = 0x36,
253     DW_TAG_restrict_type = 0x37,
254     DW_TAG_interface_type = 0x38,
255     DW_TAG_namespace = 0x39,
256     DW_TAG_imported_module = 0x3a,
257     DW_TAG_unspecified_type = 0x3b,
258     DW_TAG_partial_unit = 0x3c,
259     DW_TAG_imported_unit = 0x3d,
260     DW_TAG_condition = 0x3f,
261     DW_TAG_shared_type = 0x40,
262 
263 // DWARF 4.
264     DW_TAG_type_unit = 0x41,
265     DW_TAG_rvalue_reference_type = 0x42,
266     DW_TAG_template_alias = 0x43,
267 
268 // DWARF 5.
269     DW_TAG_coarray_type = 0x44,
270     DW_TAG_generic_subrange = 0x45,
271     DW_TAG_dynamic_type = 0x46,
272     DW_TAG_atomic_type = 0x47,
273     DW_TAG_call_site = 0x48,
274     DW_TAG_call_site_parameter = 0x49,
275     DW_TAG_skeleton_unit = 0x4a,
276     DW_TAG_immutable_type = 0x4b,
277 
278     DW_TAG_lo_user = 0x4080,
279     DW_TAG_hi_user = 0xffff,
280 
281 // SGI/MIPS extensions.
282     DW_TAG_MIPS_loop = 0x4081,
283 
284 // HP extensions.
285     DW_TAG_HP_array_descriptor = 0x4090,
286     DW_TAG_HP_Bliss_field = 0x4091,
287     DW_TAG_HP_Bliss_field_set = 0x4092,
288 
289 // GNU extensions.
290     DW_TAG_format_label = 0x4101,
291     DW_TAG_function_template = 0x4102,
292     DW_TAG_class_template = 0x4103,
293     DW_TAG_GNU_BINCL = 0x4104,
294     DW_TAG_GNU_EINCL = 0x4105,
295     DW_TAG_GNU_template_template_param = 0x4106,
296     DW_TAG_GNU_template_parameter_pack = 0x4107,
297     DW_TAG_GNU_formal_parameter_pack = 0x4108,
298     DW_TAG_GNU_call_site = 0x4109,
299     DW_TAG_GNU_call_site_parameter = 0x410a,
300 
301     DW_TAG_APPLE_property = 0x4200,
302 
303 // SUN extensions.
304     DW_TAG_SUN_function_template = 0x4201,
305     DW_TAG_SUN_class_template = 0x4202,
306     DW_TAG_SUN_struct_template = 0x4203,
307     DW_TAG_SUN_union_template = 0x4204,
308     DW_TAG_SUN_indirect_inheritance = 0x4205,
309     DW_TAG_SUN_codeflags = 0x4206,
310     DW_TAG_SUN_memop_info = 0x4207,
311     DW_TAG_SUN_omp_child_func = 0x4208,
312     DW_TAG_SUN_rtti_descriptor = 0x4209,
313     DW_TAG_SUN_dtor_info = 0x420a,
314     DW_TAG_SUN_dtor = 0x420b,
315     DW_TAG_SUN_f90_interface = 0x420c,
316     DW_TAG_SUN_fortran_vax_structure = 0x420d,
317 
318 // ALTIUM extensions.
319     DW_TAG_ALTIUM_circ_type = 0x5101,
320     DW_TAG_ALTIUM_mwa_circ_type = 0x5102,
321     DW_TAG_ALTIUM_rev_carry_type = 0x5103,
322     DW_TAG_ALTIUM_rom = 0x5111,
323 
324 // Extensions for UPC.
325     DW_TAG_upc_shared_type = 0x8765,
326     DW_TAG_upc_strict_type = 0x8766,
327     DW_TAG_upc_relaxed_type = 0x8767,
328 
329 // PGI (STMicroelectronics) extensions.
330     DW_TAG_PGI_kanji_type = 0xa000,
331     DW_TAG_PGI_interface_block = 0xa020,
332 
333 // Borland extensions.
334     DW_TAG_BORLAND_property = 0xb000,
335     DW_TAG_BORLAND_Delphi_string = 0xb001,
336     DW_TAG_BORLAND_Delphi_dynamic_array = 0xb002,
337     DW_TAG_BORLAND_Delphi_set = 0xb003,
338     DW_TAG_BORLAND_Delphi_variant = 0xb004,
339 });
340 
341 dw!(
342 /// The attribute encodings for DIE attributes.
343 ///
344 /// See Section 7.5.4, Table 7.5.
345 DwAt(u16) {
346     DW_AT_null = 0x00,
347 
348     DW_AT_sibling = 0x01,
349     DW_AT_location = 0x02,
350     DW_AT_name = 0x03,
351     DW_AT_ordering = 0x09,
352     DW_AT_byte_size = 0x0b,
353     DW_AT_bit_offset = 0x0c,
354     DW_AT_bit_size = 0x0d,
355     DW_AT_stmt_list = 0x10,
356     DW_AT_low_pc = 0x11,
357     DW_AT_high_pc = 0x12,
358     DW_AT_language = 0x13,
359     DW_AT_discr = 0x15,
360     DW_AT_discr_value = 0x16,
361     DW_AT_visibility = 0x17,
362     DW_AT_import = 0x18,
363     DW_AT_string_length = 0x19,
364     DW_AT_common_reference = 0x1a,
365     DW_AT_comp_dir = 0x1b,
366     DW_AT_const_value = 0x1c,
367     DW_AT_containing_type = 0x1d,
368     DW_AT_default_value = 0x1e,
369     DW_AT_inline = 0x20,
370     DW_AT_is_optional = 0x21,
371     DW_AT_lower_bound = 0x22,
372     DW_AT_producer = 0x25,
373     DW_AT_prototyped = 0x27,
374     DW_AT_return_addr = 0x2a,
375     DW_AT_start_scope = 0x2c,
376     DW_AT_bit_stride = 0x2e,
377     DW_AT_upper_bound = 0x2f,
378     DW_AT_abstract_origin = 0x31,
379     DW_AT_accessibility = 0x32,
380     DW_AT_address_class = 0x33,
381     DW_AT_artificial = 0x34,
382     DW_AT_base_types = 0x35,
383     DW_AT_calling_convention = 0x36,
384     DW_AT_count = 0x37,
385     DW_AT_data_member_location = 0x38,
386     DW_AT_decl_column = 0x39,
387     DW_AT_decl_file = 0x3a,
388     DW_AT_decl_line = 0x3b,
389     DW_AT_declaration = 0x3c,
390     DW_AT_discr_list = 0x3d,
391     DW_AT_encoding = 0x3e,
392     DW_AT_external = 0x3f,
393     DW_AT_frame_base = 0x40,
394     DW_AT_friend = 0x41,
395     DW_AT_identifier_case = 0x42,
396     DW_AT_macro_info = 0x43,
397     DW_AT_namelist_item = 0x44,
398     DW_AT_priority = 0x45,
399     DW_AT_segment = 0x46,
400     DW_AT_specification = 0x47,
401     DW_AT_static_link = 0x48,
402     DW_AT_type = 0x49,
403     DW_AT_use_location = 0x4a,
404     DW_AT_variable_parameter = 0x4b,
405     DW_AT_virtuality = 0x4c,
406     DW_AT_vtable_elem_location = 0x4d,
407 
408 // DWARF 3.
409     DW_AT_allocated = 0x4e,
410     DW_AT_associated = 0x4f,
411     DW_AT_data_location = 0x50,
412     DW_AT_byte_stride = 0x51,
413     DW_AT_entry_pc = 0x52,
414     DW_AT_use_UTF8 = 0x53,
415     DW_AT_extension = 0x54,
416     DW_AT_ranges = 0x55,
417     DW_AT_trampoline = 0x56,
418     DW_AT_call_column = 0x57,
419     DW_AT_call_file = 0x58,
420     DW_AT_call_line = 0x59,
421     DW_AT_description = 0x5a,
422     DW_AT_binary_scale = 0x5b,
423     DW_AT_decimal_scale = 0x5c,
424     DW_AT_small = 0x5d,
425     DW_AT_decimal_sign = 0x5e,
426     DW_AT_digit_count = 0x5f,
427     DW_AT_picture_string = 0x60,
428     DW_AT_mutable = 0x61,
429     DW_AT_threads_scaled = 0x62,
430     DW_AT_explicit = 0x63,
431     DW_AT_object_pointer = 0x64,
432     DW_AT_endianity = 0x65,
433     DW_AT_elemental = 0x66,
434     DW_AT_pure = 0x67,
435     DW_AT_recursive = 0x68,
436 
437 // DWARF 4.
438     DW_AT_signature = 0x69,
439     DW_AT_main_subprogram = 0x6a,
440     DW_AT_data_bit_offset = 0x6b,
441     DW_AT_const_expr = 0x6c,
442     DW_AT_enum_class = 0x6d,
443     DW_AT_linkage_name = 0x6e,
444 
445 // DWARF 5.
446     DW_AT_string_length_bit_size = 0x6f,
447     DW_AT_string_length_byte_size = 0x70,
448     DW_AT_rank = 0x71,
449     DW_AT_str_offsets_base = 0x72,
450     DW_AT_addr_base = 0x73,
451     DW_AT_rnglists_base = 0x74,
452     DW_AT_dwo_name = 0x76,
453     DW_AT_reference = 0x77,
454     DW_AT_rvalue_reference = 0x78,
455     DW_AT_macros = 0x79,
456     DW_AT_call_all_calls = 0x7a,
457     DW_AT_call_all_source_calls = 0x7b,
458     DW_AT_call_all_tail_calls = 0x7c,
459     DW_AT_call_return_pc = 0x7d,
460     DW_AT_call_value = 0x7e,
461     DW_AT_call_origin = 0x7f,
462     DW_AT_call_parameter = 0x80,
463     DW_AT_call_pc = 0x81,
464     DW_AT_call_tail_call = 0x82,
465     DW_AT_call_target = 0x83,
466     DW_AT_call_target_clobbered = 0x84,
467     DW_AT_call_data_location = 0x85,
468     DW_AT_call_data_value = 0x86,
469     DW_AT_noreturn = 0x87,
470     DW_AT_alignment = 0x88,
471     DW_AT_export_symbols = 0x89,
472     DW_AT_deleted = 0x8a,
473     DW_AT_defaulted = 0x8b,
474     DW_AT_loclists_base = 0x8c,
475 
476     DW_AT_lo_user = 0x2000,
477     DW_AT_hi_user = 0x3fff,
478 
479 // SGI/MIPS extensions.
480     DW_AT_MIPS_fde = 0x2001,
481     DW_AT_MIPS_loop_begin = 0x2002,
482     DW_AT_MIPS_tail_loop_begin = 0x2003,
483     DW_AT_MIPS_epilog_begin = 0x2004,
484     DW_AT_MIPS_loop_unroll_factor = 0x2005,
485     DW_AT_MIPS_software_pipeline_depth = 0x2006,
486     DW_AT_MIPS_linkage_name = 0x2007,
487     DW_AT_MIPS_stride = 0x2008,
488     DW_AT_MIPS_abstract_name = 0x2009,
489     DW_AT_MIPS_clone_origin = 0x200a,
490     DW_AT_MIPS_has_inlines = 0x200b,
491     DW_AT_MIPS_stride_byte = 0x200c,
492     DW_AT_MIPS_stride_elem = 0x200d,
493     DW_AT_MIPS_ptr_dopetype = 0x200e,
494     DW_AT_MIPS_allocatable_dopetype = 0x200f,
495     DW_AT_MIPS_assumed_shape_dopetype = 0x2010,
496 
497 // This one appears to have only been implemented by Open64 for
498 // fortran and may conflict with other extensions.
499     DW_AT_MIPS_assumed_size = 0x2011,
500 
501 // TODO: HP/CPQ extensions.
502 // These conflict with the MIPS extensions.
503 
504     DW_AT_INTEL_other_endian = 0x2026,
505 
506 // GNU extensions
507     DW_AT_sf_names = 0x2101,
508     DW_AT_src_info = 0x2102,
509     DW_AT_mac_info = 0x2103,
510     DW_AT_src_coords = 0x2104,
511     DW_AT_body_begin = 0x2105,
512     DW_AT_body_end = 0x2106,
513     DW_AT_GNU_vector = 0x2107,
514     DW_AT_GNU_guarded_by = 0x2108,
515     DW_AT_GNU_pt_guarded_by = 0x2109,
516     DW_AT_GNU_guarded = 0x210a,
517     DW_AT_GNU_pt_guarded = 0x210b,
518     DW_AT_GNU_locks_excluded = 0x210c,
519     DW_AT_GNU_exclusive_locks_required = 0x210d,
520     DW_AT_GNU_shared_locks_required = 0x210e,
521     DW_AT_GNU_odr_signature = 0x210f,
522     DW_AT_GNU_template_name = 0x2110,
523     DW_AT_GNU_call_site_value = 0x2111,
524     DW_AT_GNU_call_site_data_value = 0x2112,
525     DW_AT_GNU_call_site_target = 0x2113,
526     DW_AT_GNU_call_site_target_clobbered = 0x2114,
527     DW_AT_GNU_tail_call = 0x2115,
528     DW_AT_GNU_all_tail_call_sites = 0x2116,
529     DW_AT_GNU_all_call_sites = 0x2117,
530     DW_AT_GNU_all_source_call_sites = 0x2118,
531     DW_AT_GNU_macros = 0x2119,
532 
533 // Extensions for Fission proposal.
534     DW_AT_GNU_dwo_name = 0x2130,
535     DW_AT_GNU_dwo_id = 0x2131,
536     DW_AT_GNU_ranges_base = 0x2132,
537     DW_AT_GNU_addr_base = 0x2133,
538     DW_AT_GNU_pubnames = 0x2134,
539     DW_AT_GNU_pubtypes = 0x2135,
540     DW_AT_GNU_discriminator = 0x2136,
541     DW_AT_GNU_locviews = 0x2137,
542     DW_AT_GNU_entry_view = 0x2138,
543 
544 // Conflict with Sun.
545 // DW_AT_VMS_rtnbeg_pd_address = 0x2201,
546 
547 // Sun extensions.
548     DW_AT_SUN_template = 0x2201,
549     DW_AT_SUN_alignment = 0x2202,
550     DW_AT_SUN_vtable = 0x2203,
551     DW_AT_SUN_count_guarantee = 0x2204,
552     DW_AT_SUN_command_line = 0x2205,
553     DW_AT_SUN_vbase = 0x2206,
554     DW_AT_SUN_compile_options = 0x2207,
555     DW_AT_SUN_language = 0x2208,
556     DW_AT_SUN_browser_file = 0x2209,
557     DW_AT_SUN_vtable_abi = 0x2210,
558     DW_AT_SUN_func_offsets = 0x2211,
559     DW_AT_SUN_cf_kind = 0x2212,
560     DW_AT_SUN_vtable_index = 0x2213,
561     DW_AT_SUN_omp_tpriv_addr = 0x2214,
562     DW_AT_SUN_omp_child_func = 0x2215,
563     DW_AT_SUN_func_offset = 0x2216,
564     DW_AT_SUN_memop_type_ref = 0x2217,
565     DW_AT_SUN_profile_id = 0x2218,
566     DW_AT_SUN_memop_signature = 0x2219,
567     DW_AT_SUN_obj_dir = 0x2220,
568     DW_AT_SUN_obj_file = 0x2221,
569     DW_AT_SUN_original_name = 0x2222,
570     DW_AT_SUN_hwcprof_signature = 0x2223,
571     DW_AT_SUN_amd64_parmdump = 0x2224,
572     DW_AT_SUN_part_link_name = 0x2225,
573     DW_AT_SUN_link_name = 0x2226,
574     DW_AT_SUN_pass_with_const = 0x2227,
575     DW_AT_SUN_return_with_const = 0x2228,
576     DW_AT_SUN_import_by_name = 0x2229,
577     DW_AT_SUN_f90_pointer = 0x222a,
578     DW_AT_SUN_pass_by_ref = 0x222b,
579     DW_AT_SUN_f90_allocatable = 0x222c,
580     DW_AT_SUN_f90_assumed_shape_array = 0x222d,
581     DW_AT_SUN_c_vla = 0x222e,
582     DW_AT_SUN_return_value_ptr = 0x2230,
583     DW_AT_SUN_dtor_start = 0x2231,
584     DW_AT_SUN_dtor_length = 0x2232,
585     DW_AT_SUN_dtor_state_initial = 0x2233,
586     DW_AT_SUN_dtor_state_final = 0x2234,
587     DW_AT_SUN_dtor_state_deltas = 0x2235,
588     DW_AT_SUN_import_by_lname = 0x2236,
589     DW_AT_SUN_f90_use_only = 0x2237,
590     DW_AT_SUN_namelist_spec = 0x2238,
591     DW_AT_SUN_is_omp_child_func = 0x2239,
592     DW_AT_SUN_fortran_main_alias = 0x223a,
593     DW_AT_SUN_fortran_based = 0x223b,
594 
595     DW_AT_ALTIUM_loclist = 0x2300,
596 
597     DW_AT_use_GNAT_descriptive_type = 0x2301,
598     DW_AT_GNAT_descriptive_type = 0x2302,
599     DW_AT_GNU_numerator = 0x2303,
600     DW_AT_GNU_denominator = 0x2304,
601     DW_AT_GNU_bias = 0x2305,
602 
603     DW_AT_upc_threads_scaled = 0x3210,
604 
605 // PGI (STMicroelectronics) extensions.
606     DW_AT_PGI_lbase = 0x3a00,
607     DW_AT_PGI_soffset = 0x3a01,
608     DW_AT_PGI_lstride = 0x3a02,
609 
610 // Borland extensions.
611     DW_AT_BORLAND_property_read = 0x3b11,
612     DW_AT_BORLAND_property_write = 0x3b12,
613     DW_AT_BORLAND_property_implements = 0x3b13,
614     DW_AT_BORLAND_property_index = 0x3b14,
615     DW_AT_BORLAND_property_default = 0x3b15,
616     DW_AT_BORLAND_Delphi_unit = 0x3b20,
617     DW_AT_BORLAND_Delphi_class = 0x3b21,
618     DW_AT_BORLAND_Delphi_record = 0x3b22,
619     DW_AT_BORLAND_Delphi_metaclass = 0x3b23,
620     DW_AT_BORLAND_Delphi_constructor = 0x3b24,
621     DW_AT_BORLAND_Delphi_destructor = 0x3b25,
622     DW_AT_BORLAND_Delphi_anonymous_method = 0x3b26,
623     DW_AT_BORLAND_Delphi_interface = 0x3b27,
624     DW_AT_BORLAND_Delphi_ABI = 0x3b28,
625     DW_AT_BORLAND_Delphi_return = 0x3b29,
626     DW_AT_BORLAND_Delphi_frameptr = 0x3b30,
627     DW_AT_BORLAND_closure = 0x3b31,
628 
629 // LLVM project extensions.
630     DW_AT_LLVM_include_path = 0x3e00,
631     DW_AT_LLVM_config_macros = 0x3e01,
632     DW_AT_LLVM_isysroot = 0x3e02,
633 
634 // Apple extensions.
635     DW_AT_APPLE_optimized = 0x3fe1,
636     DW_AT_APPLE_flags = 0x3fe2,
637     DW_AT_APPLE_isa = 0x3fe3,
638     DW_AT_APPLE_block = 0x3fe4,
639     DW_AT_APPLE_major_runtime_vers = 0x3fe5,
640     DW_AT_APPLE_runtime_class = 0x3fe6,
641     DW_AT_APPLE_omit_frame_ptr = 0x3fe7,
642     DW_AT_APPLE_property_name = 0x3fe8,
643     DW_AT_APPLE_property_getter = 0x3fe9,
644     DW_AT_APPLE_property_setter = 0x3fea,
645     DW_AT_APPLE_property_attribute = 0x3feb,
646     DW_AT_APPLE_objc_complete_type = 0x3fec,
647     DW_AT_APPLE_property = 0x3fed
648 });
649 
650 dw!(
651 /// The attribute form encodings for DIE attributes.
652 ///
653 /// See Section 7.5.6, Table 7.6.
654 DwForm(u16) {
655     DW_FORM_null = 0x00,
656 
657     DW_FORM_addr = 0x01,
658     DW_FORM_block2 = 0x03,
659     DW_FORM_block4 = 0x04,
660     DW_FORM_data2 = 0x05,
661     DW_FORM_data4 = 0x06,
662     DW_FORM_data8 = 0x07,
663     DW_FORM_string = 0x08,
664     DW_FORM_block = 0x09,
665     DW_FORM_block1 = 0x0a,
666     DW_FORM_data1 = 0x0b,
667     DW_FORM_flag = 0x0c,
668     DW_FORM_sdata = 0x0d,
669     DW_FORM_strp = 0x0e,
670     DW_FORM_udata = 0x0f,
671     DW_FORM_ref_addr = 0x10,
672     DW_FORM_ref1 = 0x11,
673     DW_FORM_ref2 = 0x12,
674     DW_FORM_ref4 = 0x13,
675     DW_FORM_ref8 = 0x14,
676     DW_FORM_ref_udata = 0x15,
677     DW_FORM_indirect = 0x16,
678 
679 // DWARF 4.
680     DW_FORM_sec_offset = 0x17,
681     DW_FORM_exprloc = 0x18,
682     DW_FORM_flag_present = 0x19,
683     DW_FORM_ref_sig8 = 0x20,
684 
685 // DWARF 5.
686     DW_FORM_strx = 0x1a,
687     DW_FORM_addrx = 0x1b,
688     DW_FORM_ref_sup4 = 0x1c,
689     DW_FORM_strp_sup = 0x1d,
690     DW_FORM_data16 = 0x1e,
691     DW_FORM_line_strp = 0x1f,
692     DW_FORM_implicit_const = 0x21,
693     DW_FORM_loclistx = 0x22,
694     DW_FORM_rnglistx = 0x23,
695     DW_FORM_ref_sup8 = 0x24,
696     DW_FORM_strx1 = 0x25,
697     DW_FORM_strx2 = 0x26,
698     DW_FORM_strx3 = 0x27,
699     DW_FORM_strx4 = 0x28,
700     DW_FORM_addrx1 = 0x29,
701     DW_FORM_addrx2 = 0x2a,
702     DW_FORM_addrx3 = 0x2b,
703     DW_FORM_addrx4 = 0x2c,
704 
705 // Extensions for Fission proposal
706     DW_FORM_GNU_addr_index = 0x1f01,
707     DW_FORM_GNU_str_index = 0x1f02,
708 
709 // Alternate debug sections proposal (output of "dwz" tool).
710     DW_FORM_GNU_ref_alt = 0x1f20,
711     DW_FORM_GNU_strp_alt = 0x1f21
712 });
713 
714 dw!(
715 /// The encodings of the constants used in the `DW_AT_encoding` attribute.
716 ///
717 /// See Section 7.8, Table 7.11.
718 DwAte(u8) {
719     DW_ATE_address = 0x01,
720     DW_ATE_boolean = 0x02,
721     DW_ATE_complex_float = 0x03,
722     DW_ATE_float = 0x04,
723     DW_ATE_signed = 0x05,
724     DW_ATE_signed_char = 0x06,
725     DW_ATE_unsigned = 0x07,
726     DW_ATE_unsigned_char = 0x08,
727 
728 // DWARF 3.
729     DW_ATE_imaginary_float = 0x09,
730     DW_ATE_packed_decimal = 0x0a,
731     DW_ATE_numeric_string = 0x0b,
732     DW_ATE_edited = 0x0c,
733     DW_ATE_signed_fixed = 0x0d,
734     DW_ATE_unsigned_fixed = 0x0e,
735     DW_ATE_decimal_float = 0x0f ,
736 
737 // DWARF 4.
738     DW_ATE_UTF = 0x10,
739     DW_ATE_UCS = 0x11,
740     DW_ATE_ASCII = 0x12,
741 
742     DW_ATE_lo_user = 0x80,
743     DW_ATE_hi_user = 0xff,
744 });
745 
746 dw!(
747 /// The encodings of the constants used in location list entries.
748 ///
749 /// See Section 7.7.3, Table 7.10.
750 DwLle(u8) {
751     DW_LLE_end_of_list = 0x00,
752     DW_LLE_base_addressx = 0x01,
753     DW_LLE_startx_endx = 0x02,
754     DW_LLE_startx_length = 0x03,
755     DW_LLE_offset_pair = 0x04,
756     DW_LLE_default_location = 0x05,
757     DW_LLE_base_address = 0x06,
758     DW_LLE_start_end = 0x07,
759     DW_LLE_start_length = 0x08,
760     DW_LLE_GNU_view_pair = 0x09,
761 });
762 
763 dw!(
764 /// The encodings of the constants used in the `DW_AT_decimal_sign` attribute.
765 ///
766 /// See Section 7.8, Table 7.12.
767 DwDs(u8) {
768     DW_DS_unsigned = 0x01,
769     DW_DS_leading_overpunch = 0x02,
770     DW_DS_trailing_overpunch = 0x03,
771     DW_DS_leading_separate = 0x04,
772     DW_DS_trailing_separate = 0x05,
773 });
774 
775 dw!(
776 /// The encodings of the constants used in the `DW_AT_endianity` attribute.
777 ///
778 /// See Section 7.8, Table 7.13.
779 DwEnd(u8) {
780     DW_END_default = 0x00,
781     DW_END_big = 0x01,
782     DW_END_little = 0x02,
783     DW_END_lo_user = 0x40,
784     DW_END_hi_user = 0xff,
785 });
786 
787 dw!(
788 /// The encodings of the constants used in the `DW_AT_accessibility` attribute.
789 ///
790 /// See Section 7.9, Table 7.14.
791 DwAccess(u8) {
792     DW_ACCESS_public = 0x01,
793     DW_ACCESS_protected = 0x02,
794     DW_ACCESS_private = 0x03,
795 });
796 
797 dw!(
798 /// The encodings of the constants used in the `DW_AT_visibility` attribute.
799 ///
800 /// See Section 7.10, Table 7.15.
801 DwVis(u8) {
802     DW_VIS_local = 0x01,
803     DW_VIS_exported = 0x02,
804     DW_VIS_qualified = 0x03,
805 });
806 
807 dw!(
808 /// The encodings of the constants used in the `DW_AT_virtuality` attribute.
809 ///
810 /// See Section 7.11, Table 7.16.
811 DwVirtuality(u8) {
812     DW_VIRTUALITY_none = 0x00,
813     DW_VIRTUALITY_virtual = 0x01,
814     DW_VIRTUALITY_pure_virtual = 0x02,
815 });
816 
817 dw!(
818 /// The encodings of the constants used in the `DW_AT_language` attribute.
819 ///
820 /// See Section 7.12, Table 7.17.
821 DwLang(u16) {
822     DW_LANG_C89 = 0x0001,
823     DW_LANG_C = 0x0002,
824     DW_LANG_Ada83 = 0x0003,
825     DW_LANG_C_plus_plus = 0x0004,
826     DW_LANG_Cobol74 = 0x0005,
827     DW_LANG_Cobol85 = 0x0006,
828     DW_LANG_Fortran77 = 0x0007,
829     DW_LANG_Fortran90 = 0x0008,
830     DW_LANG_Pascal83 = 0x0009,
831     DW_LANG_Modula2 = 0x000a,
832     DW_LANG_Java = 0x000b,
833     DW_LANG_C99 = 0x000c,
834     DW_LANG_Ada95 = 0x000d,
835     DW_LANG_Fortran95 = 0x000e,
836     DW_LANG_PLI = 0x000f,
837     DW_LANG_ObjC = 0x0010,
838     DW_LANG_ObjC_plus_plus = 0x0011,
839     DW_LANG_UPC = 0x0012,
840     DW_LANG_D = 0x0013,
841     DW_LANG_Python = 0x0014,
842     DW_LANG_OpenCL = 0x0015,
843     DW_LANG_Go = 0x0016,
844     DW_LANG_Modula3 = 0x0017,
845     DW_LANG_Haskell = 0x0018,
846     DW_LANG_C_plus_plus_03 = 0x0019,
847     DW_LANG_C_plus_plus_11 = 0x001a,
848     DW_LANG_OCaml = 0x001b,
849     DW_LANG_Rust = 0x001c,
850     DW_LANG_C11 = 0x001d,
851     DW_LANG_Swift = 0x001e,
852     DW_LANG_Julia = 0x001f,
853     DW_LANG_Dylan = 0x0020,
854     DW_LANG_C_plus_plus_14 = 0x0021,
855     DW_LANG_Fortran03 = 0x0022,
856     DW_LANG_Fortran08 = 0x0023,
857     DW_LANG_RenderScript = 0x0024,
858     DW_LANG_BLISS = 0x0025,
859     DW_LANG_Kotlin = 0x0026,
860     DW_LANG_Zig = 0x0027,
861     DW_LANG_Crystal = 0x0028,
862     DW_LANG_C_plus_plus_17 = 0x002a,
863     DW_LANG_C_plus_plus_20 = 0x002b,
864     DW_LANG_C17 = 0x002c,
865     DW_LANG_Fortran18 = 0x002d,
866     DW_LANG_Ada2005 = 0x002e,
867     DW_LANG_Ada2012 = 0x002f,
868 
869     DW_LANG_lo_user = 0x8000,
870     DW_LANG_hi_user = 0xffff,
871 
872     DW_LANG_Mips_Assembler = 0x8001,
873     DW_LANG_GOOGLE_RenderScript = 0x8e57,
874     DW_LANG_SUN_Assembler = 0x9001,
875     DW_LANG_ALTIUM_Assembler = 0x9101,
876     DW_LANG_BORLAND_Delphi = 0xb000,
877 });
878 
879 impl DwLang {
880     /// Get the default DW_AT_lower_bound for this language.
default_lower_bound(self) -> Option<usize>881     pub fn default_lower_bound(self) -> Option<usize> {
882         match self {
883             DW_LANG_C89
884             | DW_LANG_C
885             | DW_LANG_C_plus_plus
886             | DW_LANG_Java
887             | DW_LANG_C99
888             | DW_LANG_ObjC
889             | DW_LANG_ObjC_plus_plus
890             | DW_LANG_UPC
891             | DW_LANG_D
892             | DW_LANG_Python
893             | DW_LANG_OpenCL
894             | DW_LANG_Go
895             | DW_LANG_Haskell
896             | DW_LANG_C_plus_plus_03
897             | DW_LANG_C_plus_plus_11
898             | DW_LANG_OCaml
899             | DW_LANG_Rust
900             | DW_LANG_C11
901             | DW_LANG_Swift
902             | DW_LANG_Dylan
903             | DW_LANG_C_plus_plus_14
904             | DW_LANG_RenderScript
905             | DW_LANG_BLISS => Some(0),
906             DW_LANG_Ada83 | DW_LANG_Cobol74 | DW_LANG_Cobol85 | DW_LANG_Fortran77
907             | DW_LANG_Fortran90 | DW_LANG_Pascal83 | DW_LANG_Modula2 | DW_LANG_Ada95
908             | DW_LANG_Fortran95 | DW_LANG_PLI | DW_LANG_Modula3 | DW_LANG_Julia
909             | DW_LANG_Fortran03 | DW_LANG_Fortran08 => Some(1),
910             _ => None,
911         }
912     }
913 }
914 
915 dw!(
916 /// The encodings of the constants used in the `DW_AT_address_class` attribute.
917 ///
918 /// There is only one value that is common to all target architectures.
919 /// See Section 7.13.
920 DwAddr(u64) {
921     DW_ADDR_none = 0x00,
922 });
923 
924 dw!(
925 /// The encodings of the constants used in the `DW_AT_identifier_case` attribute.
926 ///
927 /// See Section 7.14, Table 7.18.
928 DwId(u8) {
929     DW_ID_case_sensitive = 0x00,
930     DW_ID_up_case = 0x01,
931     DW_ID_down_case = 0x02,
932     DW_ID_case_insensitive = 0x03,
933 });
934 
935 dw!(
936 /// The encodings of the constants used in the `DW_AT_calling_convention` attribute.
937 ///
938 /// See Section 7.15, Table 7.19.
939 DwCc(u8) {
940     DW_CC_normal = 0x01,
941     DW_CC_program = 0x02,
942     DW_CC_nocall = 0x03,
943     DW_CC_pass_by_reference = 0x04,
944     DW_CC_pass_by_value = 0x05,
945     DW_CC_lo_user = 0x40,
946     DW_CC_hi_user = 0xff,
947 });
948 
949 dw!(
950 /// The encodings of the constants used in the `DW_AT_inline` attribute.
951 ///
952 /// See Section 7.16, Table 7.20.
953 DwInl(u8) {
954     DW_INL_not_inlined = 0x00,
955     DW_INL_inlined = 0x01,
956     DW_INL_declared_not_inlined = 0x02,
957     DW_INL_declared_inlined = 0x03,
958 });
959 
960 dw!(
961 /// The encodings of the constants used in the `DW_AT_ordering` attribute.
962 ///
963 /// See Section 7.17, Table 7.17.
964 DwOrd(u8) {
965     DW_ORD_row_major = 0x00,
966     DW_ORD_col_major = 0x01,
967 });
968 
969 dw!(
970 /// The encodings of the constants used in the `DW_AT_discr_list` attribute.
971 ///
972 /// See Section 7.18, Table 7.22.
973 DwDsc(u8) {
974     DW_DSC_label = 0x00,
975     DW_DSC_range = 0x01,
976 });
977 
978 dw!(
979 /// Name index attribute encodings.
980 ///
981 /// See Section 7.19, Table 7.23.
982 DwIdx(u16) {
983     DW_IDX_compile_unit = 1,
984     DW_IDX_type_unit = 2,
985     DW_IDX_die_offset = 3,
986     DW_IDX_parent = 4,
987     DW_IDX_type_hash = 5,
988     DW_IDX_lo_user = 0x2000,
989     DW_IDX_hi_user = 0x3fff,
990 });
991 
992 dw!(
993 /// The encodings of the constants used in the `DW_AT_defaulted` attribute.
994 ///
995 /// See Section 7.20, Table 7.24.
996 DwDefaulted(u8) {
997     DW_DEFAULTED_no = 0x00,
998     DW_DEFAULTED_in_class = 0x01,
999     DW_DEFAULTED_out_of_class = 0x02,
1000 });
1001 
1002 dw!(
1003 /// The encodings for the standard opcodes for line number information.
1004 ///
1005 /// See Section 7.22, Table 7.25.
1006 DwLns(u8) {
1007     DW_LNS_copy = 0x01,
1008     DW_LNS_advance_pc = 0x02,
1009     DW_LNS_advance_line = 0x03,
1010     DW_LNS_set_file = 0x04,
1011     DW_LNS_set_column = 0x05,
1012     DW_LNS_negate_stmt = 0x06,
1013     DW_LNS_set_basic_block = 0x07,
1014     DW_LNS_const_add_pc = 0x08,
1015     DW_LNS_fixed_advance_pc = 0x09,
1016     DW_LNS_set_prologue_end = 0x0a,
1017     DW_LNS_set_epilogue_begin = 0x0b,
1018     DW_LNS_set_isa = 0x0c,
1019 });
1020 
1021 dw!(
1022 /// The encodings for the extended opcodes for line number information.
1023 ///
1024 /// See Section 7.22, Table 7.26.
1025 DwLne(u8) {
1026     DW_LNE_end_sequence = 0x01,
1027     DW_LNE_set_address = 0x02,
1028     DW_LNE_define_file = 0x03,
1029     DW_LNE_set_discriminator = 0x04,
1030 
1031     DW_LNE_lo_user = 0x80,
1032     DW_LNE_hi_user = 0xff,
1033 });
1034 
1035 dw!(
1036 /// The encodings for the line number header entry formats.
1037 ///
1038 /// See Section 7.22, Table 7.27.
1039 DwLnct(u16) {
1040     DW_LNCT_path = 0x1,
1041     DW_LNCT_directory_index = 0x2,
1042     DW_LNCT_timestamp = 0x3,
1043     DW_LNCT_size = 0x4,
1044     DW_LNCT_MD5 = 0x5,
1045     DW_LNCT_lo_user = 0x2000,
1046     DW_LNCT_hi_user = 0x3fff,
1047 });
1048 
1049 dw!(
1050 /// The encodings for macro information entry types.
1051 ///
1052 /// See Section 7.23, Table 7.28.
1053 DwMacro(u8) {
1054     DW_MACRO_define = 0x01,
1055     DW_MACRO_undef = 0x02,
1056     DW_MACRO_start_file = 0x03,
1057     DW_MACRO_end_file = 0x04,
1058     DW_MACRO_define_strp = 0x05,
1059     DW_MACRO_undef_strp = 0x06,
1060     DW_MACRO_import = 0x07,
1061     DW_MACRO_define_sup = 0x08,
1062     DW_MACRO_undef_sup = 0x09,
1063     DW_MACRO_import_sup = 0x0a,
1064     DW_MACRO_define_strx = 0x0b,
1065     DW_MACRO_undef_strx = 0x0c,
1066     DW_MACRO_lo_user = 0xe0,
1067     DW_MACRO_hi_user = 0xff,
1068 });
1069 
1070 dw!(
1071 /// Range list entry encoding values.
1072 ///
1073 /// See Section 7.25, Table 7.30.
1074 DwRle(u8) {
1075     DW_RLE_end_of_list = 0x00,
1076     DW_RLE_base_addressx = 0x01,
1077     DW_RLE_startx_endx = 0x02,
1078     DW_RLE_startx_length = 0x03,
1079     DW_RLE_offset_pair = 0x04,
1080     DW_RLE_base_address = 0x05,
1081     DW_RLE_start_end = 0x06,
1082     DW_RLE_start_length = 0x07,
1083 });
1084 
1085 dw!(
1086 /// The encodings for DWARF expression operations.
1087 ///
1088 /// See Section 7.7.1, Table 7.9.
1089 DwOp(u8) {
1090     DW_OP_addr = 0x03,
1091     DW_OP_deref = 0x06,
1092     DW_OP_const1u = 0x08,
1093     DW_OP_const1s = 0x09,
1094     DW_OP_const2u = 0x0a,
1095     DW_OP_const2s = 0x0b,
1096     DW_OP_const4u = 0x0c,
1097     DW_OP_const4s = 0x0d,
1098     DW_OP_const8u = 0x0e,
1099     DW_OP_const8s = 0x0f,
1100     DW_OP_constu = 0x10,
1101     DW_OP_consts = 0x11,
1102     DW_OP_dup = 0x12,
1103     DW_OP_drop = 0x13,
1104     DW_OP_over = 0x14,
1105     DW_OP_pick = 0x15,
1106     DW_OP_swap = 0x16,
1107     DW_OP_rot = 0x17,
1108     DW_OP_xderef = 0x18,
1109     DW_OP_abs = 0x19,
1110     DW_OP_and = 0x1a,
1111     DW_OP_div = 0x1b,
1112     DW_OP_minus = 0x1c,
1113     DW_OP_mod = 0x1d,
1114     DW_OP_mul = 0x1e,
1115     DW_OP_neg = 0x1f,
1116     DW_OP_not = 0x20,
1117     DW_OP_or = 0x21,
1118     DW_OP_plus = 0x22,
1119     DW_OP_plus_uconst = 0x23,
1120     DW_OP_shl = 0x24,
1121     DW_OP_shr = 0x25,
1122     DW_OP_shra = 0x26,
1123     DW_OP_xor = 0x27,
1124     DW_OP_bra = 0x28,
1125     DW_OP_eq = 0x29,
1126     DW_OP_ge = 0x2a,
1127     DW_OP_gt = 0x2b,
1128     DW_OP_le = 0x2c,
1129     DW_OP_lt = 0x2d,
1130     DW_OP_ne = 0x2e,
1131     DW_OP_skip = 0x2f,
1132     DW_OP_lit0 = 0x30,
1133     DW_OP_lit1 = 0x31,
1134     DW_OP_lit2 = 0x32,
1135     DW_OP_lit3 = 0x33,
1136     DW_OP_lit4 = 0x34,
1137     DW_OP_lit5 = 0x35,
1138     DW_OP_lit6 = 0x36,
1139     DW_OP_lit7 = 0x37,
1140     DW_OP_lit8 = 0x38,
1141     DW_OP_lit9 = 0x39,
1142     DW_OP_lit10 = 0x3a,
1143     DW_OP_lit11 = 0x3b,
1144     DW_OP_lit12 = 0x3c,
1145     DW_OP_lit13 = 0x3d,
1146     DW_OP_lit14 = 0x3e,
1147     DW_OP_lit15 = 0x3f,
1148     DW_OP_lit16 = 0x40,
1149     DW_OP_lit17 = 0x41,
1150     DW_OP_lit18 = 0x42,
1151     DW_OP_lit19 = 0x43,
1152     DW_OP_lit20 = 0x44,
1153     DW_OP_lit21 = 0x45,
1154     DW_OP_lit22 = 0x46,
1155     DW_OP_lit23 = 0x47,
1156     DW_OP_lit24 = 0x48,
1157     DW_OP_lit25 = 0x49,
1158     DW_OP_lit26 = 0x4a,
1159     DW_OP_lit27 = 0x4b,
1160     DW_OP_lit28 = 0x4c,
1161     DW_OP_lit29 = 0x4d,
1162     DW_OP_lit30 = 0x4e,
1163     DW_OP_lit31 = 0x4f,
1164     DW_OP_reg0 = 0x50,
1165     DW_OP_reg1 = 0x51,
1166     DW_OP_reg2 = 0x52,
1167     DW_OP_reg3 = 0x53,
1168     DW_OP_reg4 = 0x54,
1169     DW_OP_reg5 = 0x55,
1170     DW_OP_reg6 = 0x56,
1171     DW_OP_reg7 = 0x57,
1172     DW_OP_reg8 = 0x58,
1173     DW_OP_reg9 = 0x59,
1174     DW_OP_reg10 = 0x5a,
1175     DW_OP_reg11 = 0x5b,
1176     DW_OP_reg12 = 0x5c,
1177     DW_OP_reg13 = 0x5d,
1178     DW_OP_reg14 = 0x5e,
1179     DW_OP_reg15 = 0x5f,
1180     DW_OP_reg16 = 0x60,
1181     DW_OP_reg17 = 0x61,
1182     DW_OP_reg18 = 0x62,
1183     DW_OP_reg19 = 0x63,
1184     DW_OP_reg20 = 0x64,
1185     DW_OP_reg21 = 0x65,
1186     DW_OP_reg22 = 0x66,
1187     DW_OP_reg23 = 0x67,
1188     DW_OP_reg24 = 0x68,
1189     DW_OP_reg25 = 0x69,
1190     DW_OP_reg26 = 0x6a,
1191     DW_OP_reg27 = 0x6b,
1192     DW_OP_reg28 = 0x6c,
1193     DW_OP_reg29 = 0x6d,
1194     DW_OP_reg30 = 0x6e,
1195     DW_OP_reg31 = 0x6f,
1196     DW_OP_breg0 = 0x70,
1197     DW_OP_breg1 = 0x71,
1198     DW_OP_breg2 = 0x72,
1199     DW_OP_breg3 = 0x73,
1200     DW_OP_breg4 = 0x74,
1201     DW_OP_breg5 = 0x75,
1202     DW_OP_breg6 = 0x76,
1203     DW_OP_breg7 = 0x77,
1204     DW_OP_breg8 = 0x78,
1205     DW_OP_breg9 = 0x79,
1206     DW_OP_breg10 = 0x7a,
1207     DW_OP_breg11 = 0x7b,
1208     DW_OP_breg12 = 0x7c,
1209     DW_OP_breg13 = 0x7d,
1210     DW_OP_breg14 = 0x7e,
1211     DW_OP_breg15 = 0x7f,
1212     DW_OP_breg16 = 0x80,
1213     DW_OP_breg17 = 0x81,
1214     DW_OP_breg18 = 0x82,
1215     DW_OP_breg19 = 0x83,
1216     DW_OP_breg20 = 0x84,
1217     DW_OP_breg21 = 0x85,
1218     DW_OP_breg22 = 0x86,
1219     DW_OP_breg23 = 0x87,
1220     DW_OP_breg24 = 0x88,
1221     DW_OP_breg25 = 0x89,
1222     DW_OP_breg26 = 0x8a,
1223     DW_OP_breg27 = 0x8b,
1224     DW_OP_breg28 = 0x8c,
1225     DW_OP_breg29 = 0x8d,
1226     DW_OP_breg30 = 0x8e,
1227     DW_OP_breg31 = 0x8f,
1228     DW_OP_regx = 0x90,
1229     DW_OP_fbreg = 0x91,
1230     DW_OP_bregx = 0x92,
1231     DW_OP_piece = 0x93,
1232     DW_OP_deref_size = 0x94,
1233     DW_OP_xderef_size = 0x95,
1234     DW_OP_nop = 0x96,
1235     DW_OP_push_object_address = 0x97,
1236     DW_OP_call2 = 0x98,
1237     DW_OP_call4 = 0x99,
1238     DW_OP_call_ref = 0x9a,
1239     DW_OP_form_tls_address = 0x9b,
1240     DW_OP_call_frame_cfa = 0x9c,
1241     DW_OP_bit_piece = 0x9d,
1242     DW_OP_implicit_value = 0x9e,
1243     DW_OP_stack_value = 0x9f,
1244     DW_OP_implicit_pointer = 0xa0,
1245     DW_OP_addrx = 0xa1,
1246     DW_OP_constx = 0xa2,
1247     DW_OP_entry_value = 0xa3,
1248     DW_OP_const_type = 0xa4,
1249     DW_OP_regval_type = 0xa5,
1250     DW_OP_deref_type = 0xa6,
1251     DW_OP_xderef_type = 0xa7,
1252     DW_OP_convert = 0xa8,
1253     DW_OP_reinterpret = 0xa9,
1254 
1255     // GNU extensions
1256     DW_OP_GNU_push_tls_address = 0xe0,
1257     DW_OP_GNU_implicit_pointer = 0xf2,
1258     DW_OP_GNU_entry_value = 0xf3,
1259     DW_OP_GNU_const_type = 0xf4,
1260     DW_OP_GNU_regval_type = 0xf5,
1261     DW_OP_GNU_deref_type = 0xf6,
1262     DW_OP_GNU_convert = 0xf7,
1263     DW_OP_GNU_reinterpret = 0xf9,
1264     DW_OP_GNU_parameter_ref = 0xfa,
1265     DW_OP_GNU_addr_index = 0xfb,
1266     DW_OP_GNU_const_index = 0xfc,
1267 
1268     // Wasm extensions
1269     DW_OP_WASM_location = 0xed,
1270 });
1271 
1272 dw!(
1273 /// Pointer encoding used by `.eh_frame`.
1274 ///
1275 /// The four lower bits describe the
1276 /// format of the pointer, the upper four bits describe how the encoding should
1277 /// be applied.
1278 ///
1279 /// Defined in https://refspecs.linuxfoundation.org/LSB_4.0.0/LSB-Core-generic/LSB-Core-generic/dwarfext.html
1280 DwEhPe(u8) {
1281 // Format of pointer encoding.
1282 
1283 // "Unsigned value is encoded using the Little Endian Base 128"
1284     DW_EH_PE_uleb128 = 0x1,
1285 // "A 2 bytes unsigned value."
1286     DW_EH_PE_udata2 = 0x2,
1287 // "A 4 bytes unsigned value."
1288     DW_EH_PE_udata4 = 0x3,
1289 // "An 8 bytes unsigned value."
1290     DW_EH_PE_udata8 = 0x4,
1291 // "Signed value is encoded using the Little Endian Base 128"
1292     DW_EH_PE_sleb128 = 0x9,
1293 // "A 2 bytes signed value."
1294     DW_EH_PE_sdata2 = 0x0a,
1295 // "A 4 bytes signed value."
1296     DW_EH_PE_sdata4 = 0x0b,
1297 // "An 8 bytes signed value."
1298     DW_EH_PE_sdata8 = 0x0c,
1299 
1300 // How the pointer encoding should be applied.
1301 
1302 // `DW_EH_PE_pcrel` pointers are relative to their own location.
1303     DW_EH_PE_pcrel = 0x10,
1304 // "Value is relative to the beginning of the .text section."
1305     DW_EH_PE_textrel = 0x20,
1306 // "Value is relative to the beginning of the .got or .eh_frame_hdr section."
1307     DW_EH_PE_datarel = 0x30,
1308 // "Value is relative to the beginning of the function."
1309     DW_EH_PE_funcrel = 0x40,
1310 // "Value is aligned to an address unit sized boundary."
1311     DW_EH_PE_aligned = 0x50,
1312 
1313 // This bit can be set for any of the above encoding applications. When set,
1314 // the encoded value is the address of the real pointer result, not the
1315 // pointer result itself.
1316 //
1317 // This isn't defined in the DWARF or the `.eh_frame` standards, but is
1318 // generated by both GNU/Linux and OSX tooling.
1319     DW_EH_PE_indirect = 0x80,
1320 
1321 // These constants apply to both the lower and upper bits.
1322 
1323 // "The Value is a literal pointer whose size is determined by the
1324 // architecture."
1325     DW_EH_PE_absptr = 0x0,
1326 // The absence of a pointer and encoding.
1327     DW_EH_PE_omit = 0xff,
1328 });
1329 
1330 const DW_EH_PE_FORMAT_MASK: u8 = 0b0000_1111;
1331 
1332 // Ignores indirection bit.
1333 const DW_EH_PE_APPLICATION_MASK: u8 = 0b0111_0000;
1334 
1335 impl DwEhPe {
1336     /// Get the pointer encoding's format.
1337     #[inline]
format(self) -> DwEhPe1338     pub fn format(self) -> DwEhPe {
1339         DwEhPe(self.0 & DW_EH_PE_FORMAT_MASK)
1340     }
1341 
1342     /// Get the pointer encoding's application.
1343     #[inline]
application(self) -> DwEhPe1344     pub fn application(self) -> DwEhPe {
1345         DwEhPe(self.0 & DW_EH_PE_APPLICATION_MASK)
1346     }
1347 
1348     /// Is this encoding the absent pointer encoding?
1349     #[inline]
is_absent(self) -> bool1350     pub fn is_absent(self) -> bool {
1351         self == DW_EH_PE_omit
1352     }
1353 
1354     /// Is this coding indirect? If so, its encoded value is the address of the
1355     /// real pointer result, not the pointer result itself.
1356     #[inline]
is_indirect(self) -> bool1357     pub fn is_indirect(self) -> bool {
1358         self.0 & DW_EH_PE_indirect.0 != 0
1359     }
1360 
1361     /// Is this a known, valid pointer encoding?
is_valid_encoding(self) -> bool1362     pub fn is_valid_encoding(self) -> bool {
1363         if self.is_absent() {
1364             return true;
1365         }
1366 
1367         match self.format() {
1368             DW_EH_PE_absptr | DW_EH_PE_uleb128 | DW_EH_PE_udata2 | DW_EH_PE_udata4
1369             | DW_EH_PE_udata8 | DW_EH_PE_sleb128 | DW_EH_PE_sdata2 | DW_EH_PE_sdata4
1370             | DW_EH_PE_sdata8 => {}
1371             _ => return false,
1372         }
1373 
1374         match self.application() {
1375             DW_EH_PE_absptr | DW_EH_PE_pcrel | DW_EH_PE_textrel | DW_EH_PE_datarel
1376             | DW_EH_PE_funcrel | DW_EH_PE_aligned => {}
1377             _ => return false,
1378         }
1379 
1380         true
1381     }
1382 }
1383 
1384 #[cfg(test)]
1385 mod tests {
1386     use super::*;
1387 
1388     #[test]
test_dw_eh_pe_format()1389     fn test_dw_eh_pe_format() {
1390         let encoding = DwEhPe(DW_EH_PE_pcrel.0 | DW_EH_PE_uleb128.0);
1391         assert_eq!(encoding.format(), DW_EH_PE_uleb128);
1392     }
1393 
1394     #[test]
test_dw_eh_pe_application()1395     fn test_dw_eh_pe_application() {
1396         let encoding = DwEhPe(DW_EH_PE_pcrel.0 | DW_EH_PE_uleb128.0);
1397         assert_eq!(encoding.application(), DW_EH_PE_pcrel);
1398     }
1399 
1400     #[test]
test_dw_eh_pe_is_absent()1401     fn test_dw_eh_pe_is_absent() {
1402         assert_eq!(DW_EH_PE_absptr.is_absent(), false);
1403         assert_eq!(DW_EH_PE_omit.is_absent(), true);
1404     }
1405 
1406     #[test]
test_dw_eh_pe_is_valid_encoding_ok()1407     fn test_dw_eh_pe_is_valid_encoding_ok() {
1408         let encoding = DwEhPe(DW_EH_PE_uleb128.0 | DW_EH_PE_pcrel.0);
1409         assert!(encoding.is_valid_encoding());
1410         assert!(DW_EH_PE_absptr.is_valid_encoding());
1411         assert!(DW_EH_PE_omit.is_valid_encoding());
1412     }
1413 
1414     #[test]
test_dw_eh_pe_is_valid_encoding_bad_format()1415     fn test_dw_eh_pe_is_valid_encoding_bad_format() {
1416         let encoding = DwEhPe((DW_EH_PE_sdata8.0 + 1) | DW_EH_PE_pcrel.0);
1417         assert_eq!(encoding.is_valid_encoding(), false);
1418     }
1419 
1420     #[test]
test_dw_eh_pe_is_valid_encoding_bad_application()1421     fn test_dw_eh_pe_is_valid_encoding_bad_application() {
1422         let encoding = DwEhPe(DW_EH_PE_sdata8.0 | (DW_EH_PE_aligned.0 + 1));
1423         assert_eq!(encoding.is_valid_encoding(), false);
1424     }
1425 }
1426