Skip to main content

pe_assembler/formats/dll/reader/
mod.rs

1use crate::{
2    helpers::{
3        pe_reader::{read_pe_head, read_pe_program, read_pe_section_headers},
4        PeReader,
5    },
6    types::{PeHeader, PeInfo, PeProgram, SectionHeader},
7};
8use gaia_types::{GaiaDiagnostics, GaiaError};
9use std::io::{Read, Seek, SeekFrom};
10
11/// DLL reader for parsing PE format DLL files.
12#[derive(Debug)]
13pub struct DllReader<R> {
14    /// The underlying reader.
15    reader: R,
16    /// The parsed PE header.
17    dll_header: Option<PeHeader>,
18    /// The parsed PE info.
19    dll_info: Option<PeInfo>,
20    /// The parsed section headers.
21    dll_section_headers: Option<Vec<SectionHeader>>,
22    /// The fully parsed PE program.
23    dll_program: Option<PeProgram>,
24    /// Collected errors during parsing.
25    errors: Vec<GaiaError>,
26}
27
28impl<R: Read> Read for DllReader<R> {
29    fn read(&mut self, buffer: &mut [u8]) -> std::io::Result<usize> {
30        self.reader.read(buffer)
31    }
32}
33
34impl<R: Seek> Seek for DllReader<R> {
35    fn seek(&mut self, position: SeekFrom) -> std::io::Result<u64> {
36        self.reader.seek(position)
37    }
38}
39
40impl<R> DllReader<R> {
41    /// Creates a new DllReader with the specified reader.
42    pub fn new(reader: R) -> Self {
43        Self { reader, dll_header: None, dll_section_headers: None, dll_program: None, dll_info: None, errors: vec![] }
44    }
45    /// Finalizes the reading process and returns the parsed PE program.
46    pub fn finish(mut self) -> GaiaDiagnostics<PeProgram>
47    where
48        R: Read + Seek,
49    {
50        if self.dll_program.is_none() {
51            if let Err(e) = read_pe_program(&mut self) {
52                return GaiaDiagnostics { result: Err(e), diagnostics: self.errors };
53            }
54        }
55        unsafe {
56            let exe = self.dll_program.unwrap_unchecked();
57            GaiaDiagnostics { result: Ok(exe), diagnostics: self.errors }
58        }
59    }
60}
61
62impl<R: Read + Seek> PeReader<R> for DllReader<R> {
63    fn get_viewer(&mut self) -> &mut R {
64        &mut self.reader
65    }
66
67    fn add_diagnostics(&mut self, error: impl Into<GaiaError>) {
68        self.errors.push(error.into());
69    }
70
71    fn get_section_headers(&mut self) -> Result<&[SectionHeader], GaiaError> {
72        if self.dll_section_headers.is_none() {
73            self.dll_section_headers = Some(read_pe_section_headers(self)?);
74        }
75        unsafe { Ok(self.dll_section_headers.as_ref().unwrap_unchecked()) }
76    }
77
78    fn get_pe_header(&mut self) -> Result<&PeHeader, GaiaError> {
79        if self.dll_header.is_none() {
80            self.dll_header = Some(read_pe_head(self)?)
81        }
82        unsafe { Ok(self.dll_header.as_ref().unwrap_unchecked()) }
83    }
84
85    fn get_program(&mut self) -> Result<&PeProgram, GaiaError> {
86        if self.dll_program.is_none() {
87            self.dll_program = Some(read_pe_program(self)?);
88        }
89        unsafe { Ok(self.dll_program.as_ref().unwrap_unchecked()) }
90    }
91}