xhypervisor

xhypervisor is a Rust library that taps into functionality that enables hardware-accelerated execution of virtual machines on OS X. It is a fork of hypervisor-rs and modified for the development of uhyve. Derived from ahv, we added the support of Apple's Hypervisor Framework on Apple Silicon.

It binds to the Hypervisor framework on OS X, and exposes a safe Rust interface through the hypervisor module, and an unsafe foreign function interface through the xhypervisor::ffi module.

Prerequisites

To use this library, you need

• macOS 10, or newer
• An Intel processor with the VT-x feature or an Apple Silicon processor with virtualization support. To verify this, run and expect the following in your Terminal:

  $ sysctl kern.hv_support
  kern.hv_support: 1
  

Status

• Accessing x86 registers
• Accessing aarch64 registers
• Mapping guest physical memory segments into guest physical address space
• x86: Accessing fields of Virtual Machine Control Structures (VMCS)
• Virtual x86 CPUs
  • Executing and interrupting
  • Force flushing cached state
  • Invalidating translation lookaside buffer (TLB)
  • Accessing floating point (FP) and SIMD state
  • Obtaining cumulative execution time
  • Synchronizing guest timestamp-counters (TSC)
  • Accessing model-specific registers (MSRs)
• Virtual aarch64 CPUs
  • Executing and interrupting
  • GICv3 support (requires macOS 15, or newer)