objdiff-core 3.7.3

A local diffing tool for decompilation projects.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

use objdiff_core::{
    diff::{DiffObjConfig, SymbolDiff, display::DiffTextSegment},
    obj::Object,
};

pub fn display_diff(
    obj: &Object,
    diff: &SymbolDiff,
    symbol_idx: usize,
    diff_config: &DiffObjConfig,
) -> String {
    let mut output = String::new();
    for row in &diff.instruction_rows {
        output.push('[');
        let mut separator = false;
        objdiff_core::diff::display::display_row(obj, symbol_idx, row, diff_config, |segment| {
            if separator {
                output.push_str(", ");
            } else {
                separator = true;
            }
            let DiffTextSegment { text, color, pad_to } = segment;
            output.push_str(&format!("({text:?}, {color:?}, {pad_to:?})"));
            Ok(())
        })
        .unwrap();
        output.push_str("]\n");
    }
    output
}

#[repr(C)]
pub struct AlignedAs<Align, Bytes: ?Sized> {
    pub _align: [Align; 0],
    pub bytes: Bytes,
}

#[macro_export]
macro_rules! include_bytes_align_as {
    ($align_ty:ty, $path:literal) => {{
        static ALIGNED: &common::AlignedAs<$align_ty, [u8]> =
            &common::AlignedAs { _align: [], bytes: *include_bytes!($path) };
        &ALIGNED.bytes
    }};
}

#[macro_export]
macro_rules! include_object {
    ($path:literal) => {
        include_bytes_align_as!(u64, $path)
    };
}

#[allow(dead_code)]
pub fn assert_literal_value(
    obj: &Object,
    diff_config: &DiffObjConfig,
    function_name: &str,
    ins_row_idx: usize,
    literal_label: &str,
    literal_value: &str,
) {
    let symbol_idx = obj.symbols.iter().position(|s| s.name == function_name).unwrap();
    let diff = objdiff_core::diff::code::no_diff_code(obj, symbol_idx, diff_config).unwrap();
    let ins_ref = diff.instruction_rows[ins_row_idx].ins_ref.unwrap();
    let resolved = obj.resolve_instruction_ref(symbol_idx, ins_ref).unwrap();
    let literals = objdiff_core::diff::display::display_ins_data_literals(obj, resolved);
    let target_literal =
        literals.iter().find(|lit_info| lit_info.label_override == Some(literal_label.to_string()));
    assert_ne!(target_literal, None);
    let lit_info = target_literal.unwrap();
    assert_eq!(lit_info.literal, literal_value);
}