axvm 0.5.26

Virtual Machine resource management crate for ArceOS's hypervisor variant.
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

//! Final ACPI table metadata and direct-boot image.

use std::vec::Vec;

use super::AcpiBuildError;

/// One standard ACPI table placed in guest memory or an fw_cfg file.
#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) struct AcpiTableRecord {
    signature: [u8; 4],
    address: u64,
    length: usize,
}

impl AcpiTableRecord {
    pub(crate) const fn new(signature: [u8; 4], address: u64, length: usize) -> Self {
        Self {
            signature,
            address,
            length,
        }
    }

    #[cfg(test)]
    pub(crate) const fn signature(&self) -> [u8; 4] {
        self.signature
    }

    #[cfg(test)]
    pub(crate) const fn address(&self) -> u64 {
        self.address
    }

    #[cfg(test)]
    pub(crate) const fn length(&self) -> usize {
        self.length
    }
}

/// Logical table collection used for pointer closure and diagnostics.
#[derive(Clone, Debug, Default, Eq, PartialEq)]
pub(crate) struct AcpiTableSet {
    tables: Vec<AcpiTableRecord>,
}

impl AcpiTableSet {
    pub(crate) const fn new() -> Self {
        Self { tables: Vec::new() }
    }

    pub(crate) fn add(&mut self, table: AcpiTableRecord) -> Result<(), AcpiBuildError> {
        if self
            .tables
            .iter()
            .any(|existing| existing.signature == table.signature)
        {
            return Err(AcpiBuildError::DuplicateTable {
                signature: table.signature,
            });
        }
        self.tables.push(table);
        Ok(())
    }

    #[cfg(test)]
    pub(crate) fn find(&self, signature: [u8; 4]) -> Option<&AcpiTableRecord> {
        self.tables
            .iter()
            .find(|table| table.signature == signature)
    }

    pub(crate) fn iter(&self) -> impl Iterator<Item = &AcpiTableRecord> {
        self.tables.iter()
    }
}

/// ACPI bytes installed directly into guest physical memory.
#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) struct AcpiImage {
    load_gpa: u64,
    rsdp_gpa: u64,
    bytes: Vec<u8>,
    tables: AcpiTableSet,
}

impl AcpiImage {
    pub(crate) const fn new(
        load_gpa: u64,
        rsdp_gpa: u64,
        bytes: Vec<u8>,
        tables: AcpiTableSet,
    ) -> Self {
        Self {
            load_gpa,
            rsdp_gpa,
            bytes,
            tables,
        }
    }

    pub(crate) const fn load_gpa(&self) -> u64 {
        self.load_gpa
    }

    pub(crate) const fn rsdp_gpa(&self) -> u64 {
        self.rsdp_gpa
    }

    pub(crate) fn bytes(&self) -> &[u8] {
        &self.bytes
    }

    pub(crate) const fn tables(&self) -> &AcpiTableSet {
        &self.tables
    }
}