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.
At runtime, determine whether the Hypervisor APIs are available on a particular machine with the sysctl:
bash
$ 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:
bash
$ codesign --sign - --force --entitlements=example.entitlements ./binary
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.
This crate uses hv-sys
Here is basic "Hello world" example on Apple Silicon: ```rust // Init VM let vm = Arc::new(hv::Vm::new(std::ptr::null_mut())?);
// Initialize guest memory vm.map(loadaddr, GUESTADDR, MEM_SIZE, hv::Memory::READ)?;
// Create VCPU let cpu = vm.create_cpu()?;
// Set regs cpu.setreg(Reg::PC, GUESTADDR)? cpu.setreg(Reg::X1, GUESTRESULT_ADDR)?
loop { cpu.run().expect("Failed to run CPU");
let info = cpu.exit_info();
println!("{:?}", info);
break;
} ```