Eric Blake bc5ee6da71 qcow2: Deprecate use of qemu-img amend to change backing file ... The use of 'qemu-img amend' to change qcow2 backing files is not tested very well. In particular, our implementation has a bug where if a new backing file is provided without a format, then the prior format is blindly reused, even if this results in data corruption, but this is not caught by iotests. There are also situations where amending other options needs access to the original backing file (for example, on a downgrade to a v2 image, knowing whether a v3 zero cluster must be allocated or may be left unallocated depends on knowing whether the backing file already reads as zero), but the command line does not have a nice way to tell us both the backing file to use for opening the image as well as the backing file to install after the operation is complete. Even if we do allow changing the backing file, it is redundant with the existing ability to change backing files via 'qemu-img rebase -u'. It is time to deprecate this support (leaving the existing behavior intact, even if it is buggy), and at a point in the future, require the use of only 'qemu-img rebase' for adjusting backing chain relations, saving 'qemu-img amend' for changes unrelated to the backing chain. Signed-off-by: Eric Blake <eblake@redhat.com> Message-Id: <20200706203954.341758-8-eblake@redhat.com> Signed-off-by: Kevin Wolf <kwolf@redhat.com>		2020-07-14 15:18:59 +02:00
..
arm	docs/system: Document Aspeed boards	2020-06-05 17:23:09 +01:00
s390x	docs/system/s390x: Improve the 3270 documentation	2020-07-13 11:40:52 +02:00
build-platforms.rst	docs/system: convert Texinfo documentation to rST	2020-03-06 10:05:12 +00:00
conf.py	docs: Generate qemu.1 manpage with Sphinx	2020-03-06 11:06:55 +00:00
cpu-models-mips.rst.inc	docs/system: Convert qemu-cpu-models.texi to rST	2020-03-06 10:05:12 +00:00
cpu-models-x86.rst.inc	qemu-cpu-models.rst: Document -noTSX, mds-no, taa-no, and tsx-ctrl	2020-03-16 23:02:25 +01:00
deprecated.rst	qcow2: Deprecate use of qemu-img amend to change backing file	2020-07-14 15:18:59 +02:00
device-url-syntax.rst.inc	docs: Split out sections for the manpage into .rst.inc files	2020-03-06 11:06:55 +00:00
gdb.rst	docs: Add to gdbstub documentation the PhyMemMode	2020-07-11 15:53:00 +01:00
images.rst	docs/system: convert Texinfo documentation to rST	2020-03-06 10:05:12 +00:00
index.rst	Documentation: create/move s390x documentation	2020-03-23 12:36:27 +01:00
invocation.rst	docs: Split out sections for the manpage into .rst.inc files	2020-03-06 11:06:55 +00:00
ivshmem.rst	docs/system: convert Texinfo documentation to rST	2020-03-06 10:05:12 +00:00
keys.rst	docs: Split out sections for the manpage into .rst.inc files	2020-03-06 11:06:55 +00:00
keys.rst.inc	docs: Split out sections for the manpage into .rst.inc files	2020-03-06 11:06:55 +00:00
license.rst	docs/system: convert Texinfo documentation to rST	2020-03-06 10:05:12 +00:00
linuxboot.rst	docs/system: convert Texinfo documentation to rST	2020-03-06 10:05:12 +00:00
managed-startup.rst	docs/system: convert managed startup to rST.	2020-03-06 10:05:12 +00:00
monitor.rst	hmp-commands-info.hx: Add rST documentation fragments	2020-03-06 10:05:12 +00:00
mux-chardev.rst	docs: Split out sections for the manpage into .rst.inc files	2020-03-06 11:06:55 +00:00
mux-chardev.rst.inc	docs: Split out sections for the manpage into .rst.inc files	2020-03-06 11:06:55 +00:00
net.rst	docs/system: convert Texinfo documentation to rST	2020-03-06 10:05:12 +00:00
qemu-block-drivers.rst	docs: Create defs.rst.inc as a place to define substitutions	2020-03-06 10:04:58 +00:00
qemu-block-drivers.rst.inc	docs/system: put qemu-block-drivers body in an included file	2020-03-06 10:04:58 +00:00
qemu-cpu-models.rst	docs/system: Convert qemu-cpu-models.texi to rST	2020-03-06 10:05:12 +00:00
qemu-manpage.rst	docs: Generate qemu.1 manpage with Sphinx	2020-03-06 11:06:55 +00:00
quickstart.rst	docs/system: convert Texinfo documentation to rST	2020-03-06 10:05:12 +00:00
security.rst	docs/system: Convert security.texi to rST format	2020-03-06 10:05:12 +00:00
target-arm.rst	docs/system: Document Aspeed boards	2020-06-05 17:23:09 +01:00
target-avr.rst	target/avr: Add section into QEMU documentation	2020-07-11 11:02:05 +02:00
target-i386-desc.rst.inc	pcspk: update docs/system/target-i386-desc.rst.inc	2020-07-06 17:01:11 +02:00
target-i386.rst	docs: Split out sections for the manpage into .rst.inc files	2020-03-06 11:06:55 +00:00
target-m68k.rst	docs: Roll semihosting option information into qemu-options.hx	2020-03-06 10:05:12 +00:00
target-mips.rst	hw/mips/fuloong2e: Fix typo in Fuloong machine name	2020-05-26 13:20:48 +02:00
target-ppc.rst	docs: Roll -prom-env and -g target-specific info into qemu-options.hx	2020-03-06 10:05:18 +00:00
target-rx.rst	docs: Document the RX target	2020-06-22 18:37:12 +02:00
target-s390x.rst	docs/s390x: document vfio-ccw	2020-06-05 17:13:11 +02:00
target-sparc.rst	docs: Roll -prom-env and -g target-specific info into qemu-options.hx	2020-03-06 10:05:18 +00:00
target-sparc64.rst	docs: Roll -prom-env and -g target-specific info into qemu-options.hx	2020-03-06 10:05:18 +00:00
target-xtensa.rst	docs: Roll semihosting option information into qemu-options.hx	2020-03-06 10:05:12 +00:00
targets.rst	target/avr: Add section into QEMU documentation	2020-07-11 11:02:05 +02:00
tls.rst	docs/system: convert Texinfo documentation to rST	2020-03-06 10:05:12 +00:00
usb.rst	docs/system: convert Texinfo documentation to rST	2020-03-06 10:05:12 +00:00
vnc-security.rst	docs/system: convert Texinfo documentation to rST	2020-03-06 10:05:12 +00:00