qemu/include/migration
Maciej S. Szmigiero d3237d0d85 migration: Clarify that {load, save}_cleanup handlers can run without setup
It's possible for {load,save}_cleanup SaveVMHandlers to get called without
the corresponding {load,save}_setup handler being called first.

One such example is if {load,save}_setup handler of a proceeding device
returns error.
In this case the migration core cleanup code will call all corresponding
cleanup handlers, even for these devices which haven't had its setup
handler called.

Since this behavior can generate some surprises let's clearly document it
in these SaveVMHandlers description.

Reviewed-by: Fabiano Rosas <farosas@suse.de>
Reviewed-by: Cédric Le Goater <clg@redhat.com>
Signed-off-by: Maciej S. Szmigiero <maciej.szmigiero@oracle.com>
Link: https://lore.kernel.org/qemu-devel/991636623fb780350f493b5f045cb17e13ce4c0f.1741124640.git.maciej.szmigiero@oracle.com
Signed-off-by: Cédric Le Goater <clg@redhat.com>
2025-03-06 06:47:33 +01:00
..
blocker.h migration: per-mode blockers 2023-11-01 16:13:59 +01:00
client-options.h migration: export vcpu_dirty_limit_period 2024-03-11 16:28:59 -04:00
colo.h migration/colo: make colo_incoming_co() return void 2024-05-22 17:34:31 -03:00
cpr.h migration: cpr-transfer mode 2025-01-29 11:56:24 -03:00
cpu.h Include migration/vmstate.h less 2019-08-16 13:31:52 +02:00
failover.h Include qemu-common.h exactly where needed 2019-06-12 13:20:20 +02:00
global_state.h migration: never fail in global_state_store() 2023-06-02 01:03:19 +02:00
misc.h migration: enhance migrate_uri_parse 2025-01-29 11:43:04 -03:00
qemu-file-types.h migration/qemu-file: add utility methods for working with seekable channels 2024-03-01 15:42:04 +08:00
register.h migration: Clarify that {load, save}_cleanup handlers can run without setup 2025-03-06 06:47:33 +01:00
snapshot.h migration: preserve suspended for snapshot 2024-01-04 09:52:42 +08:00
vmstate.h migration: VMSTATE_FD 2025-01-29 11:43:05 -03:00