From Fedora Project Wiki
Description
Assign a physical PCI device to a KVM guest, and verify that it works as expected.
Setup
- Functioning F19+ host and F19+ VM.
- PCI device you can afford to devote entirely to a VM
- Verify your host as necessary hardware support for VFIO
- If on an Intel CPU, this command should show at least 2 matches:
dmesg | grep -e DMAR -e IOMMU - If on an AMD CPU, this command should show some output:
dmesg | grep AMD-Vi
- If on an Intel CPU, this command should show at least 2 matches:
How to test
Using virt-manager
- Run virt-manager, open an existing shutoff guest and go to the details page.
- Add Hardware->PCI Host Device
- Choose the device you want to assign from the list, like:
00:19.0 Interface eth0 (82566DM-2 Gigabit Network Connection) - Click Finish
- Start the guest and check the device is functional within the guest
- Shut down the guest and check the device is functional within the host
- Select the device in virt-manager and Remove it
Hoptlug from the command line
- Find the device you want to attach in the output of
lspci, copy the address string at the start of the line, something like02:00.0 - Attach the device to running VM 'test-day-vm' using virt-xml:
sudo virt-xml test-day-vm --update --add-device --host-device 02:00.0
- Verify the device is usable in the VM
- Remove the device from the running VM 'test-day-vm':
sudo virt-xml test-day-vm --update --remove-device --host-device 02:00.0
- Verify the device is visible and functioning on the host machine
Expected Results
No obvious errors occur. PCI device assignment can be quirky and does not always work with every PCI device or host PCI layout. If you get an error, ask in #fedora-test-day IRC first and we can likely provide some direction.