hypervisor 0.0.1

Hardware-accelerated virtualization on OS X
Documentation

hypervisor-rs

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

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

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());
    // should print some random finite value every time
    
    // destroy the virtual CPU
    vcpu.destory();
    
    // destroy the VM
    destory_vm();
    

Status

More is yet to come.