15.2. Adding a PCI device with virt-manager

Identify the PCI device designated for passthrough to the guest. The virsh nodedev-list command lists all devices attached to the system. The --tree option is useful for identifying devices attached to the PCI device (for example, disk controllers and USB controllers).

virsh nodedev-list --tree

# virsh nodedev-list --tree

For a list of only PCI devices, run the following command:

virsh nodedev-list | grep pci

# virsh nodedev-list | grep pci

Each PCI device is identified by a string in the following format (where 8086 is a variable that in this case represents Intel equipment, and **** is a four digit hexadecimal code specific to each device):

pci_8086_****

pci_8086_****

Record the PCI device number; the number is needed in other steps.

Detach the device from the system.

virsh nodedev-dettach pci_8086_3a6c

# virsh nodedev-dettach pci_8086_3a6c 
Device pci_8086_3a6c dettached

Power off the guest. Hotplugging PCI devices into guests is presently unsupported and may fail or crash.

Open the virtual machine and select the Hardware tab. Click the Add Hardware button to add a new device to the guest.

Select Physical Host Device from the Hardware type list. The Physical Host Device represents PCI devices. Click Forward to continue.

Select an unused PCI device. Note that selecting PCI devices presently in use on the host causes errors. In this example a PCI to USB interface device is used.

Click the Finish button to confirm the device setup and add the device to the guest.