libdonut-rs 0.1.0

Public API for the Donut-rs project
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

use std::fs;
use std::path::PathBuf;
use goblin::Object;
use serde::{Deserialize, Serialize};
use crate::types::enums::{Arch, DonutValidFileType};
use crate::types::structs::DotnetParameters;
use crate::utils::globals::extract_dotnet_runtime_version;
use crate::errors::{DonutError, DonutResult};

/// Struct to store information about the embedded file
#[repr(C)]
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct FileInfo {
    #[serde(skip_serializing)]
    pub(crate) filename: String,
    pub(crate) size: usize,
    pub(crate) arch: Arch,
    pub(crate) file_bytes: Vec<u8>,
    pub(crate) file_type: DonutValidFileType,
    pub(crate) dotnet_parameters: Option<DotnetParameters>,
    pub(crate) entry: u32,
}

impl FileInfo {
    fn parse_file(bytes: &mut [u8], filename: String) -> DonutResult<Self> {
        let b= bytes.to_vec();
        let obj = Object::parse(&b).map_err(|e| DonutError::GoblinError(e.to_string()))?;
        let file_size = bytes.len();
        let val = match obj {
            Object::Elf(elf) => Self {
                filename,
                size: file_size,
                arch: if elf.is_64 { Arch::X64 } else { Arch::X86 },
                file_type: if elf.is_lib {
                    DonutValidFileType::SharedObject
                } else {
                    DonutValidFileType::ELF
                },
                file_bytes: bytes.to_vec(),
                dotnet_parameters: None,
                entry: elf.entry as u32
            },

            Object::PE(pe) => {
                let (version, is_dotnet) = match extract_dotnet_runtime_version(&pe, bytes) {
                    Ok(v) => (v, true),
                    Err(DonutError::InvalidFormat) => (String::new(), false),
                    Err(e) => return Err(e),
                };
                Self {
                    filename,
                    size: file_size,
                    arch: if pe.is_64 { Arch::X64 } else { Arch::X86 },
                    file_type: if pe.is_lib {
                        DonutValidFileType::Dll { dotnet: is_dotnet }
                    } else {
                        DonutValidFileType::PE { dotnet: is_dotnet }
                    },
                    file_bytes: bytes.to_vec(),
                    dotnet_parameters: is_dotnet.then_some(DotnetParameters {
                        runtime: version.clone(),
                        version,
                        ..Default::default()
                    }),
                    entry: pe.entry
                }
            }
            _ => {
                return Err(DonutError::InvalidFormat)
            },
        };
        Ok(val)
    }
    /// Create a new [`FileInfo`] object from a path
    pub fn from_path(path: impl Into<PathBuf>) -> DonutResult<Self> {
        let path = path.into();
        let filename = path
            .file_name()
            .and_then(|f| f.to_str())
            .ok_or(DonutError::ParseFailed)?
            .to_string();
        let mut file_bytes = fs::read(&path).map_err(|e| {
            DonutError::Io(e.to_string())
        })?;
        Self::parse_file(&mut file_bytes, filename)
    }
}