diff options
| author |   Hu Tao <hutao@cn.fujitsu.com> | 2012-08-21 17:18:42 +0800 |
|---|---|---|
| committer |   Daniel Veillard <veillard@redhat.com> | 2012-08-22 16:52:22 +0800 |
| commit | b65dafa812abc4f5c3b8a035b96a80785ac40ee1 (patch) | |
| tree | 3451c5af4923b6c176f573ebedff5aa95aedd812 /docs | |
| parent | limit cpu bandwidth only for vcpus (diff) | |
| download | libvirt-b65dafa812abc4f5c3b8a035b96a80785ac40ee1.tar.gz libvirt-b65dafa812abc4f5c3b8a035b96a80785ac40ee1.tar.bz2 libvirt-b65dafa812abc4f5c3b8a035b96a80785ac40ee1.zip | |
qemu: introduce period/quota tuning for emulator
This patch introduces support of setting emulator's period and
quota to limit cpu bandwidth when the vm starts. Also updates
XML Schema for new entries and docs.
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/formatdomain.html.in | 24 | ||||
| -rw-r--r-- | docs/schemas/domaincommon.rng | 10 |
2 files changed, 34 insertions, 0 deletions
diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in index 42df928a3..5d8f66957 100644 --- a/docs/formatdomain.html.in +++ b/docs/formatdomain.html.in @@ -388,6 +388,8 @@ <shares>2048</shares> <period>1000000</period> <quota>-1</quota> + <emulator_period>1000000</period> + <emulator_quota>-1</quota> </cputune> ... </domain> @@ -451,6 +453,28 @@ <span class="since">Only QEMU driver support since 0.9.4, LXC since 0.9.10</span> </dd> + + <dt><code>emulator_period</code></dt> + <dd> + The optional <code>emulator_period</code> element specifies the enforcement + interval(unit: microseconds). Within <code>emulator_period</code>, emulator + threads(those excluding vcpus) of the domain will not be allowed to consume + more than <code>emulator_quota</code> worth of runtime. The value should be + in range [1000, 1000000]. A period with value 0 means no value. + <span class="since">Only QEMU driver support since 0.10.0</span> + </dd> + <dt><code>emulator_quota</code></dt> + <dd> + The optional <code>emulator_quota</code> element specifies the maximum + allowed bandwidth(unit: microseconds) for domain's emulator threads(those + excluding vcpus). A domain with <code>emulator_quota</code> as any negative + value indicates that the domain has infinite bandwidth for emulator threads + (those excluding vcpus), 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. + <span class="since">Only QEMU driver support since 0.10.0</span> + </dd> + </dl> diff --git a/docs/schemas/domaincommon.rng b/docs/schemas/domaincommon.rng index f4005c51e..145caf78d 100644 --- a/docs/schemas/domaincommon.rng +++ b/docs/schemas/domaincommon.rng @@ -581,6 +581,16 @@ <ref name="cpuquota"/> </element> </optional> + <optional> + <element name="emulator_period"> + <ref name="cpuperiod"/> + </element> + </optional> + <optional> + <element name="emulator_quota"> + <ref name="cpuquota"/> + </element> + </optional> <zeroOrMore> <element name="vcpupin"> <attribute name="vcpu"> |