Manual Pages — VMM

NAME

vmm.ko – bhyve virtual machine monitor

SYNOPSIS
DESCRIPTION
PCI PASSTHROUGH
LOADER TUNABLES
EXAMPLES
SEE ALSO
HISTORY
AUTHORS

SYNOPSIS

To load the driver as a module at boot, add this line to loader.conf(5):

vmm_load="YES"

The module can also be loaded manually with kldload(8):

kldload vmm

DESCRIPTION

vmm.ko provides the kernel portion of the bhyve(4) hypervisor.

An Intel CPU with VT-x/EPT or AMD CPU with SVM support is required.

PCI device passthrough to a virtual machine requires hardware with VT-d support.

PCI PASSTHROUGH

When the hardware supports VT-d, and vmm.ko has been loaded at boot time, PCI devices can be reserved for use by the hypervisor. Entries consisting of the PCI bus/slot/function are added to the pptdevs loader.conf(5) variable. Additional entries are separated by spaces. Host PCI devices that match an entry will be assigned to the hypervisor and will not be probed by FreeBSD device drivers. See the EXAMPLES section below for sample usage.

Note that vmm must be given first the right of refusal to all pci(4) devices it may need to claim. As a result, the vmm kernel module almost certainly needs to be loaded from loader.conf(5) rather than by adding it to kld_list in rc.conf(5).

A large number of PCI device entries may require a string longer than the 128-character limit of loader.conf(5) variables. The pptdevs2 and pptdevs3 variables can be used for additional entries.