Patch series https://www.redhat.com/archives/libvir-list/2016-January/msg00482.html introduced the parameters but didn't update the docs. Signed-off-by: Katerina Koukiou <kkoukiou(a)redhat.com&gt; --- docs/formatdomain.html.in | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in index a3afe137bf..7fa448acdc 100644 --- a/docs/formatdomain.html.in +++ b/docs/formatdomain.html.in @@ -747,6 +747,8 @@ &lt;shares&gt;2048&lt;/shares&gt; &lt;period&gt;1000000&lt;/period&gt; &lt;quota&gt;-1&lt;/quota&gt; + &lt;global_period&gt;1000000&lt;/global_period&gt; + &lt;global_quota&gt;-1&lt;/global_quota&gt; &lt;emulator_period&gt;1000000&lt;/emulator_period&gt; &lt;emulator_quota&gt;-1&lt;/emulator_quota&gt; &lt;iothread_period&gt;1000000&lt;/iothread_period&gt; @@ -837,6 +839,25 @@ <span class="since">Only QEMU driver support since 0.9.4, LXC since 0.9.10</span> </dd> + <dt><code>global_period</code></dt> + <dd> + The optional <code>global_period</code> element specifies the + enforcement period for a quota (unit: microseconds) for whole domain, + when using posix scheduler. The value should be in range + [1000, 1000000]. A global_period with value 0 means no value. + <span class="since">Only QEMU driver support since 1.3.3</span> + </dd> + <dt><code>global_quota</code></dt> + <dd> + The optional <code>global_quota</code> element specifies the maximum + allowed bandwidth (unit: microseconds) to be used within a period for + whole domain. A domain with <code>global_quota</code> as any negative + value indicates that the domain has infinite bandwidth, which means that + it is not bandwidth controlled. The value should be in range + [1000, 18446744073709551] or less than 0. A global_quota with value 0 + means no value. + <span class="since">Only QEMU driver support since 1.3.3</span> + </dd> <dt><code>emulator_period</code></dt> <dd> -- 2.17.1

Although the name of the element is not self-explanatory, it's affecting only the vcpu threads. Signed-off-by: Katerina Koukiou <kkoukiou(a)redhat.com&gt; --- docs/formatdomain.html.in | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in index 7fa448acdc..61930e4907 100644 --- a/docs/formatdomain.html.in +++ b/docs/formatdomain.html.in @@ -831,11 +831,11 @@ <dd> The optional <code>quota</code> element specifies the maximum allowed bandwidth(unit: microseconds). A domain with <code>quota</code> as any - negative value indicates that the domain has infinite bandwidth, which - means that it is not bandwidth controlled. The value should be in range - [1000, 18446744073709551] or less than 0. A quota with value 0 means no - value. You can use this feature to ensure that all vcpus run at the same - speed. + negative value indicates that the domain has infinite bandwidth for + VCPU threads, which means that it is not bandwidth controlled. The value + should be in range [1000, 18446744073709551] or less than 0. A quota + with value 0 means no value. You can use this feature to ensure that all + vcpus run at the same speed. <span class="since">Only QEMU driver support since 0.9.4, LXC since 0.9.10</span> </dd> -- 2.17.1

On Tue, Jul 17, 2018 at 06:01:50PM +0200, Fabiano Fidêncio wrote: even "vcpu" would be fine, but I agree with Fabiano. If you adjust that, you have my Reviewed-by: Erik Skultety <eskultet(a)redhat.com&gt;

On Wed, Jul 18, 2018 at 10:05:30AM +0200, Ján Tomko wrote: Yes, this approach looks indeed cleaner. I 'll merge this patch with Fabianos/Erics comment and I 'll keep moving to table format as a followup.