lief 1.0.0

Official Rust bindings for LIEF
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
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

use super::Command;
use lief_ffi as ffi;

use crate::macho::binding_info::{CHAINED_FORMAT, Chained};
use crate::to_slice;
use crate::{common::FromFFI, declare_iterator};
use std::marker::PhantomData;

/// Structure that represents the `LC_DYLD_CHAINED_FIXUPS` command
///
/// This command aims at providing rebase and binding information like
/// the DyldInfo's bytecode. Compared to the DyldInfo bytecode, these chained
/// fixups are taking less space.
pub struct DyldChainedFixups<'a> {
    ptr: cxx::UniquePtr<ffi::MachO_DyldChainedFixups>,
    _owner: PhantomData<&'a ffi::MachO_Binary>,
}

impl std::fmt::Debug for DyldChainedFixups<'_> {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        let base = self as &dyn Command;
        f.debug_struct("DyldChainedFixups")
            .field("base", &base)
            .field("data_offset", &self.data_offset())
            .field("data_size", &self.data_size())
            .field("fixups_version", &self.fixups_version())
            .field("starts_offset", &self.starts_offset())
            .field("imports_offset", &self.imports_offset())
            .field("symbols_offset", &self.symbols_offset())
            .field("imports_count", &self.imports_count())
            .field("symbols_format", &self.symbols_format())
            .field("imports_format", &self.imports_format())
            .finish()
    }
}

impl DyldChainedFixups<'_> {
    /// Offset of the `LC_DYLD_CHAINED_FIXUPS` chained payload.
    /// This offset should point in the `__LINKEDIT` segment
    pub fn data_offset(&self) -> u32 {
        self.ptr.data_offset()
    }

    /// Size of the `LC_DYLD_CHAINED_FIXUPS` payload.
    pub fn data_size(&self) -> u32 {
        self.ptr.data_size()
    }

    /// Chained fixups version. The loader (dyld v852.2) checks
    /// that this value is set to 0
    pub fn fixups_version(&self) -> u32 {
        self.ptr.fixups_version()
    }

    /// offset of `dyld_chained_starts_in_image` in chain_data
    pub fn starts_offset(&self) -> u32 {
        self.ptr.starts_offset()
    }

    /// Offset of imports table in chain data
    pub fn imports_offset(&self) -> u32 {
        self.ptr.imports_offset()
    }

    /// Offset of symbol strings in chain data
    pub fn symbols_offset(&self) -> u32 {
        self.ptr.symbols_offset()
    }

    /// Number of imported symbol names
    pub fn imports_count(&self) -> u32 {
        self.ptr.imports_count()
    }

    /// The compression algorithm (if any) used to store the symbols
    /// 0 means uncompressed while 1 means zlib compressed.
    ///
    /// As far of the version v852.2 of dyld loader, it only supports
    /// **uncompressed** format
    pub fn symbols_format(&self) -> u32 {
        self.ptr.symbols_format()
    }

    /// The format of the imports
    pub fn imports_format(&self) -> CHAINED_FORMAT {
        CHAINED_FORMAT::from_value(self.ptr.imports_format())
    }

    /// Iterator over the bindings [`crate::macho::BindingInfo::Chained`]
    /// associated with this command
    pub fn bindings(&self) -> Bindings<'_> {
        Bindings::new(self.ptr.bindings())
    }

    /// Return the raw content of the command
    pub fn payload(&self) -> &[u8] {
        to_slice!(self.ptr.payload());
    }
}

impl FromFFI<ffi::MachO_DyldChainedFixups> for DyldChainedFixups<'_> {
    fn from_ffi(cmd: cxx::UniquePtr<ffi::MachO_DyldChainedFixups>) -> Self {
        Self {
            ptr: cmd,
            _owner: PhantomData,
        }
    }
}

impl Command for DyldChainedFixups<'_> {
    fn get_base(&self) -> &ffi::MachO_Command {
        self.ptr.as_ref().unwrap().as_ref()
    }
}

declare_iterator!(
    Bindings,
    Chained<'a>,
    ffi::MachO_ChainedBindingInfo,
    ffi::MachO_DyldChainedFixups,
    ffi::MachO_DyldChainedFixups_it_bindings
);