docs: Add at least some docs and fix schema entry for perf events

There was no documentation at all for the XML part. I added at least
some. The 2.0.0 introduction date is deliberate as the parser for the
XML is broken.

The schema file was missing entries for 'mbml' and 'mbmt'.

diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
index 7a42b8e00563cea5f2ee805644c44c1c10579850..7d3436304babca360b471d34fb09b936bd4b7cb2 100644 (file)
--- a/docs/formatdomain.html.in
+++ b/docs/formatdomain.html.in
@@ -1822,6 +1822,50 @@
       </dd>
     </dl>
 
+    <h3><a name="elementsPerf">Performance monitoring events</a></h3>
+
+    <p>
+      Some platforms allow monitoring of performance of the virtual machine and
+      the code executed inside. To enable the performance monitoring events
+      you can either specify them in the <code>perf</code> element or enable
+      them via <code>virDomainSetPerfEvents</code> API. The performance values
+      are then retrieved using the virConnectGetAllDomainStats API.
+      <span class="since">Since 2.0.0</span>
+    </p>
+
+<pre>
+  ...
+  &lt;perf&gt;
+    &lt;event name='cmt' enabled='yes'/&gt;
+    &lt;event name='mbmt' enabled='no'/&gt;
+    &lt;event name='mbml' enabled='yes'/&gt;
+  &lt;/perf&gt;
+  ...
+</pre>
+
+  <table class="top_table">
+    <tr>
+      <th>event name</th>
+      <th>Description</th>
+      <th>stats parameter name</th>
+    </tr>
+    <tr>
+      <td><code>cmt</code></td>
+      <td>usage of l3 cache in bytes by applications running on the platform</td>
+      <td><code>perf.cmt</code></td>
+    </tr>
+    <tr>
+      <td><code>mbmt</code></td>
+      <td>total system bandwidth from one level of cache</td>
+      <td><code>perf.mbmt</code></td>
+    </tr>
+    <tr>
+      <td><code>mbml</code></td>
+      <td>bandwidth of memory traffic for a memory controller</td>
+      <td><code>perf.mbml</code></td>
+    </tr>
+  </table>
+
     <h3><a name="elementsDevices">Devices</a></h3>
 
     <p>

diff --git a/docs/schemas/domaincommon.rng b/docs/schemas/domaincommon.rng
index 2e07505b1a80f52b6b5ffb8c9b4bbcd10cc14fb7..162c2e016480f96ef5fd88b055784f60675a7143 100644 (file)
--- a/docs/schemas/domaincommon.rng
+++ b/docs/schemas/domaincommon.rng
@@ -412,6 +412,8 @@
           <attribute name="name">
             <choice>
               <value>cmt</value>
+              <value>mbmt</value>
+              <value>mbml</value>
             </choice>
           </attribute>
           <attribute name="enabled">