docs/interop/live-block-operations.rst

10 Live Block Device Operations
14 live block device jobs -- stream, commit, mirror, and backup.  These can
16 namely: live copy data from backing files into overlays; shorten long
17 disk image chains by merging data from overlays into backing files; live
37 A simple disk image chain.  (This can be created live using QMP
40                    (Live QEMU)
50 [B].  And live QEMU is currently writing to image [B], consequently, it
73 Brief overview of live block QMP primitives
76 The following are the four different kinds of live block operations that
79 (1) ``block-stream``: Live copy of data from backing files into overlay
97 (2) ``block-commit``: Live merge of data from overlay files into backing
122     Point-in-time (live) copy of a block device to a destination.
180 overlay images; image [D] is the active layer -- i.e. live QEMU is
181 writing to it.  (The rule of thumb is: live QEMU will always be pointing
235 Live block streaming --- ``block-stream``
238 The ``block-stream`` command allows you to do live copy data from backing
254     into it (where live QEMU writes go to)::
277     live QEMU is writing to [D])::
327 Live block commit --- ``block-commit``
330 The ``block-commit`` command lets you merge live data from overlay
331 images into backing file(s).  Since QEMU 2.0, this includes "live active
333 image in a disk image chain where live QEMU will be writing to, into the
337 Again, starting afresh with our example disk image chain, where live
437 the active layer, [D], is committed back to [A] -- which is where live
503 Live disk synchronization --- ``drive-mirror`` and ``blockdev-mirror``
541     live VM migration with non-shared storage.
544     ``BLOCK_JOB_COMPLETED``) will adjust the guest device (i.e. live
640 (b) Or, complete the operation and pivot the live QEMU to the target
656 QMP invocation for live storage migration with ``drive-mirror`` + NBD
659 Live storage migration (without shared storage setup) is one of the most
808 created (using ``qemu-img``) and attach it to live QEMU via
934 Live disk backup --- ``blockdev-backup`` and the deprecated ``drive-backup``
970 will be issued, indicating the live block device job operation has
1022 overlay (live QEMU is writing to it)::