PCI passthrough documentation does not describe the steps necessary to passthrough PFs

[Stephen Finucane]

This came up on IRC [1]. By default, nova will not allow you to use PF devices unless you specifically request this type of device. This is intentional behavior to allow users to whitelist all devices from a particular vendor and avoid passing through the PF device when they meant to only consume the VFs. In the future, we might want to prevent whitelisting of both PF and VFs, but for now we should document the current behavior.

[1] http://eavesdrop.openstack.org/irclogs/%23openstack-nova/%23openstack-nova.2019-11-15.log.html#t2019-11-15T08:39:17

[OpenStack Infra (hudson-openstack)]

Related fix proposed to branch: master
Review: https://review.opendev.org/694521

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.opendev.org/694521
Committed: https://git.openstack.org/cgit/openstack/nova/commit/?id=557728abaf0c822f2b1a5cdd4fb2e11e19d8ead7
Submitter: Zuul
Branch: master

commit 557728abaf0c822f2b1a5cdd4fb2e11e19d8ead7
Author: Stephen Finucane <email address hidden>
Date: Fri Nov 15 11:33:26 2019 +0000

    docs: Change order of PCI configuration steps

    It doesn't really make sense to describe the "higher level"
    configuration steps necessary for PCI passthrough before describing
    things like BIOS configuration. Simply switch the ordering.

    Change-Id: I4ea1d9a332d6585ce2c0d5a531fa3c4ad9c89482
    Signed-off-by: Stephen Finucane <email address hidden>
    Related-Bug: #1852727

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.opendev.org/694522
Committed: https://git.openstack.org/cgit/openstack/nova/commit/?id=810aafc5ec9a7d25b33cf6c137c47b117c91269a
Submitter: Zuul
Branch: master

commit 810aafc5ec9a7d25b33cf6c137c47b117c91269a
Author: Stephen Finucane <email address hidden>
Date: Fri Nov 15 10:16:28 2019 +0000

    docs: Clarify configuration steps for PF devices

    Devices that report SR-IOV capabilities cannot be used without special
    configuration - namely, the addition of "'device_type': 'type-PF'" or
    "'device_type': 'type-VF'" to the '[pci] alias' configuration option.
    Spell this out in the docs.

    Change-Id: I4abbe30505a5e4ccba16027addd6d5f45066e31b
    Signed-off-by: Stephen Finucane <email address hidden>
    Closes-Bug: #1852727

[OpenStack Infra (hudson-openstack)]

This issue was fixed in the openstack/nova 20.5.0 release.