pvscsi(4)

pvscsi4

Vmware paravirtual scsi controller

Usage

To compile this driver into the kernel, place the following line in your kernel configuration file:

device pci device scbus device pvscsi

Alternatively, to load the driver as a module at boot time, place the following line in loader.conf(5):

pvscsi_load="YES"

The following tunables are settable from the loader(8):

hw.pvscsi.request_ring_pages

controls how many pages are allocated for the device request ring. A non-positive value will cause the driver to choose the value based on device capabilities. A non-zero value will use that many number of pages up to a maximum of 32. The default setting is 0.

hw.pvscsi.max_queue_depth

controls the queue size for the adapter. A non-positive value will cause the driver to choose the value based on number of request ring pages. A non-zero value will set the queue size up to a maximum allowed by the number of request ring pages. Default is 0.

hw.pvscsi.use_msg

setting to nonzero value enables the use of the PVSCSI message queue allowing for disk hot-add and remove without manual rescan needed. Default is 1.

hw.pvscsi.use_msi

setting to nonzero value enables the use of MSI interrupts. Default is 1.

hw.pvscsi.use_msix

setting to nonzero value enables the use of MSI-X interrupts. Default is 1.

hw.pvscsi.use_req_call_threshold

setting to nonzero value enables the request call threshold functionality. TODO. Default is 1.

Overview

The pvscsi driver provides support for the VMware Paravirtual SCSI Controller (PVSCSI) in virtual machines by VMware.

Releases

Unchanged in 7 releases since FreeBSD 13.5-RELEASE.

  1. 13.5–16.0

History

The pvscsi driver first appeared in FreeBSD 13.0.

Authors

Vishal Bhakta ⟨[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.