x86_vcpu 0.5.18

x86 Virtual CPU implementation for the Arceos Hypervisor
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

// Fallback stub types for x86_vcpu builds without a hypervisor backend.
//
// These types are exported as `X86ArchVCpu` and `X86ArchPerCpuState` when
// neither the `vmx` nor `svm` feature is enabled (e.g., a `host-fs`-only
// build). The stubs implement the required traits so that downstream crates
// that gate their VM-related logic on a separate feature can still compile.
//
// None of the methods are ever called at runtime in such configurations.

use ax_errno::{AxResult, ax_err};
use axvm_types::{
    GuestPhysAddr, NestedPagingConfig, VCpuId, VMId, VmArchPerCpuOps, VmArchVcpuOps, VmExit,
};

use crate::{X86VCpuCreateConfig, X86VCpuSetupConfig};

/// Stub per-CPU state; never instantiated in no-backend builds.
pub struct X86ArchPerCpuState;

impl VmArchPerCpuOps for X86ArchPerCpuState {
    fn new(_cpu_id: usize) -> AxResult<Self> {
        ax_err!(Unsupported, "no hypervisor backend (vmx/svm) enabled")
    }

    fn is_enabled(&self) -> bool {
        false
    }

    fn hardware_enable(&mut self) -> AxResult {
        ax_err!(Unsupported, "no hypervisor backend (vmx/svm) enabled")
    }

    fn hardware_disable(&mut self) -> AxResult {
        ax_err!(Unsupported, "no hypervisor backend (vmx/svm) enabled")
    }
}

/// Stub vCPU; never instantiated in no-backend builds.
pub struct X86ArchVCpu;

impl VmArchVcpuOps for X86ArchVCpu {
    type CreateConfig = X86VCpuCreateConfig;
    type SetupConfig = X86VCpuSetupConfig;
    type Exit = VmExit;

    fn new(_vm_id: VMId, _vcpu_id: VCpuId, _config: X86VCpuCreateConfig) -> AxResult<Self> {
        ax_err!(Unsupported, "no hypervisor backend (vmx/svm) enabled")
    }

    fn set_entry(&mut self, _entry: GuestPhysAddr) -> AxResult {
        ax_err!(Unsupported, "no hypervisor backend (vmx/svm) enabled")
    }

    fn set_nested_page_table(&mut self, _config: NestedPagingConfig) -> AxResult {
        ax_err!(Unsupported, "no hypervisor backend (vmx/svm) enabled")
    }

    fn setup(&mut self, _config: X86VCpuSetupConfig) -> AxResult {
        ax_err!(Unsupported, "no hypervisor backend (vmx/svm) enabled")
    }

    fn run(&mut self) -> AxResult<Self::Exit> {
        ax_err!(Unsupported, "no hypervisor backend (vmx/svm) enabled")
    }

    fn bind(&mut self) -> AxResult {
        ax_err!(Unsupported, "no hypervisor backend (vmx/svm) enabled")
    }

    fn unbind(&mut self) -> AxResult {
        ax_err!(Unsupported, "no hypervisor backend (vmx/svm) enabled")
    }

    fn set_gpr(&mut self, _reg: usize, _val: usize) {
        unreachable!("no hypervisor backend (vmx/svm) enabled")
    }

    fn inject_interrupt(&mut self, _vector: usize) -> AxResult {
        ax_err!(Unsupported, "no hypervisor backend (vmx/svm) enabled")
    }

    fn set_return_value(&mut self, _val: usize) {
        unreachable!("no hypervisor backend (vmx/svm) enabled")
    }
}