CLI Commands for Managing PCI DevicesΒΆ

Several commands are available for managing PCI devices from the CLI.

The following commands are available for managing PCI devices on a host:

system host-device-list <hostname>

Lists the devices for a host.

system host-device-show <hostname> <pciaddress>

Lists the device at a specific PCI address on a host.

system host-device-modify [options] <hostname> <pciaddress>

Exposes a device to applications.

For example:

~(keystone_admin)$ system host-device-list worker-0
+-------+----------+--------+--------+--------+------------+-------------+----------------------+-----------+---------+
| name  | address  | class  | vendor | device | class name | vendor name | device name          | numa_node | enabled |
|       |          | id     | id     | id     |            |             |                      |           |         |
+-------+----------+--------+--------+--------+------------+-------------+----------------------+-----------+---------+
| pci_0 | 0000:0c: | 030000 | 102b   | 0522   | VGA        | Matrox      | MGA G200e [Pilot]    | 0         | True    |
| 000_0 | 00.0     |        |        |        | compatible | Electronics | ServerEngines (SEP1) |           |         |
| c_00_ |          |        |        |        | controller | Systems Ltd |                      |           |         |
| 0     |          |        |        |        |            |             |                      |           |         |
|       |          |        |        |        |            |             |                      |           |         |
|pci_0  | 0000:b7: | 120000 | 8086   | 0d8f   | Processing |Intel        | Device 0d8f          | 1         | True    |
|000_b7 | 00.0     |        |        |        |accelerators|Corporation  |                      |           |         |
|_00_0  |          |        |        |        |            |             |                      |           |         |
|       |          |        |        |        |            |             |                      |           |         |
+-------+----------+--------+--------+--------+------------+-------------+----------------------+-----------+---------+

~(keystone_admin)$ system host-device-show worker-0 0000:0c::00.0
+-----------------------+----------------------------------------+
| Property              | Value                                  |
+-----------------------+----------------------------------------+
| name                  | pci_0000_0c_00_0                       |
| address               | 0000:0c:00.0                           |
| class id              | 030000                                 |
| vendor id             | 102b                                   |
| device id             | 0522                                   |
| class name            | VGA compatible controller              |
| vendor name           | Matrox Electronics Systems Ltd.        |
| device name           | MGA G200e [Pilot] ServerEngines (SEP1) |
| numa_node             | 0                                      |
| enabled               | True                                   |
| sriov_totalvfs        | None                                   |
| sriov_numvfs          | 0                                      |
| sriov_vfs_pci_address |                                        |
| extra_info            |                                        |
| created_at            | 2020-01-02T15:47:00.900816+00:00       |
| updated_at            | None                                   |
+-----------------------+----------------------------------------+

~(keystone_admin)$ system host-device-modify --name="Encryption1" --enable=True worker-0 0000:09:00.0