qemu/docs/interop
Vladimir Sementsov-Ogievskiy 3ae3fcfae5 docs: improve qcow2 spec about extending image header
Make it more obvious how to add new fields to the version 3 header and
how to interpret them.

The specification is adjusted so that for new defined optional fields:

1. Software may support some of these optional fields and ignore the
   others, which means that features may be backported to downstream
   Qemu independently.
2. If we want to add incompatible field (or a field, for which some of
   its values would be incompatible), it must be accompanied by
   incompatible feature bit.

Also the concept of "default is zero" is clarified, as it's strange to
say that the value of the field is assumed to be zero for the software
version which don't know about the field at all and don't know how to
treat it be it zero or not.

Signed-off-by: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com>
Reviewed-by: Eric Blake <eblake@redhat.com>
Message-Id: <20200131142219.3264-2-vsementsov@virtuozzo.com>
Reviewed-by: Alberto Garcia <berto@igalia.com>
[mreitz: s/some its/some of its/]
Signed-off-by: Max Reitz <mreitz@redhat.com>
2020-02-20 16:20:14 +01:00
..
bitmaps.rst docs/bitmaps: use QMP lexer instead of json 2019-07-10 15:08:07 -04:00
conf.py docs: add virtiofsd(1) man page 2020-02-10 17:25:52 +00:00
dbus-vmstate.rst Add dbus-vmstate object 2020-01-06 18:41:32 +04:00
dbus.rst Add dbus-vmstate object 2020-01-06 18:41:32 +04:00
firmware.json hw/ppc/prep: Remove the deprecated "prep" machine and the OpenHackware BIOS 2020-02-02 14:07:57 +11:00
index.rst docs: add virtiofsd(1) man page 2020-02-10 17:25:52 +00:00
live-block-operations.rst Remove the deprecated -nodefconfig option 2018-08-31 09:52:46 +02:00
nbd.txt nbd: Prepare for NBD_CMD_FLAG_FAST_ZERO 2019-09-05 16:03:13 -05:00
parallels.txt
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 docs: improve qcow2 spec about extending image header 2020-02-20 16:20:14 +01:00
qed_spec.txt
qemu-ga-ref.texi
qemu-ga.rst qemu-ga: Convert invocation documentation to rST 2019-09-13 16:05:01 +01:00
qemu-img.rst qemu-img: Place the '-i aio' option in alphabetical order 2020-02-06 11:09:36 +01:00
qemu-nbd.rst qemu-nbd: Removed deprecated --partition option 2020-02-05 17:29:49 -06:00
qemu-option-trace.rst.inc qemu-nbd: Convert invocation documentation to rST 2020-01-23 15:22:39 +00:00
qemu-qmp-ref.texi
qemu-trace-stap.rst scripts/qemu-trace-stap: Convert documentation to rST 2020-02-03 11:02:23 +00:00
qmp-intro.txt docs/interop/qmp: Improve OOB documentation 2018-07-03 23:09:31 +02:00
qmp-spec.txt docs: Update references to JSON RFC 2018-12-13 19:10:06 +01:00
vhost-user-gpu.rst vhost-user: add vhost_user_gpu_set_socket() 2019-05-29 06:29:07 +02:00
vhost-user.json virtiofsd: add --print-capabilities option 2020-01-23 16:41:36 +00:00
vhost-user.rst vhost-user: add VHOST_USER_RESET_DEVICE to reset devices 2020-01-05 07:03:03 -05:00
virtfs-proxy-helper.rst virtfs-proxy-helper: Convert documentation to rST 2020-02-03 11:02:23 +00:00
virtiofsd.rst docs: add virtiofsd(1) man page 2020-02-10 17:25:52 +00:00
vnc-ledstate-Pseudo-encoding.txt