hypervisor 0.0.3

Hardware-accelerated virtualization on OS X
Documentation

hypervisor-rs

[] (https://crates.io/crates/hypervisor) [] (https://github.com/saurvs/hypervisor-rs/blob/master/LICENSE.md)

hypervisor is a Rust library that enables hardware-accelerated execution of virtual machines on OS X.

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 hypervisor::ffi module.

Documentation

Prerequisites

To use this library, you need

  • OS X Yosemite (10.10), or newer

  • an Intel processor with the VT-x feature set that includes Extended Page Tables (EPT) and the Unrestricted Mode. To verify this, run and expect the following in your Terminal:

    $ sysctl kern.hv_support
kern.hv_support: 1

Usage

  • Add the dependency hypervisor in your Cargo.toml

    [dependencies]
hypervisor = "0.0.1"

  • Include the crate hypervisor in your code

    extern crate hypervisor;

use hypervisor::osx::*;

  • Create a virtual machine that executes for a finite time (doing nothing useful)

    // create a VM
create_vm();

// create a virtual CPU
let vcpu = vCPU::new().unwrap();

// run it
vcpu.run();

// print time elapsed in nanoseconds
println!("vcpu execution time: {:?}ns", vcpu.exec_time().unwrap());

// destroy the virtual CPU
vcpu.destory();

// destroy the VM
destory_vm();