Repository files navigation

hypervisor is a Rust library that taps into functionality that enables hardware-accelerated execution ofvirtual machines on OS X.

It binds to theHypervisor framework on OS X, and exposes a safe Rustinterface through thehypervisor module, and an unsafe foreign functioninterface through thehypervisor::ffi module.

Documentation

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 PageTables (EPT) and the Unrestricted Mode. To verify this, run and expect thefollowing in your Terminal:

  $ sysctl kern.hv_supportkern.hv_support: 1

• Accessing x86 registers
• Accessing model-specific registers (MSRs)
• Mapping guest physical memory segments into guest physical address space
• Virtual 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 fields of Virtual Machine Control Structures (VMCS)