From ee0684aba4f537659506d8562fc0531ad33a506e Mon Sep 17 00:00:00 2001
From: "Daniel P. Berrange" <berrange@redhat.com>
Date: Wed, 21 Jul 2010 11:53:56 +0100
Subject: [PATCH] Document the memory balloon device
* formatdomain.html.in: Document <memballoon> element
---
docs/formatdomain.html.in | 47 +++++++++++++++++++++++++++++++++++++++
1 file changed, 47 insertions(+)
diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
index 4cca67fc48..3e80312570 100644
--- a/docs/formatdomain.html.in
+++ b/docs/formatdomain.html.in
@@ -1506,6 +1506,53 @@ qemu-kvm -net nic,model=? /dev/null
</dd>
</dl>
+ <h4><a name="elementsMemBalloon">Memory balloon device</a></h4>
+
+ <p>
+ A virtual memory balloon device is added to all Xen and KVM/QEMU
+ guests. It will be seen as <code>memballoon</code> element.
+ It will be automatically added when appropriate, so there is no
+ need to explicitly add this element in the guest XML unless a
+ specific PCI slot needs to be assigned.
+ <span class="since">Since 0.8.3, Xen, QEMU and KVM only</span>
+ </p>
+
+ <p>
+ Example automatically added device with KVM
+ </p>
+<pre>
+ ...
+ <devices>
+ <memballoon model='virtio'/>
+ </devices>
+ ...</pre>
+
+ <p>
+ Example manually added device with static PCI slot 2 requested
+ </p>
+<pre>
+ ...
+ <devices>
+ <watchdog model='virtio'/>
+ <address type='pci' domain='0x0000' bus='0x00' slot='0x02' function='0x0'/>
+ </devices>
+</domain></pre>
+
+ <dl>
+ <dt><code>model</code></dt>
+ <dd>
+ <p>
+ The required <code>model</code> attribute specifies what type
+ of balloon device is provided. Valid values are specific to
+ the virtualization platform
+ </p>
+ <ul>
+ <li>'virtio' — default with QEMU/KVM</li>
+ <li>'xen' — default with Xen</li>
+ </ul>
+ </dd>
+ </dl>
+
<h2><a name="examples">Example configs</a></h2>
<p>