Crate arm_vcpu

arm_vcpu

[]

AArch64 virtual CPU (vCPU) implementation for hypervisors. This crate provides the core vCPU structure and virtualization-related interface support specifically designed for the AArch64 architecture.

Features

• 🔧 Complete vCPU Implementation: Full virtual CPU structure for AArch64 guests
• 🚀 Exception Handling: Comprehensive trap and exception handling for virtualized environments
• 🎯 Hardware Virtualization: Support for ARMv8 virtualization extensions (EL2)
• 🔒 Security: SMC (Secure Monitor Call) handling and secure virtualization
• 📊 Per-CPU Support: Efficient per-CPU data structures and management
• 🛠️ No-std Compatible: Works in bare-metal and embedded environments

Architecture Overview

This crate implements the following key components:

• Aarch64VCpu: The main virtual CPU structure that manages guest execution state
• TrapFrame: Context frame for handling traps and exceptions from guest VMs
• Exception Handlers: Support for synchronous and asynchronous exception handling
• System Register Emulation: Virtualized access to AArch64 system registers
• SMC Interface: Secure Monitor Call handling for trusted execution

Usage

Add this to your Cargo.toml:

[dependencies]
arm_vcpu = "0.1"

Basic Example

use arm_vcpu::{Aarch64VCpu, Aarch64VCpuCreateConfig, has_hardware_support};

// Check if hardware virtualization is supported
if has_hardware_support() {
    // Create vCPU configuration
    let config = Aarch64VCpuCreateConfig::default();
    
    // Create and configure the virtual CPU
    let vcpu = Aarch64VCpu::new(config)?;
    
    // Run the virtual CPU
    vcpu.run()?;
}

Requirements

• Architecture: AArch64 (ARMv8-A or later)
• Privilege Level: EL2 (Hypervisor mode) required for full functionality

License

This project is dual-licensed under either:

• MIT License (LICENSE-MIT or http://opensource.org/licenses/MIT)
• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)

at your option.

Structs

Aarch64PerCpu

Per-CPU data. A pointer to this struct is loaded into TP when a CPU starts. This structure

Aarch64VCpu

A virtual CPU within a guest

Aarch64VCpuCreateConfig

Configuration for creating a new Aarch64VCpu

Aarch64VCpuSetupConfig

Configuration for setting up a new Aarch64VCpu

Functions

has_hardware_support

Return if current platform support virtualization extension.

Type Aliases

TrapFrame

context frame for aarch64