vee gpu
Manage GPU VFIO passthrough bindings and run preflight checks.
vee gpu <subcommand>
List all PCI GPUs on the host with their IOMMU group, current driver, and power state.
vee gpu list
Bind a GPU (and optionally its audio peer) to vfio-pci.
sudo vee gpu bind 08:00.0
All devices in the same IOMMU group must be bound together or QEMU cannot take ownership of the group. vee gpu bind warns if there are unbound peers.
Unbind a device from vfio-pci and restore the original driver.
sudo vee gpu unbind 08:00.0
Run a full preflight check for a GPU before starting a passthrough VM.
vee gpu status 08:00.0 --memory 16G
Checks:
| Check | Pass condition |
|---|---|
| Driver | vfio-pci |
| IOMMU group device | /dev/vfio/<group> exists |
| Group isolation | All peer devices also bound to vfio-pci |
| Locked memory | memlock ≥ requested --memory |
| Power state | Not D3cold (or recoverable) |