From: Kashyap Chamarthy <kchamart@redhat.com>
Date: Mon, 26 Mar 2018 10:53:12 +0000 (+0200)
Subject: docs: formatdomain: Clarify CPU feature policy option "require"
X-Git-Url: http://xenbits.xensource.com/gitweb?a=commitdiff_plain;h=bb0e0bcf6a0d785df7063cb6118b3a25f2a24d55;p=libvirt.git

docs: formatdomain: Clarify CPU feature policy option "require"

Using the 'require' value for the 'policy' attribute indicates
that the guest will have the feature so the host CPU does not
need to support it if the hypervisor can emulate it.

E.g. 'x2apic' is emulated by QEMU even if the host does not support it:

    <feature policy='require' name='x2apic'/>

Signed-off-by: Kashyap Chamarthy <kchamart@redhat.com>
---

diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
index 08dc74b6b9..82e7d7ce66 100644
--- a/docs/formatdomain.html.in
+++ b/docs/formatdomain.html.in
@@ -1531,8 +1531,8 @@
           <dd>The virtual CPU will claim the feature is supported regardless
             of it being supported by host CPU.</dd>
           <dt><code>require</code></dt>
-          <dd>Guest creation will fail unless the feature is supported by host
-            CPU.</dd>
+          <dd>Guest creation will fail unless the feature is supported by the
+            host CPU or the hypervisor is able to emulate it.</dd>
           <dt><code>optional</code></dt>
           <dd>The feature will be supported by virtual CPU if and only if it
             is supported by host CPU.</dd>