docs/doc/source/node_management/openstack/pci-device-access-for-vms.rst
Ron Stone f125a8b892 Remove spurious escapes (r8,dsR8)
This change addresses a long-standing issue in rST documentation imported from XML.
That import process added backslash escapes in front of various characters. The three
most common being '(', ')', and '_'.
These instances are removed.

Signed-off-by: Ron Stone <ronald.stone@windriver.com>
Change-Id: Id43a9337ffcd505ccbdf072d7b29afdb5d2c997e
2023-03-01 11:19:04 +00:00

2.3 KiB

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>