summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorJim Fehlig <jfehlig@suse.com>2016-02-22 17:03:21 -0700
committerJim Fehlig <jfehlig@suse.com>2016-03-21 09:28:17 -0600
commit9d243e08955a239e965fa626a1347eb27839bda6 (patch)
treee3115e90cfe4426b9b10f85eae232569dde36934 /docs
parent109017d9b392832b355e54054c814b9529e1e0f6 (diff)
downloadlibvirt-9d243e08955a239e965fa626a1347eb27839bda6.tar.gz
conf: add 'state' attribute to <hap> feature
Most hypervisors use Hardware Assisted Paging by default and don't require specifying the feature in domain conf. But some hypervisors support disabling HAP on a per-domain basis. To enable HAP by default yet provide a knob to disable it, extend the <hap> feature with a 'state=on|off' attribute, similar to <pvspinlock> and <vmport> features. In the absence of <hap>, the hypervisor default (on) is used. <hap> without the state attribute would be the same as <hap state='on'/> for backwards compatibility. And of course <hap state='off'/> disables hap. Signed-off-by: Jim Fehlig <jfehlig@suse.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/formatdomain.html.in6
-rw-r--r--docs/schemas/domaincommon.rng6
2 files changed, 9 insertions, 3 deletions
diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
index 423dcdc1e2..71ffe75045 100644
--- a/docs/formatdomain.html.in
+++ b/docs/formatdomain.html.in
@@ -1494,8 +1494,10 @@
Interrupt) for the guest.
</dd>
<dt><code>hap</code></dt>
- <dd>Enable use of Hardware Assisted Paging if available in
- the hardware.
+ <dd>Depending on the <code>state</code> attribute (values <code>on</code>,
+ <code>off</code>) enable or disable use of Hardware Assisted Paging.
+ The default is <code>on</code> if the hypervisor detects availability
+ of Hardware Assisted Paging.
</dd>
<dt><code>viridian</code></dt>
<dd>Enable Viridian hypervisor extensions for paravirtualizing
diff --git a/docs/schemas/domaincommon.rng b/docs/schemas/domaincommon.rng
index 0eb1e5ad72..da6de40f87 100644
--- a/docs/schemas/domaincommon.rng
+++ b/docs/schemas/domaincommon.rng
@@ -4144,7 +4144,11 @@
</optional>
<optional>
<element name="hap">
- <empty/>
+ <optional>
+ <attribute name="state">
+ <ref name="virOnOff"/>
+ </attribute>
+ </optional>
</element>
</optional>
<optional>