docs: Document VFIO live migration support

Add a live migration section to the VFIO documentation covering the
requirements beyond snapshot and restore, the dirty tracking behavior,
the destination file descriptor substitution with an example, and the
failure recovery behavior. Link it from the live migration and
snapshot sections.

Signed-off-by: Saravanan D <saravanand@crusoe.ai>
This commit is contained in:
Saravanan D
2026-07-04 08:34:26 +00:00
committed by Bo Chen
parent 59a6563a51
commit 8b61fd0238
2 changed files with 81 additions and 3 deletions

View File

@@ -382,6 +382,17 @@ migration process. Via the API or `ch-remote`, you may specify:
Memory transfer mode. `postcopy` resumes the destination first and faults
guest pages in on demand over a dedicated connection. Defaults to `precopy`.
## Migrating VMs with VFIO Devices
VMs with migratable VFIO devices, for example NIC VFs bound to
`mlx5_vfio_pci`, can be live migrated. The opaque device state is captured
during the downtime window and the destination receives new device file
descriptors through the `vfio_fds` and `iommufd_fd` options of
`receive-migration`.
See [Live Migration of VFIO Devices](vfio.md#live-migration-of-vfio-devices)
for the requirements, the dirty tracking behavior, and an example.
## Version Compatibility
Cloud Hypervisor live migration compatibility has two dimensions: the