xemu/docs/interop
Vladimir Sementsov-Ogievskiy 1084159b31 qapi: deprecate drive-backup
Modern way is using blockdev-add + blockdev-backup, which provides a
lot more control on how target is opened.

As example of drive-backup problems consider the following:

User of drive-backup expects that target will be opened in the same
cache and aio mode as source. Corresponding logic is in
drive_backup_prepare(), where we take bs->open_flags of source.

It works rather bad if source was added by blockdev-add. Assume source
is qcow2 image. On blockdev-add we should specify aio and cache options
for file child of qcow2 node. What happens next:

drive_backup_prepare() looks at bs->open_flags of qcow2 source node.
But there no BDRV_O_NOCAHE neither BDRV_O_NATIVE_AIO: BDRV_O_NOCAHE is
places in bs->file->bs->open_flags, and BDRV_O_NATIVE_AIO is nowhere,
as file-posix parse options and simply set s->use_linux_aio.

The documentation is updated in a minimal way, so that drive-backup is
noted only as a deprecated command, and blockdev-backup used in most of
places.

Signed-off-by: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com>
Signed-off-by: Markus Armbruster <armbru@redhat.com>
Reviewed-by: Eric Blake <eblake@redhat.com>
2021-11-09 18:21:19 +01:00
..
barrier.rst docs: Move the protocol part of barrier.txt into interop 2021-08-02 12:55:51 +01:00
bitmaps.rst docs/interop/bitmaps: use blockdev-backup 2021-11-09 18:20:47 +01:00
dbus-vmstate.rst Add dbus-vmstate object 2020-01-06 18:41:32 +04:00
dbus.rst docs/: fix some comment spelling errors 2020-09-17 20:37:13 +02:00
firmware.json docs/interop/firmware.json: Add SEV-ES support 2021-06-17 14:11:06 -04:00
index.rst docs: standardize directory index to --- with overline 2021-09-13 13:56:26 +02:00
live-block-operations.rst qapi: deprecate drive-backup 2021-11-09 18:21:19 +01:00
nbd.txt nbd: Add new qemu:allocation-depth metadata context 2020-10-30 15:22:00 -05:00
parallels.txt parallels.txt: fix bitmap L1 table description 2021-03-08 14:56:54 +01:00
pr-helper.rst global: Squash 'the the' 2019-11-06 17:19:40 +01:00
prl-xml.txt docs/interop/prl-xml: description of Parallels Disk format 2018-01-22 14:02:33 +00:00
qcow2.txt qcow2: introduce icount field for snapshots 2020-10-06 08:34:49 +02:00
qed_spec.txt
qemu-ga-ref.rst docs: Remove stale TODO comments about license and version 2021-08-02 11:42:38 +01:00
qemu-ga.rst qemu-ga: document vsock-listen in the man page 2020-03-24 11:32:19 -05:00
qemu-qmp-ref.rst docs: Remove stale TODO comments about license and version 2021-08-02 11:42:38 +01:00
qemu-storage-daemon-qmp-ref.rst docs: Remove stale TODO comments about license and version 2021-08-02 11:42:38 +01:00
qmp-intro.txt docs: update to show preferred boolean syntax for -chardev 2021-02-25 14:14:33 +01:00
qmp-spec.txt docs/interop/qmp-spec: Document the request queue limit 2021-02-04 13:20:29 +01:00
vhost-user-gpu.rst docs: Move licence/copyright from HTML output to rST comments 2021-08-02 11:42:38 +01:00
vhost-user.json configure: Improve OpenGL dependency detections 2021-03-04 09:35:30 +01:00
vhost-user.rst docs: Move licence/copyright from HTML output to rST comments 2021-08-02 11:42:38 +01:00
vhost-vdpa.rst vhost-vdpa: introduce vhost-vdpa backend 2020-07-07 07:59:51 -04:00
vnc-ledstate-Pseudo-encoding.txt