From: Peter Krempa Date: Wed, 24 Jun 2020 09:34:16 +0000 (+0200) Subject: kbase: incrementalbackupinternals: Add section on 'qemu-img bitmap' use X-Git-Url: http://xenbits.xensource.com/gitweb?a=commitdiff_plain;h=abf20e65f73243f9a97a100d6e668219603a6f6d;p=libvirt.git 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 Reviewed-by: Eric Blake --- diff --git a/docs/kbase/incrementalbackupinternals.rst b/docs/kbase/incrementalbackupinternals.rst index 0d6c77dfa1..6f087bdb87 100644 --- a/docs/kbase/incrementalbackupinternals.rst +++ b/docs/kbase/incrementalbackupinternals.rst @@ -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 ----------------------