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