migration.h

   1 /*
   2  * QEMU live migration
   3  *
   4  * Copyright IBM, Corp. 2008
   5  *
   6  * Authors:
   7  *  Anthony Liguori   <aliguori@us.ibm.com>
   8  *
   9  * This work is licensed under the terms of the GNU GPL, version 2.  See
  10  * the COPYING file in the top-level directory.
  11  *
  12  */
  13
  14 #ifndef QEMU_MIGRATION_H
  15 #define QEMU_MIGRATION_H
  16
  17 #include "qdict.h"
  18 #include "qemu-common.h"
  19 #include "notify.h"
  20
  21 #define MIG_STATE_ERROR         -1
  22 #define MIG_STATE_COMPLETED     0
  23 #define MIG_STATE_CANCELLED     1
  24 #define MIG_STATE_ACTIVE        2
  25
  26 typedef struct FdMigrationState FdMigrationState;
  27
  28 struct FdMigrationState
  29 {
  30     int64_t bandwidth_limit;
  31     QEMUFile *file;
  32     int fd;
  33     Monitor *mon;
  34     int state;
  35     int (*get_error)(struct FdMigrationState*);
  36     int (*close)(struct FdMigrationState*);
  37     int (*write)(struct FdMigrationState*, const void *, size_t);
  38     void (*cancel)(FdMigrationState *s);
  39     int (*get_status)(FdMigrationState *s);
  40     void (*release)(FdMigrationState *s);
  41     void *opaque;
  42     int blk;
  43     int shared;
  44 };
  45
  46 void process_incoming_migration(QEMUFile *f);
  47
  48 int qemu_start_incoming_migration(const char *uri);
  49
  50 int do_migrate(Monitor *mon, const QDict *qdict, QObject **ret_data);
  51
  52 int do_migrate_cancel(Monitor *mon, const QDict *qdict, QObject **ret_data);
  53
  54 int do_migrate_set_speed(Monitor *mon, const QDict *qdict, QObject **ret_data);
  55
  56 uint64_t migrate_max_downtime(void);
  57
  58 int do_migrate_set_downtime(Monitor *mon, const QDict *qdict,
  59                             QObject **ret_data);
  60
  61 void do_info_migrate_print(Monitor *mon, const QObject *data);
  62
  63 void do_info_migrate(Monitor *mon, QObject **ret_data);
  64
  65 int exec_start_incoming_migration(const char *host_port);
  66
  67 FdMigrationState *exec_start_outgoing_migration(Monitor *mon,
  68                                               const char *host_port,
  69                                               int64_t bandwidth_limit,
  70                                               int detach,
  71                                               int blk,
  72                                               int inc);
  73
  74 int tcp_start_incoming_migration(const char *host_port);
  75
  76 FdMigrationState *tcp_start_outgoing_migration(Monitor *mon,
  77                                              const char *host_port,
  78                                              int64_t bandwidth_limit,
  79                                              int detach,
  80                                              int blk,
  81                                              int inc);
  82
  83 int unix_start_incoming_migration(const char *path);
  84
  85 FdMigrationState *unix_start_outgoing_migration(Monitor *mon,
  86                                               const char *path,
  87                                               int64_t bandwidth_limit,
  88                                               int detach,
  89                                               int blk,
  90                                               int inc);
  91
  92 int fd_start_incoming_migration(const char *path);
  93
  94 FdMigrationState *fd_start_outgoing_migration(Monitor *mon,
  95                                             const char *fdname,
  96                                             int64_t bandwidth_limit,
  97                                             int detach,
  98                                             int blk,
  99                                             int inc);
 100
 101 void migrate_fd_monitor_suspend(FdMigrationState *s, Monitor *mon);
 102
 103 void migrate_fd_error(FdMigrationState *s);
 104
 105 int migrate_fd_cleanup(FdMigrationState *s);
 106
 107 void migrate_fd_put_notify(void *opaque);
 108
 109 ssize_t migrate_fd_put_buffer(void *opaque, const void *data, size_t size);
 110
 111 void migrate_fd_connect(FdMigrationState *s);
 112
 113 void migrate_fd_put_ready(void *opaque);
 114
 115 int migrate_fd_get_status(FdMigrationState *mig_state);
 116
 117 void migrate_fd_cancel(FdMigrationState *mig_state);
 118
 119 void migrate_fd_release(FdMigrationState *mig_state);
 120
 121 void migrate_fd_wait_for_unfreeze(void *opaque);
 122
 123 int migrate_fd_close(void *opaque);
 124
 125 void add_migration_state_change_notifier(Notifier *notify);
 126 void remove_migration_state_change_notifier(Notifier *notify);
 127 int get_migration_state(void);
 128
 129 uint64_t ram_bytes_remaining(void);
 130 uint64_t ram_bytes_transferred(void);
 131 uint64_t ram_bytes_total(void);
 132
 133 int ram_save_live(Monitor *mon, QEMUFile *f, int stage, void *opaque);
 134 int ram_load(QEMUFile *f, void *opaque, int version_id);
 135
 136 extern int incoming_expected;
 137
 138 #endif