]> xenbits.xensource.com Git - libvirt.git/commit
docs: Add warning about using a cleared image with VIR_MIGRATE_PARAM_MIGRATE_DISKS_DE...
authorPeter Krempa <pkrempa@redhat.com>
Thu, 10 Oct 2024 06:42:20 +0000 (08:42 +0200)
committerPeter Krempa <pkrempa@redhat.com>
Mon, 14 Oct 2024 14:25:21 +0000 (16:25 +0200)
commit332ee4931a84ec23e7f6fcb963083318c1307dc7
tree93ebbf99febe0f583b743b45352e595ea60319bb
parent04d6a0ec5d80c7618e00fcd6456e1bd0773207a9
docs: Add warning about using a cleared image with VIR_MIGRATE_PARAM_MIGRATE_DISKS_DETECT_ZEROES_ZEROES

The migration parameter causes zero detection to be enabled and zero
blocks are *not* transferred to the destination. This means that users
must provide pre-cleared images that read all zero, otherwise the
non-zero blocks on destination which reside in places where the source
has zero blocks would be kept intact corrupting the image.

As not transferring and overwriting the zero blocks is what the feature
is supposed to do the users need to provide the proper environment.

Document the requirement, both in API and in the virsh man page for the
'--migrate-disks-detect-zeroes' option.

Signed-off-by: Peter Krempa <pkrempa@redhat.com>
Reviewed-by: Jiri Denemark <jdenemar@redhat.com>
docs/manpages/virsh.rst
include/libvirt/libvirt-domain.h