maple-rs 0.1.2

A Rust library for loading Windows PE executables and DLLs directly from memory without writing to disk
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
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
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
use crate::{MapleError, Result};
use std::mem;

#[repr(C)]
pub struct ImageDosHeader {
    pub e_magic: u16,
    pub e_cblp: u16,
    pub e_cp: u16,
    pub e_crlc: u16,
    pub e_cparhdr: u16,
    pub e_minalloc: u16,
    pub e_maxalloc: u16,
    pub e_ss: u16,
    pub e_sp: u16,
    pub e_csum: u16,
    pub e_ip: u16,
    pub e_cs: u16,
    pub e_lfarlc: u16,
    pub e_ovno: u16,
    pub e_res: [u16; 4],
    pub e_oemid: u16,
    pub e_oeminfo: u16,
    pub e_res2: [u16; 10],
    pub e_lfanew: u32,
}

#[repr(C)]
pub struct ImageFileHeader {
    pub machine: u16,
    pub number_of_sections: u16,
    pub time_date_stamp: u32,
    pub pointer_to_symbol_table: u32,
    pub number_of_symbols: u32,
    pub size_of_optional_header: u16,
    pub characteristics: u16,
}

#[repr(C)]
pub struct ImageOptionalHeader32 {
    pub magic: u16,
    pub major_linker_version: u8,
    pub minor_linker_version: u8,
    pub size_of_code: u32,
    pub size_of_initialized_data: u32,
    pub size_of_uninitialized_data: u32,
    pub address_of_entry_point: u32,
    pub base_of_code: u32,
    pub base_of_data: u32,
    pub image_base: u32,
    pub section_alignment: u32,
    pub file_alignment: u32,
    pub major_operating_system_version: u16,
    pub minor_operating_system_version: u16,
    pub major_image_version: u16,
    pub minor_image_version: u16,
    pub major_subsystem_version: u16,
    pub minor_subsystem_version: u16,
    pub win32_version_value: u32,
    pub size_of_image: u32,
    pub size_of_headers: u32,
    pub checksum: u32,
    pub subsystem: u16,
    pub dll_characteristics: u16,
    pub size_of_stack_reserve: u32,
    pub size_of_stack_commit: u32,
    pub size_of_heap_reserve: u32,
    pub size_of_heap_commit: u32,
    pub loader_flags: u32,
    pub number_of_rva_and_sizes: u32,
}

#[repr(C)]
pub struct ImageOptionalHeader64 {
    pub magic: u16,
    pub major_linker_version: u8,
    pub minor_linker_version: u8,
    pub size_of_code: u32,
    pub size_of_initialized_data: u32,
    pub size_of_uninitialized_data: u32,
    pub address_of_entry_point: u32,
    pub base_of_code: u32,
    pub image_base: u64,
    pub section_alignment: u32,
    pub file_alignment: u32,
    pub major_operating_system_version: u16,
    pub minor_operating_system_version: u16,
    pub major_image_version: u16,
    pub minor_image_version: u16,
    pub major_subsystem_version: u16,
    pub minor_subsystem_version: u16,
    pub win32_version_value: u32,
    pub size_of_image: u32,
    pub size_of_headers: u32,
    pub checksum: u32,
    pub subsystem: u16,
    pub dll_characteristics: u16,
    pub size_of_stack_reserve: u64,
    pub size_of_stack_commit: u64,
    pub size_of_heap_reserve: u64,
    pub size_of_heap_commit: u64,
    pub loader_flags: u32,
    pub number_of_rva_and_sizes: u32,
}

#[repr(C)]
pub struct ImageDataDirectory {
    pub virtual_address: u32,
    pub size: u32,
}

#[repr(C)]
pub struct ImageSectionHeader {
    pub name: [u8; 8],
    pub virtual_size: u32,
    pub virtual_address: u32,
    pub size_of_raw_data: u32,
    pub pointer_to_raw_data: u32,
    pub pointer_to_relocations: u32,
    pub pointer_to_line_numbers: u32,
    pub number_of_relocations: u16,
    pub number_of_line_numbers: u16,
    pub characteristics: u32,
}

#[repr(C)]
pub struct ImageImportDescriptor {
    pub original_first_thunk: u32,
    pub time_date_stamp: u32,
    pub forwarder_chain: u32,
    pub name: u32,
    pub first_thunk: u32,
}

#[repr(C)]
pub struct ImageImportByName {
    pub hint: u16,
    pub name: [u8; 1],
}

#[repr(C)]
pub struct ImageBaseRelocation {
    pub virtual_address: u32,
    pub size_of_block: u32,
}

#[repr(C)]
pub struct ImageExportDirectory {
    pub characteristics: u32,
    pub time_date_stamp: u32,
    pub major_version: u16,
    pub minor_version: u16,
    pub name: u32,
    pub base: u32,
    pub number_of_functions: u32,
    pub number_of_names: u32,
    pub address_of_functions: u32,
    pub address_of_names: u32,
    pub address_of_name_ordinals: u32,
}

#[repr(C)]
pub struct ImageTlsDirectory32 {
    pub start_address_of_raw_data: u32,
    pub end_address_of_raw_data: u32,
    pub address_of_index: u32,
    pub address_of_callbacks: u32,
    pub size_of_zero_fill: u32,
    pub characteristics: u32,
}

#[repr(C)]
pub struct ImageTlsDirectory64 {
    pub start_address_of_raw_data: u64,
    pub end_address_of_raw_data: u64,
    pub address_of_index: u64,
    pub address_of_callbacks: u64,
    pub size_of_zero_fill: u32,
    pub characteristics: u32,
}

#[repr(C)]
pub struct ImageResourceDirectory {
    pub characteristics: u32,
    pub time_date_stamp: u32,
    pub major_version: u16,
    pub minor_version: u16,
    pub number_of_name_entries: u16,
    pub number_of_id_entries: u16,
}

#[repr(C)]
pub struct ImageResourceDirectoryEntry {
    pub name_or_id: u32,
    pub offset_to_data_or_directory: u32,
}

#[repr(C)]
pub struct ImageResourceDataEntry {
    pub offset_to_data: u32,
    pub size: u32,
    pub code_page: u32,
    pub reserved: u32,
}

pub const IMAGE_DOS_SIGNATURE: u16 = 0x5A4D;
pub const IMAGE_NT_SIGNATURE: u32 = 0x00004550;
pub const IMAGE_NT_OPTIONAL_HDR32_MAGIC: u16 = 0x010b;
pub const IMAGE_NT_OPTIONAL_HDR64_MAGIC: u16 = 0x020b;

pub const IMAGE_DIRECTORY_ENTRY_EXPORT: usize = 0;
pub const IMAGE_DIRECTORY_ENTRY_IMPORT: usize = 1;
pub const IMAGE_DIRECTORY_ENTRY_RESOURCE: usize = 2;
pub const IMAGE_DIRECTORY_ENTRY_BASERELOC: usize = 5;
pub const IMAGE_DIRECTORY_ENTRY_TLS: usize = 9;

pub const IMAGE_REL_BASED_ABSOLUTE: u16 = 0;
pub const IMAGE_REL_BASED_HIGH: u16 = 1;
pub const IMAGE_REL_BASED_LOW: u16 = 2;
pub const IMAGE_REL_BASED_HIGHLOW: u16 = 3;
pub const IMAGE_REL_BASED_HIGHADJ: u16 = 4;
pub const IMAGE_REL_BASED_DIR64: u16 = 10;

pub const IMAGE_ORDINAL_FLAG32: u32 = 0x80000000;
pub const IMAGE_ORDINAL_FLAG64: u64 = 0x8000000000000000;

#[derive(Clone, Copy, Debug)]
pub enum PEArchitecture {
    PE32,
    PE32Plus,
}

pub enum OptionalHeader<'a> {
    PE32(&'a ImageOptionalHeader32),
    PE32Plus(&'a ImageOptionalHeader64),
}

pub struct PEParser<'a> {
    data: &'a [u8],
    _dos_header: &'a ImageDosHeader,
    _nt_headers_offset: usize,
    file_header: &'a ImageFileHeader,
    pub optional_header: &'a ImageOptionalHeader64,
    data_directories: &'a [ImageDataDirectory],
    sections: Vec<&'a ImageSectionHeader>,
}

impl<'a> PEParser<'a> {
    pub fn new(data: &'a [u8]) -> Result<Self> {
        if data.len() < mem::size_of::<ImageDosHeader>() {
            return Err(MapleError::InvalidPEFormat(
                "File too small for DOS header".to_string(),
            ));
        }

        let dos_header = unsafe { &*(data.as_ptr() as *const ImageDosHeader) };

        if dos_header.e_magic != IMAGE_DOS_SIGNATURE {
            return Err(MapleError::InvalidPEFormat(
                "Invalid DOS signature".to_string(),
            ));
        }

        let nt_headers_offset = dos_header.e_lfanew as usize;
        if nt_headers_offset + 4 > data.len() {
            return Err(MapleError::InvalidPEFormat(
                "Invalid NT headers offset".to_string(),
            ));
        }

        let nt_signature = u32::from_le_bytes([
            data[nt_headers_offset],
            data[nt_headers_offset + 1],
            data[nt_headers_offset + 2],
            data[nt_headers_offset + 3],
        ]);

        if nt_signature != IMAGE_NT_SIGNATURE {
            return Err(MapleError::InvalidPEFormat(
                "Invalid NT signature".to_string(),
            ));
        }

        let file_header_offset = nt_headers_offset + 4;
        if file_header_offset + mem::size_of::<ImageFileHeader>() > data.len() {
            return Err(MapleError::InvalidPEFormat(
                "Invalid file header".to_string(),
            ));
        }

        let file_header =
            unsafe { &*(data[file_header_offset..].as_ptr() as *const ImageFileHeader) };

        let optional_header_offset = file_header_offset + mem::size_of::<ImageFileHeader>();
        if optional_header_offset + mem::size_of::<ImageOptionalHeader64>() > data.len() {
            return Err(MapleError::InvalidPEFormat(
                "Invalid optional header".to_string(),
            ));
        }

        let optional_header =
            unsafe { &*(data[optional_header_offset..].as_ptr() as *const ImageOptionalHeader64) };

        if optional_header.magic != IMAGE_NT_OPTIONAL_HDR64_MAGIC {
            return Err(MapleError::InvalidPEFormat(
                "Not a 64-bit executable".to_string(),
            ));
        }

        let data_directories_offset =
            optional_header_offset + mem::size_of::<ImageOptionalHeader64>();
        let data_directories = unsafe {
            std::slice::from_raw_parts(
                data[data_directories_offset..].as_ptr() as *const ImageDataDirectory,
                optional_header.number_of_rva_and_sizes as usize,
            )
        };

        let sections_offset = optional_header_offset + file_header.size_of_optional_header as usize;
        let mut sections = Vec::new();

        for i in 0..file_header.number_of_sections {
            let section_offset =
                sections_offset + i as usize * mem::size_of::<ImageSectionHeader>();
            if section_offset + mem::size_of::<ImageSectionHeader>() > data.len() {
                return Err(MapleError::InvalidPEFormat(
                    "Invalid section header".to_string(),
                ));
            }

            let section =
                unsafe { &*(data[section_offset..].as_ptr() as *const ImageSectionHeader) };
            sections.push(section);
        }

        Ok(PEParser {
            data,
            _dos_header: dos_header,
            _nt_headers_offset: nt_headers_offset,
            file_header,
            optional_header,
            data_directories,
            sections,
        })
    }

    pub fn image_base(&self) -> u64 {
        self.optional_header.image_base
    }

    pub fn size_of_image(&self) -> u32 {
        self.optional_header.size_of_image
    }

    pub fn entry_point(&self) -> u32 {
        self.optional_header.address_of_entry_point
    }

    pub fn sections(&self) -> &[&ImageSectionHeader] {
        &self.sections
    }

    pub fn data_directory(&self, index: usize) -> Option<&ImageDataDirectory> {
        self.data_directories.get(index)
    }

    pub fn rva_to_offset(&self, rva: u32) -> Option<usize> {
        for section in &self.sections {
            if rva >= section.virtual_address
                && rva < section.virtual_address + section.virtual_size
            {
                let offset = rva - section.virtual_address;
                return Some(section.pointer_to_raw_data as usize + offset as usize);
            }
        }
        None
    }

    pub fn get_data_at_rva(&self, rva: u32, size: usize) -> Option<&[u8]> {
        let offset = self.rva_to_offset(rva)?;
        if offset + size <= self.data.len() {
            Some(&self.data[offset..offset + size])
        } else {
            None
        }
    }

    pub fn get_import_directory(&self) -> Option<&ImageDataDirectory> {
        self.data_directory(IMAGE_DIRECTORY_ENTRY_IMPORT)
    }

    pub fn get_export_directory(&self) -> Option<&ImageDataDirectory> {
        self.data_directory(IMAGE_DIRECTORY_ENTRY_EXPORT)
    }

    pub fn get_base_relocation_directory(&self) -> Option<&ImageDataDirectory> {
        self.data_directory(IMAGE_DIRECTORY_ENTRY_BASERELOC)
    }

    pub fn get_tls_directory(&self) -> Option<&ImageDataDirectory> {
        self.data_directory(IMAGE_DIRECTORY_ENTRY_TLS)
    }

    pub fn get_resource_directory(&self) -> Option<&ImageDataDirectory> {
        self.data_directory(IMAGE_DIRECTORY_ENTRY_RESOURCE)
    }

    pub fn is_dll(&self) -> bool {
        const IMAGE_FILE_DLL: u16 = 0x2000;
        (self.file_header.characteristics & IMAGE_FILE_DLL) != 0
    }
}