From: Hyman Huang(黄勇) <huangy81@chinatelecom.cn>
Date: Mon, 21 Feb 2022 13:30:23 +0000 (+0800)
Subject: NEWS: Document domain dirty page rate calculation APIs
X-Git-Tag: v8.1.0-rc1~16
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=d85a5d09bae9ce51b0ec11f86e6e0df6bd1a9ca5;p=thirdparty%2Flibvirt.git

NEWS: Document domain dirty page rate calculation APIs

The Libvirt API virDomainStartDirtyRateCalc was extended.
Document this change.

Signed-off-by: Hyman Huang(黄勇) <huangy81@chinatelecom.cn>
Reviewed-by: Michal Privoznik <mprivozn@redhat.com>
---

diff --git a/NEWS.rst b/NEWS.rst
index f5453257ab..b684416909 100644
--- a/NEWS.rst
+++ b/NEWS.rst
@@ -22,6 +22,20 @@ v8.1.0 (unreleased)
     It works on Intel machines as well as recent machines powered by Apple
     Silicon. QEMU 6.2.0 is needed for Apple Silicon support.
 
+  * qemu: Support mode option for dirtyrate calculation
+
+    Introduce ``virDomainDirtyRateCalcFlags`` as parameter of
+    ``virDomainStartDirtyRateCalc``, which is used to specify the mode of
+    dirty page rate calculation.
+
+    Add ``--mode`` option to ``virsh domdirtyrate-calc``, which can be
+    either of the following 3 options:
+    ``page-sampling, dirty-bitmap, dirty-ring``.
+
+    Add ``calc_mode`` field for dirtyrate statistics retured by
+    ``virsh domstats --dirtyrate``, also add ``vCPU dirtyrate`` if
+    ``dirty-ring`` mode was used in last measurement.
+
 * **Improvements**
 
   * packaging: sysconfig files no longer installed