arcbox-hypervisor 0.1.4

Cross-platform hypervisor abstraction layer for ArcBox
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

# arcbox-hypervisor

Cross-platform hypervisor abstraction layer for ArcBox.

## Overview

This crate provides platform-agnostic traits for virtualization, allowing the same VM management code to work across different operating systems. It abstracts away the differences between macOS Virtualization.framework and Linux KVM.

## Features

- **Cross-platform abstraction**: Unified API for VM creation and management
- **macOS support**: Native Virtualization.framework backend (Apple Silicon and Intel)
- **Linux support**: KVM backend for x86_64 and ARM64
- **Type-safe configuration**: Builder pattern for VM configuration
- **Memory management**: Guest physical address space abstraction

## Core Traits

- `Hypervisor` - Main entry point for creating VMs
- `VirtualMachine` - VM lifecycle management (start, stop, memory mapping)
- `Vcpu` - Virtual CPU execution and register access
- `GuestMemory` - Guest physical memory read/write operations

## Usage

```rust
use arcbox_hypervisor::{create_hypervisor, VmConfig};

// Create platform-appropriate hypervisor
let hypervisor = create_hypervisor()?;

// Configure VM
let config = VmConfig::builder()
    .vcpu_count(4)
    .memory_size(4 * 1024 * 1024 * 1024) // 4GB
    .build();

// Create and start VM
let vm = hypervisor.create_vm(config)?;
```

## Platform Backends

| Platform | Backend | Status |
|----------|---------|--------|
| macOS (Apple Silicon) | Virtualization.framework | Primary |
| macOS (Intel) | Virtualization.framework | Supported |
| Linux (x86_64) | KVM | Supported |
| Linux (ARM64) | KVM | Supported |

## License

MIT OR Apache-2.0