Line data Source code
1 : use super::Command;
2 : use crate::common::FromFFI;
3 : use crate::macho::Symbol;
4 : use lief_ffi as ffi;
5 : use std::marker::PhantomData;
6 :
7 : use crate::declare_iterator;
8 :
9 : /// Structure that represents the `LC_DYSYMTAB` command.
10 : ///
11 : /// This command completes the `LC_SYMTAB` to provide
12 : /// a better granularity over the symbols layout.
13 : pub struct DynamicSymbolCommand<'a> {
14 : ptr: cxx::UniquePtr<ffi::MachO_DynamicSymbolCommand>,
15 : _owner: PhantomData<&'a ffi::MachO_Binary>,
16 : }
17 :
18 : impl DynamicSymbolCommand<'_> {
19 : /// Index of the first symbol in the group of local symbols.
20 280 : pub fn idx_local_symbol(&self) -> u32 {
21 280 : self.ptr.idx_local_symbol()
22 280 : }
23 :
24 : /// Number of symbols in the group of local symbols.
25 280 : pub fn nb_local_symbols(&self) -> u32 {
26 280 : self.ptr.nb_local_symbols()
27 280 : }
28 :
29 : /// Index of the first symbol in the group of defined external symbols.
30 280 : pub fn idx_external_define_symbol(&self) -> u32 {
31 280 : self.ptr.idx_external_define_symbol()
32 280 : }
33 :
34 : /// Number of symbols in the group of defined external symbols.
35 280 : pub fn nb_external_define_symbols(&self) -> u32 {
36 280 : self.ptr.nb_external_define_symbols()
37 280 : }
38 :
39 : /// Index of the first symbol in the group of undefined external symbols.
40 280 : pub fn idx_undefined_symbol(&self) -> u32 {
41 280 : self.ptr.idx_undefined_symbol()
42 280 : }
43 :
44 : /// Number of symbols in the group of undefined external symbols.
45 280 : pub fn nb_undefined_symbols(&self) -> u32 {
46 280 : self.ptr.nb_undefined_symbols()
47 280 : }
48 :
49 : /// Byte offset from the start of the file to the table of contents data
50 : ///
51 : /// Table of content is used by legacy Mach-O loader and this field should be
52 : /// set to 0
53 280 : pub fn toc_offset(&self) -> u32 {
54 280 : self.ptr.toc_offset()
55 280 : }
56 :
57 : /// Number of entries in the table of contents.
58 : ///
59 : /// Should be set to 0 on recent Mach-O
60 280 : pub fn nb_toc(&self) -> u32 {
61 280 : self.ptr.nb_toc()
62 280 : }
63 :
64 : /// Byte offset from the start of the file to the module table data.
65 : ///
66 : /// This field seems unused by recent Mach-O loader and should be set to 0
67 280 : pub fn module_table_offset(&self) -> u32 {
68 280 : self.ptr.module_table_offset()
69 280 : }
70 :
71 : /// Number of entries in the module table.
72 : ///
73 : /// This field seems unused by recent Mach-O loader and should be set to 0
74 280 : pub fn nb_module_table(&self) -> u32 {
75 280 : self.ptr.nb_module_table()
76 280 : }
77 :
78 : /// Byte offset from the start of the file to the external reference table data.
79 : ///
80 : /// This field seems unused by recent Mach-O loader and should be set to 0
81 280 : pub fn external_reference_symbol_offset(&self) -> u32 {
82 280 : self.ptr.external_reference_symbol_offset()
83 280 : }
84 :
85 : /// Number of entries in the external reference table
86 : ///
87 : /// This field seems unused by recent Mach-O loader and should be set to 0
88 280 : pub fn nb_external_reference_symbols(&self) -> u32 {
89 280 : self.ptr.nb_external_reference_symbols()
90 280 : }
91 :
92 : /// Byte offset from the start of the file to the indirect symbol table data.
93 : ///
94 : /// Indirect symbol table is used by the loader to speed-up symbol resolution during
95 : /// the *lazy binding* process
96 : ///
97 : /// References:
98 : /// * dyld-519.2.1/src/ImageLoaderMachOCompressed.cpp
99 : /// * dyld-519.2.1/src/ImageLoaderMachOClassic.cpp
100 280 : pub fn indirect_symbol_offset(&self) -> u32 {
101 280 : self.ptr.indirect_symbol_offset()
102 280 : }
103 :
104 : /// Number of entries in the indirect symbol table.
105 280 : pub fn nb_indirect_symbols(&self) -> u32 {
106 280 : self.ptr.nb_indirect_symbols()
107 280 : }
108 :
109 : /// Byte offset from the start of the file to the external relocation table data.
110 : ///
111 : /// This field seems unused by recent Mach-O loader and should be set to 0
112 280 : pub fn external_relocation_offset(&self) -> u32 {
113 280 : self.ptr.external_relocation_offset()
114 280 : }
115 :
116 : /// Number of entries in the external relocation table.
117 : ///
118 : /// This field seems unused by recent Mach-O loader and should be set to 0
119 280 : pub fn nb_external_relocations(&self) -> u32 {
120 280 : self.ptr.nb_external_relocations()
121 280 : }
122 :
123 : /// Byte offset from the start of the file to the local relocation table data.
124 : ///
125 : /// This field seems unused by recent Mach-O loader and should be set to 0
126 280 : pub fn local_relocation_offset(&self) -> u32 {
127 280 : self.ptr.local_relocation_offset()
128 280 : }
129 :
130 : /// Number of entries in the local relocation table.
131 : ///
132 : /// This field seems unused by recent Mach-O loader and should be set to 0
133 280 : pub fn nb_local_relocations(&self) -> u32 {
134 280 : self.ptr.nb_local_relocations()
135 280 : }
136 :
137 : /// Iterator over the indirect symbols indexed by this command
138 140 : pub fn indirect_symbols(&self) -> IndirectSymbols {
139 140 : IndirectSymbols::new(self.ptr.indirect_symbols())
140 140 : }
141 : }
142 :
143 : impl std::fmt::Debug for DynamicSymbolCommand<'_> {
144 280 : fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
145 280 : let base = self as &dyn Command;
146 280 : f.debug_struct("DynamicSymbolCommand")
147 280 : .field("base", &base)
148 280 : .field("idx_local_symbol", &self.idx_local_symbol())
149 280 : .field("nb_local_symbols", &self.nb_local_symbols())
150 280 : .field(
151 280 : "idx_external_define_symbol",
152 280 : &self.idx_external_define_symbol(),
153 280 : )
154 280 : .field(
155 280 : "nb_external_define_symbols",
156 280 : &self.nb_external_define_symbols(),
157 280 : )
158 280 : .field("idx_undefined_symbol", &self.idx_undefined_symbol())
159 280 : .field("nb_undefined_symbols", &self.nb_undefined_symbols())
160 280 : .field("toc_offset", &self.toc_offset())
161 280 : .field("nb_toc", &self.nb_toc())
162 280 : .field("module_table_offset", &self.module_table_offset())
163 280 : .field("nb_module_table", &self.nb_module_table())
164 280 : .field(
165 280 : "external_reference_symbol_offset",
166 280 : &self.external_reference_symbol_offset(),
167 280 : )
168 280 : .field(
169 280 : "nb_external_reference_symbols",
170 280 : &self.nb_external_reference_symbols(),
171 280 : )
172 280 : .field("indirect_symbol_offset", &self.indirect_symbol_offset())
173 280 : .field("nb_indirect_symbols", &self.nb_indirect_symbols())
174 280 : .field(
175 280 : "external_relocation_offset",
176 280 : &self.external_relocation_offset(),
177 280 : )
178 280 : .field("nb_external_relocations", &self.nb_external_relocations())
179 280 : .field("local_relocation_offset", &self.local_relocation_offset())
180 280 : .field("nb_local_relocations", &self.nb_local_relocations())
181 280 : .finish()
182 280 : }
183 : }
184 :
185 : impl FromFFI<ffi::MachO_DynamicSymbolCommand> for DynamicSymbolCommand<'_> {
186 280 : fn from_ffi(cmd: cxx::UniquePtr<ffi::MachO_DynamicSymbolCommand>) -> Self {
187 280 : Self {
188 280 : ptr: cmd,
189 280 : _owner: PhantomData,
190 280 : }
191 280 : }
192 : }
193 :
194 : impl Command for DynamicSymbolCommand<'_> {
195 1120 : fn get_base(&self) -> &ffi::MachO_Command {
196 1120 : self.ptr.as_ref().unwrap().as_ref()
197 1120 : }
198 : }
199 :
200 42080 : declare_iterator!(
201 42080 : IndirectSymbols,
202 42080 : Symbol<'a>,
203 42080 : ffi::MachO_Symbol,
204 42080 : ffi::MachO_DynamicSymbolCommand,
205 42080 : ffi::MachO_DynamicSymbolCommand_it_indirect_symbols
206 42080 : );
|
