docs.rs failed to build arcbox-vmm-0.4.9
Please check the build logs for more information.
See Builds for ideas on how to fix a failed build, or Metadata for how to configure docs.rs builds.
If you believe this is docs.rs' fault, open an issue.

Visit the last successful build: arcbox-vmm-0.0.1-alpha.1

arcbox-vmm

Virtual Machine Monitor (VMM) for ArcBox.

Overview

This crate provides high-level VM management on top of the hypervisor abstraction layer. It orchestrates VM lifecycle, vCPU execution, memory layout, device management, and boot process.

Features

VmBuilder: Fluent API for VM configuration and construction
VcpuManager: Manages vCPU threads and execution
MemoryManager: Memory allocation and guest physical address mapping
DeviceManager: VirtIO device registration and I/O handling
FDT generation: Flattened Device Tree for ARM64 boot

Architecture

+--------------------------------------------------+
|                      VMM                          |
|  +------------+ +-------------+ +-------------+  |
|  |VcpuManager | |MemoryManager| |DeviceManager|  |
|  +------------+ +-------------+ +-------------+  |
|  +------------+ +-------------+ +-------------+  |
|  | EventLoop  | |   IrqChip   | |    Boot     |  |
|  +------------+ +-------------+ +-------------+  |
+--------------------------------------------------+
                       |
                       v
          +------------------------+
          |   arcbox-hypervisor    |
          +------------------------+

Usage

use arcbox_vmm::builder::VmBuilder;

let vm = VmBuilder::new()
    .name("my-vm")
    .cpus(4)
    .memory_gb(2)
    .kernel("/path/to/vmlinux")
    .cmdline("console=hvc0 root=/dev/vda")
    .block_device("/path/to/disk.img", false)
    .network_device(None, None)
    .build()?;

vm.run().await?;

Memory Layout (ARM64)

0x0000_0000 - 0x3FFF_FFFF  : RAM (low memory)
0x4000_0000 - 0x4000_FFFF  : GIC distributor
0x4001_0000 - 0x4001_FFFF  : GIC redistributor
0x4002_0000 - 0x4002_FFFF  : UART (PL011)
0x4003_0000 - ...          : VirtIO MMIO devices
0x8000_0000 - ...          : RAM (high memory)

License

MIT OR Apache-2.0