Re: [libvirt] [PATCH] fix documentation for cputune parameters

this re-adds the example section originally written by Osier Yang, and indicates the version in which the cputune parameters became available in libvirt. --- docs/formatdomain.html.in | 28 ++++++++++++++++++++++------ 1 files changed, 22 insertions(+), 6 deletions(-) diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in index dcfcd94..f3bf8fd 100644 --- a/docs/formatdomain.html.in +++ b/docs/formatdomain.html.in @@ -288,6 +288,13 @@ &lt;min_guarantee&gt;65536&lt;/min_guarantee&gt; &lt;/memtune&gt; &lt;vcpu cpuset="1-4,^3,6" current="1"&gt;2&lt;/vcpu&gt; +&lt;cputune&gt; +&lt;vcpupin vcpu="0" cpuset="1-4,^2"&gt; +&lt;vcpupin vcpu="1" cpuset="0,1"&gt; +&lt;vcpupin vcpu="2" cpuset="2,3"&gt; +&lt;vcpupin vcpu="3" cpuset="0,4"&gt; +&lt;cpushares&gt;2048&lt;/cpushares&gt; +&lt;/cputune&gt; ...</pre> <dl> @@ -351,21 +358,30 @@ virtual CPUs should be enabled. </dd> <dt><code>cputune</code></dt> -<dd> The optional<code>cputune</code> element provides details - regarding the cpu tunable parameters for the domain.</dd> +<dd> + The optional<code>cputune</code> element provides details + regarding the cpu tunable parameters for the domain. +<span class="since">Since 0.9.0</span> +</dd> <dt><code>vcpupin</code></dt> -<dd> The optional<code>vcpupin</code> element specifies which of host +<dd> + The optional<code>vcpupin</code> element specifies which of host physical CPUS the domain VCPU will be pinned to. If this is ommited, each VCPU pinned to all the physical CPUS by default. It contains two required attributes, the attribute<code>vcpu</code> specifies vcpu id, and the attribute<code>cpuset</code> is same as attribute<code>cpuset</code> - of element<code>vcpu</code>. NB, Only qemu driver supports</dd> + of element<code>vcpu</code>. (NB: Only qemu driver support) +<span class="since">Since 0.9.0</span>