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

use super::Command;
use crate::common::FromFFI;
use crate::macho::binding_info::Dyld;
use crate::macho::{BindingInfo, ExportInfo};
use std::marker::PhantomData;

use crate::{declare_iterator, declare_iterator_conv, to_slice};

use lief_ffi as ffi;

/// Structure that represents the `LC_DYLD_INFO` and `LC_DYLD_INFO_ONLY` commands
pub struct DyldInfo<'a> {
    ptr: cxx::UniquePtr<ffi::MachO_DyldInfo>,
    _owner: PhantomData<&'a ffi::MachO_Binary>,
}

impl std::fmt::Debug for DyldInfo<'_> {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        let base = self as &dyn Command;
        f.debug_struct("DyldInfo")
            .field("base", &base)
            .field("rebase_opcodes", &self.rebase_opcodes().is_empty())
            .field("bind_opcodes", &self.bind_opcodes().is_empty())
            .field("weak_bind_opcodes", &self.weak_bind_opcodes().is_empty())
            .field("lazy_bind_opcodes", &self.lazy_bind_opcodes().is_empty())
            .field("export_trie", &self.export_trie().is_empty())
            .finish()
    }
}

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

impl<'a> DyldInfo<'a> {
    /// Return Rebase's opcodes as a slice of bytes
    pub fn rebase_opcodes(&self) -> &[u8] {
        to_slice!(self.ptr.rebase_opcodes());
    }

    /// Return **regular** binding's opcodes as a slice of bytes
    pub fn bind_opcodes(&self) -> &[u8] {
        to_slice!(self.ptr.bind_opcodes());
    }

    /// Return **weak** binding's opcodes as a slice of bytes
    pub fn weak_bind_opcodes(&self) -> &[u8] {
        to_slice!(self.ptr.weak_bind_opcodes());
    }

    /// Return **lazy** binding's opcodes as a slice of bytes
    pub fn lazy_bind_opcodes(&self) -> &[u8] {
        to_slice!(self.ptr.lazy_bind_opcodes());
    }

    /// Return the raw export trie as a slice of bytes
    pub fn export_trie(&self) -> &[u8] {
        to_slice!(self.ptr.export_trie());
    }

    /// Return an iterator over the [`crate::macho::BindingInfo::Dyld`] associated with this
    /// command
    pub fn bindings(&self) -> BindingInfos<'_> {
        BindingInfos::new(self.ptr.bindings())
    }

    /// Return an iterator over the [`crate::macho::ExportInfo`] associated with this command
    pub fn exports(&self) -> ExportInfos<'_> {
        ExportInfos::new(self.ptr.exports())
    }
}

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

declare_iterator_conv!(
    BindingInfos,
    BindingInfo<'a>,
    ffi::MachO_BindingInfo,
    ffi::MachO_DyldInfo,
    ffi::MachO_DyldInfo_it_bindings,
    |n| BindingInfo::Dyld(Dyld::from_ffi(n))
);
declare_iterator!(
    ExportInfos,
    ExportInfo<'a>,
    ffi::MachO_ExportInfo,
    ffi::MachO_DyldInfo,
    ffi::MachO_DyldInfo_it_exports
);