[libvirt] [PATCH 1/4] numatune: Define XML schema and add docs

[Osier Yang]

Example of numatune XML:

  <numatune>
    <memory model="interleave" nodeset="+0-4,8-12"/>
  </numatune>
---
 docs/formatdomain.html.in |   14 ++++++++++++++
 docs/schemas/domain.rng   |   25 +++++++++++++++++++++++++
 2 files changed, 39 insertions(+), 0 deletions(-)

diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
index dcfcd94..f6ab621 100644
--- a/docs/formatdomain.html.in
+++ b/docs/formatdomain.html.in
@@ -288,6 +288,9 @@
     <min_guarantee>65536</min_guarantee>
   </memtune>
   <vcpu cpuset="1-4,^3,6" current="1">2</vcpu>
+  <numatune>
+  <memory model="strict" nodeset="1,2,!3-6">
+  </numatune>
   ...</pre>
 
     <dl>
@@ -366,6 +369,17 @@
         the OS provided defaults. NB, There is no unit for the value, it's a relative
         measure based on the setting of other VM, e.g. A VM configured with value
         2048 will get twice as much CPU time as a VM configured with value 1024.</dd>
+      <dt><code>numatune</code></dt>
+      <dd> The optional <code>numatune</code> element provides details of
+        how to tune the performance of a NUMA host via controlling NUMA policy for
+        domain process. NB, only supported by QEMU driver.
+      <dt><code>memory</code></dt>
+      <dd> The optional <code>memory</code> element specify how to allocate memory
+        for the domain process on a NUMA host. It contains two attributes,
+        attribute <code>model</code> is either 'interleave', 'strict', or 'preferred'.
+        attribute <code>nodeset</code> specifies the NUMA nodes, it can be specified as
+        25 or 12-15 or 1,3,5-7 or +6-10 or 1-7,!3-5 or !+6-10. NB, if <code>model</code>
+        is "preferred", <code>nodeset</code> only accepts single node.</dd>
     </dl>
 
     <h3><a name="elementsCPU">CPU model and topology</a></h3>
diff --git a/docs/schemas/domain.rng b/docs/schemas/domain.rng
index 7163c6e..7e7765d 100644
--- a/docs/schemas/domain.rng
+++ b/docs/schemas/domain.rng
@@ -387,6 +387,26 @@
           </zeroOrMore>
         </element>
       </optional>
+
+      <!-- All the NUMA related tunables would go in the numatune -->
+      <optional>
+        <element name="numatune">
+          <optional>
+            <element name="memory">
+              <attribute name="model">
+                <choice>
+                  <value>interleave</value>
+                  <value>strict</value>
+                  <value>preferred</value>
+                </choice>
+              </attribute>
+              <attribute name="nodeset">
+                <ref name="nodeset"/>
+              </attribute>
+            </element>
+          </optional>
+        </element>
+      </optional>
     </interleave>
   </define>
   <define name="clock">
@@ -2265,6 +2285,11 @@
       <param name="pattern">([0-9]+(-[0-9]+)?|\^[0-9]+)(,([0-9]+(-[0-9]+)?|\^[0-9]+))*</param>
     </data>
   </define>
+  <define name="nodeset">
+    <data type="string">
+      <param name="pattern">([!\+]?[0-9]+(-[0-9]+)?)(,([!\+]?[0-9]+(-[0-9]+)?))*</param>
+    </data>
+  </define>
   <define name="countCPU">
     <data type="unsignedShort">
       <param name="pattern">[0-9]+</param>
-- 
1.7.4