From nobody Wed Feb 11 10:04:35 2026 Delivered-To: importer@patchew.org Received-SPF: pass (zoho.com: domain of redhat.com designates 209.132.183.25 as permitted sender) client-ip=209.132.183.25; envelope-from=libvir-list-bounces@redhat.com; helo=mx4-phx2.redhat.com; Authentication-Results: mx.zoho.com; spf=pass (zoho.com: domain of redhat.com designates 209.132.183.25 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; Return-Path: Received: from mx4-phx2.redhat.com (mx4-phx2.redhat.com [209.132.183.25]) by mx.zohomail.com with SMTPS id 1489510889742547.3724573550895; Tue, 14 Mar 2017 10:01:29 -0700 (PDT) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by mx4-phx2.redhat.com (8.13.8/8.13.8) with ESMTP id v2EGvtVC022219; Tue, 14 Mar 2017 12:57:56 -0400 Received: from int-mx11.intmail.prod.int.phx2.redhat.com (int-mx11.intmail.prod.int.phx2.redhat.com [10.5.11.24]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id v2EGvtnT002591 for ; Tue, 14 Mar 2017 12:57:55 -0400 Received: from virval.usersys.redhat.com (dhcp129-92.brq.redhat.com [10.34.129.92]) by int-mx11.intmail.prod.int.phx2.redhat.com (8.14.4/8.14.4) with ESMTP id v2EGvrNP008592 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO) for ; Tue, 14 Mar 2017 12:57:54 -0400 Received: by virval.usersys.redhat.com (Postfix, from userid 500) id 7DAD21062CF; Tue, 14 Mar 2017 17:57:53 +0100 (CET) From: Jiri Denemark To: libvir-list@redhat.com Date: Tue, 14 Mar 2017 17:57:41 +0100 Message-Id: <885966add99618df3a9ed730b346510a018bf9b1.1489510598.git.jdenemar@redhat.com> In-Reply-To: References: In-Reply-To: References: Mail-Followup-To: libvir-list@redhat.com X-Scanned-By: MIMEDefang 2.68 on 10.5.11.24 X-loop: libvir-list@redhat.com Subject: [libvirt] [PATCH 02/12] docs: Clarify /domain/cpu/@match description 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: , MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-ZohoMail: RSF_0 Z_629925259 SPT_0 Content-Type: text/plain; charset="utf-8" Signed-off-by: Jiri Denemark --- docs/formatdomain.html.in | 22 +++++++++++++++------- 1 file changed, 15 insertions(+), 7 deletions(-) diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in index 9a204f845..75367d6dd 100644 --- a/docs/formatdomain.html.in +++ b/docs/formatdomain.html.in @@ -1217,8 +1217,8 @@
cpu
The cpu element is the main container for describing - guest CPU requirements. Its match attribute specified= how - strictly has the virtual CPU provided to the guest match these + guest CPU requirements. Its match attribute specifies= how + strictly the virtual CPU provided to the guest matches these requirements. Since 0.7.6 the match attribute can be omitted if topology is the only element within cpu. Possible values for t= he @@ -1227,13 +1227,21 @@
minimum
The specified CPU model and features describes the minimum - requested CPU.
+ requested CPU. A better CPU will be provided to the guest if it + is possible with the requested hypervisor on the current host. + This is a constrained host-model mode; the domain + will not be created if the provided virtual CPU does not meet + the requirements.
+
exact
-
The virtual CPU provided to the guest will exactly match the - specification
+
The virtual CPU provided to the guest should exactly match t= he + specification. If such CPU is not supported, libvirt will refu= se + to start the domain.
+
strict
-
The guest will not be created unless the host CPU does exact= ly - match the specification.
+
The domain will not be created unless the host CPU exactly + matches the specification. This is not very useful in practice + and should only be used if there is a real reason.
=20 Since 0.8.5 the match --=20 2.12.0 -- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list