17b1e1a22SJuan Quintela /* 27b1e1a22SJuan Quintela * QEMU migration miscellaneus exported functions 37b1e1a22SJuan Quintela * 47b1e1a22SJuan Quintela * Copyright IBM, Corp. 2008 57b1e1a22SJuan Quintela * 67b1e1a22SJuan Quintela * Authors: 77b1e1a22SJuan Quintela * Anthony Liguori <aliguori@us.ibm.com> 87b1e1a22SJuan Quintela * 97b1e1a22SJuan Quintela * This work is licensed under the terms of the GNU GPL, version 2. See 107b1e1a22SJuan Quintela * the COPYING file in the top-level directory. 117b1e1a22SJuan Quintela * 127b1e1a22SJuan Quintela */ 137b1e1a22SJuan Quintela 147b1e1a22SJuan Quintela #ifndef MIGRATION_MISC_H 157b1e1a22SJuan Quintela #define MIGRATION_MISC_H 167b1e1a22SJuan Quintela 171adc1ceeSJuan Quintela #include "qemu/notify.h" 18eea1e5c9SSteve Sistare #include "qapi/qapi-types-migration.h" 19ee3d96baSDr. David Alan Gilbert #include "qapi/qapi-types-net.h" 201adc1ceeSJuan Quintela 217b1e1a22SJuan Quintela /* migration/ram.c */ 227b1e1a22SJuan Quintela 23bd227060SWei Wang typedef enum PrecopyNotifyReason { 24bd227060SWei Wang PRECOPY_NOTIFY_SETUP = 0, 25bd227060SWei Wang PRECOPY_NOTIFY_BEFORE_BITMAP_SYNC = 1, 26bd227060SWei Wang PRECOPY_NOTIFY_AFTER_BITMAP_SYNC = 2, 27bd227060SWei Wang PRECOPY_NOTIFY_COMPLETE = 3, 28bd227060SWei Wang PRECOPY_NOTIFY_CLEANUP = 4, 29bd227060SWei Wang PRECOPY_NOTIFY_MAX = 5, 30bd227060SWei Wang } PrecopyNotifyReason; 31bd227060SWei Wang 32bd227060SWei Wang typedef struct PrecopyNotifyData { 33bd227060SWei Wang enum PrecopyNotifyReason reason; 34bd227060SWei Wang } PrecopyNotifyData; 35bd227060SWei Wang 36bd227060SWei Wang void precopy_infrastructure_init(void); 37bd227060SWei Wang void precopy_add_notifier(NotifierWithReturn *n); 38bd227060SWei Wang void precopy_remove_notifier(NotifierWithReturn *n); 39bd227060SWei Wang int precopy_notify(PrecopyNotifyReason reason, Error **errp); 40bd227060SWei Wang 417b1e1a22SJuan Quintela void ram_mig_init(void); 426bcb05fcSWei Wang void qemu_guest_free_page_hint(void *addr, size_t len); 43f161c88aSDavid Hildenbrand bool migrate_ram_is_ignored(RAMBlock *block); 447b1e1a22SJuan Quintela 452c9e6fecSJuan Quintela /* migration/block.c */ 462c9e6fecSJuan Quintela 472c9e6fecSJuan Quintela #ifdef CONFIG_LIVE_BLOCK_MIGRATION 482c9e6fecSJuan Quintela void blk_mig_init(void); 492c9e6fecSJuan Quintela #else 502c9e6fecSJuan Quintela static inline void blk_mig_init(void) {} 512c9e6fecSJuan Quintela #endif 522c9e6fecSJuan Quintela 53ee3d96baSDr. David Alan Gilbert AnnounceParameters *migrate_announce_params(void); 54b7722747SJuan Quintela /* migration/savevm.c */ 55b7722747SJuan Quintela 56b7722747SJuan Quintela void dump_vmstate_json_to_file(FILE *out_fp); 57b7722747SJuan Quintela 58c4b63b7cSJuan Quintela /* migration/migration.c */ 59e5cb7e76SPeter Xu void migration_object_init(void); 60892ae715SDr. David Alan Gilbert void migration_shutdown(void); 61c4b63b7cSJuan Quintela bool migration_is_idle(void); 628f8d528eSWei Yang bool migration_is_active(MigrationState *); 63*9867d4ddSSteve Sistare bool migrate_mode_is_cpr(MigrationState *); 649d9babf7SSteve Sistare 659d9babf7SSteve Sistare typedef enum MigrationEventType { 669d9babf7SSteve Sistare MIG_EVENT_PRECOPY_SETUP, 679d9babf7SSteve Sistare MIG_EVENT_PRECOPY_DONE, 689d9babf7SSteve Sistare MIG_EVENT_PRECOPY_FAILED, 699d9babf7SSteve Sistare MIG_EVENT_MAX 709d9babf7SSteve Sistare } MigrationEventType; 719d9babf7SSteve Sistare 729d9babf7SSteve Sistare typedef struct MigrationEvent { 739d9babf7SSteve Sistare MigrationEventType type; 749d9babf7SSteve Sistare } MigrationEvent; 759d9babf7SSteve Sistare 764af667f8SSteve Sistare /* 774af667f8SSteve Sistare * A MigrationNotifyFunc may return an error code and an Error object, 784af667f8SSteve Sistare * but only when @e->type is MIG_EVENT_PRECOPY_SETUP. The code is an int 794af667f8SSteve Sistare * to allow for different failure modes and recovery actions. 804af667f8SSteve Sistare */ 815663dd3fSSteve Sistare typedef int (*MigrationNotifyFunc)(NotifierWithReturn *notify, 825663dd3fSSteve Sistare MigrationEvent *e, Error **errp); 835663dd3fSSteve Sistare 849d9babf7SSteve Sistare /* 859d9babf7SSteve Sistare * Register the notifier @notify to be called when a migration event occurs 869d9babf7SSteve Sistare * for MIG_MODE_NORMAL, as specified by the MigrationEvent passed to @func. 879d9babf7SSteve Sistare * Notifiers may receive events in any of the following orders: 889d9babf7SSteve Sistare * - MIG_EVENT_PRECOPY_SETUP -> MIG_EVENT_PRECOPY_DONE 899d9babf7SSteve Sistare * - MIG_EVENT_PRECOPY_SETUP -> MIG_EVENT_PRECOPY_FAILED 909d9babf7SSteve Sistare * - MIG_EVENT_PRECOPY_FAILED 919d9babf7SSteve Sistare */ 923e775730SSteve Sistare void migration_add_notifier(NotifierWithReturn *notify, 935663dd3fSSteve Sistare MigrationNotifyFunc func); 949d9babf7SSteve Sistare 956835f5a1SSteve Sistare /* 966835f5a1SSteve Sistare * Same as migration_add_notifier, but applies to be specified @mode. 976835f5a1SSteve Sistare */ 986835f5a1SSteve Sistare void migration_add_notifier_mode(NotifierWithReturn *notify, 996835f5a1SSteve Sistare MigrationNotifyFunc func, MigMode mode); 1006835f5a1SSteve Sistare 1013e775730SSteve Sistare void migration_remove_notifier(NotifierWithReturn *notify); 1024af667f8SSteve Sistare int migration_call_notifiers(MigrationState *s, MigrationEventType type, 1034af667f8SSteve Sistare Error **errp); 104c4b63b7cSJuan Quintela bool migration_in_setup(MigrationState *); 105c4b63b7cSJuan Quintela bool migration_has_finished(MigrationState *); 106c4b63b7cSJuan Quintela bool migration_has_failed(MigrationState *); 107c4b63b7cSJuan Quintela /* ...and after the device transmission */ 10880fe315cSDavid Hildenbrand /* True if incoming migration entered POSTCOPY_INCOMING_DISCARD */ 10906df2e69SDavid Hildenbrand bool migration_in_incoming_postcopy(void); 11080fe315cSDavid Hildenbrand /* True if incoming migration entered POSTCOPY_INCOMING_ADVISE */ 11180fe315cSDavid Hildenbrand bool migration_incoming_postcopy_advised(void); 1121a8e44a8SAndrey Gruzdev /* True if background snapshot is active */ 1131a8e44a8SAndrey Gruzdev bool migration_in_bg_snapshot(void); 1143df663e5SPeter Xu 115b35ebdf0SVladimir Sementsov-Ogievskiy /* migration/block-dirty-bitmap.c */ 116b35ebdf0SVladimir Sementsov-Ogievskiy void dirty_bitmap_mig_init(void); 117b35ebdf0SVladimir Sementsov-Ogievskiy 1187b1e1a22SJuan Quintela #endif 119