From 256f6b18261ff41d28dca5d98c82792a9c5ed65a Mon Sep 17 00:00:00 2001 From: "Jason J. Herne" Date: Fri, 9 Dec 2016 14:38:35 -0500 Subject: [PATCH] docs: document cpu host-passthrough migration issue Documents in formatdomain.html that when migrating a guest defined with the host-passthrough CPU model from a machine that is running on a newer CPU model than the destination machine's CPU model, it is very likely that the guest will crash upon arrival. Signed-off-by: Jason J. Herne --- docs/formatdomain.html.in | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in index 9646782828..f7bef51dec 100644 --- a/docs/formatdomain.html.in +++ b/docs/formatdomain.html.in @@ -1292,7 +1292,11 @@ understand. Though the downside of this mode is that the guest environment cannot be reproduced on different hardware. Thus, if you hit any bugs, you are on your own. Further details of that CPU can - be changed using feature elements. + be changed using feature elements. Migration of a guest + using host-passthrough is dangerous if the source and destination + hosts are not identical in both hardware and configuration. If such + a migration is attempted then the guest may hang or crash upon + resuming execution on the destination host. In both host-model and host-passthrough