[PATCH 4/6] kbase: incrementalbackupinternals: Add section on 'qemu-img bitmap' use

Peter Krempa pkrempa at redhat.com
Wed Jun 24 14:07:51 UTC 2020


Define what users should look for when wanting to manipulate bitmaps
themselves.

Later on a patch will turn the bash algorithms into pseudocode for
simplicity.

Signed-off-by: Peter Krempa <pkrempa at redhat.com>
---
 docs/kbase/incrementalbackupinternals.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/docs/kbase/incrementalbackupinternals.rst b/docs/kbase/incrementalbackupinternals.rst
index adc415e282..c8a0a66baa 100644
--- a/docs/kbase/incrementalbackupinternals.rst
+++ b/docs/kbase/incrementalbackupinternals.rst
@@ -190,6 +190,20 @@ It's reccomended to use ``--output=json`` parameter to work with a machine
 readable output rather than trying to process the human readable output by
 scripts. For processing JSON in shell the ``jq`` tool can be used.

+``qemu-img bitmap`` command allows modification of block-dirty-bitmaps of an
+image. It supports the following operations relevant to this document (see man
+page for full list of operations):
+
+``--add NAME``
+    Creates a new bitmap named ``NAME``. Optionally ``-g`` can be used to
+    specify granularity.
+
+``--remove NAME``
+    Deletes bitmap ``NAME``.
+
+``--merge SRCBITMAP -b SRCFILE -F SRCFILEFMT DSTBITMAP``
+    Merges bitmap ``SRCBITMAP`` from ``SRCFILE`` into ``DSTBITMAP``.
+
 Checking bitmap health
 ----------------------

-- 
2.26.2




More information about the libvir-list mailing list