1*052e12a5SJosh Paetzel.\" Copyright (c) 2018 VMware, Inc. 2*052e12a5SJosh Paetzel.\" 3*052e12a5SJosh Paetzel.\" SPDX-License-Identifier: (BSD-2-Clause OR GPL-2.0) 4*052e12a5SJosh Paetzel.Dd December 5, 2018 5*052e12a5SJosh Paetzel.Dt PVSCSI 4 6*052e12a5SJosh Paetzel.Os 7*052e12a5SJosh Paetzel.Sh NAME 8*052e12a5SJosh Paetzel.Nm pvscsi 9*052e12a5SJosh Paetzel.Nd VMware Paravirtual SCSI Controller 10*052e12a5SJosh Paetzel.Sh SYNOPSIS 11*052e12a5SJosh PaetzelTo compile this driver into the kernel, 12*052e12a5SJosh Paetzelplace the following line in your 13*052e12a5SJosh Paetzelkernel configuration file: 14*052e12a5SJosh Paetzel.Bd -ragged -offset indent 15*052e12a5SJosh Paetzel.Cd "device pci" 16*052e12a5SJosh Paetzel.Cd "device scbus" 17*052e12a5SJosh Paetzel.Cd "device pvscsi" 18*052e12a5SJosh Paetzel.Ed 19*052e12a5SJosh Paetzel.Pp 20*052e12a5SJosh PaetzelAlternatively, to load the driver as a 21*052e12a5SJosh Paetzelmodule at boot time, place the following line in 22*052e12a5SJosh Paetzel.Xr loader.conf 5 : 23*052e12a5SJosh Paetzel.Bd -literal -offset indent 24*052e12a5SJosh Paetzelpvscsi_load="YES" 25*052e12a5SJosh Paetzel.Ed 26*052e12a5SJosh Paetzel.Pp 27*052e12a5SJosh PaetzelThe following tunables are settable from the 28*052e12a5SJosh Paetzel.Xr loader 8 : 29*052e12a5SJosh Paetzel.Bl -ohang 30*052e12a5SJosh Paetzel.It Va hw.pvscsi.request_ring_pages 31*052e12a5SJosh Paetzelcontrols how many pages are allocated for the device request ring. 32*052e12a5SJosh PaetzelA non-positive value will cause the driver to choose the value based on device 33*052e12a5SJosh Paetzelcapabilities. 34*052e12a5SJosh PaetzelA non-zero value will use that many number of pages up to a maximum of 32. 35*052e12a5SJosh PaetzelThe default setting is 0. 36*052e12a5SJosh Paetzel.It Va hw.pvscsi.max_queue_depth 37*052e12a5SJosh Paetzelcontrols the queue size for the adapter. 38*052e12a5SJosh PaetzelA non-positive value will cause the driver to choose the value based on number 39*052e12a5SJosh Paetzelof request ring pages. 40*052e12a5SJosh PaetzelA non-zero value will set the queue size up to a maximum allowed by the number 41*052e12a5SJosh Paetzelof request ring pages. 42*052e12a5SJosh PaetzelDefault is 0. 43*052e12a5SJosh Paetzel.It Va hw.pvscsi.use_msg 44*052e12a5SJosh Paetzelsetting to nonzero value enables the use of the PVSCSI message queue allowing 45*052e12a5SJosh Paetzelfor disk hot-add and remove without manual rescan needed. 46*052e12a5SJosh PaetzelDefault is 1. 47*052e12a5SJosh Paetzel.It Va hw.pvscsi.use_msi 48*052e12a5SJosh Paetzelsetting to nonzero value enables the use of MSI interrupts. 49*052e12a5SJosh PaetzelDefault is 1. 50*052e12a5SJosh Paetzel.It Va hw.pvscsi.use_msix 51*052e12a5SJosh Paetzelsetting to nonzero value enables the use of MSI-X interrupts. 52*052e12a5SJosh PaetzelDefault is 1. 53*052e12a5SJosh Paetzel.It Va hw.pvscsi.use_req_call_threshold 54*052e12a5SJosh Paetzelsetting to nonzero value enables the request call threshold functionality. 55*052e12a5SJosh PaetzelTODO. 56*052e12a5SJosh PaetzelDefault is 1. 57*052e12a5SJosh Paetzel.El 58*052e12a5SJosh Paetzel.Sh DESCRIPTION 59*052e12a5SJosh PaetzelThe 60*052e12a5SJosh Paetzel.Nm 61*052e12a5SJosh Paetzeldriver provides support for the VMware Paravirtual SCSI Controller (PVSCSI) in 62*052e12a5SJosh Paetzelvirtual machines by VMware. 63*052e12a5SJosh Paetzel.Sh SEE ALSO 64*052e12a5SJosh Paetzel.Xr cam 4 , 65*052e12a5SJosh Paetzel.Xr da 4 66*052e12a5SJosh Paetzel.Sh HISTORY 67*052e12a5SJosh PaetzelThe 68*052e12a5SJosh Paetzel.Nm 69*052e12a5SJosh Paetzeldriver first appeared in 70*052e12a5SJosh Paetzel.Fx 13.0 . 71*052e12a5SJosh Paetzel.Sh AUTHORS 72*052e12a5SJosh Paetzel.An Vishal Bhakta Aq Mt vbhakta@vmware.com . 73