From nobody Sat Jul 12 10:49:08 2025 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 Return-Path: Received: from mx1.redhat.com (mx1.redhat.com [209.132.183.28]) by mx.zohomail.com with SMTPS id 153731898212362.15215428059901; Tue, 18 Sep 2018 18:03:02 -0700 (PDT) Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id 42E1988310; Wed, 19 Sep 2018 01:02:59 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.20]) by smtp.corp.redhat.com (Postfix) with ESMTPS id D1B5F600C8; Wed, 19 Sep 2018 01:02:58 +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 20D25180053A; Wed, 19 Sep 2018 01:02:56 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx09.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 w8J12uoZ016300 for ; Tue, 18 Sep 2018 21:02:56 -0400 Received: by smtp.corp.redhat.com (Postfix) id 2BBA6308BDA2; Wed, 19 Sep 2018 01:02:56 +0000 (UTC) Received: from mx1.redhat.com (ext-mx10.extmail.prod.ext.phx2.redhat.com [10.5.110.39]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 21620308BDA0 for ; Wed, 19 Sep 2018 01:02:54 +0000 (UTC) Received: from out1-smtp.messagingengine.com (out1-smtp.messagingengine.com [66.111.4.25]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id C78F99E614 for ; Wed, 19 Sep 2018 01:02:52 +0000 (UTC) Received: from compute7.internal (compute7.nyi.internal [10.202.2.47]) by mailout.nyi.internal (Postfix) with ESMTP id 3E47721F85; Tue, 18 Sep 2018 21:02:52 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute7.internal (MEProxy); Tue, 18 Sep 2018 21:02:52 -0400 Received: from localhost.localdomain (ip5b40bfaa.dynamic.kabel-deutschland.de [91.64.191.170]) by mail.messagingengine.com (Postfix) with ESMTPA id 85ADEE46BC; Tue, 18 Sep 2018 21:02:51 -0400 (EDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:content-type :date:from:in-reply-to:in-reply-to:message-id:mime-version :references:references:subject:to:x-me-sender:x-me-sender :x-sasl-enc; s=fm3; bh=DGxPzF43PunW744qTySip1fC2quYQc7lHxEop9/9r T4=; b=UacGLYX4lo9uw+axEzAjWerWMqGg/LAbjlfx/WYsn7Tr6Li82hRFj2Y04 Dlu7V4UQX0Q+KXQ9U2oaRv1U4+MNNJUS4cS+D7cPO7BzSJl6uKnLcGNSlxhTaSjf SYnKu22T72JvyksYRf5pQpqK8ZRn/YzZNyduy8P3cXVwiM5QHzmTP7+emnCtXPvT Tfqb55l9d/Qms1t6tD1ZE6IlE50Z1b+iwLVlHdylB3XviZdGSZAf03h9BjCXZIWB 2E3e+zaPyD4CV6riaTQWQqoBiA2TdT5/AJNLE2bmk6dkf+B8clqu9W+WJrLDM0Zm nmtjumBPVfkq5IZ7SvNZhpO9jWXSw== X-ME-Proxy: X-ME-Sender: From: =?UTF-8?q?Marek=20Marczykowski-G=C3=B3recki?= To: libvir-list@redhat.com Date: Wed, 19 Sep 2018 02:50:30 +0200 Message-Id: <99c2cdd2ce3627df85ea6bfc758fc6ed82310099.1537318168.git-series.marmarek@invisiblethingslab.com> In-Reply-To: References: MIME-Version: 1.0 In-Reply-To: References: X-Greylist: Sender passed SPF test, Sender IP whitelisted by DNSRBL, ACL 214 matched, not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.39]); Wed, 19 Sep 2018 01:02:53 +0000 (UTC) X-Greylist: inspected by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.39]); Wed, 19 Sep 2018 01:02:53 +0000 (UTC) for IP:'66.111.4.25' DOMAIN:'out1-smtp.messagingengine.com' HELO:'out1-smtp.messagingengine.com' FROM:'marmarek@invisiblethingslab.com' RCPT:'' X-RedHat-Spam-Score: -0.701 (DKIM_SIGNED, DKIM_VALID, RCVD_IN_DNSWL_LOW, SPF_HELO_PASS) 66.111.4.25 out1-smtp.messagingengine.com 66.111.4.25 out1-smtp.messagingengine.com X-Scanned-By: MIMEDefang 2.78 on 10.5.110.39 X-Scanned-By: MIMEDefang 2.84 on 10.5.11.24 X-loop: libvir-list@redhat.com Subject: [libvirt] [PATCH v2 1/8] docs: add documentation of arch element of capabilities.xml 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-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.11 X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.28]); Wed, 19 Sep 2018 01:03:00 +0000 (UTC) X-ZohoMail: RSF_0 Z_629925259 SPT_0 Specifically, list sub-elements and where they can be used. In addition, describe supported machine types for Xen. Signed-off-by: Marek Marczykowski-G=C3=B3recki Reviewed-by: Jim Fehlig --- Changes in v2: - clarify type@domain description, add a link to domain xml there --- docs/formatcaps.html.in | 22 +++++++++++++++++++++- docs/formatdomain.html.in | 11 ++++++----- 2 files changed, 27 insertions(+), 6 deletions(-) diff --git a/docs/formatcaps.html.in b/docs/formatcaps.html.in index 41a9a3a..0d9c53d 100644 --- a/docs/formatcaps.html.in +++ b/docs/formatcaps.html.in @@ -91,7 +91,27 @@ =20
arch
-
This element brings some information on supported guest archit= ecture.
+
This element brings some information on supported guest + architecture. Possible subelements are: +
+
wordsize
Size of CPU word in bits, fo= r example 64.
+
emulator
Emulator (device model) path= , for + use in emulato= r + element of domain XML.
+
loader
Loader path, for use in + loader eleme= nt of domain + XML.
+
machine
Machine type, for use in + machine= + attribute of os/type element in domain XML. For example Xen + supports xenfv for HVM or xenpv for + PV.
+
domain
The type attribut= e of + this element specifies the type of hypervisor required to ru= n the + domain. Use in type + attribute of the domain root element.
+
+
=20
features
This optional element encases possible features that can be us= ed diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in index 1f12ab5..8189959 100644 --- a/docs/formatdomain.html.in +++ b/docs/formatdomain.html.in @@ -19,7 +19,8 @@

The root element required for all virtual machines is named domain. It has two attributes, the - type specifies the hypervisor used for running + type + specifies the hypervisor used for running the domain. The allowed values are driver specific, but include "xen", "kvm", "qemu", "lxc" and "kqemu". The second attribute is id which is a unique @@ -148,11 +149,11 @@ (badly named!) refers to an OS that supports the Xen 3 hypervisor guest ABI. There are also two optional attributes, arch specifying the CPU architecture to virtualization, - and machine referring to the machine - type. The Capabilities XML + and machine refe= rring + to the machine type. The Capabilities = XML provides details on allowed values for these. Since 0.0.1

-
loader
+
loader
The optional loader tag refers to a firmware blob, which is specified by absolute path, used to assist the domain creation process. It is used by Xen @@ -2621,7 +2622,7 @@ ... =20
-
emulator
+
emulator
The contents of the emulator element specify the fully qualified path to the device model emulator binary. --=20 git-series 0.9.1 -- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list