symbolization

This module performs symbolization. It uses the results of several analysis:

-use_def -value -data_access

Part of symbolization is pointer reattribution, that is detecting cases where a number is the result of a symbol+constant. This is done in an independent module ‘pointer_reattribution’ which also uses the results of these analyses.

The data symbolization itself uses the following heuristics:

• address_array: whether we have potential symbols evenly spaced. The more symbols the less likely they are all value collisions. We require at least 3 symbols evenly spaced to consider it an array.

• preferred_data_access and data_access_patterns (from the data_access analysis): - if an address is accessed with the size of the pointer, it is more likely to be a pointer. - if an address is accessed with a size other than the size of the pointers, it is almost

  certainly not a pointer.

• strings: if we have a pointer candidate in what seems to be a string, it is less likely to be a pointer.

• aligned location: if a pointer candidate is aligned, it is more likely to be a pointer. Compilers usually (but not always) store pointers aligned.

This module also computes and symbol_minus_symbol.

symbolic_operand(EA:address, Index:operand_index, Value:address, Type:symbol)

Instruction at address ‘EA’ has a symbolic operand with value ‘Value’. ‘Value’ is given as an address. The field ‘Index’ identifies which operand is symbolic and ‘Type’ specifies if the target is “data” or “code”. This predicate only supports symbolic expressions with one symbol and no offset. For symbolic operands with offset see moved_label.

• Uses: base_addr_offset_operand, symbolic_operand_candidate

• Used by: bad_symbol_constant, false_negative, false_positive, moved_label_class

• Recursive: symbolic_expr_symbol_minus_symbol, symbolic_expr, +disconnected3, data_object_conflict, labeled_data_candidate, code_pointer_in_data, +disconnected2, labeled_ea, code_in_refined_block, moved_label, block_needs_merging, best_symexpr_symbol, discarded_jump_table_entry, best_func_symbol, data_limit, moved_displacement_candidate, symbol_minus_symbol, refined_block, +disconnected1, moved_data_label, next_address_in_data, symbolic_expr_attribute, relative_jump_table_entry, inferred_main_function, symbol_minus_symbol_candidate, next_data_limit, main_function, symbolic_data, symbolic_operand_point, resolved_transfer, code_in_split_block, base_relative_symbolic_operand, address_array_aux, data_access_limit, symbol_minus_symbol_from_relocation, string_candidate_refined, split_block, +disconnected6, data_object_total_points, string_candidate, data_object, address_array, discarded_data_object, block_needs_splitting_at, inferred_special_symbol, symbol_score, after_address_in_data, symbolic_operand_attribute, data_object_point, moved_pc_relative_candidate, symbolic_operand, function_inference.function_entry, jump_table, data_limit_after_access, boundary_sym_expr, data_object_candidate, label_conflict, got_reference, moved_label_candidate, preferred_data_access

symbolic_data(EA:address, Size:unsigned, Value:address)

There is a symbolic expression in the data at address ‘EA’ of size ‘Size’ pointing to ‘Value’. ‘Value’ is given as an address. This predicate only supports symbolic expressions with one symbol and no offset. For symbolic expressions in data with offset see moved_data_label and for symbol-symbol expressions see symbol_minus_symbol.

• Uses: address_in_data_refined, cie_encoding, cie_personality, dwarf_encoding_size, fde_entry, fde_pointer_locations, litpool_symbolic_operand, loaded_section, lsda, lsda_type_entry, option, relocation, symbol

• Used by: data_object_boundary, false_negative, false_positive, moved_label_class

• Recursive: symbolic_expr_symbol_minus_symbol, symbolic_expr, +disconnected3, data_object_conflict, labeled_data_candidate, code_pointer_in_data, +disconnected2, labeled_ea, code_in_refined_block, moved_label, block_needs_merging, best_symexpr_symbol, discarded_jump_table_entry, best_func_symbol, data_limit, moved_displacement_candidate, symbol_minus_symbol, refined_block, +disconnected1, moved_data_label, next_address_in_data, symbolic_expr_attribute, relative_jump_table_entry, inferred_main_function, symbol_minus_symbol_candidate, next_data_limit, main_function, symbolic_data, symbolic_operand_point, resolved_transfer, code_in_split_block, base_relative_symbolic_operand, address_array_aux, data_access_limit, symbol_minus_symbol_from_relocation, string_candidate_refined, split_block, +disconnected6, data_object_total_points, string_candidate, data_object, address_array, discarded_data_object, block_needs_splitting_at, inferred_special_symbol, symbol_score, after_address_in_data, symbolic_operand_attribute, data_object_point, moved_pc_relative_candidate, symbolic_operand, function_inference.function_entry, jump_table, data_limit_after_access, boundary_sym_expr, data_object_candidate, label_conflict, got_reference, moved_label_candidate, preferred_data_access

symbol_minus_symbol(EA:address, Size:unsigned, Symbol1:address, Symbol2:address, Scale:unsigned, Offset:number)

There is a symbolic expression in data at address ‘EA’ of size ‘Size’ of the form:

’(Symbol2-Symbol1)*Scale+Offset’

Both symbols are given as addresses.

• Uses: base_address, base_relative_operand, cie_encoding, cie_entry, code_in_block, data_segment, fde_entry, fde_instruction, fde_instruction_ref, fde_pointer_locations, got_reference_pointer, instruction, instruction_displacement_offset, instruction_get_op, instruction_immediate_offset, invalid, last_fde, litpool_symbolic_operand, loaded_section, lsda_symbol_minus_symbol, op_immediate_and_reg, op_indirect, option, pc_relative_operand, reg_def_use.def_used, reg_has_got, relocation, seh_handler_entry, split_load, symbol, tls_index, tls_segment

• Used by: data_object_boundary, false_negative, false_positive, moved_label_class

• Recursive: symbolic_expr_symbol_minus_symbol, symbolic_expr, +disconnected3, data_object_conflict, labeled_data_candidate, code_pointer_in_data, +disconnected2, labeled_ea, code_in_refined_block, moved_label, block_needs_merging, best_symexpr_symbol, discarded_jump_table_entry, best_func_symbol, data_limit, moved_displacement_candidate, symbol_minus_symbol, refined_block, +disconnected1, moved_data_label, next_address_in_data, symbolic_expr_attribute, relative_jump_table_entry, inferred_main_function, symbol_minus_symbol_candidate, next_data_limit, main_function, symbolic_data, symbolic_operand_point, resolved_transfer, code_in_split_block, base_relative_symbolic_operand, address_array_aux, data_access_limit, symbol_minus_symbol_from_relocation, string_candidate_refined, split_block, +disconnected6, data_object_total_points, string_candidate, data_object, address_array, discarded_data_object, block_needs_splitting_at, inferred_special_symbol, symbol_score, after_address_in_data, symbolic_operand_attribute, data_object_point, moved_pc_relative_candidate, symbolic_operand, function_inference.function_entry, jump_table, data_limit_after_access, boundary_sym_expr, data_object_candidate, label_conflict, got_reference, moved_label_candidate, preferred_data_access

symbolic_expr_from_relocation(EA:address, Size:unsigned, Symbol:symbol, Offset:number, TargetEA:address)

There is a symbolic expression at address ‘EA’ of size ‘Size’ of the form:

Symbol+Offset

This symbolic expression corresponds to a relocation and the symbol

is referenced by name.

• Uses: arch.memory_access, base_address, binary_format, binary_type, elf_relocation_size, instruction_displacement_offset, instruction_get_op, instruction_immediate_offset, lo_reloc_index, op_immediate, op_indirect, pc_relative_operand, reg_def_use.def, reloc_type_nameless, reloc_type_with_name, relocation, relocation_size, section, symbol, tls_operand_attribute, tls_segment

• Used by: data_object_boundary, labeled_ea, resolved_transfer, symbolic_expr, symbolic_expr_symbol_minus_symbol, symbolic_operand_attribute

• Recursive: cmp_defines, first_block_in_byte_interval, overlapping_instruction, split_load_for_symbolization, relocation_adjustment, call_tls_get_addr, simple_data_access_pattern, reg_def_use.def_used, base_relative_operand, split_load_total_points, block, litpool_confidence, reg_has_got, value_reg_limit, stack_def_use.live_var_used, split_load_point, split_load_operand, flags_and_jump_pair, wis_schedule_iter, unresolved_interval, code_in_block, compare_and_jump_indirect_op_valid, __agg_subclause3, inferred_main_in_reg, reg_used_for, is_padding, resolved_reaches, compare_and_jump_indirect, __agg_subclause2, padding_block_candidate, reg_reg_arithmetic_operation_defs, def_used_for_address, impossible_block, plt_block, arm_jump_table_block_instruction, composite_data_access, possible_target_from, jump_table_candidate_refined, base_relative_operation, split_load, __agg_single3, reg_has_base_image, no_value_reg_limit, relative_address_start, wis_schedule, plt_entry, reg_def_use.used_in_block, adjusts_stack_in_block, possible_target, initialized_data_segment, reg_def_use.live_var_at_block_end, cmp_reg_to_reg, indefinite_litpool_ref, negative_block_heuristic, contains_implausible_instr_seq, indexed_pc_relative_load, next_block_in_byte_interval, code_in_block_candidate, symbolic_expr_from_relocation, unlikely_have_symbolic_immediate, incomplete_block, arm_jump_table_data_block_limit, inferred_main_dispatch, arch.simple_data_load, data_block_limit, block_total_points, invalid_jump_table_candidate, stack_def_use.live_var_def, reg_def_use.live_var_def, arm_jump_table_block_start, block_overlap, stack_base_reg_move, may_fallthrough, __agg_single2, block_heuristic, __agg_subclause9, block_implies_block, segment_target_range, stack_def_use.live_var_at_prior_used, cinf_ldr_add_pc, no_return_call_propagated, unresolved_block_overlap, jump_table_max, common_tail, unresolved_interval_order, tls_get_addr, block_points_proportional, likely_fallthrough, block_boundaries, jump_table_element_access, block_points, invalid, jump_table_target, reg_def_use.used, arm_jump_table_candidate, reg_def_use.live_var_at_prior_used, no_return_call, arm_jump_table_skip_first_entry, stack_def_use.defined_in_block, split_load_conflict, arm_jump_table_candidate_start, stack_def_use.live_var_at_block_end, reg_def_use.last_def_in_block, arm_jump_table_cmp_limit, data_in_code, candidate_block_is_not_padding, inter_procedural_edge, known_block, instruction_memory_access_size, overlap_with_litpool, block_limit, function_inference.function_entry_initial, init_symbol_minus_symbol_candidate_arm, const_value_reg_used, self_contained_segment, stack_def_use.last_def_in_block, must_fallthrough, straight_line_last_def, padding_block_limit, jump_table_candidate, no_return_call_refined, block_candidate_dependency_edge, split_load_candidate, stack_def_use.block_last_def, last_value_reg_limit, relative_address, no_return_block, litpool_ref, symbol_minus_symbol_litpool_access_pattern, block_last_instruction, gp_relative_operand, data_in_code_propagate, block_candidate_boundaries, basic_target, compare_and_jump_immediate, wis_memo, __agg_subclause6, nop_in_padding_candidate, reg_def_use.defined_in_block, __agg_single6, relocation_adjustment_total, candidate_block_is_padding, wis_prior, reg_def_use.live_var_used, __agg_subclause7, wis_has_prior, compare_and_jump_register, block_instruction_next, arm_jump_table_data_block, value_reg, contains_plausible_instr_seq, relative_jump_table_entry_candidate, adrp_used, stack_def_use.def_used, got_relative_operand, __agg_subclause10, value_reg_edge, arch.reg_relative_load, reg_def_use.flow_def, hi_load_prop, jump_table_start, branch_to_calculated_pc_rel_addr, tls_desc_call, discarded_block, stack_def_use.live_var_used_in_block, data_segment, value_reg_unsupported, block_next, discarded_split_load, indexed_pc_relative_load_relative, litpool_symbolic_operand, data_block_candidate, reg_def_use.return_block_end, code_in_block_candidate_refined, after_end, jump_table_signed, reg_def_use.block_last_def, base_relative_jump, unresolved_interval_best_block, straight_line_def_used, unresolved_block, data_access, correlated_live_reg, jump_table_prelude, litpool_boundaries, init_ldr_add_pc, arch.extend_load, stack_def_use.used_in_block, stack_def_use.ref_in_block, reg_def_use.ref_in_block, reg_def_use.return_val_used

symbol_minus_symbol_from_relocation(EA:address, Size:unsigned, Symbol1:symbol, Symbol2:symbol, Scale:unsigned, Offset:number)

There is a symbolic expression at address ‘EA’ of size ‘Size’ of the form:

(Symbol2-Symbol1)*Scale+Offset

This symbolic expression corresponds to a relocation and the symbol is referenced by name.

• Uses: binary_type, relocation, symbol_minus_symbol_litpool_access_pattern

• Recursive: symbolic_expr_symbol_minus_symbol, symbolic_expr, +disconnected3, data_object_conflict, labeled_data_candidate, code_pointer_in_data, +disconnected2, labeled_ea, code_in_refined_block, moved_label, block_needs_merging, best_symexpr_symbol, discarded_jump_table_entry, best_func_symbol, data_limit, moved_displacement_candidate, symbol_minus_symbol, refined_block, +disconnected1, moved_data_label, next_address_in_data, symbolic_expr_attribute, relative_jump_table_entry, inferred_main_function, symbol_minus_symbol_candidate, next_data_limit, main_function, symbolic_data, symbolic_operand_point, resolved_transfer, code_in_split_block, base_relative_symbolic_operand, address_array_aux, data_access_limit, symbol_minus_symbol_from_relocation, string_candidate_refined, split_block, +disconnected6, data_object_total_points, string_candidate, data_object, address_array, discarded_data_object, block_needs_splitting_at, inferred_special_symbol, symbol_score, after_address_in_data, symbolic_operand_attribute, data_object_point, moved_pc_relative_candidate, symbolic_operand, function_inference.function_entry, jump_table, data_limit_after_access, boundary_sym_expr, data_object_candidate, label_conflict, got_reference, moved_label_candidate, preferred_data_access

symbolic_expr(EA:address, Size:unsigned, Symbol:symbol, Offset:number)

There is a symbolic expression at address ‘EA’ of size ‘Size’ of the form:

’Symbol+Offset’

In contrast to symbolic_operand and symbolic_data, the symbol in this predicate is referred by name. This allows us to include symbolic expressions from relocations and to choose between multiple symbols at the same location. This predicate captures all symbolic expressions from symbolic_operand, moved_label, symbolic_data, moved_data_label, and symbolic_expr_from_relocation.

• Uses: got_reference_pointer, instruction_displacement_offset, instruction_immediate_offset, op_immediate_and_reg, reg_has_got, relocation, symbolic_expr_from_relocation

• Used by: missing_relocation_handling, pointer_to_external_symbol

• Recursive: symbolic_expr_symbol_minus_symbol, symbolic_expr, +disconnected3, data_object_conflict, labeled_data_candidate, code_pointer_in_data, +disconnected2, labeled_ea, code_in_refined_block, moved_label, block_needs_merging, best_symexpr_symbol, discarded_jump_table_entry, best_func_symbol, data_limit, moved_displacement_candidate, symbol_minus_symbol, refined_block, +disconnected1, moved_data_label, next_address_in_data, symbolic_expr_attribute, relative_jump_table_entry, inferred_main_function, symbol_minus_symbol_candidate, next_data_limit, main_function, symbolic_data, symbolic_operand_point, resolved_transfer, code_in_split_block, base_relative_symbolic_operand, address_array_aux, data_access_limit, symbol_minus_symbol_from_relocation, string_candidate_refined, split_block, +disconnected6, data_object_total_points, string_candidate, data_object, address_array, discarded_data_object, block_needs_splitting_at, inferred_special_symbol, symbol_score, after_address_in_data, symbolic_operand_attribute, data_object_point, moved_pc_relative_candidate, symbolic_operand, function_inference.function_entry, jump_table, data_limit_after_access, boundary_sym_expr, data_object_candidate, label_conflict, got_reference, moved_label_candidate, preferred_data_access

symbolic_expr_symbol_minus_symbol(EA:address, Size:unsigned, Symbol:symbol, Symbol2:symbol, Scale:unsigned, Offset:number)

There is a symbolic expression at address ‘EA’ of size ‘Size’ of the form:

’(Symbol2-Symbol1)*Scale+Offset’

The symbols in this predicate are referred by name.

• Uses: symbolic_expr_from_relocation

• Recursive: symbolic_expr_symbol_minus_symbol, symbolic_expr, +disconnected3, data_object_conflict, labeled_data_candidate, code_pointer_in_data, +disconnected2, labeled_ea, code_in_refined_block, moved_label, block_needs_merging, best_symexpr_symbol, discarded_jump_table_entry, best_func_symbol, data_limit, moved_displacement_candidate, symbol_minus_symbol, refined_block, +disconnected1, moved_data_label, next_address_in_data, symbolic_expr_attribute, relative_jump_table_entry, inferred_main_function, symbol_minus_symbol_candidate, next_data_limit, main_function, symbolic_data, symbolic_operand_point, resolved_transfer, code_in_split_block, base_relative_symbolic_operand, address_array_aux, data_access_limit, symbol_minus_symbol_from_relocation, string_candidate_refined, split_block, +disconnected6, data_object_total_points, string_candidate, data_object, address_array, discarded_data_object, block_needs_splitting_at, inferred_special_symbol, symbol_score, after_address_in_data, symbolic_operand_attribute, data_object_point, moved_pc_relative_candidate, symbolic_operand, function_inference.function_entry, jump_table, data_limit_after_access, boundary_sym_expr, data_object_candidate, label_conflict, got_reference, moved_label_candidate, preferred_data_access

symbolic_operand_attribute(EA:address, Index:unsigned, Attribute:symbol)

The symbolic operand at address ‘EA’ and ‘Index’ has a symbolic expression attribute ‘Attribute’. Note that some attributes may be inferred but not used, if the corresponding symbolic_operand is not selected.

• Uses: base_addr_offset_operand, binary_format, binary_type, code_in_block, const_value_reg_used, data_segment, direct_call, direct_jump, elf_relocation_size, got_reference_pointer, got_relative_operand, indirect_call, instruction_displacement_offset, instruction_has_relocation, instruction_immediate_offset, litpool_ref, lo_reloc_index, loaded_section, movw_movt_pair, op_immediate_and_reg, pc_relative_operand, plt_block, reg_def_use.def_used, reg_has_got, relocation, split_load, split_load_for_symbolization, split_loadstore, symbol, symbolic_expr_from_relocation, symbolic_operand_candidate, symbolic_operand_mips_candidate, tls_descriptor, tls_global_dynamic, tls_index, tls_local_dynamic, tls_operand_attribute, tls_relative_operand

• Recursive: symbolic_expr_symbol_minus_symbol, symbolic_expr, +disconnected3, data_object_conflict, labeled_data_candidate, code_pointer_in_data, +disconnected2, labeled_ea, code_in_refined_block, moved_label, block_needs_merging, best_symexpr_symbol, discarded_jump_table_entry, best_func_symbol, data_limit, moved_displacement_candidate, symbol_minus_symbol, refined_block, +disconnected1, moved_data_label, next_address_in_data, symbolic_expr_attribute, relative_jump_table_entry, inferred_main_function, symbol_minus_symbol_candidate, next_data_limit, main_function, symbolic_data, symbolic_operand_point, resolved_transfer, code_in_split_block, base_relative_symbolic_operand, address_array_aux, data_access_limit, symbol_minus_symbol_from_relocation, string_candidate_refined, split_block, +disconnected6, data_object_total_points, string_candidate, data_object, address_array, discarded_data_object, block_needs_splitting_at, inferred_special_symbol, symbol_score, after_address_in_data, symbolic_operand_attribute, data_object_point, moved_pc_relative_candidate, symbolic_operand, function_inference.function_entry, jump_table, data_limit_after_access, boundary_sym_expr, data_object_candidate, label_conflict, got_reference, moved_label_candidate, preferred_data_access

symbolic_expr_attribute(ea:address, attribute:symbol)

The symbolic expression at address ‘EA’ has a symbolic expression attribute ‘Attribute’.

• Uses: binary_type, instruction_displacement_offset, instruction_immediate_offset, litpool_symbolic_operand, loaded_section, relocation, symbol

• Recursive: symbolic_expr_symbol_minus_symbol, symbolic_expr, +disconnected3, data_object_conflict, labeled_data_candidate, code_pointer_in_data, +disconnected2, labeled_ea, code_in_refined_block, moved_label, block_needs_merging, best_symexpr_symbol, discarded_jump_table_entry, best_func_symbol, data_limit, moved_displacement_candidate, symbol_minus_symbol, refined_block, +disconnected1, moved_data_label, next_address_in_data, symbolic_expr_attribute, relative_jump_table_entry, inferred_main_function, symbol_minus_symbol_candidate, next_data_limit, main_function, symbolic_data, symbolic_operand_point, resolved_transfer, code_in_split_block, base_relative_symbolic_operand, address_array_aux, data_access_limit, symbol_minus_symbol_from_relocation, string_candidate_refined, split_block, +disconnected6, data_object_total_points, string_candidate, data_object, address_array, discarded_data_object, block_needs_splitting_at, inferred_special_symbol, symbol_score, after_address_in_data, symbolic_operand_attribute, data_object_point, moved_pc_relative_candidate, symbolic_operand, function_inference.function_entry, jump_table, data_limit_after_access, boundary_sym_expr, data_object_candidate, label_conflict, got_reference, moved_label_candidate, preferred_data_access

code_pointer_in_data(EA:address, Val:address)

There is a symbolic expression in data at address ‘EA’ pointing to a code block at address ‘Val’.

• Uses: block

• Recursive: symbolic_expr_symbol_minus_symbol, symbolic_expr, +disconnected3, data_object_conflict, labeled_data_candidate, code_pointer_in_data, +disconnected2, labeled_ea, code_in_refined_block, moved_label, block_needs_merging, best_symexpr_symbol, discarded_jump_table_entry, best_func_symbol, data_limit, moved_displacement_candidate, symbol_minus_symbol, refined_block, +disconnected1, moved_data_label, next_address_in_data, symbolic_expr_attribute, relative_jump_table_entry, inferred_main_function, symbol_minus_symbol_candidate, next_data_limit, main_function, symbolic_data, symbolic_operand_point, resolved_transfer, code_in_split_block, base_relative_symbolic_operand, address_array_aux, data_access_limit, symbol_minus_symbol_from_relocation, string_candidate_refined, split_block, +disconnected6, data_object_total_points, string_candidate, data_object, address_array, discarded_data_object, block_needs_splitting_at, inferred_special_symbol, symbol_score, after_address_in_data, symbolic_operand_attribute, data_object_point, moved_pc_relative_candidate, symbolic_operand, function_inference.function_entry, jump_table, data_limit_after_access, boundary_sym_expr, data_object_candidate, label_conflict, got_reference, moved_label_candidate, preferred_data_access

labeled_ea(Ea:address)

The address ‘Ea’ needs to be labeled so it can be referred in symbolic expressions.

• Uses: cie_personality, data_sym, defined_symbol, fde_entry, symbolic_expr_from_relocation, thumb_sym

• Used by: bss_data, data_object_boundary, inferred_symbol

• Recursive: symbolic_expr_symbol_minus_symbol, symbolic_expr, +disconnected3, data_object_conflict, labeled_data_candidate, code_pointer_in_data, +disconnected2, labeled_ea, code_in_refined_block, moved_label, block_needs_merging, best_symexpr_symbol, discarded_jump_table_entry, best_func_symbol, data_limit, moved_displacement_candidate, symbol_minus_symbol, refined_block, +disconnected1, moved_data_label, next_address_in_data, symbolic_expr_attribute, relative_jump_table_entry, inferred_main_function, symbol_minus_symbol_candidate, next_data_limit, main_function, symbolic_data, symbolic_operand_point, resolved_transfer, code_in_split_block, base_relative_symbolic_operand, address_array_aux, data_access_limit, symbol_minus_symbol_from_relocation, string_candidate_refined, split_block, +disconnected6, data_object_total_points, string_candidate, data_object, address_array, discarded_data_object, block_needs_splitting_at, inferred_special_symbol, symbol_score, after_address_in_data, symbolic_operand_attribute, data_object_point, moved_pc_relative_candidate, symbolic_operand, function_inference.function_entry, jump_table, data_limit_after_access, boundary_sym_expr, data_object_candidate, label_conflict, got_reference, moved_label_candidate, preferred_data_access

data_object_boundary(EA:address)

• Uses: labeled_ea, moved_data_label, string, symbol_minus_symbol, symbolic_data, symbolic_expr_from_relocation

bss_data(ea:address)

• Uses: bss_section, labeled_ea, loaded_section

symbolic_operand_candidate(ea:address, operand_index:operand_index, Dest:address, Type:symbol)

• Uses: address_in_data, arch.call, arch.jump_operation_op_index, arch.pc_relative_addr, base_addr_offset_operand, base_address, binary_format, binary_type, code_in_block, const_value_reg_used, data_segment, direct_call, direct_jump, function_symbol, got_relative_operand, indirect_call, indirect_jump, instruction, instruction_displacement_offset, instruction_get_op, instruction_has_loop_prefix, instruction_immediate_offset, litpool_ref, movw_movt_pair, op_immediate, op_indirect, pc_relative_operand, relocation, split_load_operand, symbol, symbolic_operand_mips_candidate, tls_descriptor, tls_relative_operand, tls_segment

• Used by: data_object_candidate, data_object_point, def_register_is_not_base_address, symbolic_operand, symbolic_operand_attribute, symbolic_operand_point

symbolic_operand_point(ea:address, operand_index:operand_index, points:number, why:symbol)

• Uses: arch.cmp_operation, arch.jump, arch.logic_operation, binary_format, binary_type, cmp_immediate_to_reg, def_register_is_not_base_address, def_used_for_address, exception_section, instruction, instruction_get_op, is_xor_reset, loaded_section, low_pass_filter, op_immediate, op_immediate_and_reg, op_indirect, op_regdirect_contains_reg, pc_relative_operand, reg_def_use.def_used, relocation, symbolic_operand_candidate

• Recursive: symbolic_expr_symbol_minus_symbol, symbolic_expr, +disconnected3, data_object_conflict, labeled_data_candidate, code_pointer_in_data, +disconnected2, labeled_ea, code_in_refined_block, moved_label, block_needs_merging, best_symexpr_symbol, discarded_jump_table_entry, best_func_symbol, data_limit, moved_displacement_candidate, symbol_minus_symbol, refined_block, +disconnected1, moved_data_label, next_address_in_data, symbolic_expr_attribute, relative_jump_table_entry, inferred_main_function, symbol_minus_symbol_candidate, next_data_limit, main_function, symbolic_data, symbolic_operand_point, resolved_transfer, code_in_split_block, base_relative_symbolic_operand, address_array_aux, data_access_limit, symbol_minus_symbol_from_relocation, string_candidate_refined, split_block, +disconnected6, data_object_total_points, string_candidate, data_object, address_array, discarded_data_object, block_needs_splitting_at, inferred_special_symbol, symbol_score, after_address_in_data, symbolic_operand_attribute, data_object_point, moved_pc_relative_candidate, symbolic_operand, function_inference.function_entry, jump_table, data_limit_after_access, boundary_sym_expr, data_object_candidate, label_conflict, got_reference, moved_label_candidate, preferred_data_access

symbolic_operand_total_points(ea:address, operand_index:operand_index, points:number)

WARNING: Predicate not present in compiled Datalog program (Dead Code)

labeled_data_candidate(EA:address)

• Uses: address_in_data_refined, arm_sym, base_address, cinf_symbol_minus_symbol_candidate_arm, data_segment, symbol, symbol_minus_symbol_litpool_access_pattern, thumb_sym

• Recursive: symbolic_expr_symbol_minus_symbol, symbolic_expr, +disconnected3, data_object_conflict, labeled_data_candidate, code_pointer_in_data, +disconnected2, labeled_ea, code_in_refined_block, moved_label, block_needs_merging, best_symexpr_symbol, discarded_jump_table_entry, best_func_symbol, data_limit, moved_displacement_candidate, symbol_minus_symbol, refined_block, +disconnected1, moved_data_label, next_address_in_data, symbolic_expr_attribute, relative_jump_table_entry, inferred_main_function, symbol_minus_symbol_candidate, next_data_limit, main_function, symbolic_data, symbolic_operand_point, resolved_transfer, code_in_split_block, base_relative_symbolic_operand, address_array_aux, data_access_limit, symbol_minus_symbol_from_relocation, string_candidate_refined, split_block, +disconnected6, data_object_total_points, string_candidate, data_object, address_array, discarded_data_object, block_needs_splitting_at, inferred_special_symbol, symbol_score, after_address_in_data, symbolic_operand_attribute, data_object_point, moved_pc_relative_candidate, symbolic_operand, function_inference.function_entry, jump_table, data_limit_after_access, boundary_sym_expr, data_object_candidate, label_conflict, got_reference, moved_label_candidate, preferred_data_access

symbol_minus_symbol_candidate(EA:address, Size:unsigned, Symbol1:address, Symbol2:address, Scale:unsigned, Offset:number)

A candidate for a symbol-symbol in data (includes jump tables and other relative symbols)

• Uses: cinf_symbol_minus_symbol_candidate_arm

• Recursive: symbolic_expr_symbol_minus_symbol, symbolic_expr, +disconnected3, data_object_conflict, labeled_data_candidate, code_pointer_in_data, +disconnected2, labeled_ea, code_in_refined_block, moved_label, block_needs_merging, best_symexpr_symbol, discarded_jump_table_entry, best_func_symbol, data_limit, moved_displacement_candidate, symbol_minus_symbol, refined_block, +disconnected1, moved_data_label, next_address_in_data, symbolic_expr_attribute, relative_jump_table_entry, inferred_main_function, symbol_minus_symbol_candidate, next_data_limit, main_function, symbolic_data, symbolic_operand_point, resolved_transfer, code_in_split_block, base_relative_symbolic_operand, address_array_aux, data_access_limit, symbol_minus_symbol_from_relocation, string_candidate_refined, split_block, +disconnected6, data_object_total_points, string_candidate, data_object, address_array, discarded_data_object, block_needs_splitting_at, inferred_special_symbol, symbol_score, after_address_in_data, symbolic_operand_attribute, data_object_point, moved_pc_relative_candidate, symbolic_operand, function_inference.function_entry, jump_table, data_limit_after_access, boundary_sym_expr, data_object_candidate, label_conflict, got_reference, moved_label_candidate, preferred_data_access

address_in_data_is_printable(EA:address)

The address appearing at ‘EA’ is within a potential ascii_string and therefore more likely to be spurious.

WARNING: Predicate not present in compiled Datalog program (Dead Code)

address_in_data_refined(EA:address, Val:address)

• Uses: address_in_data, binary_type, block, data_segment, relocation

• Used by: address_array_aux, address_in_data_refined_range.in_ea, after_address_in_data, data_object_candidate, data_object_conflict, data_object_point, labeled_data_candidate, next_address_in_data, symbolic_data

string(EA:address, End:address, Encoding:symbol)

Data-object analysis for string encodings.

Possible string of some ‘Encoding’ at interval [‘EA’,’End’).

• Uses: data_object, string_candidate_refined

• Used by: data_object_boundary

string_candidate(EA:address, End:address, Encoding:symbol)

• Uses: ascii_string, data_segment

• Recursive: symbolic_expr_symbol_minus_symbol, symbolic_expr, +disconnected3, data_object_conflict, labeled_data_candidate, code_pointer_in_data, +disconnected2, labeled_ea, code_in_refined_block, moved_label, block_needs_merging, best_symexpr_symbol, discarded_jump_table_entry, best_func_symbol, data_limit, moved_displacement_candidate, symbol_minus_symbol, refined_block, +disconnected1, moved_data_label, next_address_in_data, symbolic_expr_attribute, relative_jump_table_entry, inferred_main_function, symbol_minus_symbol_candidate, next_data_limit, main_function, symbolic_data, symbolic_operand_point, resolved_transfer, code_in_split_block, base_relative_symbolic_operand, address_array_aux, data_access_limit, symbol_minus_symbol_from_relocation, string_candidate_refined, split_block, +disconnected6, data_object_total_points, string_candidate, data_object, address_array, discarded_data_object, block_needs_splitting_at, inferred_special_symbol, symbol_score, after_address_in_data, symbolic_operand_attribute, data_object_point, moved_pc_relative_candidate, symbolic_operand, function_inference.function_entry, jump_table, data_limit_after_access, boundary_sym_expr, data_object_candidate, label_conflict, got_reference, moved_label_candidate, preferred_data_access

string_candidate_refined(EA:address, End:address, Encoding:symbol)

• Used by: string

• Recursive: symbolic_expr_symbol_minus_symbol, symbolic_expr, +disconnected3, data_object_conflict, labeled_data_candidate, code_pointer_in_data, +disconnected2, labeled_ea, code_in_refined_block, moved_label, block_needs_merging, best_symexpr_symbol, discarded_jump_table_entry, best_func_symbol, data_limit, moved_displacement_candidate, symbol_minus_symbol, refined_block, +disconnected1, moved_data_label, next_address_in_data, symbolic_expr_attribute, relative_jump_table_entry, inferred_main_function, symbol_minus_symbol_candidate, next_data_limit, main_function, symbolic_data, symbolic_operand_point, resolved_transfer, code_in_split_block, base_relative_symbolic_operand, address_array_aux, data_access_limit, symbol_minus_symbol_from_relocation, string_candidate_refined, split_block, +disconnected6, data_object_total_points, string_candidate, data_object, address_array, discarded_data_object, block_needs_splitting_at, inferred_special_symbol, symbol_score, after_address_in_data, symbolic_operand_attribute, data_object_point, moved_pc_relative_candidate, symbolic_operand, function_inference.function_entry, jump_table, data_limit_after_access, boundary_sym_expr, data_object_candidate, label_conflict, got_reference, moved_label_candidate, preferred_data_access

data_object_candidate(ea:address, size:unsigned, type:symbol)

• Uses: address_in_data_refined, arm_jump_table_candidate, arm_jump_table_data_block, impossible_jump_target, litpool_ref, symbol_minus_symbol_litpool_access_pattern, symbolic_operand_candidate

• Recursive: symbolic_expr_symbol_minus_symbol, symbolic_expr, +disconnected3, data_object_conflict, labeled_data_candidate, code_pointer_in_data, +disconnected2, labeled_ea, code_in_refined_block, moved_label, block_needs_merging, best_symexpr_symbol, discarded_jump_table_entry, best_func_symbol, data_limit, moved_displacement_candidate, symbol_minus_symbol, refined_block, +disconnected1, moved_data_label, next_address_in_data, symbolic_expr_attribute, relative_jump_table_entry, inferred_main_function, symbol_minus_symbol_candidate, next_data_limit, main_function, symbolic_data, symbolic_operand_point, resolved_transfer, code_in_split_block, base_relative_symbolic_operand, address_array_aux, data_access_limit, symbol_minus_symbol_from_relocation, string_candidate_refined, split_block, +disconnected6, data_object_total_points, string_candidate, data_object, address_array, discarded_data_object, block_needs_splitting_at, inferred_special_symbol, symbol_score, after_address_in_data, symbolic_operand_attribute, data_object_point, moved_pc_relative_candidate, symbolic_operand, function_inference.function_entry, jump_table, data_limit_after_access, boundary_sym_expr, data_object_candidate, label_conflict, got_reference, moved_label_candidate, preferred_data_access

data_object_point(ea:address, size:unsigned, type:symbol, points:number, why:symbol)

• Uses: address_in_data, address_in_data_refined, arm_jump_table_candidate, arm_jump_table_data_block, binary_type, exception_section, is_padding, jump_table_start, litpool_ref, loaded_section, npad, relocation, special_data_section, symbol_minus_symbol_litpool_access_pattern, symbolic_operand_candidate

• Recursive: symbolic_expr_symbol_minus_symbol, symbolic_expr, +disconnected3, data_object_conflict, labeled_data_candidate, code_pointer_in_data, +disconnected2, labeled_ea, code_in_refined_block, moved_label, block_needs_merging, best_symexpr_symbol, discarded_jump_table_entry, best_func_symbol, data_limit, moved_displacement_candidate, symbol_minus_symbol, refined_block, +disconnected1, moved_data_label, next_address_in_data, symbolic_expr_attribute, relative_jump_table_entry, inferred_main_function, symbol_minus_symbol_candidate, next_data_limit, main_function, symbolic_data, symbolic_operand_point, resolved_transfer, code_in_split_block, base_relative_symbolic_operand, address_array_aux, data_access_limit, symbol_minus_symbol_from_relocation, string_candidate_refined, split_block, +disconnected6, data_object_total_points, string_candidate, data_object, address_array, discarded_data_object, block_needs_splitting_at, inferred_special_symbol, symbol_score, after_address_in_data, symbolic_operand_attribute, data_object_point, moved_pc_relative_candidate, symbolic_operand, function_inference.function_entry, jump_table, data_limit_after_access, boundary_sym_expr, data_object_candidate, label_conflict, got_reference, moved_label_candidate, preferred_data_access

data_object_conflict(ea:address, size:unsigned, type:symbol, ea2:address, size2:unsigned, type2:symbol)

• Uses: address_in_data_refined, binary_format

• Recursive: symbolic_expr_symbol_minus_symbol, symbolic_expr, +disconnected3, data_object_conflict, labeled_data_candidate, code_pointer_in_data, +disconnected2, labeled_ea, code_in_refined_block, moved_label, block_needs_merging, best_symexpr_symbol, discarded_jump_table_entry, best_func_symbol, data_limit, moved_displacement_candidate, symbol_minus_symbol, refined_block, +disconnected1, moved_data_label, next_address_in_data, symbolic_expr_attribute, relative_jump_table_entry, inferred_main_function, symbol_minus_symbol_candidate, next_data_limit, main_function, symbolic_data, symbolic_operand_point, resolved_transfer, code_in_split_block, base_relative_symbolic_operand, address_array_aux, data_access_limit, symbol_minus_symbol_from_relocation, string_candidate_refined, split_block, +disconnected6, data_object_total_points, string_candidate, data_object, address_array, discarded_data_object, block_needs_splitting_at, inferred_special_symbol, symbol_score, after_address_in_data, symbolic_operand_attribute, data_object_point, moved_pc_relative_candidate, symbolic_operand, function_inference.function_entry, jump_table, data_limit_after_access, boundary_sym_expr, data_object_candidate, label_conflict, got_reference, moved_label_candidate, preferred_data_access

discarded_data_object(ea:address, size:unsigned, type:symbol)

• Recursive: symbolic_expr_symbol_minus_symbol, symbolic_expr, +disconnected3, data_object_conflict, labeled_data_candidate, code_pointer_in_data, +disconnected2, labeled_ea, code_in_refined_block, moved_label, block_needs_merging, best_symexpr_symbol, discarded_jump_table_entry, best_func_symbol, data_limit, moved_displacement_candidate, symbol_minus_symbol, refined_block, +disconnected1, moved_data_label, next_address_in_data, symbolic_expr_attribute, relative_jump_table_entry, inferred_main_function, symbol_minus_symbol_candidate, next_data_limit, main_function, symbolic_data, symbolic_operand_point, resolved_transfer, code_in_split_block, base_relative_symbolic_operand, address_array_aux, data_access_limit, symbol_minus_symbol_from_relocation, string_candidate_refined, split_block, +disconnected6, data_object_total_points, string_candidate, data_object, address_array, discarded_data_object, block_needs_splitting_at, inferred_special_symbol, symbol_score, after_address_in_data, symbolic_operand_attribute, data_object_point, moved_pc_relative_candidate, symbolic_operand, function_inference.function_entry, jump_table, data_limit_after_access, boundary_sym_expr, data_object_candidate, label_conflict, got_reference, moved_label_candidate, preferred_data_access

data_object(ea:address, size:unsigned, type:symbol)

• Used by: string

• Recursive: symbolic_expr_symbol_minus_symbol, symbolic_expr, +disconnected3, data_object_conflict, labeled_data_candidate, code_pointer_in_data, +disconnected2, labeled_ea, code_in_refined_block, moved_label, block_needs_merging, best_symexpr_symbol, discarded_jump_table_entry, best_func_symbol, data_limit, moved_displacement_candidate, symbol_minus_symbol, refined_block, +disconnected1, moved_data_label, next_address_in_data, symbolic_expr_attribute, relative_jump_table_entry, inferred_main_function, symbol_minus_symbol_candidate, next_data_limit, main_function, symbolic_data, symbolic_operand_point, resolved_transfer, code_in_split_block, base_relative_symbolic_operand, address_array_aux, data_access_limit, symbol_minus_symbol_from_relocation, string_candidate_refined, split_block, +disconnected6, data_object_total_points, string_candidate, data_object, address_array, discarded_data_object, block_needs_splitting_at, inferred_special_symbol, symbol_score, after_address_in_data, symbolic_operand_attribute, data_object_point, moved_pc_relative_candidate, symbolic_operand, function_inference.function_entry, jump_table, data_limit_after_access, boundary_sym_expr, data_object_candidate, label_conflict, got_reference, moved_label_candidate, preferred_data_access

after_address_in_data(EA:address, EA_next:address)

• Uses: address_in_data_refined

• Recursive: symbolic_expr_symbol_minus_symbol, symbolic_expr, +disconnected3, data_object_conflict, labeled_data_candidate, code_pointer_in_data, +disconnected2, labeled_ea, code_in_refined_block, moved_label, block_needs_merging, best_symexpr_symbol, discarded_jump_table_entry, best_func_symbol, data_limit, moved_displacement_candidate, symbol_minus_symbol, refined_block, +disconnected1, moved_data_label, next_address_in_data, symbolic_expr_attribute, relative_jump_table_entry, inferred_main_function, symbol_minus_symbol_candidate, next_data_limit, main_function, symbolic_data, symbolic_operand_point, resolved_transfer, code_in_split_block, base_relative_symbolic_operand, address_array_aux, data_access_limit, symbol_minus_symbol_from_relocation, string_candidate_refined, split_block, +disconnected6, data_object_total_points, string_candidate, data_object, address_array, discarded_data_object, block_needs_splitting_at, inferred_special_symbol, symbol_score, after_address_in_data, symbolic_operand_attribute, data_object_point, moved_pc_relative_candidate, symbolic_operand, function_inference.function_entry, jump_table, data_limit_after_access, boundary_sym_expr, data_object_candidate, label_conflict, got_reference, moved_label_candidate, preferred_data_access

next_address_in_data(EA:address, EA_next:address)

• Uses: address_in_data_refined

• Recursive: symbolic_expr_symbol_minus_symbol, symbolic_expr, +disconnected3, data_object_conflict, labeled_data_candidate, code_pointer_in_data, +disconnected2, labeled_ea, code_in_refined_block, moved_label, block_needs_merging, best_symexpr_symbol, discarded_jump_table_entry, best_func_symbol, data_limit, moved_displacement_candidate, symbol_minus_symbol, refined_block, +disconnected1, moved_data_label, next_address_in_data, symbolic_expr_attribute, relative_jump_table_entry, inferred_main_function, symbol_minus_symbol_candidate, next_data_limit, main_function, symbolic_data, symbolic_operand_point, resolved_transfer, code_in_split_block, base_relative_symbolic_operand, address_array_aux, data_access_limit, symbol_minus_symbol_from_relocation, string_candidate_refined, split_block, +disconnected6, data_object_total_points, string_candidate, data_object, address_array, discarded_data_object, block_needs_splitting_at, inferred_special_symbol, symbol_score, after_address_in_data, symbolic_operand_attribute, data_object_point, moved_pc_relative_candidate, symbolic_operand, function_inference.function_entry, jump_table, data_limit_after_access, boundary_sym_expr, data_object_candidate, label_conflict, got_reference, moved_label_candidate, preferred_data_access

address_array_aux(EA:address, Distance:unsigned, type:symbol, InitialEA:address)

Auxiliary predicate to compute address_array.

• Uses: address_in_data_refined, binary_format, code_in_block, data_segment

• Recursive: symbolic_expr_symbol_minus_symbol, symbolic_expr, +disconnected3, data_object_conflict, labeled_data_candidate, code_pointer_in_data, +disconnected2, labeled_ea, code_in_refined_block, moved_label, block_needs_merging, best_symexpr_symbol, discarded_jump_table_entry, best_func_symbol, data_limit, moved_displacement_candidate, symbol_minus_symbol, refined_block, +disconnected1, moved_data_label, next_address_in_data, symbolic_expr_attribute, relative_jump_table_entry, inferred_main_function, symbol_minus_symbol_candidate, next_data_limit, main_function, symbolic_data, symbolic_operand_point, resolved_transfer, code_in_split_block, base_relative_symbolic_operand, address_array_aux, data_access_limit, symbol_minus_symbol_from_relocation, string_candidate_refined, split_block, +disconnected6, data_object_total_points, string_candidate, data_object, address_array, discarded_data_object, block_needs_splitting_at, inferred_special_symbol, symbol_score, after_address_in_data, symbolic_operand_attribute, data_object_point, moved_pc_relative_candidate, symbolic_operand, function_inference.function_entry, jump_table, data_limit_after_access, boundary_sym_expr, data_object_candidate, label_conflict, got_reference, moved_label_candidate, preferred_data_access

address_array(EA:address, Distance:unsigned, InitialEA:address)

This predicate is used for the symbolization heuristics. The pointer candidate at address ‘EA’ belongs to a sequence of evenly spaced pointer candidates starting at address ‘InitialEA’. The space between pointers is ‘Distance’. This sequence has at least three pointers. All the pointers in a sequence either point to code or to the same data_segment.

• Recursive: symbolic_expr_symbol_minus_symbol, symbolic_expr, +disconnected3, data_object_conflict, labeled_data_candidate, code_pointer_in_data, +disconnected2, labeled_ea, code_in_refined_block, moved_label, block_needs_merging, best_symexpr_symbol, discarded_jump_table_entry, best_func_symbol, data_limit, moved_displacement_candidate, symbol_minus_symbol, refined_block, +disconnected1, moved_data_label, next_address_in_data, symbolic_expr_attribute, relative_jump_table_entry, inferred_main_function, symbol_minus_symbol_candidate, next_data_limit, main_function, symbolic_data, symbolic_operand_point, resolved_transfer, code_in_split_block, base_relative_symbolic_operand, address_array_aux, data_access_limit, symbol_minus_symbol_from_relocation, string_candidate_refined, split_block, +disconnected6, data_object_total_points, string_candidate, data_object, address_array, discarded_data_object, block_needs_splitting_at, inferred_special_symbol, symbol_score, after_address_in_data, symbolic_operand_attribute, data_object_point, moved_pc_relative_candidate, symbolic_operand, function_inference.function_entry, jump_table, data_limit_after_access, boundary_sym_expr, data_object_candidate, label_conflict, got_reference, moved_label_candidate, preferred_data_access

label_conflict(EA:address, Size:unsigned, Kind:symbol)

• Recursive: symbolic_expr_symbol_minus_symbol, symbolic_expr, +disconnected3, data_object_conflict, labeled_data_candidate, code_pointer_in_data, +disconnected2, labeled_ea, code_in_refined_block, moved_label, block_needs_merging, best_symexpr_symbol, discarded_jump_table_entry, best_func_symbol, data_limit, moved_displacement_candidate, symbol_minus_symbol, refined_block, +disconnected1, moved_data_label, next_address_in_data, symbolic_expr_attribute, relative_jump_table_entry, inferred_main_function, symbol_minus_symbol_candidate, next_data_limit, main_function, symbolic_data, symbolic_operand_point, resolved_transfer, code_in_split_block, base_relative_symbolic_operand, address_array_aux, data_access_limit, symbol_minus_symbol_from_relocation, string_candidate_refined, split_block, +disconnected6, data_object_total_points, string_candidate, data_object, address_array, discarded_data_object, block_needs_splitting_at, inferred_special_symbol, symbol_score, after_address_in_data, symbolic_operand_attribute, data_object_point, moved_pc_relative_candidate, symbolic_operand, function_inference.function_entry, jump_table, data_limit_after_access, boundary_sym_expr, data_object_candidate, label_conflict, got_reference, moved_label_candidate, preferred_data_access

data_object_total_points(EA:address, Size:unsigned, Type:symbol, Points:number)

• Recursive: symbolic_expr_symbol_minus_symbol, symbolic_expr, +disconnected3, data_object_conflict, labeled_data_candidate, code_pointer_in_data, +disconnected2, labeled_ea, code_in_refined_block, moved_label, block_needs_merging, best_symexpr_symbol, discarded_jump_table_entry, best_func_symbol, data_limit, moved_displacement_candidate, symbol_minus_symbol, refined_block, +disconnected1, moved_data_label, next_address_in_data, symbolic_expr_attribute, relative_jump_table_entry, inferred_main_function, symbol_minus_symbol_candidate, next_data_limit, main_function, symbolic_data, symbolic_operand_point, resolved_transfer, code_in_split_block, base_relative_symbolic_operand, address_array_aux, data_access_limit, symbol_minus_symbol_from_relocation, string_candidate_refined, split_block, +disconnected6, data_object_total_points, string_candidate, data_object, address_array, discarded_data_object, block_needs_splitting_at, inferred_special_symbol, symbol_score, after_address_in_data, symbolic_operand_attribute, data_object_point, moved_pc_relative_candidate, symbolic_operand, function_inference.function_entry, jump_table, data_limit_after_access, boundary_sym_expr, data_object_candidate, label_conflict, got_reference, moved_label_candidate, preferred_data_access