kbase: incrementalbackupinternals: Add section on 'qemu-img bitmap' use

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@redhat.com>
Reviewed-by: Eric Blake <eblake@redhat.com>
This commit is contained in:
Peter Krempa 2020-06-24 11:34:16 +02:00
parent a4e81e0c32
commit abf20e65f7

View File

@ -190,6 +190,20 @@ It's recommended 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.
The ``qemu-img bitmap`` command allows modification of block-dirty-bitmaps of an
offline 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
----------------------