libvirt/include/libvirt
Peter Krempa 332ee4931a 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>
2024-10-14 16:25:21 +02:00
..
libvirt-admin.h admin: Introduce virAdmConnectSetDaemonTimeout 2022-07-07 14:35:30 +02:00
libvirt-common.h.in docstring: remove 'v' from since metadata 2022-05-04 18:11:06 +02:00
libvirt-domain-checkpoint.h docstring: remove 'v' from since metadata 2022-05-04 18:11:06 +02:00
libvirt-domain-snapshot.h docstring: remove 'v' from since metadata 2022-05-04 18:11:06 +02:00
libvirt-domain.h docs: Add warning about using a cleared image with VIR_MIGRATE_PARAM_MIGRATE_DISKS_DETECT_ZEROES_ZEROES 2024-10-14 16:25:21 +02:00
libvirt-event.h docstring: remove 'v' from since metadata 2022-05-04 18:11:06 +02:00
libvirt-host.h Support cpu0-id of Qemu QMP query-sev-capabilities 2022-05-05 12:29:53 +02:00
libvirt-interface.h docstring: remove 'v' from since metadata 2022-05-04 18:11:06 +02:00
libvirt-lxc.h Enforce a standard header file guard symbol name 2018-12-14 10:47:13 +00:00
libvirt-network.h Define Network Metadata change event 2023-09-18 11:24:47 +02:00
libvirt-nodedev.h api: add virNodeDeviceUpdate() 2024-02-26 11:03:51 +01:00
libvirt-nwfilter.h docstring: remove 'v' from since metadata 2022-05-04 18:11:06 +02:00
libvirt-qemu.h docstring: remove 'v' from since metadata 2022-05-04 18:11:06 +02:00
libvirt-secret.h docstring: remove 'v' from since metadata 2022-05-04 18:11:06 +02:00
libvirt-storage.h storage: Add VIR_STORAGE_VOL_CREATE_VALIDATE flag 2022-11-01 13:07:20 +01:00
libvirt-stream.h docstring: remove 'v' from since metadata 2022-05-04 18:11:06 +02:00
libvirt.h backup: Introduce virDomainCheckpoint APIs 2019-07-26 16:48:58 -05:00
meson.build meson: Use @BASENAME@ more 2020-09-01 13:22:24 +02:00
virterror.h Adding Public Get and Set APIs for Network Metadata 2023-08-25 12:36:37 +02:00