starlingx/docs
Code Issues Proposed changes
docs/doc/source/node_management/openstack/pci-device-access-for-vms.rst
Ron Stone af747f6e15 String cleanup 
Replaced some downstream terms with substitutions
Removed double dash (--) in file name and adjusted index
Fixed broken label
Incorporated comment from patchset 1

Signed-off-by: Ron Stone <ronald.stone@windriver.com>
Change-Id: I199481424a9630ad828c4570ac2ff0cbbb4f7c60
Signed-off-by: Ron Stone <ronald.stone@windriver.com>
2021-04-23 11:39:38 -04:00

2.3 KiB
Raw Blame History

PCI Device Access for VMs

You can provide with passthrough or access to network interface cards and other devices.

Note

To use passthrough or devices, you must have Intel-VTx and Intel VT-d features enabled in the BIOS.

Note

When starting a where interfaces have binding_vif_type, the following parameter is required for the flavor, hw:mem_page_size=large enabled

where, page size is one of the following:

  • small: Requests the smallest available size on the compute node, which is always 4KiB of regular memory.
  • large: Requests the largest available huge page size, 1GiB or 2MiB.
  • any: Requests any available size, including small pages. uses the largest available size, 1GiB, then 2MiB, and then 4KiB.

For a network interface card, you can provide access by configuring the network interface. For more information, see Configuring PCI Passthrough Ethernet Interfaces <configure-pci-passthrough-ethernet-interfaces>.

For other types of device, you can provide access by assigning a alias to the device, and then referencing the alias in a flavor extra specification. For more information, see Expose a Generic PCI Device for Use by VMs <expose-a-generic-pci-device-for-use-by-vms> and Configuring a Flavor to Use a Generic PCI Device <configuring-a-flavor-to-use-a-generic-pci-device>.

  • PCI Passthrough Ethernet Interface Devices <pci-passthrough-ethernet-interface-devices>
  • Configuring PCI Passthrough Ethernet Interfaces <configure-pci-passthrough-ethernet-interfaces>
  • PCI SR-IOV Ethernet Interface Devices <pci-sr-iov-ethernet-interface-devices>
  • Generic PCI Passthrough <generic-pci-passthrough>
  • SR-IOV Encryption Acceleration <sr-iov-encryption-acceleration>
  • Expose a Generic PCI Device for Use by VMs <expose-a-generic-pci-device-for-use-by-vms>
  • Exposing a Generic PCI Device Using the CLI <exposing-a-generic-pci-device-using-the-cli>
  • Configure a Flavor to Use a Generic PCI Device <configuring-a-flavor-to-use-a-generic-pci-device>