)]}'
{"doc/source/admin/pci-passthrough.rst":[{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"677d620bfb563f53f8813b8161e9cb5b20db2a0c","unresolved":false,"context_lines":[{"line_number":104,"context_line":"given device type, identified by the standard PCI ``vendor_id`` and (optional)"},{"line_number":105,"context_line":"``product_id`` fields, to an arbitrary name or *alias*. This alias can then be"},{"line_number":106,"context_line":"used to request a PCI device using the ``pci_passthrough:alias\u003d\u003calias\u003e`` flavor"},{"line_number":107,"context_line":"extra spec, as discussed previously."},{"line_number":108,"context_line":""},{"line_number":109,"context_line":"As noted previously, our sample device has a vendor ID of ``0x8086`` and a"},{"line_number":110,"context_line":"product ID of ``0x154d``. However, it\u0027s important to note that this device also"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3fa7e38b_f32a578f","line":107,"updated":"2019-12-02 14:58:20.000000000","message":"I would mention why we are using aliases. I think there reason is to have a way to request something abstract in the flavor (i.e. alias) where the specific physical device might be different on different compute.","commit_id":"9e22def0b1342053c271f4e94be1f8b1669663df"},{"author":{"_account_id":15907,"name":"Wei Hui","email":"huiweics@gmail.com","username":"huiweics"},"change_message_id":"2c52e95ca56e573b70a68197dac9a88eaffbf8ee","unresolved":false,"context_lines":[{"line_number":121,"context_line":"``type-PCI``"},{"line_number":122,"context_line":"  The device does not support SR-IOV."},{"line_number":123,"context_line":""},{"line_number":124,"context_line":"By default, devices corresponding to ``type-PF`` can be indexed by the"},{"line_number":125,"context_line":"``nova-compute`` service, assuming they\u0027re whitelisted using the"},{"line_number":126,"context_line":":oslo.config:option:`pci.passthrough_whitelist` option, but they will not be"},{"line_number":127,"context_line":"requestable using an alias as passing through a ``type-PF`` device will prevent"},{"line_number":128,"context_line":"the use of the child ``type-VF`` devices by other guests. Because our device is"},{"line_number":129,"context_line":"a ``type-PF`` device and we actually want to use this device rather than the"},{"line_number":130,"context_line":"VFs, we need to specifically state the device type, alongside the other fields,"},{"line_number":131,"context_line":"when configuring the :oslo.config:option:`pci.alias` configuration option. For"},{"line_number":132,"context_line":"example:"},{"line_number":133,"context_line":""},{"line_number":134,"context_line":".. code-block:: ini"},{"line_number":135,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"3fa7e38b_f03b37e7","line":132,"range":{"start_line":124,"start_character":0,"end_line":132,"end_character":8},"updated":"2019-11-30 11:29:06.000000000","message":"i am a bit confused. qemu use vfio-pci kernel module to passthrough pci device. according to https://patchwork.kernel.org/patch/10522381/, PF with SR-IOV enabled can\u0027t be passthroughed,i think better point out this explicitly, let user decide pasthrough a vf or disable sriov then passthrough pf. as for alias config, type-PF demands disable sriov, or it will failed.","commit_id":"9e22def0b1342053c271f4e94be1f8b1669663df"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"a172fabc76fbbf22f410709c0f229d81e875fa53","unresolved":false,"context_lines":[{"line_number":123,"context_line":""},{"line_number":124,"context_line":"By default, devices corresponding to ``type-PF`` can be indexed by the"},{"line_number":125,"context_line":"``nova-compute`` service, assuming they\u0027re whitelisted using the"},{"line_number":126,"context_line":":oslo.config:option:`pci.passthrough_whitelist` option, but they will not be"},{"line_number":127,"context_line":"requestable using an alias as passing through a ``type-PF`` device will prevent"},{"line_number":128,"context_line":"the use of the child ``type-VF`` devices by other guests. Because our device is"},{"line_number":129,"context_line":"a ``type-PF`` device and we actually want to use this device rather than the"},{"line_number":130,"context_line":"VFs, we need to specifically state the device type, alongside the other fields,"},{"line_number":131,"context_line":"when configuring the :oslo.config:option:`pci.alias` configuration option. For"},{"line_number":132,"context_line":"example:"},{"line_number":133,"context_line":""},{"line_number":134,"context_line":".. code-block:: ini"},{"line_number":135,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"3fa7e38b_f38f811f","line":132,"range":{"start_line":126,"start_character":55,"end_line":132,"end_character":8},"updated":"2019-11-15 12:26:09.000000000","message":"i will check this today or monday.\n\ni think this is not quite right.\n\nthe alias needs to use the correct vendor id and product id\nand the product id of the pf will be different the the VF.\nmy understanding is as long as the PF does not have and VF allcoated you can request it without specificly setting the device type to type-PF. the device_type is optional in the alias","commit_id":"9e22def0b1342053c271f4e94be1f8b1669663df"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"2ea364a548853e14051902efb020d41726d2e615","unresolved":false,"context_lines":[{"line_number":121,"context_line":"``type-PCI``"},{"line_number":122,"context_line":"  The device does not support SR-IOV."},{"line_number":123,"context_line":""},{"line_number":124,"context_line":"By default, devices corresponding to ``type-PF`` can be indexed by the"},{"line_number":125,"context_line":"``nova-compute`` service, assuming they\u0027re whitelisted using the"},{"line_number":126,"context_line":":oslo.config:option:`pci.passthrough_whitelist` option, but they will not be"},{"line_number":127,"context_line":"requestable using an alias as passing through a ``type-PF`` device will prevent"},{"line_number":128,"context_line":"the use of the child ``type-VF`` devices by other guests. Because our device is"},{"line_number":129,"context_line":"a ``type-PF`` device and we actually want to use this device rather than the"},{"line_number":130,"context_line":"VFs, we need to specifically state the device type, alongside the other fields,"},{"line_number":131,"context_line":"when configuring the :oslo.config:option:`pci.alias` configuration option. For"},{"line_number":132,"context_line":"example:"},{"line_number":133,"context_line":""},{"line_number":134,"context_line":".. code-block:: ini"},{"line_number":135,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"3fa7e38b_e22d9f45","line":132,"range":{"start_line":124,"start_character":0,"end_line":132,"end_character":8},"in_reply_to":"3fa7e38b_96a43109","updated":"2019-12-02 18:12:11.000000000","message":"Done","commit_id":"9e22def0b1342053c271f4e94be1f8b1669663df"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"677d620bfb563f53f8813b8161e9cb5b20db2a0c","unresolved":false,"context_lines":[{"line_number":121,"context_line":"``type-PCI``"},{"line_number":122,"context_line":"  The device does not support SR-IOV."},{"line_number":123,"context_line":""},{"line_number":124,"context_line":"By default, devices corresponding to ``type-PF`` can be indexed by the"},{"line_number":125,"context_line":"``nova-compute`` service, assuming they\u0027re whitelisted using the"},{"line_number":126,"context_line":":oslo.config:option:`pci.passthrough_whitelist` option, but they will not be"},{"line_number":127,"context_line":"requestable using an alias as passing through a ``type-PF`` device will prevent"},{"line_number":128,"context_line":"the use of the child ``type-VF`` devices by other guests. Because our device is"},{"line_number":129,"context_line":"a ``type-PF`` device and we actually want to use this device rather than the"},{"line_number":130,"context_line":"VFs, we need to specifically state the device type, alongside the other fields,"},{"line_number":131,"context_line":"when configuring the :oslo.config:option:`pci.alias` configuration option. For"},{"line_number":132,"context_line":"example:"},{"line_number":133,"context_line":""},{"line_number":134,"context_line":".. code-block:: ini"},{"line_number":135,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"3fa7e38b_96a43109","line":132,"range":{"start_line":124,"start_character":0,"end_line":132,"end_character":8},"in_reply_to":"3fa7e38b_f03b37e7","updated":"2019-12-02 14:58:20.000000000","message":"I\u0027m confused too about the formulation of the above paragraph. Sorry based on this text I don\u0027t see why it is a problem to request a PF as type-PCI. \n\nFrom the previous block of text I see that nova-compute _detects_ the a PF PCI dev as type-PF. So I can imagine that a request with type-PCI will not match with the pool that has type-PF devices in it.","commit_id":"9e22def0b1342053c271f4e94be1f8b1669663df"},{"author":{"_account_id":15334,"name":"Stephen Finucane","display_name":"stephenfin","email":"stephenfin@redhat.com","username":"sfinucan"},"change_message_id":"2195ea2694d469eeb203233f9680b282736ed5dc","unresolved":false,"context_lines":[{"line_number":123,"context_line":""},{"line_number":124,"context_line":"By default, devices corresponding to ``type-PF`` can be indexed by the"},{"line_number":125,"context_line":"``nova-compute`` service, assuming they\u0027re whitelisted using the"},{"line_number":126,"context_line":":oslo.config:option:`pci.passthrough_whitelist` option, but they will not be"},{"line_number":127,"context_line":"requestable using an alias as passing through a ``type-PF`` device will prevent"},{"line_number":128,"context_line":"the use of the child ``type-VF`` devices by other guests. Because our device is"},{"line_number":129,"context_line":"a ``type-PF`` device and we actually want to use this device rather than the"},{"line_number":130,"context_line":"VFs, we need to specifically state the device type, alongside the other fields,"},{"line_number":131,"context_line":"when configuring the :oslo.config:option:`pci.alias` configuration option. For"},{"line_number":132,"context_line":"example:"},{"line_number":133,"context_line":""},{"line_number":134,"context_line":".. code-block:: ini"},{"line_number":135,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"3fa7e38b_f779aa92","line":132,"range":{"start_line":126,"start_character":55,"end_line":132,"end_character":8},"in_reply_to":"3fa7e38b_f38f811f","updated":"2019-11-15 15:11:26.000000000","message":"This is what you\u0027re looking for:\n\n  https://github.com/openstack/nova/blob/c06374862edddeb88db1e99e315f896ed5b422cd/nova/pci/stats.py#L289-L297\n\nAs far as I can tell, unless \u0027device_type\u0027 is set in the config option, we\u0027ll skip that PCI device.","commit_id":"9e22def0b1342053c271f4e94be1f8b1669663df"},{"author":{"_account_id":11604,"name":"sean mooney","email":"smooney@redhat.com","username":"sean-k-mooney"},"change_message_id":"0f1413313cd4fdeff44c4ae15fedfe2c701999ea","unresolved":false,"context_lines":[{"line_number":129,"context_line":"a ``type-PF`` device and we actually want to use this device rather than the"},{"line_number":130,"context_line":"VFs, we need to specifically state the device type, alongside the other fields,"},{"line_number":131,"context_line":"when configuring the :oslo.config:option:`pci.alias` configuration option. For"},{"line_number":132,"context_line":"example:"},{"line_number":133,"context_line":""},{"line_number":134,"context_line":".. code-block:: ini"},{"line_number":135,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"3fa7e38b_bdcf4126","line":132,"in_reply_to":"3fa7e38b_f779aa92","updated":"2019-11-22 01:21:37.000000000","message":"this was changed in f85b2b8 as par of adding support for neutron vnic_type\u003ddirect-physical. the logic I described is how it used to work before that. I\u0027m not sure it was an intentional change that it became required to set type-pf.  it\u0027s been 4 year however so the doc reflect what is required today.","commit_id":"9e22def0b1342053c271f4e94be1f8b1669663df"},{"author":{"_account_id":14070,"name":"Eric Fried","email":"openstack@fried.cc","username":"efried"},"change_message_id":"e4fcd469339d340f247d38050b3cace33a71120e","unresolved":false,"context_lines":[{"line_number":112,"context_line":"   [pci]"},{"line_number":113,"context_line":"   alias \u003d { \"vendor_id\":\"8086\", \"product_id\":\"154d\", \"device_type\":\"type-PF\", \"name\":\"a1\" }"},{"line_number":114,"context_line":""},{"line_number":115,"context_line":"It\u0027s important to note the addition of the ``device_type`` field. This is"},{"line_number":116,"context_line":"necessary because this PCI device supports SR-IOV. The ``nova-compute`` service"},{"line_number":117,"context_line":"categorizes devices into one of three types, depending on the capabilities the"},{"line_number":118,"context_line":"devices report:"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3fa7e38b_07324df3","line":115,"range":{"start_line":115,"start_character":0,"end_line":115,"end_character":4},"updated":"2019-12-02 16:58:55.000000000","message":"avoid contractions","commit_id":"810aafc5ec9a7d25b33cf6c137c47b117c91269a"},{"author":{"_account_id":14070,"name":"Eric Fried","email":"openstack@fried.cc","username":"efried"},"change_message_id":"e4fcd469339d340f247d38050b3cace33a71120e","unresolved":false,"context_lines":[{"line_number":128,"context_line":""},{"line_number":129,"context_line":"By default, it is only possible to attach ``type-PCI`` devices using PCI"},{"line_number":130,"context_line":"passthrough. If you wish to attach ``type-PF`` or ``type-VF`` devices, you must"},{"line_number":131,"context_line":"specify the ``device_type`` field in the config option. If the device was a"},{"line_number":132,"context_line":"device that did not support SR-IOV, the ``device_type`` field could be omitted."},{"line_number":133,"context_line":""},{"line_number":134,"context_line":"Refer to :oslo.config:option:`pci.alias` for syntax information."},{"line_number":135,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"3fa7e38b_e775b198","line":132,"range":{"start_line":131,"start_character":70,"end_line":132,"end_character":12},"updated":"2019-12-02 16:58:55.000000000","message":"strike","commit_id":"810aafc5ec9a7d25b33cf6c137c47b117c91269a"}],"nova/conf/pci.py":[{"author":{"_account_id":14070,"name":"Eric Fried","email":"openstack@fried.cc","username":"efried"},"change_message_id":"e4fcd469339d340f247d38050b3cace33a71120e","unresolved":false,"context_lines":[{"line_number":61,"context_line":"  ``device_type``"},{"line_number":62,"context_line":"    Type of PCI device. Valid values are: ``type-PCI``, ``type-PF`` and"},{"line_number":63,"context_line":"    ``type-VF``. Note that ``\"device_type\": \"type-PF\"`` **must** be specified"},{"line_number":64,"context_line":"    if you wish to passthrough a device that supports SR-IOV in its entirety."},{"line_number":65,"context_line":""},{"line_number":66,"context_line":"  ``numa_policy``"},{"line_number":67,"context_line":"    Required NUMA affinity of device. Valid values are: ``legacy``,"}],"source_content_type":"text/x-python","patch_set":3,"id":"3fa7e38b_0719ed78","line":64,"range":{"start_line":64,"start_character":61,"end_line":64,"end_character":76},"updated":"2019-12-02 16:58:55.000000000","message":"Unclear whether this refers to the device or the SR-IOV support. From context it\u0027s probably obvious enough that it\u0027s the former.\n\nAlthough technically if we\u0027re passing through one of several PFs, we\u0027re not passing through the *entire* device...","commit_id":"810aafc5ec9a7d25b33cf6c137c47b117c91269a"},{"author":{"_account_id":14070,"name":"Eric Fried","email":"openstack@fried.cc","username":"efried"},"change_message_id":"e4fcd469339d340f247d38050b3cace33a71120e","unresolved":false,"context_lines":[{"line_number":61,"context_line":"  ``device_type``"},{"line_number":62,"context_line":"    Type of PCI device. Valid values are: ``type-PCI``, ``type-PF`` and"},{"line_number":63,"context_line":"    ``type-VF``. Note that ``\"device_type\": \"type-PF\"`` **must** be specified"},{"line_number":64,"context_line":"    if you wish to passthrough a device that supports SR-IOV in its entirety."},{"line_number":65,"context_line":""},{"line_number":66,"context_line":"  ``numa_policy``"},{"line_number":67,"context_line":"    Required NUMA affinity of device. Valid values are: ``legacy``,"}],"source_content_type":"text/x-python","patch_set":3,"id":"3fa7e38b_0cffd402","line":64,"range":{"start_line":64,"start_character":19,"end_line":64,"end_character":30},"updated":"2019-12-02 16:58:55.000000000","message":"this is a noun\n\ntechnically it should be \"pass through\"\n\nbut it\u0027s also kind of a special term (though still a noun)\n\nso maybe like \"perform passthrough with\"\n\nwhich is ew\n\nso meh, leave it.","commit_id":"810aafc5ec9a7d25b33cf6c137c47b117c91269a"}]}