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" 20f3bff6c4SSteve Sistare #include "migration/client-options.h" 211adc1ceeSJuan Quintela 227b1e1a22SJuan Quintela /* migration/ram.c */ 237b1e1a22SJuan Quintela 24bd227060SWei Wang typedef enum PrecopyNotifyReason { 25bd227060SWei Wang PRECOPY_NOTIFY_SETUP = 0, 26bd227060SWei Wang PRECOPY_NOTIFY_BEFORE_BITMAP_SYNC = 1, 27bd227060SWei Wang PRECOPY_NOTIFY_AFTER_BITMAP_SYNC = 2, 28bd227060SWei Wang PRECOPY_NOTIFY_COMPLETE = 3, 29bd227060SWei Wang PRECOPY_NOTIFY_CLEANUP = 4, 30bd227060SWei Wang PRECOPY_NOTIFY_MAX = 5, 31bd227060SWei Wang } PrecopyNotifyReason; 32bd227060SWei Wang 33bd227060SWei Wang typedef struct PrecopyNotifyData { 34bd227060SWei Wang enum PrecopyNotifyReason reason; 35bd227060SWei Wang } PrecopyNotifyData; 36bd227060SWei Wang 37bd227060SWei Wang void precopy_infrastructure_init(void); 38bd227060SWei Wang void precopy_add_notifier(NotifierWithReturn *n); 39bd227060SWei Wang void precopy_remove_notifier(NotifierWithReturn *n); 40bd227060SWei Wang int precopy_notify(PrecopyNotifyReason reason, Error **errp); 41bd227060SWei Wang 427b1e1a22SJuan Quintela void ram_mig_init(void); 436bcb05fcSWei Wang void qemu_guest_free_page_hint(void *addr, size_t len); 44f161c88aSDavid Hildenbrand bool migrate_ram_is_ignored(RAMBlock *block); 457b1e1a22SJuan Quintela 462c9e6fecSJuan Quintela /* migration/block.c */ 472c9e6fecSJuan Quintela 48ee3d96baSDr. David Alan Gilbert AnnounceParameters *migrate_announce_params(void); 49b7722747SJuan Quintela /* migration/savevm.c */ 50b7722747SJuan Quintela 51b7722747SJuan Quintela void dump_vmstate_json_to_file(FILE *out_fp); 52b7722747SJuan Quintela 53c4b63b7cSJuan Quintela /* migration/migration.c */ 54e5cb7e76SPeter Xu void migration_object_init(void); 55892ae715SDr. David Alan Gilbert void migration_shutdown(void); 56c4b63b7cSJuan Quintela bool migration_is_idle(void); 573a6813b6SSteve Sistare bool migration_is_active(void); 589bb630c6SSteve Sistare bool migration_is_device(void); 596e785639SSteve Sistare bool migration_thread_is_self(void); 607dcb3c87SSteve Sistare bool migration_is_setup_or_active(void); 619d9babf7SSteve Sistare 629d9babf7SSteve Sistare typedef enum MigrationEventType { 639d9babf7SSteve Sistare MIG_EVENT_PRECOPY_SETUP, 649d9babf7SSteve Sistare MIG_EVENT_PRECOPY_DONE, 659d9babf7SSteve Sistare MIG_EVENT_PRECOPY_FAILED, 669d9babf7SSteve Sistare MIG_EVENT_MAX 679d9babf7SSteve Sistare } MigrationEventType; 689d9babf7SSteve Sistare 699d9babf7SSteve Sistare typedef struct MigrationEvent { 709d9babf7SSteve Sistare MigrationEventType type; 719d9babf7SSteve Sistare } MigrationEvent; 729d9babf7SSteve Sistare 734af667f8SSteve Sistare /* 744af667f8SSteve Sistare * A MigrationNotifyFunc may return an error code and an Error object, 754af667f8SSteve Sistare * but only when @e->type is MIG_EVENT_PRECOPY_SETUP. The code is an int 764af667f8SSteve Sistare * to allow for different failure modes and recovery actions. 774af667f8SSteve Sistare */ 785663dd3fSSteve Sistare typedef int (*MigrationNotifyFunc)(NotifierWithReturn *notify, 795663dd3fSSteve Sistare MigrationEvent *e, Error **errp); 805663dd3fSSteve Sistare 819d9babf7SSteve Sistare /* 829d9babf7SSteve Sistare * Register the notifier @notify to be called when a migration event occurs 839d9babf7SSteve Sistare * for MIG_MODE_NORMAL, as specified by the MigrationEvent passed to @func. 849d9babf7SSteve Sistare * Notifiers may receive events in any of the following orders: 859d9babf7SSteve Sistare * - MIG_EVENT_PRECOPY_SETUP -> MIG_EVENT_PRECOPY_DONE 869d9babf7SSteve Sistare * - MIG_EVENT_PRECOPY_SETUP -> MIG_EVENT_PRECOPY_FAILED 879d9babf7SSteve Sistare * - MIG_EVENT_PRECOPY_FAILED 889d9babf7SSteve Sistare */ 893e775730SSteve Sistare void migration_add_notifier(NotifierWithReturn *notify, 905663dd3fSSteve Sistare MigrationNotifyFunc func); 919d9babf7SSteve Sistare 926835f5a1SSteve Sistare /* 936835f5a1SSteve Sistare * Same as migration_add_notifier, but applies to be specified @mode. 946835f5a1SSteve Sistare */ 956835f5a1SSteve Sistare void migration_add_notifier_mode(NotifierWithReturn *notify, 966835f5a1SSteve Sistare MigrationNotifyFunc func, MigMode mode); 976835f5a1SSteve Sistare 983e775730SSteve Sistare void migration_remove_notifier(NotifierWithReturn *notify); 99aeaafb1eSSteve Sistare bool migration_is_running(void); 100*019d9e6cSCédric Le Goater void migration_file_set_error(int ret, Error *err); 10120c64c8aSSteve Sistare 10280fe315cSDavid Hildenbrand /* True if incoming migration entered POSTCOPY_INCOMING_DISCARD */ 10306df2e69SDavid Hildenbrand bool migration_in_incoming_postcopy(void); 104c9539d9bSSteve Sistare 10580fe315cSDavid Hildenbrand /* True if incoming migration entered POSTCOPY_INCOMING_ADVISE */ 10680fe315cSDavid Hildenbrand bool migration_incoming_postcopy_advised(void); 107c9539d9bSSteve Sistare 1081a8e44a8SAndrey Gruzdev /* True if background snapshot is active */ 1091a8e44a8SAndrey Gruzdev bool migration_in_bg_snapshot(void); 1103df663e5SPeter Xu 111b35ebdf0SVladimir Sementsov-Ogievskiy /* migration/block-dirty-bitmap.c */ 112b35ebdf0SVladimir Sementsov-Ogievskiy void dirty_bitmap_mig_init(void); 113b35ebdf0SVladimir Sementsov-Ogievskiy 1147b1e1a22SJuan Quintela #endif 115