Specification for qcow2 version 3
authorKevin Wolf <kwolf@redhat.com>
Thu, 12 Apr 2012 11:20:41 +0000 (13:20 +0200)
committerKevin Wolf <kwolf@redhat.com>
Fri, 20 Apr 2012 13:57:27 +0000 (15:57 +0200)
commit4fabffc11234d0587a213418574095e036110cd2
tree2fdfd1e834a37627e59d3eeeccbf5f38bfdd1e36
parentf24423bd902bce29bc546cf8d030bfa369726ab1
Specification for qcow2 version 3

This updates the qcow2 specification to cover version 3. It contains the
following changes:

- Added compatible/incompatible/auto-clear feature bits plus an optional
  feature name table to allow useful error messages even if an older
  version doesn't know some feature at all.

- Configurable refcount width. If you don't want to use internal
  snapshots, make refcounts one bit and save cache space and I/O.

- Zero cluster flags. This allows discard even with a backing file that
  doesn't contain zeros. It is also useful for copy-on-read/image
  streaming, as you'll want to keep sparseness without accessing the
  remote image for an unallocated cluster all the time.

- Fixed internal snapshot metadata to use 64 bit VM state size. You
  can't save a snapshot of a VM with >= 4 GB RAM today.

- Extended internal snapshot metadata to contain the disk size, so that
  resizing images that have snapshots can be allowed in the future.

Signed-off-by: Kevin Wolf <kwolf@redhat.com>
docs/specs/qcow2.txt