[libvirt PATCH 1/2] docs: domain: Clarify on the dangers of migrating with hyperv-passthrough enabled

[Tim Wiederhake]

Signed-off-by: Tim Wiederhake <twiederh at redhat.com>
---
 docs/formatdomain.rst | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst
index 0c5e33c78f..2e9c450606 100644
--- a/docs/formatdomain.rst
+++ b/docs/formatdomain.rst
@@ -1929,7 +1929,14 @@ are:
       Set exactly the specified features.
 
    ``passthrough``
-      Enable all features currently supported by the hypervisor.
+      Enable all features currently supported by the hypervisor, even those that
+      libvirt does not understand. Migration of a guest using passthrough is
+      dangerous if the source and destination hosts are not identical in both
+      hardware, QEMU version, microcode version and configuration. If such a
+      migration is attempted then the guest may hang or crash upon resuming
+      execution on the destination host. Depending on hypervisor version the
+      virtual CPU may or may not contain features which may block migration
+      even to an identical host.
 
    The ``mode`` attribute can be omitted and will default to ``custom``.
 
-- 
2.31.1