[libvirt] [PATCH 1/8] Add on_migrate element to domainXML

[Jim Fehlig]

on_migrate can be used to modify default parameters used when
migrating a domain.
---
 docs/formatdomain.html.in                   |   21 ++++++++++++++++
 docs/schemas/domain.rng                     |   13 ++++++++++
 tests/domainschemadata/migration-params.xml |   34 +++++++++++++++++++++++++++
 3 files changed, 68 insertions(+), 0 deletions(-)
 create mode 100644 tests/domainschemadata/migration-params.xml

diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
index f46771d..84dd590 100644
--- a/docs/formatdomain.html.in
+++ b/docs/formatdomain.html.in
@@ -692,6 +692,27 @@
         domain will be restarted with the same configuration</dd>
     </dl>
 
+    <p>
+      Default migration parameters, such as maximum or peak bandwidth
+      used during domain migration, can be specified with the
+      on_migrate element.  Note that some hypervisors may not support
+      changing migration parameters.
+    </p>
+
+<pre>
+  ...
+  <on_migrate>
+    <bandwidth peak="1024">
+  </on_migrate>
+  ...</pre>
+
+     <dl>
+      <dt><code>bandwidth</code></dt>
+      <dd>Maximum or peak bandwidth consumed during the migration
+        operation can be specified with the <code>peak</code>
+        attribute.  Units are MB/s.</dd>
+     </dl>
+
     <h3><a name="elementsFeatures">Hypervisor features</a></h3>
 
     <p>
diff --git a/docs/schemas/domain.rng b/docs/schemas/domain.rng
index dd8c41a..b729aa7 100644
--- a/docs/schemas/domain.rng
+++ b/docs/schemas/domain.rng
@@ -1623,6 +1623,19 @@
           <ref name="crashOptions"/>
         </element>
       </optional>
+      <optional>
+        <element name="on_migrate">
+          <optional>
+            <element name="bandwidth">
+              <optional>
+                <attribute name="peak">
+                  <ref name="positiveInteger"/>
+                </attribute>
+              </optional>
+            </element>
+          </optional>
+        </element>
+      </optional>
     </interleave>
   </define>
   <!--
diff --git a/tests/domainschemadata/migration-params.xml b/tests/domainschemadata/migration-params.xml
new file mode 100644
index 0000000..d01229b
--- /dev/null
+++ b/tests/domainschemadata/migration-params.xml
@@ -0,0 +1,34 @@
+<domain type='qemu'>
+  <name>test-domain</name>
+  <uuid>c3d496e6-fb22-7d89-1e73-9d3e231ba59f</uuid>
+  <memory>524288</memory>
+  <currentMemory>524288</currentMemory>
+  <vcpu>1</vcpu>
+  <os>
+    <type arch='x86_64' machine='pc'>hvm</type>
+    <boot dev='hd'/>
+  </os>
+  <features>
+    <acpi/>
+    <apic/>
+    <pae/>
+  </features>
+  <clock offset='utc'/>
+  <on_poweroff>destroy</on_poweroff>
+  <on_reboot>restart</on_reboot>
+  <on_crash>destroy</on_crash>
+  <on_migrate>
+    <bandwidth peak='1024' />
+  </on_migrate>
+  <devices>
+    <emulator>/usr/bin/qemu</emulator>
+    <disk type='file' device='disk'>
+      <driver name='qemu' type='raw'/>
+      <source file='/path/to/disk.img'/>
+      <target dev='hda' bus='ide'/>
+      <address type='drive' controller='0' bus='0' unit='0'/>
+    </disk>
+    <controller type='ide' index='0'/>
+    <memballoon model='virtio'/>
+  </devices>
+</domain>
-- 
1.7.5.4