From nobody Sat Apr 27 16:53:58 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zoho.com: domain of redhat.com designates 209.132.183.28 as permitted sender) client-ip=209.132.183.28; envelope-from=libvir-list-bounces@redhat.com; helo=mx1.redhat.com; Authentication-Results: mx.zohomail.com; spf=pass (zoho.com: domain of redhat.com designates 209.132.183.28 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1564750463; cv=none; d=zoho.com; s=zohoarc; b=WpoNMTMSV+pQwOj0FAFmhgVyGx3jUWJnGDhtz/rhfzkQVnSuYv/t5XnypXvb0ypGVx3rIxGtUBR0u9BOidR/QK3Ha3nIoxKxuwzptf7zsjIRdaTdnJKrQ3O4zbEv26itvawyVFSIbKfPRKE0zWg+Tp1o5Hf3k8VK1Wec0v3l7Hc= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zoho.com; s=zohoarc; t=1564750463; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:To:ARC-Authentication-Results; bh=JGX/BaUw00SxkhqtuIFIVlJ4SzCHeze4TnLIuSIui88=; b=Jv6WQPaFLKT3aGp8H1yqa/ROJA/nCu6EuRvDVy9QmGzA5xp1liZ3bkAnAfDx5KZ8fUyPi4K0RkH6aghrLjkGsgNBixGcLk6wSETBMGX3Op2IEKID3CHsZSzjpjroLPJ8m61gxuI34OYj4lJ/yYNjg8KlbIulmVM2WVakxjMWVc4= ARC-Authentication-Results: i=1; mx.zoho.com; spf=pass (zoho.com: domain of redhat.com designates 209.132.183.28 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from mx1.redhat.com (mx1.redhat.com [209.132.183.28]) by mx.zohomail.com with SMTPS id 1564750463171526.6047673084328; Fri, 2 Aug 2019 05:54:23 -0700 (PDT) Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.phx2.redhat.com [10.5.11.22]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id C5129C04BD48; Fri, 2 Aug 2019 12:54:21 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.21]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 987371001B03; Fri, 2 Aug 2019 12:54:21 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id 597AF1972D; Fri, 2 Aug 2019 12:54:21 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx06.intmail.prod.int.phx2.redhat.com [10.5.11.16]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id x72CsKFE021860 for ; Fri, 2 Aug 2019 08:54:20 -0400 Received: by smtp.corp.redhat.com (Postfix) id 29C685C220; Fri, 2 Aug 2019 12:54:20 +0000 (UTC) Received: from donizetti.redhat.com (ovpn-112-18.ams2.redhat.com [10.36.112.18]) by smtp.corp.redhat.com (Postfix) with ESMTP id 50BE75C207; Fri, 2 Aug 2019 12:54:16 +0000 (UTC) From: Paolo Bonzini To: libvir-list@redhat.com Date: Fri, 2 Aug 2019 14:54:15 +0200 Message-Id: <20190802125415.15227-1-pbonzini@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.16 X-loop: libvir-list@redhat.com Cc: dgilbert@redhat.com Subject: [libvirt] [PATCH] docs: formatdomain: explain host-model/host-passthrough requirements X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Transfer-Encoding: quoted-printable Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.84 on 10.5.11.22 X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.31]); Fri, 02 Aug 2019 12:54:22 +0000 (UTC) Content-Type: text/plain; charset="utf-8" host-passthrough documentation menions that the source and destination hosts are not identical in both hardware and configuration. Configuration actually includes microcode version and QEMU version, but this is not clear so make it explicit Signed-off-by: Paolo Bonzini Reviewed-by: Jiri Denemark --- docs/formatdomain.html.in | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in index f5c882141a..6d084d7c04 100644 --- a/docs/formatdomain.html.in +++ b/docs/formatdomain.html.in @@ -1590,8 +1590,8 @@ hand, the ABI provided to the guest is reproducible. During migration, complete CPU model definition is transferred to the destination host so the migrated guest will see exactly the same= CPU - model even if the destination host contains more capable CPUs for - the running instance of the guest; but shutting down and restart= ing + model for the running instance of the guest, even if the destina= tion + host contains more capable CPUs or newer kernel; but shutting do= wn and restarting the guest may present different hardware to the guest according = to the capabilities of the new host. Prior to libvirt 3.2.0 and QEMU 2.9.0 detection of the host CPU model via QEMU is not supported. @@ -1625,10 +1625,10 @@ environment cannot be reproduced on different hardware. Thus, if= you hit any bugs, you are on your own. Further details of that CPU c= an be changed using feature elements. Migration of a g= uest - using host-passthrough is dangerous if the source and destination - hosts are not identical in both hardware and configuration. If s= uch - a migration is attempted then the guest may hang or crash upon - resuming execution on the destination host. + using host-passthrough is dangerous if the source and destinatio= n hosts + are not identical in both hardware, QEMU version, microcode vers= ion + and configuration. If such a migration is attempted then the gue= st may + hang or crash upon resuming execution on the destination host. =20 Both host-model and host-passthrough mod= es --=20 2.21.0 -- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list