portugalfuturista/rizin
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
rizin/librz/include/rz_bin_dwarf.h
billow 71aa8bf1dd
Fix memory leaks related to DWARF (#6245) 
* fix: memory leak rz_analysis_op_fini op->src

* fix: memory leak, replaced `rz_type_clone` with `rz_type_clone_shallow` to resolve the memory leak in `rz_type_free(type.callable)`

* fix: memory leak in try_create_var_global

* fix: memory leak in dwarf

* fix: remove redundant memset calls and add documentation for rz_type_clone_shallow

* Update librz/arch/op.c

Co-authored-by: Giovanni <561184+wargio@users.noreply.github.com>

* fix: set free and free_user to NULL in vector copy when item_cpy is not provided

---------

Co-authored-by: Giovanni <561184+wargio@users.noreply.github.com>
2026-04-17 17:33:11 +00:00

1911 lines
54 KiB
C
Raw Permalink Blame History

#ifndef RZ_BIN_DWARF_H
#define RZ_BIN_DWARF_H
#include <rz_types.h>
#include <rz_bin.h>
#ifdef __cplusplus
extern "C" {
#endif
typedef enum {
DW_LNS_copy = 0x01,
DW_LNS_advance_pc = 0x02,
DW_LNS_advance_line = 0x03,
DW_LNS_set_file = 0x04,
DW_LNS_set_column = 0x05,
DW_LNS_negate_stmt = 0x06,
DW_LNS_set_basic_block = 0x07,
DW_LNS_const_add_pc = 0x08,
DW_LNS_fixed_advance_pc = 0x09,
DW_LNS_set_prologue_end = 0x0a, /* DWARF3 */
DW_LNS_set_epilogue_begin = 0x0b, /* DWARF3 */
DW_LNS_set_isa = 0x0c, /* DWARF3 */
} DW_LNS;
/* Line number extended opcode name. */
typedef enum {
DW_LNE_end_sequence = 0x01,
DW_LNE_set_address = 0x02,
DW_LNE_define_file = 0x03,
DW_LNE_set_discriminator = 0x04, /* DWARF4 */
DW_LNE_lo_user = 0x80, /* DWARF3 */
DW_LNE_hi_user = 0xff, /* DWARF3 */
/* HP extensions. */
DW_LNE_HP_negate_is_UV_update = 0x11, /* 17 HP */
DW_LNE_HP_push_context = 0x12, /* 18 HP */
DW_LNE_HP_pop_context = 0x13, /* 19 HP */
DW_LNE_HP_set_file_line_column = 0x14, /* 20 HP */
DW_LNE_HP_set_routine_name = 0x15, /* 21 HP */
DW_LNE_HP_set_sequence = 0x16, /* 22 HP */
DW_LNE_HP_negate_post_semantics = 0x17, /* 23 HP */
DW_LNE_HP_negate_function_exit = 0x18, /* 24 HP */
DW_LNE_HP_negate_front_end_logical = 0x19, /* 25 HP */
DW_LNE_HP_define_proc = 0x20, /* 32 HP */
} DW_LNE;
/* debug_info tags */
// this is not a real dwarf named entry, but I wanted to give it
// a name so it's more obvious and readable that it's just a type of entry
typedef enum {
DW_TAG_null_entry = 0x00,
DW_TAG_array_type = 0x01,
DW_TAG_class_type = 0x02,
DW_TAG_entry_point = 0x03,
DW_TAG_enumeration_type = 0x04,
DW_TAG_formal_parameter = 0x05,
DW_TAG_imported_declaration = 0x08,
DW_TAG_label = 0x0a,
DW_TAG_lexical_block = 0x0b,
DW_TAG_member = 0x0d,
DW_TAG_pointer_type = 0x0f,
DW_TAG_reference_type = 0x10,
DW_TAG_compile_unit = 0x11, //
DW_TAG_string_type = 0x12,
DW_TAG_structure_type = 0x13,
DW_TAG_subroutine_type = 0x15,
DW_TAG_typedef = 0x16,
DW_TAG_union_type = 0x17,
DW_TAG_unspecified_parameters = 0x18,
DW_TAG_variant = 0x19,
DW_TAG_common_block = 0x1a,
DW_TAG_common_inclusion = 0x1b,
DW_TAG_inheritance = 0x1c,
DW_TAG_inlined_subroutine = 0x1d,
DW_TAG_module = 0x1e,
DW_TAG_ptr_to_member_type = 0x1f,
DW_TAG_set_type = 0x20,
DW_TAG_subrange_type = 0x21,
DW_TAG_with_stmt = 0x22,
DW_TAG_access_declaration = 0x23,
DW_TAG_base_type = 0x24,
DW_TAG_catch_block = 0x25,
DW_TAG_const_type = 0x26,
DW_TAG_constant = 0x27,
DW_TAG_enumerator = 0x28,
DW_TAG_file_type = 0x29,
DW_TAG_friend = 0x2a,
DW_TAG_namelist = 0x2b,
/* Early releases of this header had the following
misspelled with a trailing 's' */
DW_TAG_namelist_item = 0x2c, /* DWARF3/2 spelling */
DW_TAG_namelist_items = 0x2c, /* SGI misspelling/typo */
DW_TAG_packed_type = 0x2d,
DW_TAG_subprogram = 0x2e,
/* The DWARF2 document had two spellings of the following
two TAGs, DWARF3 specifies the longer spelling. */
DW_TAG_template_type_parameter = 0x2f, /* DWARF3/2 spelling*/
DW_TAG_template_type_param = 0x2f, /* DWARF2 spelling*/
DW_TAG_template_value_parameter = 0x30, /* DWARF3/2 spelling*/
DW_TAG_template_value_param = 0x30, /* DWARF2 spelling*/
DW_TAG_thrown_type = 0x31,
DW_TAG_try_block = 0x32,
DW_TAG_variant_part = 0x33,
DW_TAG_variable = 0x34,
DW_TAG_volatile_type = 0x35,
DW_TAG_dwarf_procedure = 0x36, /* DWARF3 */
DW_TAG_restrict_type = 0x37, /* DWARF3 */
DW_TAG_interface_type = 0x38, /* DWARF3 */
DW_TAG_namespace = 0x39, /* DWARF3 */
DW_TAG_imported_module = 0x3a, /* DWARF3 */
DW_TAG_unspecified_type = 0x3b, /* DWARF3 */
DW_TAG_partial_unit = 0x3c, /* DWARF3 */
DW_TAG_imported_unit = 0x3d, /* DWARF3 */
/* Do not use DW_TAG_mutable_type */
DW_TAG_mutable_type = 0x3e, /* Withdrawn from DWARF3 by DWARF3f. */
DW_TAG_condition = 0x3f, /* DWARF3f */
DW_TAG_shared_type = 0x40, /* DWARF3f */
DW_TAG_type_unit = 0x41, /* DWARF4 */
DW_TAG_rvalue_reference_type = 0x42, /* DWARF4 */
DW_TAG_template_alias = 0x43, /* DWARF4 */
// DWARF 5.
DW_TAG_coarray_type = 0x44,
DW_TAG_generic_subrange = 0x45,
DW_TAG_dynamic_type = 0x46,
DW_TAG_atomic_type = 0x47,
DW_TAG_call_site = 0x48,
DW_TAG_call_site_parameter = 0x49,
DW_TAG_skeleton_unit = 0x4a,
DW_TAG_immutable_type = 0x4b,
DW_TAG_lo_user = 0x4080,
DW_TAG_hi_user = 0xffff,
// SGI/MIPS extensions.
DW_TAG_MIPS_loop = 0x4081,
// HP extensions.
DW_TAG_HP_array_descriptor = 0x4090,
DW_TAG_HP_Bliss_field = 0x4091,
DW_TAG_HP_Bliss_field_set = 0x4092,
// GNU extensions.
DW_TAG_format_label = 0x4101,
DW_TAG_function_template = 0x4102,
DW_TAG_class_template = 0x4103,
DW_TAG_GNU_BINCL = 0x4104,
DW_TAG_GNU_EINCL = 0x4105,
DW_TAG_GNU_template_template_param = 0x4106,
DW_TAG_GNU_template_parameter_pack = 0x4107,
DW_TAG_GNU_formal_parameter_pack = 0x4108,
DW_TAG_GNU_call_site = 0x4109,
DW_TAG_GNU_call_site_parameter = 0x410a,
DW_TAG_APPLE_property = 0x4200,
// SUN extensions.
DW_TAG_SUN_function_template = 0x4201,
DW_TAG_SUN_class_template = 0x4202,
DW_TAG_SUN_struct_template = 0x4203,
DW_TAG_SUN_union_template = 0x4204,
DW_TAG_SUN_indirect_inheritance = 0x4205,
DW_TAG_SUN_codeflags = 0x4206,
DW_TAG_SUN_memop_info = 0x4207,
DW_TAG_SUN_omp_child_func = 0x4208,
DW_TAG_SUN_rtti_descriptor = 0x4209,
DW_TAG_SUN_dtor_info = 0x420a,
DW_TAG_SUN_dtor = 0x420b,
DW_TAG_SUN_f90_interface = 0x420c,
DW_TAG_SUN_fortran_vax_structure = 0x420d,
// ALTIUM extensions.
DW_TAG_ALTIUM_circ_type = 0x5101,
DW_TAG_ALTIUM_mwa_circ_type = 0x5102,
DW_TAG_ALTIUM_rev_carry_type = 0x5103,
DW_TAG_ALTIUM_rom = 0x5111,
// Extensions for UPC.
DW_TAG_upc_shared_type = 0x8765,
DW_TAG_upc_strict_type = 0x8766,
DW_TAG_upc_relaxed_type = 0x8767,
// PGI (STMicroelectronics) extensions.
DW_TAG_PGI_kanji_type = 0xa000,
DW_TAG_PGI_interface_block = 0xa020,
// Borland extensions.
DW_TAG_BORLAND_property = 0xb000,
DW_TAG_BORLAND_Delphi_string = 0xb001,
DW_TAG_BORLAND_Delphi_dynamic_array = 0xb002,
DW_TAG_BORLAND_Delphi_set = 0xb003,
DW_TAG_BORLAND_Delphi_variant = 0xb004,
} DW_TAG;
typedef enum {
DW_CHILDREN_no = 0x00,
DW_CHILDREN_yes = 0x01,
} DW_CHILDREN;
typedef enum {
DW_AT_sibling = 0x01,
DW_AT_location = 0x02,
DW_AT_name = 0x03,
DW_AT_ordering = 0x09,
DW_AT_byte_size = 0x0b,
DW_AT_bit_offset = 0x0c,
DW_AT_bit_size = 0x0d,
DW_AT_stmt_list = 0x10,
DW_AT_low_pc = 0x11,
DW_AT_high_pc = 0x12,
DW_AT_language = 0x13,
DW_AT_discr = 0x15,
DW_AT_discr_value = 0x16,
DW_AT_visibility = 0x17,
DW_AT_import = 0x18,
DW_AT_string_length = 0x19,
DW_AT_common_reference = 0x1a,
DW_AT_comp_dir = 0x1b,
DW_AT_const_value = 0x1c,
DW_AT_containing_type = 0x1d,
DW_AT_default_value = 0x1e,
DW_AT_inline = 0x20,
DW_AT_is_optional = 0x21,
DW_AT_lower_bound = 0x22,
DW_AT_producer = 0x25,
DW_AT_prototyped = 0x27,
DW_AT_return_addr = 0x2a,
DW_AT_start_scope = 0x2c,
DW_AT_stride_size = 0x2e,
DW_AT_upper_bound = 0x2f,
DW_AT_abstract_origin = 0x31,
DW_AT_accessibility = 0x32,
DW_AT_address_class = 0x33,
DW_AT_artificial = 0x34,
DW_AT_base_types = 0x35,
DW_AT_calling_convention = 0x36,
DW_AT_count = 0x37,
DW_AT_data_member_location = 0x38,
DW_AT_decl_column = 0x39,
DW_AT_decl_file = 0x3a,
DW_AT_decl_line = 0x3b,
DW_AT_declaration = 0x3c,
DW_AT_discr_list = 0x3d,
DW_AT_encoding = 0x3e,
DW_AT_external = 0x3f,
DW_AT_frame_base = 0x40,
DW_AT_friend = 0x41,
DW_AT_identifier_case = 0x42,
DW_AT_macro_info = 0x43,
DW_AT_namelist_item = 0x44,
DW_AT_priority = 0x45,
DW_AT_segment = 0x46,
DW_AT_specification = 0x47,
DW_AT_static_link = 0x48,
DW_AT_type = 0x49,
DW_AT_use_location = 0x4a,
DW_AT_variable_parameter = 0x4b,
DW_AT_virtuality = 0x4c,
DW_AT_vtable_elem_location = 0x4d,
DW_AT_allocated = 0x4e, // DWARF 3 additions start
DW_AT_associated = 0x4f,
DW_AT_data_location = 0x50,
DW_AT_byte_stride = 0x51,
DW_AT_entry_pc = 0x52,
DW_AT_use_UTF8 = 0x53,
DW_AT_extension = 0x54,
DW_AT_ranges = 0x55,
DW_AT_trampoline = 0x56,
DW_AT_call_column = 0x57,
DW_AT_call_file = 0x58,
DW_AT_call_line = 0x59,
DW_AT_description = 0x5a,
DW_AT_binary_scale = 0x5b,
DW_AT_decimal_scale = 0x5c,
DW_AT_small = 0x5d,
DW_AT_decimal_sign = 0x5e,
DW_AT_digit_count = 0x5f,
DW_AT_picture_string = 0x60,
DW_AT_mutable = 0x61,
DW_AT_threads_scaled = 0x62,
DW_AT_explicit = 0x63,
DW_AT_object_pointer = 0x64,
DW_AT_endianity = 0x65,
DW_AT_elemental = 0x66,
DW_AT_pure = 0x67,
DW_AT_recursive = 0x68, // DWARF 3 additions end
DW_AT_signature = 0x69,
DW_AT_main_subprogram = 0x6a,
DW_AT_data_bit_offset = 0x6b,
DW_AT_const_expr = 0x6c,
DW_AT_enum_class = 0x6d,
DW_AT_linkage_name = 0x6e,
DW_AT_string_length_bit_size = 0x6f,
DW_AT_string_length_byte_size = 0x70,
DW_AT_rank = 0x71,
DW_AT_str_offsets_base = 0x72,
DW_AT_addr_base = 0x73,
DW_AT_rnglists_base = 0x74,
DW_AT_reserved = 0x75,
DW_AT_dwo_name = 0x76,
DW_AT_reference = 0x77,
DW_AT_rvalue_reference = 0x78,
DW_AT_macros = 0x79,
DW_AT_call_all_calls = 0x7a,
DW_AT_call_all_source_calls = 0x7b,
DW_AT_call_all_tail_calls = 0x7c,
DW_AT_call_return_pc = 0x7d,
DW_AT_call_value = 0x7e,
DW_AT_call_origin = 0x7f,
DW_AT_call_parameter = 0x80,
DW_AT_call_pc = 0x81,
DW_AT_call_tail_call = 0x82,
DW_AT_call_target = 0x83,
DW_AT_call_target_clobbered = 0x84,
DW_AT_call_data_location = 0x85,
DW_AT_call_data_value = 0x86,
DW_AT_noreturn = 0x87,
DW_AT_alignment = 0x88,
DW_AT_export_symbols = 0x89,
DW_AT_deleted = 0x8a,
DW_AT_defaulted = 0x8b,
DW_AT_loclists_base = 0x8c,
/* <_lo_user ; _hi_user> Interval is reserved for vendor extensions */
DW_AT_lo_user = 0x2000,
// extensions:
DW_AT_MIPS_fde = 0x2001,
DW_AT_MIPS_loop_begin = 0x2002,
DW_AT_MIPS_tail_loop_begin = 0x2003,
DW_AT_MIPS_epilog_begin = 0x2004,
DW_AT_MIPS_loop_unroll_factor = 0x2005,
DW_AT_MIPS_software_pipeline_depth = 0x2006,
DW_AT_MIPS_linkage_name = 0x2007, // Same as DWARF4 DW_AT_linkage_name
DW_AT_MIPS_stride = 0x2008,
DW_AT_MIPS_abstract_name = 0x2009,
DW_AT_MIPS_clone_origin = 0x200a,
DW_AT_MIPS_has_inlines = 0x200b,
DW_AT_MIPS_stride_byte = 0x200c,
DW_AT_MIPS_stride_elem = 0x200d,
DW_AT_MIPS_ptr_dopetype = 0x200e,
DW_AT_MIPS_allocatable_dopetype = 0x200f,
DW_AT_MIPS_assumed_shape_dopetype = 0x2010,
// This one appears to have only been implemented by Open64 for
// fortran and may conflict with other extensions.
DW_AT_MIPS_assumed_size = 0x2011,
// TODO: HP/CPQ extensions.
// These conflict with the MIPS extensions.
DW_AT_INTEL_other_endian = 0x2026,
// GNU extensions
DW_AT_sf_names = 0x2101,
DW_AT_src_info = 0x2102,
DW_AT_mac_info = 0x2103,
DW_AT_src_coords = 0x2104,
DW_AT_body_begin = 0x2105,
DW_AT_body_end = 0x2106,
DW_AT_GNU_vector = 0x2107,
DW_AT_GNU_guarded_by = 0x2108,
DW_AT_GNU_pt_guarded_by = 0x2109,
DW_AT_GNU_guarded = 0x210a,
DW_AT_GNU_pt_guarded = 0x210b,
DW_AT_GNU_locks_excluded = 0x210c,
DW_AT_GNU_exclusive_locks_required = 0x210d,
DW_AT_GNU_shared_locks_required = 0x210e,
DW_AT_GNU_odr_signature = 0x210f,
DW_AT_GNU_template_name = 0x2110,
DW_AT_GNU_call_site_value = 0x2111,
DW_AT_GNU_call_site_data_value = 0x2112,
DW_AT_GNU_call_site_target = 0x2113,
DW_AT_GNU_call_site_target_clobbered = 0x2114,
DW_AT_GNU_tail_call = 0x2115,
DW_AT_GNU_all_tail_call_sites = 0x2116,
DW_AT_GNU_all_call_sites = 0x2117,
DW_AT_GNU_all_source_call_sites = 0x2118,
DW_AT_GNU_macros = 0x2119,
DW_AT_GNU_deleted = 0x211a,
// Extensions for Fission proposal.
DW_AT_GNU_dwo_name = 0x2130,
DW_AT_GNU_dwo_id = 0x2131,
DW_AT_GNU_ranges_base = 0x2132,
DW_AT_GNU_addr_base = 0x2133,
DW_AT_GNU_pubnames = 0x2134,
DW_AT_GNU_pubtypes = 0x2135,
DW_AT_GNU_discriminator = 0x2136,
DW_AT_GNU_locviews = 0x2137,
DW_AT_GNU_entry_view = 0x2138,
// Conflict with Sun.
// DW_AT_VMS_rtnbeg_pd_address = 0x2201,
// Sun extensions.
DW_AT_SUN_template = 0x2201,
DW_AT_SUN_alignment = 0x2202,
DW_AT_SUN_vtable = 0x2203,
DW_AT_SUN_count_guarantee = 0x2204,
DW_AT_SUN_command_line = 0x2205,
DW_AT_SUN_vbase = 0x2206,
DW_AT_SUN_compile_options = 0x2207,
DW_AT_SUN_language = 0x2208,
DW_AT_SUN_browser_file = 0x2209,
DW_AT_SUN_vtable_abi = 0x2210,
DW_AT_SUN_func_offsets = 0x2211,
DW_AT_SUN_cf_kind = 0x2212,
DW_AT_SUN_vtable_index = 0x2213,
DW_AT_SUN_omp_tpriv_addr = 0x2214,
DW_AT_SUN_omp_child_func = 0x2215,
DW_AT_SUN_func_offset = 0x2216,
DW_AT_SUN_memop_type_ref = 0x2217,
DW_AT_SUN_profile_id = 0x2218,
DW_AT_SUN_memop_signature = 0x2219,
DW_AT_SUN_obj_dir = 0x2220,
DW_AT_SUN_obj_file = 0x2221,
DW_AT_SUN_original_name = 0x2222,
DW_AT_SUN_hwcprof_signature = 0x2223,
DW_AT_SUN_amd64_parmdump = 0x2224,
DW_AT_SUN_part_link_name = 0x2225,
DW_AT_SUN_link_name = 0x2226,
DW_AT_SUN_pass_with_const = 0x2227,
DW_AT_SUN_return_with_const = 0x2228,
DW_AT_SUN_import_by_name = 0x2229,
DW_AT_SUN_f90_pointer = 0x222a,
DW_AT_SUN_pass_by_ref = 0x222b,
DW_AT_SUN_f90_allocatable = 0x222c,
DW_AT_SUN_f90_assumed_shape_array = 0x222d,
DW_AT_SUN_c_vla = 0x222e,
DW_AT_SUN_return_value_ptr = 0x2230,
DW_AT_SUN_dtor_start = 0x2231,
DW_AT_SUN_dtor_length = 0x2232,
DW_AT_SUN_dtor_state_initial = 0x2233,
DW_AT_SUN_dtor_state_final = 0x2234,
DW_AT_SUN_dtor_state_deltas = 0x2235,
DW_AT_SUN_import_by_lname = 0x2236,
DW_AT_SUN_f90_use_only = 0x2237,
DW_AT_SUN_namelist_spec = 0x2238,
DW_AT_SUN_is_omp_child_func = 0x2239,
DW_AT_SUN_fortran_main_alias = 0x223a,
DW_AT_SUN_fortran_based = 0x223b,
DW_AT_ALTIUM_loclist = 0x2300,
DW_AT_use_GNAT_descriptive_type = 0x2301,
DW_AT_GNAT_descriptive_type = 0x2302,
DW_AT_GNU_numerator = 0x2303,
DW_AT_GNU_denominator = 0x2304,
DW_AT_GNU_bias = 0x2305,
DW_AT_upc_threads_scaled = 0x3210,
// PGI (STMicroelectronics) extensions.
DW_AT_PGI_lbase = 0x3a00,
DW_AT_PGI_soffset = 0x3a01,
DW_AT_PGI_lstride = 0x3a02,
// Borland extensions.
DW_AT_BORLAND_property_read = 0x3b11,
DW_AT_BORLAND_property_write = 0x3b12,
DW_AT_BORLAND_property_implements = 0x3b13,
DW_AT_BORLAND_property_index = 0x3b14,
DW_AT_BORLAND_property_default = 0x3b15,
DW_AT_BORLAND_Delphi_unit = 0x3b20,
DW_AT_BORLAND_Delphi_class = 0x3b21,
DW_AT_BORLAND_Delphi_record = 0x3b22,
DW_AT_BORLAND_Delphi_metaclass = 0x3b23,
DW_AT_BORLAND_Delphi_constructor = 0x3b24,
DW_AT_BORLAND_Delphi_destructor = 0x3b25,
DW_AT_BORLAND_Delphi_anonymous_method = 0x3b26,
DW_AT_BORLAND_Delphi_interface = 0x3b27,
DW_AT_BORLAND_Delphi_ABI = 0x3b28,
DW_AT_BORLAND_Delphi_return = 0x3b29,
DW_AT_BORLAND_Delphi_frameptr = 0x3b30,
DW_AT_BORLAND_closure = 0x3b31,
// LLVM project extensions.
DW_AT_LLVM_include_path = 0x3e00,
DW_AT_LLVM_config_macros = 0x3e01,
DW_AT_LLVM_isysroot = 0x3e02,
DW_AT_LLVM_tag_offset = 0x3e03,
DW_AT_LLVM_ptrauth_key = 0x3e04,
DW_AT_LLVM_ptrauth_address_discriminated = 0x3e05,
DW_AT_LLVM_ptrauth_extra_discriminator = 0x3e06,
DW_AT_LLVM_apinotes = 0x3e07,
DW_AT_LLVM_ptrauth_isa_pointer = 0x3e08,
DW_AT_LLVM_ptrauth_authenticates_null_values = 0x3e09,
// Apple extensions.
DW_AT_APPLE_optimized = 0x3fe1,
DW_AT_APPLE_flags = 0x3fe2,
DW_AT_APPLE_isa = 0x3fe3,
DW_AT_APPLE_block = 0x3fe4,
DW_AT_APPLE_major_runtime_vers = 0x3fe5,
DW_AT_APPLE_runtime_class = 0x3fe6,
DW_AT_APPLE_omit_frame_ptr = 0x3fe7,
DW_AT_APPLE_property_name = 0x3fe8,
DW_AT_APPLE_property_getter = 0x3fe9,
DW_AT_APPLE_property_setter = 0x3fea,
DW_AT_APPLE_property_attribute = 0x3feb,
DW_AT_APPLE_objc_complete_type = 0x3fec,
DW_AT_APPLE_property = 0x3fed,
DW_AT_APPLE_objc_direct = 0x3fee,
DW_AT_APPLE_sdk = 0x3fef,
DW_AT_APPLE_origin = 0x3ff0,
DW_AT_hi_user = 0x3fff,
} DW_AT;
typedef enum {
DW_FORM_addr = 0x01,
DW_FORM_block2 = 0x03,
DW_FORM_block4 = 0x04,
DW_FORM_data2 = 0x05,
DW_FORM_data4 = 0x06,
DW_FORM_data8 = 0x07,
DW_FORM_string = 0x08,
DW_FORM_block = 0x09,
DW_FORM_block1 = 0x0a,
DW_FORM_data1 = 0x0b,
DW_FORM_flag = 0x0c,
DW_FORM_sdata = 0x0d,
DW_FORM_strp = 0x0e,
DW_FORM_udata = 0x0f,
DW_FORM_ref_addr = 0x10,
DW_FORM_ref1 = 0x11,
DW_FORM_ref2 = 0x12,
DW_FORM_ref4 = 0x13,
DW_FORM_ref8 = 0x14,
DW_FORM_ref_udata = 0x15,
DW_FORM_indirect = 0x16,
DW_FORM_sec_offset = 0x17, // DWARF 4 new attribute for section offset
DW_FORM_exprloc = 0x18,
DW_FORM_flag_present = 0x19,
DW_FORM_strx = 0x1a,
DW_FORM_addrx = 0x1b,
DW_FORM_ref_sup4 = 0x1c,
DW_FORM_strp_sup = 0x1d,
DW_FORM_data16 = 0x1e,
DW_FORM_line_ptr = 0x1f,
DW_FORM_ref_sig8 = 0x20,
DW_FORM_implicit_const = 0x21,
DW_FORM_loclistx = 0x22,
DW_FORM_rnglistx = 0x23,
DW_FORM_ref_sup8 = 0x24,
DW_FORM_strx1 = 0x25,
DW_FORM_strx2 = 0x26,
DW_FORM_strx3 = 0x27,
DW_FORM_strx4 = 0x28,
DW_FORM_addrx1 = 0x29,
DW_FORM_addrx2 = 0x2a,
DW_FORM_addrx3 = 0x2b,
DW_FORM_addrx4 = 0x2c,
// Extensions for Fission proposal
DW_FORM_GNU_addr_index = 0x1f01,
DW_FORM_GNU_str_index = 0x1f02,
// Alternate debug sections proposal (output of "dwz" tool).
DW_FORM_GNU_ref_alt = 0x1f20,
DW_FORM_GNU_strp_alt = 0x1f21
} DW_FORM;
typedef enum {
DW_OP_addr = 0x03,
DW_OP_deref = 0x06,
DW_OP_const1u = 0x08,
DW_OP_const1s = 0x09,
DW_OP_const2u = 0x0a,
DW_OP_const2s = 0x0b,
DW_OP_const4u = 0x0c,
DW_OP_const4s = 0x0d,
DW_OP_const8u = 0x0e,
DW_OP_const8s = 0x0f,
DW_OP_constu = 0x10,
DW_OP_consts = 0x11,
DW_OP_dup = 0x12,
DW_OP_drop = 0x13,
DW_OP_over = 0x14,
DW_OP_pick = 0x15,
DW_OP_swap = 0x16,
DW_OP_rot = 0x17,
DW_OP_xderef = 0x18,
DW_OP_abs = 0x19,
DW_OP_and = 0x1a,
DW_OP_div = 0x1b,
DW_OP_minus = 0x1c,
DW_OP_mod = 0x1d,
DW_OP_mul = 0x1e,
DW_OP_neg = 0x1f,
DW_OP_not = 0x20,
DW_OP_or = 0x21,
DW_OP_plus = 0x22,
DW_OP_plus_uconst = 0x23,
DW_OP_shl = 0x24,
DW_OP_shr = 0x25,
DW_OP_shra = 0x26,
DW_OP_xor = 0x27,
DW_OP_skip = 0x2f,
DW_OP_bra = 0x28,
DW_OP_eq = 0x29,
DW_OP_ge = 0x2a,
DW_OP_gt = 0x2b,
DW_OP_le = 0x2c,
DW_OP_lt = 0x2d,
DW_OP_ne = 0x2e,
DW_OP_lit0 = 0x30,
DW_OP_lit1 = 0x31,
DW_OP_lit2 = 0x32,
DW_OP_lit3 = 0x33,
DW_OP_lit4 = 0x34,
DW_OP_lit5 = 0x35,
DW_OP_lit6 = 0x36,
DW_OP_lit7 = 0x37,
DW_OP_lit8 = 0x38,
DW_OP_lit9 = 0x39,
DW_OP_lit10 = 0x3a,
DW_OP_lit11 = 0x3b,
DW_OP_lit12 = 0x3c,
DW_OP_lit13 = 0x3d,
DW_OP_lit14 = 0x3e,
DW_OP_lit15 = 0x3f,
DW_OP_lit16 = 0x40,
DW_OP_lit17 = 0x41,
DW_OP_lit18 = 0x42,
DW_OP_lit19 = 0x43,
DW_OP_lit20 = 0x44,
DW_OP_lit21 = 0x45,
DW_OP_lit22 = 0x46,
DW_OP_lit23 = 0x47,
DW_OP_lit24 = 0x48,
DW_OP_lit25 = 0x49,
DW_OP_lit26 = 0x4a,
DW_OP_lit27 = 0x4b,
DW_OP_lit28 = 0x4c,
DW_OP_lit29 = 0x4d,
DW_OP_lit30 = 0x4e,
DW_OP_lit31 = 0x4f,
DW_OP_reg0 = 0x50,
DW_OP_reg1 = 0x51,
DW_OP_reg2 = 0x52,
DW_OP_reg3 = 0x53,
DW_OP_reg4 = 0x54,
DW_OP_reg5 = 0x55,
DW_OP_reg6 = 0x56,
DW_OP_reg7 = 0x57,
DW_OP_reg8 = 0x58,
DW_OP_reg9 = 0x59,
DW_OP_reg10 = 0x5a,
DW_OP_reg11 = 0x5b,
DW_OP_reg12 = 0x5c,
DW_OP_reg13 = 0x5d,
DW_OP_reg14 = 0x5e,
DW_OP_reg15 = 0x5f,
DW_OP_reg16 = 0x60,
DW_OP_reg17 = 0x61,
DW_OP_reg18 = 0x62,
DW_OP_reg19 = 0x63,
DW_OP_reg20 = 0x64,
DW_OP_reg21 = 0x65,
DW_OP_reg22 = 0x66,
DW_OP_reg23 = 0x67,
DW_OP_reg24 = 0x68,
DW_OP_reg25 = 0x69,
DW_OP_reg26 = 0x6a,
DW_OP_reg27 = 0x6b,
DW_OP_reg28 = 0x6c,
DW_OP_reg29 = 0x6d,
DW_OP_reg30 = 0x6e,
DW_OP_reg31 = 0x6f,
DW_OP_breg0 = 0x70,
DW_OP_breg1 = 0x71,
DW_OP_breg2 = 0x72,
DW_OP_breg3 = 0x73,
DW_OP_breg4 = 0x74,
DW_OP_breg5 = 0x75,
DW_OP_breg6 = 0x76,
DW_OP_breg7 = 0x77,
DW_OP_breg8 = 0x78,
DW_OP_breg9 = 0x79,
DW_OP_breg10 = 0x7a,
DW_OP_breg11 = 0x7b,
DW_OP_breg12 = 0x7c,
DW_OP_breg13 = 0x7d,
DW_OP_breg14 = 0x7e,
DW_OP_breg15 = 0x7f,
DW_OP_breg16 = 0x80,
DW_OP_breg17 = 0x81,
DW_OP_breg18 = 0x82,
DW_OP_breg19 = 0x83,
DW_OP_breg20 = 0x84,
DW_OP_breg21 = 0x85,
DW_OP_breg22 = 0x86,
DW_OP_breg23 = 0x87,
DW_OP_breg24 = 0x88,
DW_OP_breg25 = 0x89,
DW_OP_breg26 = 0x8a,
DW_OP_breg27 = 0x8b,
DW_OP_breg28 = 0x8c,
DW_OP_breg29 = 0x8d,
DW_OP_breg30 = 0x8e,
DW_OP_breg31 = 0x8f,
DW_OP_regx = 0x90,
DW_OP_fbreg = 0x91,
DW_OP_bregx = 0x92,
DW_OP_piece = 0x93,
DW_OP_deref_size = 0x94,
DW_OP_xderef_size = 0x95,
DW_OP_nop = 0x96,
DW_OP_push_object_address = 0x97,
DW_OP_call2 = 0x98,
DW_OP_call4 = 0x99,
DW_OP_call_ref = 0x9a,
DW_OP_form_tls_address = 0x9b,
DW_OP_call_frame_cfa = 0x9c,
DW_OP_bit_piece = 0x9d,
DW_OP_implicit_value = 0x9e,
DW_OP_stack_value = 0x9f,
DW_OP_implicit_pointer = 0xa0,
DW_OP_addrx = 0xa1,
DW_OP_constx = 0xa2,
DW_OP_entry_value = 0xa3,
DW_OP_const_type = 0xa4,
DW_OP_regval_type = 0xa5,
DW_OP_deref_type = 0xa6,
DW_OP_xderef_type = 0xa7,
DW_OP_convert = 0xa8,
DW_OP_reinterpret = 0xa9,
// GNU extensions
DW_OP_GNU_push_tls_address = 0xe0,
DW_OP_GNU_uninit = 0xf0,
DW_OP_GNU_encoded_addr = 0xf1,
DW_OP_GNU_implicit_pointer = 0xf2,
DW_OP_GNU_entry_value = 0xf3,
DW_OP_GNU_const_type = 0xf4,
DW_OP_GNU_regval_type = 0xf5,
DW_OP_GNU_deref_type = 0xf6,
DW_OP_GNU_convert = 0xf7,
DW_OP_GNU_reinterpret = 0xf9,
DW_OP_GNU_parameter_ref = 0xfa,
DW_OP_GNU_addr_index = 0xfb,
DW_OP_GNU_const_index = 0xfc,
// Wasm extensions
DW_OP_WASM_location = 0xed,
/* <_lo_user ; _hi_user> Interval is reserved for vendor extensions */
DW_OP_lo_user = 0xe0,
DW_OP_hi_user = 0xff,
} DW_OP;
typedef enum {
DW_ATE_address = 0x01,
DW_ATE_boolean = 0x02,
DW_ATE_complex_float = 0x03,
DW_ATE_float = 0x04,
DW_ATE_signed = 0x05,
DW_ATE_signed_char = 0x06,
DW_ATE_unsigned = 0x07,
DW_ATE_unsigned_char = 0x08,
DW_ATE_imaginary_float = 0x09,
DW_ATE_packed_decimal = 0x0a,
DW_ATE_numeric_string = 0x0b,
DW_ATE_edited = 0x0c,
DW_ATE_signed_fixed = 0x0d,
DW_ATE_unsigned_fixed = 0x0e,
DW_ATE_decimal_float = 0x0f,
DW_ATE_UTF = 0x10,
/* <_lo_user ; _hi_user> Interval is reserved for vendor extensions */
DW_ATE_lo_user = 0x80,
DW_ATE_hi_user = 0xff,
} DW_ATE;
/// Range list entry encoding values.
///
/// See Section 7.25, Table 7.30.
typedef enum {
DW_RLE_end_of_list = 0x00,
DW_RLE_base_addressx = 0x01,
DW_RLE_startx_endx = 0x02,
DW_RLE_startx_length = 0x03,
DW_RLE_offset_pair = 0x04,
DW_RLE_base_address = 0x05,
DW_RLE_start_end = 0x06,
DW_RLE_start_length = 0x07,
} DW_RLE;
/// The encodings of the constants used in location list entries.
///
/// See Section 7.7.3, Table 7.10.
enum DW_LLE {
DW_LLE_end_of_list = 0x00,
DW_LLE_base_addressx = 0x01,
DW_LLE_startx_endx = 0x02,
DW_LLE_startx_length = 0x03,
DW_LLE_offset_pair = 0x04,
DW_LLE_default_location = 0x05,
DW_LLE_base_address = 0x06,
DW_LLE_start_end = 0x07,
DW_LLE_start_length = 0x08,
DW_LLE_GNU_view_pair = 0x09,
};
typedef enum {
DW_DS_unsigned = 0x01,
DW_DS_leading_overpunch = 0x02,
DW_DS_trailing_overpunch = 0x03,
DW_DS_leading_separate = 0x04,
DW_DS_trailing_separate = 0x05,
} DW_DS;
typedef enum {
DW_END_default = 0x00,
DW_END_big = 0x01,
DW_END_little = 0x02,
/* <_lo_user ; _hi_user> Interval is reserved for vendor extensions */
DW_END_lo_user = 0x40,
DW_END_hi_user = 0xff,
} DW_END;
typedef enum {
DW_ACCESS_public = 0x01,
DW_ACCESS_protected = 0x02,
DW_ACCESS_private = 0x03,
} DW_ACCESS;
typedef enum {
DW_VIS_local = 0x01,
DW_VIS_exported = 0x02,
DW_VIS_qualified = 0x03,
} DW_VIS;
typedef enum {
DW_VIRTUALITY_none = 0x00,
DW_VIRTUALITY_virtual = 0x01,
DW_VIRTUALITY_pure_virtual = 0x02,
} DW_VIRTUALITY;
typedef enum {
DW_LANG_C89 = 0x0001,
DW_LANG_C = 0x0002,
DW_LANG_Ada83 = 0x0003,
DW_LANG_C_plus_plus = 0x0004,
DW_LANG_Cobol74 = 0x0005,
DW_LANG_Cobol85 = 0x0006,
DW_LANG_Fortran77 = 0x0007,
DW_LANG_Fortran90 = 0x0008,
DW_LANG_Pascal83 = 0x0009,
DW_LANG_Modula2 = 0x000a,
DW_LANG_Java = 0x000b,
DW_LANG_C99 = 0x000c,
DW_LANG_Ada95 = 0x000d,
DW_LANG_Fortran95 = 0x000e,
DW_LANG_PLI = 0x000f,
DW_LANG_ObjC = 0x0010,
DW_LANG_ObjC_plus_plus = 0x0011,
DW_LANG_UPC = 0x0012,
DW_LANG_D = 0x0013,
DW_LANG_Python = 0x0014,
DW_LANG_Rust = 0x001c,
DW_LANG_C11 = 0x001d,
DW_LANG_Swift = 0x001e,
DW_LANG_Julia = 0x001f,
DW_LANG_Dylan = 0x0020,
DW_LANG_C_plus_plus_14 = 0x0021,
DW_LANG_Fortran03 = 0x0022,
DW_LANG_Fortran08 = 0x0023,
DW_LANG_RenderScript = 0x0024,
DW_LANG_BLISS = 0x0025,
// Since Version 5
DW_LANG_Kotlin = 0x0026,
DW_LANG_Zig = 0x0027,
DW_LANG_Crystal = 0x0028,
DW_LANG_C_plus_plus_17 = 0x002a,
DW_LANG_C_plus_plus_20 = 0x002b,
DW_LANG_C17 = 0x002c,
DW_LANG_Fortran18 = 0x002d,
DW_LANG_Ada2005 = 0x002e,
DW_LANG_Ada2012 = 0x002f,
DW_LANG_HIP = 0x0030,
DW_LANG_Assembly = 0x0031,
DW_LANG_C_sharp = 0x0032,
DW_LANG_Mojo = 0x0033,
DW_LANG_lo_user = 0x8000,
DW_LANG_hi_user = 0xffff,
DW_LANG_Mips_Assembler = 0x8001,
DW_LANG_GOOGLE_RenderScript = 0x8e57,
DW_LANG_SUN_Assembler = 0x9001,
DW_LANG_ALTIUM_Assembler = 0x9101,
DW_LANG_BORLAND_Delphi = 0xb000,
} DW_LANG;
typedef enum {
DW_ID_case_sensitive = 0x00,
DW_ID_up_case = 0x01,
DW_ID_down_case = 0x02,
DW_ID_case_insensitive = 0x03,
} DW_ID;
typedef enum {
DW_CC_normal = 0x01,
DW_CC_program = 0x02,
DW_CC_nocall = 0x03,
DW_CC_lo_user = 0x40,
DW_CC_hi_user = 0xff,
} DW_CC;
typedef enum {
DW_INL_not_inlined = 0x00,
DW_INL_inlined = 0x01,
DW_INL_declared_not_inlined = 0x02,
DW_INL_declared_inlined = 0x03,
} DW_INL;
typedef enum {
DW_ORD_row_major = 0x00,
DW_ORD_col_major = 0x01,
} DW_ORD;
typedef enum {
DW_DSC_label = 0x00,
DW_DSC_range = 0x01,
} DW_DSC;
typedef enum {
DW_MACINFO_define = 0x01,
DW_MACINFO_undef = 0x02,
DW_MACINFO_start_file = 0x03,
DW_MACINFO_end_file = 0x04,
DW_MACINFO_vendor_ext = 0xff,
} DW_MACINFO;
typedef enum {
DW_CFA_advance_loc = 0x40,
DW_CFA_offset = 0x80,
DW_CFA_restore = 0xc0,
DW_CFA_nop = 0x00,
DW_CFA_set_loc = 0x01,
DW_CFA_advance_loc1 = 0x02,
DW_CFA_advance_loc2 = 0x03,
DW_CFA_advance_loc4 = 0x04,
DW_CFA_offse_extended = 0x05,
DW_CFA_restore_extended = 0x06,
DW_CFA_undefined = 0x07,
DW_CFA_same_value = 0x08,
DW_CFA_register = 0x09,
DW_CFA_remember_state = 0x0a,
DW_CFA_restore_state = 0x0b,
DW_CFA_def_cfa = 0x0c,
DW_CFA_def_cfa_register = 0x0d,
DW_CFA_def_cfa_offset = 0x0e,
DW_CFA_def_cfa_expression = 0x0f,
DW_CFA_expression = 0x10,
DW_CFA_offset_extended_sf = 0x11,
DW_CFA_def_cfa_sf = 0x12,
DW_CFA_def_cfa_offset_sf = 0x13,
DW_CFA_val_offset = 0x14,
DW_CFA_val_offset_sf = 0x15,
DW_CFA_val_expression = 0x16,
DW_CFA_lo_user = 0x1c,
DW_CFA_hi_user = 0x3f,
} DW_CFA;
typedef enum {
DW_UT_compile = 0x01,
DW_UT_type = 0x02,
DW_UT_partial = 0x03,
DW_UT_skeleton = 0x04,
DW_UT_split_compile = 0x05,
DW_UT_split_type = 0x06,
DW_UT_lo_user = 0x80,
DW_UT_hi_user = 0xff,
} DW_UT;
/// The encodings for the line number header entry formats.
///
/// See Section 7.22, Table 7.27.
typedef enum {
DW_LNCT_path = 0x1,
DW_LNCT_directory_index = 0x2,
DW_LNCT_timestamp = 0x3,
DW_LNCT_size = 0x4,
DW_LNCT_MD5 = 0x5,
DW_LNCT_lo_user = 0x2000,
DW_LNCT_hi_user = 0x3fff,
} DW_LNCT;
struct rz_bin_section_t;
typedef struct {
ut8 *data;
bool owned;
ut64 length;
ut64 offset;
bool big_endian;
HtUP *relocations;
} RzBinEndianReader;
typedef struct {
DW_AT at;
DW_FORM form;
st64 special; // Used for values coded directly into abbrev
} RzBinDwarfAttrSpec;
typedef RzBinEndianReader RzBinDwarfBlock;
// http://www.dwarfstd.org/doc/DWARF4.pdf#page=29&zoom=100,0,0
typedef enum {
RzBinDwarfAttr_Addr,
RzBinDwarfAttr_AddrBase, /// An offset to a set of addresses in the `.debug_addr` section.
RzBinDwarfAttr_AddrIndex, /// An index into a set of addresses in the `.debug_addr` section.
RzBinDwarfAttr_Block,
RzBinDwarfAttr_Constant,
RzBinDwarfAttr_UConstant,
RzBinDwarfAttr_Exprloc,
RzBinDwarfAttr_Flag,
RzBinDwarfAttr_LoclistPtr,
RzBinDwarfAttr_MacPtr,
RzBinDwarfAttr_RangelistPtr,
RzBinDwarfAttr_Reference,
RzBinDwarfAttr_UnitRef,
RzBinDwarfAttr_SecOffset,
RzBinDwarfAttr_StrRef, /// An offset into the .debug_str section.
RzBinDwarfAttr_StrOffsetIndex, /// An offset to a set of entries in the .debug_str_offsets section.
RzBinDwarfAttr_LineStrRef, /// An offset into the .debug_line_str section.
RzBinDwarfAttr_String, /// A slice of bytes representing a string. Does not include a final null byte. Not guaranteed to be UTF-8 or anything like that.
} RzBinDwarfAttrClass;
typedef struct {
RzBinDwarfAttrClass kind;
union {
RzBinDwarfBlock block;
ut64 u64;
ut128 u128;
st64 s64;
ut8 flag;
const char *string;
};
} RzBinDwarfAttrValue;
typedef struct dwarf_attr_t {
DW_AT at;
DW_FORM form;
RzBinDwarfAttrValue value;
} RzBinDwarfAttr;
typedef struct {
ut8 address_size;
ut16 version;
bool is_64bit;
} RzBinDwarfEncoding;
typedef struct {
// A 4-byte (or 8 byte for 64bit dwarf) unsigned length of the .debug_info contribution
// for that compilation unit, not including the length field itself.
ut64 length;
// A 4-byte unsigned offset into the .debug_abbrev section.
ut64 abbrev_offset;
DW_UT ut; // DWARF 5 addition
union {
ut64 dwo_id; // DWARF 5 addition
struct {
ut64 type_sig; // DWARF 5 addition
ut64 type_offset; // DWARF 5 addition
};
};
ut64 header_size; // excluding length field
RzBinDwarfEncoding encoding;
} RzBinDwarfCompUnitHdr;
typedef struct {
ut64 offset; // important for parsing types
DW_TAG tag;
ut64 abbrev_code;
DW_CHILDREN has_children; // important for parsing types
RzVector /*<RzBinDwarfAttrValue>*/ attrs;
size_t unit_offset;
size_t index;
size_t depth;
ut64 sibling;
} RzBinDwarfDie;
typedef struct rz_bin_dwarf_comp_unit_t {
ut64 offset;
ut64 index;
RzBinDwarfCompUnitHdr hdr;
RzVector /*<RzBinDwarfDie>*/ dies;
const char *name;
const char *comp_dir;
const char *producer;
const char *dwo_name;
DW_LANG language;
ut64 low_pc;
ut64 high_pc;
ut64 stmt_list;
ut64 str_offsets_base;
ut64 addr_base;
ut64 loclists_base;
ut64 rnglists_base;
} RzBinDwarfCompUnit;
typedef struct {
RzBinEndianReader *R;
RzVector /*<RzBinDwarfCompUnit>*/ units;
HtUP /*<ut64, DwarfDie *>*/ *die_by_offset;
HtUP /*<ut64, RzBinDwarfCompUnit *>*/ *unit_by_offset;
size_t die_count;
/**
* Cache mapping from an offset in the debug_line section to a string
* representing the DW_AT_comp_dir attribute of the compilation unit
* that references this particular line information.
*/
HtUP /*<ut64, char *>*/ *comp_dir_by_offset;
HtUP /*<ut64, const RzBinDwarfEncoding*>*/ *location_encoding;
} RzBinDwarfInfo;
typedef struct {
ut64 code;
DW_TAG tag;
ut64 offset;
DW_CHILDREN has_children;
RzVector /*<RzBinDwarfAttrDef>*/ defs;
} RzBinDwarfAbbrevDecl;
typedef struct {
RzVector /*<RzBinDwarfAbbrevDecl>*/ abbrevs;
size_t offset;
} RzBinDwarfAbbrevTable;
typedef struct {
RzBinEndianReader *R;
HtUP /*<size_t,RzBinDwarfDebugAbbrevTable*>*/ *by_offset;
size_t count;
} RzBinDwarfAbbrev;
typedef struct rz_bin_dwarf_line_file_entry_format_t {
DW_LNCT content_type;
DW_FORM form;
} RzBinDwarfFileEntryFormat;
typedef struct {
const char *path_name;
ut64 directory_index;
ut64 timestamp;
ut64 size;
ut8 md5[16];
} RzBinDwarfFileEntry;
typedef struct {
ut64 offset; //< offset inside the debug_line section, for references from outside
ut64 unit_length;
ut64 header_length;
ut8 min_inst_len;
ut8 max_ops_per_inst;
ut8 default_is_stmt;
st32 line_base;
ut8 line_range;
ut8 opcode_base;
ut8 segment_selector_size;
RzBinDwarfEncoding encoding;
/**
* \brief The number of LEB128 operands for each of the standard opcodes
* From standard_opcode_lengths in DWARF 3 standard:
* The first element of the array corresponds to the opcode whose value is 1,
* and the last element corresponds to the opcode whose value is opcode_base - 1.
* Thus, the size of this array is opcode_base - 1.
*/
const ut8 *std_opcode_lengths;
RzVector /*<RzBinDwarfFileEntryFormat>*/ directory_entry_formats;
RzPVector /*<const char *>*/ directories;
RzVector /*<RzBinDwarfFileEntryFormat>*/ file_name_entry_formats;
RzVector /*<RzBinDwarfFileEntry>*/ file_names;
} RzBinDwarfLineUnitHdr;
typedef enum {
RZ_BIN_DWARF_LINE_OP_TYPE_SPEC, //< single byte op, no args
RZ_BIN_DWARF_LINE_OP_TYPE_STD, //< fixed-size op, 0 or more leb128 args (except DW_LNS_fixed_advance_pc)
RZ_BIN_DWARF_LINE_OP_TYPE_EXT, //< variable-size op, arbitrary format of args
RZ_BIN_DWARF_LINE_OP_TYPE_EXT_UNKNOWN, //< variable-size op, arbitrary format of args
} RzBinDwarfLineOpType;
typedef struct {
ut64 offset;
RzBinDwarfLineOpType type;
union {
DW_LNS opcode;
DW_LNE ext_opcode;
};
struct {
union {
ut64 advance_pc; //< DW_LNS_advance_pc
st64 advance_line; //< DW_LNS_advance_line
ut64 set_file; //< DW_LNS_set_file
ut64 set_column; //< DW_LNS_set_column
ut64 fixed_advance_pc; //< DW_LNS_fixed_advance_pc
ut64 set_isa; //< DW_LNS_set_isa
ut64 set_address; //< DW_LNE_set_address
RzBinDwarfFileEntry define_file; //< DW_LNE_define_file
ut64 set_discriminator; //< DW_LNE_set_discriminator
};
} args;
} RzBinDwarfLineOp;
/**
* \brief DWARF 3 Standard Section 6.2 Line Number Information
* This contains the entire raw line info for one compilation unit.
*/
typedef struct {
RzBinDwarfLineUnitHdr hdr;
RzVector /*<RzBinDwarfLineOp>*/ ops;
} RzBinDwarfLineUnit;
/**
* \brief Line info of all compilation units from the entire debug_line section
*/
typedef struct {
RzBinEndianReader *R;
RzPVector /*<RzBinDwarfLineUnit *>*/ *units;
RzBinSourceLineInfo *lines;
} RzBinDwarfLine;
typedef struct rz_bin_dwarf_arange_t {
ut64 addr;
ut64 length;
} RzBinDwarfARange;
/**
* \brief DWARF 3 Standard Section 6.1.2 Lookup by Address
*/
typedef struct rz_bin_dwarf_arange_set_t {
ut64 unit_length;
bool is_64bit;
ut16 version;
ut64 debug_info_offset;
ut8 address_size;
ut8 segment_size;
size_t aranges_count;
RzBinDwarfARange *aranges;
} RzBinDwarfARangeSet;
typedef struct {
RzBinEndianReader *R;
RzList /*<RzBinDwarfARangeSet *>*/ *list;
} RzBinDwarfARanges;
typedef struct {
RzBinDwarfEncoding encoding;
ut64 unit_length;
ut32 offset_entry_count;
ut8 segment_selector_size;
ut64 *location_offsets;
} RzBinDwarfListsHdr;
/// The raw contents of the `.debug_addr` section.
typedef struct {
RzBinEndianReader *R;
} RzBinDwarfAddr;
typedef struct {
RzBinEndianReader *R;
} RzBinDwarfStr;
typedef RzBinDwarfStr RzBinDwarfLineStr;
typedef struct {
RzBinEndianReader *R;
RzBinDwarfEncoding encoding;
ut64 unit_length;
ut16 padding;
} RzBinDwarfStrOffsets;
/// A raw address range from the `.debug_ranges` section.
typedef struct {
/// The beginning address of the range.
ut64 begin;
/// The first address past the end of the range.
ut64 end;
} RzBinDwarfRange;
typedef enum {
/// The bare range list format used before DWARF 5.
RzBinDwarfRngListsFormat_Bare,
/// The DW_RLE encoded range list format used in DWARF 5.
RzBinDwarfRngListsFormat_Rle,
} RzBinDwarfRngListsFormat;
/// A raw entry in .debug_rnglists
typedef struct {
DW_RLE encoding;
bool is_address_or_offset_pair;
union {
/// A range from DWARF version <= 4.
struct {
ut64 begin; /// Start of range. May be an address or an offset.
ut64 end; /// End of range. May be an address or an offset.
} address_or_offset_pair;
/// DW_RLE_base_address
struct {
ut64 addr; /// base address
} base_address;
/// DW_RLE_base_addressx
struct {
ut64 addr; /// base address
} base_addressx;
/// DW_RLE_startx_endx
struct {
ut64 begin; /// Start of range.
ut64 end; /// End of range.
} startx_endx;
/// DW_RLE_startx_length
struct {
ut64 begin; /// start of range
ut64 length; /// length of range
} startx_length;
/// DW_RLE_offset_pair
struct {
ut64 begin; /// Start of range.
ut64 end; /// End of range.
} offset_pair;
/// DW_RLE_start_end
struct {
ut64 begin; /// Start of range.
ut64 end; /// End of range.
} start_end;
/// DW_RLE_start_length
struct {
ut64 begin; /// Start of range.
ut64 length; /// Length of range.
} start_length;
};
} RzBinDwarfRawRngListEntry;
typedef struct {
ut64 offset;
RzPVector /*<RzBinDwarfRawRngListEntry *>*/ raw_entries;
RzPVector /*<RzBinDwarfRange *>*/ entries;
} RzBinDwarfRngList;
typedef struct {
RzBinEndianReader *rnglists;
RzBinEndianReader *ranges;
ut64 base_address;
RzBinDwarfListsHdr hdr;
HtUP /*<ut64, RzBinDwarfLocList>*/ *by_offset;
} RzBinDwarfRngLists;
typedef enum {
/// The bare location list format used before DWARF 5.
RzBinDwarfLocListsFormat_BARE,
/// The DW_LLE encoded range list format used in DWARF 5 and the non-standard GNU
/// split dwarf extension.
RzBinDwarfLocListsFormat_LLE,
} RzBinDwarfLocListsFormat;
typedef struct {
enum DW_LLE encoding;
bool is_address_or_offset_pair;
union {
/// A location from DWARF version <= 4.
struct {
ut64 begin; /// Start of range. May be an address or an offset.
ut64 end; /// End of range. May be an address or an offset.
RzBinDwarfBlock data; /// expression
} address_or_offset_pair;
/// DW_LLE_base_address
struct {
ut64 addr; /// base address
} base_address;
/// DW_LLE_base_addressx
struct {
ut64 addr; /// base address
} base_addressx;
/// DW_LLE_startx_endx
struct {
ut64 begin; /// Start of range.
ut64 end; /// End of range.
RzBinDwarfBlock data; /// expression
} startx_endx;
/// DW_LLE_startx_length
struct {
ut64 begin; /// start of range
ut64 length; /// length of range
RzBinDwarfBlock data; /// expression
} startx_length;
/// DW_LLE_offset_pair
struct {
ut64 begin; /// Start of range.
ut64 end; /// End of range.
RzBinDwarfBlock data; /// expression
} offset_pair;
/// DW_LLE_default_location
struct {
RzBinDwarfBlock data; /// expression
} default_location;
/// DW_LLE_start_end
struct {
ut64 begin; /// Start of range.
ut64 end; /// End of range.
RzBinDwarfBlock data; /// expression
} start_end;
/// DW_LLE_start_length
struct {
ut64 begin; /// Start of range.
ut64 length; /// Length of range.
RzBinDwarfBlock data; /// expression
} start_length;
};
} RzBinDwarfRawLocListEntry;
struct rz_bin_dwarf_location_t;
typedef struct {
RzBinDwarfRange range;
const RzBinDwarfBlock *expression;
struct rz_bin_dwarf_location_t *location;
} RzBinDwarfLocListEntry;
typedef struct {
ut64 offset;
bool has_location;
RzPVector /*<RzBinDwarfRawLocListEntry *>*/ raw_entries;
RzPVector /*<RzBinDwarfLocListEntry *>*/ entries;
} RzBinDwarfLocList;
typedef struct {
RzBinEndianReader *loclists;
RzBinEndianReader *loc;
ut64 base_address;
RzBinDwarfListsHdr hdr;
HtUP /*<ut64, RzBinDwarfLocList>*/ *by_offset;
} RzBinDwarfLocLists;
struct rz_core_bin_dwarf_t;
typedef struct rz_core_bin_dwarf_t {
struct rz_core_bin_dwarf_t *parent;
RzBinDwarfARanges *aranges;
RzBinDwarfLine *line;
RzBinDwarfLocLists *loclists;
RzBinDwarfRngLists *rnglists;
RzBinDwarfInfo *info;
RzBinDwarfAbbrev *abbrev;
RzBinDwarfAddr *addr;
RzBinDwarfStr *str;
RzBinDwarfStrOffsets *str_offsets;
RzBinDwarfLineStr *line_str;
} RzBinDWARF;
#define DWARF_FIELD_IMPL(T, F) \
static inline T *rz_bin_dwarf_##F( \
RZ_BORROW RZ_NONNULL const RzBinDWARF *dw) { \
rz_return_val_if_fail(dw, NULL); \
return dw->F ? dw->F : (dw->parent ? dw->parent->F : NULL); \
}
DWARF_FIELD_IMPL(RzBinDwarfAddr, addr);
DWARF_FIELD_IMPL(RzBinDwarfLine, line);
DWARF_FIELD_IMPL(RzBinDwarfLineStr, line_str);
#undef DWARF_FIELD_IMPL
RZ_API const char *rz_bin_dwarf_tag(DW_TAG tag);
RZ_API const char *rz_bin_dwarf_attr(DW_AT attr_code);
RZ_API const char *rz_bin_dwarf_form(DW_FORM form_code);
RZ_API const char *rz_bin_dwarf_unit_type(DW_UT unit_type);
RZ_API const char *rz_bin_dwarf_lang(DW_LANG lang);
RZ_API const char *rz_bin_dwarf_lang_for_demangle(DW_LANG lang);
RZ_API const char *rz_bin_dwarf_children(DW_CHILDREN children);
RZ_API const char *rz_bin_dwarf_lns(DW_LNS lns);
RZ_API const char *rz_bin_dwarf_lne(DW_LNE lne);
RZ_API const char *rz_bin_dwarf_lnct(DW_LNCT lnct);
RZ_API const char *rz_bin_dwarf_op(DW_OP op);
RZ_API const char *rz_bin_dwarf_ate(DW_ATE op);
/// .debug_str
RZ_API RZ_OWN RzBinDwarfStr *rz_bin_dwarf_str_new(RZ_NONNULL RZ_OWN RzBinEndianReader *R);
RZ_API RZ_OWN RzBinDwarfStr *rz_bin_dwarf_str_from_file(RZ_NONNULL RZ_BORROW RzBinFile *bf);
RZ_API void rz_bin_dwarf_str_free(RZ_NULLABLE RzBinDwarfStr *str);
RZ_API RZ_BORROW const char *rz_bin_dwarf_str_get(RZ_NONNULL RZ_BORROW RzBinDwarfStr *str, ut64 offset);
RZ_API RZ_OWN RzBinDwarfLineStr *rz_bin_dwarf_line_str_new(RZ_NONNULL RZ_OWN RzBinEndianReader *R);
RZ_API RZ_OWN RzBinDwarfLineStr *rz_bin_dwarf_line_str_from_file(RZ_NONNULL RZ_BORROW RzBinFile *bf);
RZ_API void rz_bin_dwarf_line_str_free(RZ_NULLABLE RzBinDwarfLineStr *str);
RZ_API RZ_BORROW const char *rz_bin_dwarf_line_str_get(RZ_NONNULL RZ_BORROW RzBinDwarfLineStr *str, ut64 offset);
/// .debug_str_offsets
RZ_API RZ_OWN RzBinDwarfStrOffsets *rz_bin_dwarf_str_offsets_new(RZ_NONNULL RZ_OWN RzBinEndianReader *R);
RZ_API RZ_OWN RzBinDwarfStrOffsets *rz_bin_dwarf_str_offsets_from_file(RZ_NONNULL RZ_BORROW RzBinFile *bf);
RZ_API void rz_bin_dwarf_str_offsets_free(RZ_NULLABLE RzBinDwarfStrOffsets *str_offsets);
RZ_API RZ_BORROW const char *rz_bin_dwarf_str_offsets_get(
RZ_NONNULL RZ_BORROW RzBinDwarfStr *str,
RZ_NONNULL RZ_BORROW RzBinDwarfStrOffsets *str_offsets,
ut64 base, ut64 index);
/// .debug_aranges
RZ_API RZ_OWN RzBinDwarfARanges *rz_bin_dwarf_aranges_new(RZ_NONNULL RZ_OWN RzBinEndianReader *R);
RZ_API RZ_OWN RzBinDwarfARanges *rz_bin_dwarf_aranges_from_file(RZ_BORROW RZ_NONNULL RzBinFile *bf);
RZ_API void rz_bin_dwarf_arange_set_free(RZ_OWN RZ_NULLABLE RzBinDwarfARangeSet *set);
RZ_API void rz_bin_dwarf_aranges_free(RZ_OWN RZ_NULLABLE RzBinDwarfARanges *aranges);
RZ_API void rz_bin_dwarf_aranges_dump(
RZ_NONNULL RZ_BORROW RzBinDwarfARanges *aranges,
RZ_NONNULL RZ_BORROW RzStrBuf *sb);
/// .debug_abbrev
RZ_API RZ_OWN RzBinDwarfAbbrev *rz_bin_dwarf_abbrev_new(RZ_OWN RZ_NONNULL RzBinEndianReader *R);
RZ_API RZ_OWN RzBinDwarfAbbrev *rz_bin_dwarf_abbrev_from_file(RZ_BORROW RZ_NONNULL RzBinFile *bf);
RZ_API void rz_bin_dwarf_abbrev_free(RZ_OWN RZ_NULLABLE RzBinDwarfAbbrev *abbrevs);
RZ_API size_t rz_bin_dwarf_abbrev_count(RZ_BORROW RZ_NONNULL const RzBinDwarfAbbrev *da);
RZ_API RZ_BORROW RzBinDwarfAbbrevDecl *rz_bin_dwarf_abbrev_get(
RZ_BORROW RZ_NONNULL const RzBinDwarfAbbrevTable *tbl, size_t idx);
RZ_API size_t rz_bin_dwarf_abbrev_decl_count(RZ_BORROW RZ_NONNULL const RzBinDwarfAbbrevDecl *decl);
RZ_API RZ_BORROW RzBinDwarfAttrSpec *rz_bin_dwarf_abbrev_attr_by_name(
RZ_BORROW RZ_NONNULL const RzBinDwarfAbbrevDecl *abbrev, DW_AT name);
RZ_API void rz_core_bin_dwarf_abbrevs_dump(
RZ_NONNULL RZ_BORROW const RzBinDwarfAbbrev *abbrevs,
RZ_NONNULL RZ_BORROW RzStrBuf *sb);
/// .debug_info
RZ_API RZ_OWN RzBinDwarfInfo *rz_bin_dwarf_info_from_buf(
RZ_OWN RZ_NONNULL RzBinEndianReader *R,
RZ_BORROW RZ_NONNULL RzBinDWARF *dw);
RZ_API RZ_OWN RzBinDwarfInfo *rz_bin_dwarf_info_from_file(
RZ_BORROW RZ_NULLABLE RzBinDWARF *dw,
RZ_BORROW RZ_NONNULL RzBinFile *bf);
RZ_API void rz_bin_dwarf_info_free(RZ_OWN RZ_NULLABLE RzBinDwarfInfo *info);
RZ_API RZ_BORROW RzBinDwarfAttr *rz_bin_dwarf_die_get_attr(
RZ_BORROW RZ_NONNULL const RzBinDwarfDie *die, DW_AT name);
RZ_API void rz_bin_dwarf_debug_info_dump(
RZ_NONNULL RZ_BORROW const RzBinDwarfInfo *info,
RZ_NONNULL RZ_BORROW const RzBinDWARF *dw,
RZ_NONNULL RZ_BORROW RzStrBuf *sb);
/// .debug_line
RZ_API RZ_OWN RzBinDwarfLine *rz_bin_dwarf_line_new(
RZ_BORROW RZ_NONNULL RzBinEndianReader *R,
RZ_BORROW RZ_NONNULL RzBinDwarfEncoding *encoding,
RZ_BORROW RZ_NULLABLE RzBinDWARF *dw);
RZ_API RZ_OWN RzBinDwarfLine *rz_bin_dwarf_line_from_file(
RZ_BORROW RZ_NULLABLE RzBinDWARF *dw,
RZ_BORROW RZ_NONNULL RzBinFile *bf);
RZ_API void rz_bin_dwarf_line_free(RZ_OWN RZ_NULLABLE RzBinDwarfLine *li);
RZ_API void rz_bin_dwarf_line_units_dump(
RZ_NONNULL RZ_BORROW RzBinDwarfLine *line,
RZ_NONNULL RZ_BORROW RzStrBuf *sb);
RZ_API RZ_OWN char *rz_bin_dwarf_file_path(RZ_NONNULL RZ_BORROW RzBinDWARF *dw,
RZ_NONNULL RZ_BORROW RzBinDwarfLineUnit *lu, ut64 index);
/// dwarf
RZ_API RZ_OWN RzBinDWARF *rz_bin_dwarf_from_file(RZ_BORROW RZ_NONNULL RzBinFile *bf);
RZ_API RZ_OWN RzBinDWARF *rz_bin_dwarf_from_path(
RZ_BORROW RZ_NONNULL const char *filepath,
RZ_BORROW RZ_NULLABLE RzBinDWARF *parent);
RZ_API RZ_OWN RzBinDWARF *rz_bin_dwarf_load_dsym(RZ_BORROW RZ_NONNULL RzBinFile *bf);
RZ_API RZ_OWN RzBinDWARF *rz_bin_dwarf_search_debug_file_directory(
RZ_BORROW RZ_NONNULL RzBinFile *bf,
RZ_BORROW RZ_NONNULL RzList /*<const char *>*/ *debug_file_directorys);
RZ_API RZ_OWN RzBinDWARF *rz_bin_dwarf_from_debuginfod(
RZ_BORROW RZ_NONNULL RzBinFile *bf,
RZ_BORROW RZ_NONNULL RzList /*<const char *>*/ *debuginfod_urls);
RZ_API void rz_bin_dwarf_free(RZ_OWN RZ_NULLABLE RzBinDWARF *dw);
RZ_API void rz_bin_dwarf_dump(
RZ_BORROW RZ_NONNULL RzBinDWARF *dw,
RZ_BORROW RZ_NONNULL RzStrBuf *sb);
// Assuming ValueType is an enum defined elsewhere
typedef enum {
RzBinDwarfValueType_GENERIC,
RzBinDwarfValueType_I8,
RzBinDwarfValueType_U8,
RzBinDwarfValueType_I16,
RzBinDwarfValueType_U16,
RzBinDwarfValueType_I32,
RzBinDwarfValueType_U32,
RzBinDwarfValueType_F32,
RzBinDwarfValueType_I64,
RzBinDwarfValueType_U64,
RzBinDwarfValueType_F64,
RzBinDwarfValueType_I128,
RzBinDwarfValueType_U128,
RzBinDwarfValueType_LOCATION,
} RzBinDwarfValueType;
struct rz_bin_dwarf_location_t;
typedef struct {
RzBinDwarfValueType type;
union {
ut64 generic;
ut8 u8;
st8 i8;
ut16 u16;
st16 i16;
ut32 u32;
st32 i32;
ut64 u64;
st64 i64;
float f32;
double f64;
struct rz_bin_dwarf_location_t *location;
};
} RzBinDwarfValue;
typedef ut64 UnitOffset;
typedef ut64 DebugInfoOffset;
struct rz_bin_dwarf_location_t;
typedef struct {
bool has_bit_offset;
ut64 bit_offset;
struct rz_bin_dwarf_location_t *location;
bool has_size_in_bits;
ut64 size_in_bits;
} RzBinDwarfPiece;
typedef enum {
EvaluationStateWaiting_MEMORY,
EvaluationStateWaiting_ENTRY_VALUE,
EvaluationStateWaiting_RelocatedAddress,
EvaluationStateWaiting_IndexedAddress,
EvaluationStateWaiting_TLS,
EvaluationStateWaiting_AtLocation,
EvaluationStateWaiting_ParameterRef,
EvaluationStateWaiting_FbReg,
} RzBinDwarfEvaluationStateWaiting;
typedef struct {
enum {
EVALUATION_STATE_START,
EVALUATION_STATE_READY,
EVALUATION_STATE_ERROR,
EVALUATION_STATE_DECODE_ERROR,
EVALUATION_STATE_COMPLETE,
EVALUATION_STATE_WAITING,
EVALUATION_STATE_WAITING_RESOLVE,
} kind;
union {
RzBinDwarfValue *start; // nullable
// Error error;
RzBinDwarfEvaluationStateWaiting waiting;
};
} RzBinDwarfEvaluationState;
typedef struct {
const RzBinDWARF *dw;
const RzBinDwarfCompUnit *unit;
const RzBinDwarfDie *fn_die;
RzBinEndianReader bytecode;
const RzBinDwarfEncoding *encoding;
ut64 *object_address;
ut32 max_iterations;
ut32 iteration;
RzBinDwarfEvaluationState state;
// Stack operations are done on word-sized values. We do all
// operations on 64-bit values, and then mask the results
// appropriately when popping.
ut64 addr_mask;
// The stack.
RzVector /*<RzBinDwarfValue>*/ stack;
// The next operation to decode and evaluate.
RzBinEndianReader pc;
// If we see a DW_OP_call* operation, the previous PC and bytecode
// is stored here while evaluating the subroutine.
RzVector /*<RzBinDwarfExprStackItem>*/ expression_stack;
RzVector /*<Piece>*/ result;
} RzBinDwarfEvaluation;
typedef struct {
enum {
EvaluationResult_COMPLETE,
EvaluationResult_INCOMPLETE,
EvaluationResult_ERR,
EvaluationResult_REQUIRES_MEMORY,
EvaluationResult_REQUIRES_ENTRY_VALUE,
EvaluationResult_REQUIRES_RESOLVE,
} kind;
union {
struct {
ut64 address;
ut8 size;
bool has_space : 1;
ut64 space : 63;
UnitOffset base_type;
} requires_memory;
struct {
RzBinDwarfBlock expression;
} requires_entry_value;
ut64 requires_relocated_address;
struct {
ut64 index;
bool relocate;
} requires_indexed_address;
struct {
ut64 offset;
} requires_at_location;
struct {
ut64 offset;
} requires_parameter_ref;
};
} RzBinDwarfEvaluationResult;
typedef enum {
RzBinDwarfLocationKind_EMPTY,
RzBinDwarfLocationKind_DECODE_ERROR,
RzBinDwarfLocationKind_REGISTER,
RzBinDwarfLocationKind_REGISTER_OFFSET,
RzBinDwarfLocationKind_ADDRESS,
RzBinDwarfLocationKind_VALUE,
RzBinDwarfLocationKind_BYTES,
RzBinDwarfLocationKind_IMPLICIT_POINTER,
RzBinDwarfLocationKind_COMPOSITE,
RzBinDwarfLocationKind_EVALUATION_WAITING,
RzBinDwarfLocationKind_CFA_OFFSET,
RzBinDwarfLocationKind_FB_OFFSET,
RzBinDwarfLocationKind_LOCLIST,
} RzBinDwarfLocationKind;
typedef struct rz_bin_dwarf_location_t {
RzBinDwarfLocationKind kind;
st64 offset;
RzBinDwarfEncoding encoding;
union {
ut64 register_number;
ut64 address;
RzBinDwarfValue value;
RzBinDwarfBlock bytes;
DebugInfoOffset implicit_pointer;
struct {
RzBinDwarfEvaluation *eval;
RzBinDwarfEvaluationResult *result;
} eval_waiting;
RzVector /*<RzBinDwarfPiece>*/ *composite;
const RzBinDwarfLocList *loclist;
};
} RzBinDwarfLocation;
typedef const char *(*DWARF_RegisterMapping)(ut32 register_number);
/// loclists
RZ_API RZ_OWN RzBinDwarfEvaluation *rz_bin_dwarf_evaluation_new(
RZ_OWN RZ_NONNULL RzBinEndianReader *byte_code,
RZ_BORROW RZ_NONNULL const RzBinDWARF *dw,
RZ_BORROW RZ_NULLABLE const RzBinDwarfCompUnit *unit,
RZ_BORROW RZ_NULLABLE const RzBinDwarfDie *fn_die);
RZ_API RZ_OWN RzBinDwarfEvaluation *rz_bin_dwarf_evaluation_new_from_block(
RZ_BORROW RZ_NONNULL RzBinDwarfBlock *block,
RZ_BORROW RZ_NONNULL const RzBinDWARF *dw,
RZ_BORROW RZ_NULLABLE const RzBinDwarfCompUnit *unit,
RZ_BORROW RZ_NULLABLE const RzBinDwarfDie *die);
RZ_API void rz_bin_dwarf_evaluation_free(RZ_OWN RzBinDwarfEvaluation *self);
RZ_API void RzBinDwarfEvaluationResult_free(RZ_OWN RzBinDwarfEvaluationResult *self);
RZ_API bool rz_bin_dwarf_evaluation_evaluate(
RZ_BORROW RZ_NONNULL RzBinDwarfEvaluation *self,
RZ_BORROW RZ_NONNULL RzBinDwarfEvaluationResult *out);
RZ_API RZ_BORROW RzVector /*<RzBinDwarfPiece>*/ *rz_bin_dwarf_evaluation_result(
RZ_BORROW RZ_NONNULL RzBinDwarfEvaluation *self);
RZ_API RZ_OWN RzBinDwarfLocation *rz_bin_dwarf_location_from_block(
RZ_BORROW RZ_NULLABLE const RzBinDwarfBlock *block,
RZ_BORROW RZ_NONNULL const RzBinDWARF *dw,
RZ_BORROW RZ_NONNULL const RzBinDwarfCompUnit *unit,
RZ_BORROW RZ_NULLABLE const RzBinDwarfDie *die);
typedef struct {
DWARF_RegisterMapping dwarf_register_mapping;
const char *loclist_sep;
const char *loclist_indent;
const bool loclist_breaklines;
const char *expr_sep;
const char *expr_indent;
const bool expr_breaklines;
const char *composite_sep;
const char *composite_indent;
const bool compose_breaklines;
const bool value_detail;
} RzBinDWARFDumpOption;
RZ_API void rz_bin_dwarf_expression_dump(
RZ_BORROW RZ_NONNULL const RzBinDwarfEncoding *encoding,
RZ_BORROW RZ_NONNULL const RzBinDwarfBlock *block,
RZ_BORROW RZ_NONNULL RzStrBuf *sb,
RZ_BORROW RZ_NONNULL const RzBinDWARFDumpOption *opt);
RZ_API char *rz_bin_dwarf_expression_to_string(
RZ_BORROW RZ_NONNULL const RzBinDwarfEncoding *encoding,
RZ_BORROW RZ_NONNULL const RzBinDwarfBlock *block,
RZ_BORROW RZ_NONNULL const RzBinDWARFDumpOption *opt);
RZ_API void rz_bin_dwarf_loclist_dump(
RZ_BORROW RZ_NONNULL const RzBinDwarfLocList *loclist,
RZ_BORROW RZ_NONNULL RzStrBuf *sb,
RZ_BORROW RZ_NONNULL const RzBinDWARFDumpOption *opt);
RZ_API void rz_bin_dwarf_location_composite_dump(
RZ_BORROW RZ_NONNULL const RzVector /*<RzBinDwarfPiece>*/ *composite,
RZ_BORROW RZ_NONNULL RzStrBuf *sb,
RZ_BORROW RZ_NONNULL const RzBinDWARFDumpOption *opt);
RZ_API void rz_bin_dwarf_location_dump(
RZ_BORROW RZ_NONNULL const RzBinDwarfLocation *loc,
RZ_BORROW RZ_NONNULL RzStrBuf *sb,
RZ_BORROW RZ_NONNULL const RzBinDWARFDumpOption *opt);
RZ_API RZ_OWN char *rz_bin_dwarf_location_to_string(
RZ_BORROW RZ_NONNULL const RzBinDwarfLocation *loc,
RZ_BORROW RZ_NONNULL const RzBinDWARFDumpOption *opt);
RZ_API void rz_bin_dwarf_location_fini(RZ_BORROW RZ_NONNULL RzBinDwarfLocation *self);
RZ_API void rz_bin_dwarf_location_free(RZ_BORROW RZ_NONNULL RzBinDwarfLocation *self);
RZ_API RZ_OWN RzBinDwarfLocation *rz_bin_dwarf_location_clone(
RZ_BORROW RZ_NONNULL RzBinDwarfLocation *self);
RZ_API void rz_bin_dwarf_loclists_free(RZ_OWN RZ_NULLABLE RzBinDwarfLocLists *self);
RZ_API void rz_bin_dwarf_loclists_dump(
RZ_NONNULL RZ_BORROW RzBinDwarfLocLists *loclists,
RZ_NONNULL RZ_BORROW RzBinDWARF *dw,
RZ_NONNULL RZ_BORROW RzStrBuf *sb);
RZ_API RzBinDwarfLocList *rz_bin_dwarf_loclists_get(
RZ_BORROW RZ_NONNULL RzBinDwarfLocLists *self,
RZ_BORROW RZ_NONNULL RzBinDwarfAddr *addr,
RZ_BORROW RZ_NONNULL RzBinDwarfCompUnit *cu,
ut64 offset);
RZ_API RZ_OWN RzBinDwarfLocLists *rz_bin_dwarf_loclists_new(
RzBinEndianReader *loclists, RzBinEndianReader *loc);
RZ_API RZ_OWN RzBinDwarfLocLists *rz_bin_dwarf_loclists_new_from_file(RZ_BORROW RZ_NONNULL RzBinFile *bf);
RZ_API RzBinDwarfRngList *rz_bin_dwarf_rnglists_get(
RZ_BORROW RZ_NONNULL RzBinDwarfRngLists *self,
RZ_BORROW RZ_NONNULL RzBinDwarfAddr *addr,
RZ_BORROW RZ_NONNULL RzBinDwarfCompUnit *cu,
ut64 offset);
RZ_API void rz_bin_dwarf_rnglists_dump(
RZ_NONNULL RZ_BORROW RzBinDwarfRngLists *rnglists,
RZ_NONNULL RZ_BORROW RzStrBuf *sb);
/// rnglists
RZ_API RZ_OWN RzBinDwarfRngLists *rz_bin_dwarf_rnglists_new(
RZ_OWN RZ_NULLABLE RzBinEndianReader *rnglists, RZ_OWN RZ_NULLABLE RzBinEndianReader *ranges);
RZ_API RZ_OWN RzBinDwarfRngLists *rz_bin_dwarf_rnglists_new_from_file(RZ_BORROW RZ_NONNULL RzBinFile *bf);
/// Block
RZ_API bool rz_bin_dwarf_block_empty(RZ_NULLABLE const RzBinDwarfBlock *self);
RZ_API void rz_bin_dwarf_block_dump(RZ_NONNULL const RzBinDwarfBlock *self, RZ_NONNULL RzStrBuf *sb);
RZ_API RZ_BORROW const ut8 *rz_bin_dwarf_block_data(RZ_NONNULL const RzBinDwarfBlock *self);
/// addr
RZ_API bool rz_bin_dwarf_addr_get(
RZ_BORROW RZ_NONNULL const RzBinDwarfAddr *self,
RZ_BORROW RZ_NONNULL ut64 *address,
ut8 address_size, ut64 base, ut64 index);
RZ_API void rz_bin_dwarf_addr_free(RzBinDwarfAddr *self);
RZ_API RZ_OWN RzBinDwarfAddr *rz_bin_dwarf_addr_new(RZ_OWN RZ_NONNULL RzBinEndianReader *R);
RZ_API RZ_OWN RzBinDwarfAddr *rz_bin_dwarf_addr_from_file(RZ_BORROW RZ_NONNULL RzBinFile *bf);
RZ_API const char *rz_bin_dwarf_attr_string(
RZ_BORROW RZ_NONNULL const RzBinDwarfAttr *attr,
RZ_BORROW RZ_NULLABLE const RzBinDWARF *dw,
ut64 str_offsets_base);
RZ_API RZ_OWN char *rz_bin_dwarf_attr_string_escaped(
RZ_BORROW RZ_NONNULL const RzBinDwarfAttr *attr,
RZ_BORROW RZ_NULLABLE const RzBinDWARF *dw,
ut64 str_offsets_base);
static inline ut64 rz_bin_dwarf_attr_addr(
const RzBinDwarfAttr *attr,
const RzBinDWARF *dw,
ut64 addr_size, ut64 base) {
rz_return_val_if_fail(attr, UT64_MAX);
const RzBinDwarfAttrValue *v = &attr->value;
if (v->kind == RzBinDwarfAttr_Addr) {
return attr->value.u64;
} else if (v->kind == RzBinDwarfAttr_AddrIndex && rz_bin_dwarf_addr(dw)) {
ut64 addr = 0;
if (dw && rz_bin_dwarf_addr_get(rz_bin_dwarf_addr(dw), &addr, addr_size, base, attr->value.u64)) {
return addr;
}
} else if (v->kind == RzBinDwarfAttr_UConstant) {
return attr->value.u64;
}
return attr->value.u64;
}
static inline ut64 rz_bin_dwarf_attr_udata(const RzBinDwarfAttr *attr) {
rz_return_val_if_fail(attr, UT64_MAX);
return attr->value.u64;
}
static inline bool rz_bin_dwarf_attr_flag(
const RzBinDwarfAttr *attr) {
rz_return_val_if_fail(attr, UT64_MAX);
return attr->value.flag;
}
static inline st64 rz_bin_dwarf_attr_sdata(
const RzBinDwarfAttr *attr) {
rz_return_val_if_fail(attr, UT64_MAX);
return attr->value.s64;
}
static inline const RzBinDwarfBlock *rz_bin_dwarf_attr_block(
const RzBinDwarfAttr *attr) {
rz_return_val_if_fail(attr && attr->value.kind == RzBinDwarfAttr_Block, NULL);
return &attr->value.block;
}
RZ_API void rz_bin_dwarf_attr_dump(
RZ_NONNULL RZ_BORROW const RzBinDwarfAttr *attr,
RZ_BORROW RZ_NULLABLE RzBinDWARF *dw,
ut64 str_offsets_base,
RZ_NONNULL RZ_BORROW RzStrBuf *sb);
#ifdef __cplusplus
}
#endif
#endif
Reference in a new issue View git blame Copy permalink