Crate kvm

A safe wrapper around the kernel’s KVM interface.

New code should use the hypervisor crate instead.

Modules

• cap 🔒

Structs

• IoapicState
  A structure with the same layout as kvm_ioapic_state but without the union, making it zerocopy-able.
• IrqRoute
  A single route for an IRQ.
• Kvm
  A wrapper around opening and using /dev/kvm.
• MemSlot 🔒
• RunnableVcpu
  A Vcpu that has a thread and can be run. Created by calling to_runnable on a Vcpu. Implements Deref to a Vcpu so all Vcpu methods are usable, with the addition of the run function to execute the guest.
• Vcpu
  A wrapper around creating and using a VCPU. Vcpu provides all functionality except for running. To run, to_runnable must be called to lock the vcpu to a thread. Then the returned RunnableVcpu can be used for running.
• VcpuThread
• Vm
  A wrapper around creating and using a VM.

Enums

• Cap
  A capability the kernel’s KVM interface can possibly expose.
• Datamatch
  Used in Vm::register_ioevent to indicate a size and optionally value to match.
• IoeventAddress
  An address either in programmable I/O space or in memory mapped I/O space.
• IrqSource
  A source of IRQs in an IrqRoute.
• PicId
  Interrupt controller IDs
• VcpuExit
  A reason why a VCPU exited. One of these returns every time Vcpu::run is called.

Constants

• NUM_IOAPIC_PINS
  Number of pins on the IOAPIC.
• VCPU_THREAD 🔒

Functions

• dirty_log_bitmap_size
  Helper function to determine the size in bytes of a dirty log bitmap for the given memory region size.
• errno_result 🔒
• set_user_memory_region 🔒 ^⚠

Type Aliases

• CpuId
  Wrapper for kvm_cpuid2 which has a zero length array at the end. Hides the zero length array behind a bounds check.