hv_vmbus(4)

hv_vmbus4

Hyper-v virtual machine bus (vmbus) driver

Usage

To compile this driver into the kernel, place the following lines in the system kernel configuration file:

device hyperv device pci

Overview

The hv_vmbus provides a high performance communication interface between guest and root partitions in Hyper-V. Hyper-V is a hypervisor-based virtualization technology from Microsoft. Hyper-V supports isolation in terms of a partition. A partition is a logical unit of isolation, supported by the hypervisor, in which operating systems execute.

The Microsoft hypervisor must have at least one parent, or root, partition, running Windows Server operating system. The virtualization stack runs in the parent partition and has direct access to the hardware devices. The root partition then creates the child partitions which host the guest operating systems.

Child partitions do not have direct access to other hardware resources and are presented a virtual view of the resources, as virtual devices (VDevs). Requests to the virtual devices are redirected either via the VMBus or the hypervisor to the devices in the parent partition, which handles the requests.

The VMBus is a logical inter-partition communication channel. The parent partition hosts Virtualization Service Providers (VSPs) which communicate over the VMBus to handle device access requests from child partitions. Child partitions host Virtualization Service Consumers (VSCs) which redirect device requests to VSPs in the parent partition via the VMBus. The Hyper-V VMBus driver defines and implements the interface that facilitate high performance bi-directional communication between the VSCs and VSPs. All VSCs utilize the VMBus driver.

Releases

29 releases since FreeBSD 10.1-RELEASE; the text changed 15 times.

  1. 10.1
  2. 10.2
  3. 10.3
  4. 10.4
  5. 11.0
  6. 11.1
  7. 11.2
  8. 11.3
  9. 11.4
  10. 12.0
  11. 12.1
  12. 12.2
  13. 12.3
  14. 12.4
  15. 13.0–13.2
  16. 13.3–16.0

History

Support for hv_vmbus first appeared in FreeBSD 10.0. The driver was developed through a joint effort between Citrix Incorporated, Microsoft Corporation, and Network Appliance Incorporated.

Authors

FreeBSD support for hv_vmbus was first added by Microsoft BSD Integration Services Team ⟨[email protected]⟩.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.