3 releases

0.1.2 Jan 27, 2022
0.1.1 Jun 29, 2021
0.1.0 Jun 29, 2021

#69 in macOS and iOS APIs

29 downloads per month

Apache-2.0

62KB
1K SLoC

hv

CI Crates.io Crates.io docs.rs

hv is a high level Rust bindings for Hypervisor Framework.

Build virtualization solutions on top of a lightweight hypervisor using Rust:

  • Full Hypervisor Framework support.
  • Supports Apple Silicon.
  • Safe Rust API.

Please also see the repository for latest changes and updates.

Requirements

Hypervisor Framework

At runtime, determine whether the Hypervisor APIs are available on a particular machine with the sysctl:

$ sysctl kern.hv_support
kern.hv_support: 1

In order to use Hypervisor API your app must have com.apple.security.hypervisor entitlement. Refer to example.entitlements for example of how entitlement file might look like.

Use the following command to self sign your binary for local development:

$ codesign --sign - --force --entitlements=example.entitlements ./binary

Rust

Developed and tested on latest stable Rust (1.53.0+).

Be sure to have Xcode installed and don't forget to xcode-select --install, otherwise bindgen may fail to find Hypervisor headers.

Usage

This crate uses hv-sys

Example

Here is basic "Hello world" example on Apple Silicon:

// Init VM
let vm = Arc::new(hv::Vm::new(std::ptr::null_mut())?);

// Initialize guest memory
vm.map(load_addr, GUEST_ADDR, MEM_SIZE, hv::Memory::READ)?;

// Create VCPU
let cpu = vm.create_cpu()?;

// Set regs
cpu.set_reg(Reg::PC, GUEST_ADDR)?
cpu.set_reg(Reg::X1, GUEST_RESULT_ADDR)?

loop {
    cpu.run().expect("Failed to run CPU");

    let info = cpu.exit_info();
    println!("{:?}", info);

    break;
}

Dependencies

~0–1.8MB
~35K SLoC