397dc2
From c9113d8cd9d68c932175ea63b634fc5cb7e51ef2 Mon Sep 17 00:00:00 2001
397dc2
Message-Id: <c9113d8cd9d68c932175ea63b634fc5cb7e51ef2@dist-git>
397dc2
From: Pavel Hrdina <phrdina@redhat.com>
397dc2
Date: Thu, 4 Mar 2021 12:57:56 +0100
397dc2
Subject: [PATCH] docs: use proper cpu quota value in our documentation
397dc2
MIME-Version: 1.0
397dc2
Content-Type: text/plain; charset=UTF-8
397dc2
Content-Transfer-Encoding: 8bit
397dc2
397dc2
Commit <d505b8af58912ae1e1a211fabc9995b19bd40828> changed the cpu quota
397dc2
value that reflects what kernel allows but did not update our
397dc2
documentation.
397dc2
397dc2
Signed-off-by: Pavel Hrdina <phrdina@redhat.com>
397dc2
Reviewed-by: Michal Privoznik <mprivozn@redhat.com>
397dc2
(cherry picked from commit 992635b142b261cedb6075e459918418fe6e6962)
397dc2
397dc2
Conflicts:
397dc2
    docs/formatdomain.rst
397dc2
        - missing in downstream, we use formatdomain.html.in
397dc2
397dc2
Resolves: https://bugzilla.redhat.com/show_bug.cgi?id=1798463
397dc2
397dc2
Signed-off-by: Pavel Hrdina <phrdina@redhat.com>
397dc2
Message-Id: <ba20be50c3bde1668cb214253e5ef8f212fc062b.1614858616.git.phrdina@redhat.com>
397dc2
Reviewed-by: Ján Tomko <jtomko@redhat.com>
397dc2
---
397dc2
 docs/formatdomain.html.in     | 8 ++++----
397dc2
 docs/manpages/virsh.rst       | 2 +-
397dc2
 docs/schemas/domaincommon.rng | 2 +-
397dc2
 3 files changed, 6 insertions(+), 6 deletions(-)
397dc2
397dc2
diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
397dc2
index 127dd13cc0..4341e256a8 100644
397dc2
--- a/docs/formatdomain.html.in
397dc2
+++ b/docs/formatdomain.html.in
397dc2
@@ -872,7 +872,7 @@
397dc2
         bandwidth (unit: microseconds). A domain with quota as any
397dc2
         negative value indicates that the domain has infinite bandwidth for
397dc2
         vCPU threads, which means that it is not bandwidth controlled. The value
397dc2
-        should be in range [1000, 18446744073709551] or less than 0. A quota
397dc2
+        should be in range [1000, 17592186044415] or less than 0. A quota
397dc2
         with value 0 means no value. You can use this feature to ensure that all
397dc2
         vCPUs run at the same speed.
397dc2
         Only QEMU driver support since 0.9.4, LXC since
397dc2
@@ -894,7 +894,7 @@
397dc2
         domain. A domain with global_quota as any negative
397dc2
         value indicates that the domain has infinite bandwidth, which means that
397dc2
         it is not bandwidth controlled. The value should be in range
397dc2
-        [1000, 18446744073709551] or less than 0. A global_quota
397dc2
+        [1000, 17592186044415] or less than 0. A global_quota
397dc2
         with value 0 means no value.
397dc2
         Only QEMU driver support since 1.3.3
397dc2
       
397dc2
@@ -915,7 +915,7 @@
397dc2
         excluding vCPUs). A domain with emulator_quota as any negative
397dc2
         value indicates that the domain has infinite bandwidth for emulator threads
397dc2
         (those excluding vCPUs), which means that it is not bandwidth controlled.
397dc2
-        The value should be in range [1000, 18446744073709551] or less than 0. A
397dc2
+        The value should be in range [1000, 17592186044415] or less than 0. A
397dc2
         quota with value 0 means no value.
397dc2
         Only QEMU driver support since 0.10.0
397dc2
       
397dc2
@@ -937,7 +937,7 @@
397dc2
         iothread_quota as any negative value indicates that the
397dc2
         domain IOThreads have infinite bandwidth, which means that it is
397dc2
         not bandwidth controlled. The value should be in range
397dc2
-        [1000, 18446744073709551] or less than 0. An iothread_quota
397dc2
+        [1000, 17592186044415] or less than 0. An iothread_quota
397dc2
         with value 0 means no value. You can use this feature to ensure that
397dc2
         all IOThreads run at the same speed.
397dc2
         Only QEMU driver support since 2.1.0
397dc2
diff --git a/docs/manpages/virsh.rst b/docs/manpages/virsh.rst
397dc2
index 0804465d44..a5b95c1123 100644
397dc2
--- a/docs/manpages/virsh.rst
397dc2
+++ b/docs/manpages/virsh.rst
397dc2
@@ -3715,7 +3715,7 @@ XEN_CREDIT scheduler.
397dc2
 ``Note``: The vcpu_period, emulator_period, and iothread_period parameters
397dc2
 have a valid value range of 1000-1000000 or 0, and the vcpu_quota,
397dc2
 emulator_quota, and iothread_quota parameters have a valid value range of
397dc2
-1000-18446744073709551 or less than 0. The value 0 for
397dc2
+1000-17592186044415 or less than 0. The value 0 for
397dc2
 either parameter is the same as not specifying that parameter.
397dc2
 
397dc2
 
397dc2
diff --git a/docs/schemas/domaincommon.rng b/docs/schemas/domaincommon.rng
397dc2
index 4a42cb9b40..6671ef3dfa 100644
397dc2
--- a/docs/schemas/domaincommon.rng
397dc2
+++ b/docs/schemas/domaincommon.rng
397dc2
@@ -6649,7 +6649,7 @@
397dc2
   <define name="cpuquota">
397dc2
     <data type="long">
397dc2
       <param name="pattern">-?[0-9]+</param>
397dc2
-      <param name="maxInclusive">18446744073709551</param>
397dc2
+      <param name="maxInclusive">17592186044415</param>
397dc2
       <param name='minInclusive'>-1</param>
397dc2
     </data>
397dc2
   </define>
397dc2
-- 
397dc2
2.30.0
397dc2