4 * Copyright IBM, Corp. 2008
7 * Anthony Liguori <aliguori@us.ibm.com>
9 * This work is licensed under the terms of the GNU GPL, version 2. See
10 * the COPYING file in the top-level directory.
14 #ifndef QEMU_MIGRATION_H
15 #define QEMU_MIGRATION_H
17 #include "qapi/qmp/qdict.h"
18 #include "qemu-common.h"
19 #include "qemu/thread.h"
20 #include "qemu/notify.h"
21 #include "qapi/error.h"
22 #include "migration/vmstate.h"
23 #include "qapi-types.h"
24 #include "exec/cpu-common.h"
26 struct MigrationParams
{
31 typedef struct MigrationState MigrationState
;
35 int64_t bandwidth_limit
;
43 MigrationParams params
;
47 int64_t expected_downtime
;
48 int64_t dirty_pages_rate
;
49 int64_t dirty_bytes_rate
;
50 bool enabled_capabilities
[MIGRATION_CAPABILITY_MAX
];
51 int64_t xbzrle_cache_size
;
55 void process_incoming_migration(QEMUFile
*f
);
57 void qemu_start_incoming_migration(const char *uri
, Error
**errp
);
59 uint64_t migrate_max_downtime(void);
61 void do_info_migrate_print(Monitor
*mon
, const QObject
*data
);
63 void do_info_migrate(Monitor
*mon
, QObject
**ret_data
);
65 void exec_start_incoming_migration(const char *host_port
, Error
**errp
);
67 void exec_start_outgoing_migration(MigrationState
*s
, const char *host_port
, Error
**errp
);
69 void tcp_start_incoming_migration(const char *host_port
, Error
**errp
);
71 void tcp_start_outgoing_migration(MigrationState
*s
, const char *host_port
, Error
**errp
);
73 void unix_start_incoming_migration(const char *path
, Error
**errp
);
75 void unix_start_outgoing_migration(MigrationState
*s
, const char *path
, Error
**errp
);
77 void fd_start_incoming_migration(const char *path
, Error
**errp
);
79 void fd_start_outgoing_migration(MigrationState
*s
, const char *fdname
, Error
**errp
);
81 void rdma_start_outgoing_migration(void *opaque
, const char *host_port
, Error
**errp
);
83 void rdma_start_incoming_migration(const char *host_port
, Error
**errp
);
85 void migrate_fd_error(MigrationState
*s
);
87 void migrate_fd_connect(MigrationState
*s
);
89 int migrate_fd_close(MigrationState
*s
);
91 void add_migration_state_change_notifier(Notifier
*notify
);
92 void remove_migration_state_change_notifier(Notifier
*notify
);
93 bool migration_in_setup(MigrationState
*);
94 bool migration_has_finished(MigrationState
*);
95 bool migration_has_failed(MigrationState
*);
96 MigrationState
*migrate_get_current(void);
98 uint64_t ram_bytes_remaining(void);
99 uint64_t ram_bytes_transferred(void);
100 uint64_t ram_bytes_total(void);
102 void acct_update_position(QEMUFile
*f
, size_t size
, bool zero
);
104 extern SaveVMHandlers savevm_ram_handlers
;
106 uint64_t dup_mig_bytes_transferred(void);
107 uint64_t dup_mig_pages_transferred(void);
108 uint64_t skipped_mig_bytes_transferred(void);
109 uint64_t skipped_mig_pages_transferred(void);
110 uint64_t norm_mig_bytes_transferred(void);
111 uint64_t norm_mig_pages_transferred(void);
112 uint64_t xbzrle_mig_bytes_transferred(void);
113 uint64_t xbzrle_mig_pages_transferred(void);
114 uint64_t xbzrle_mig_pages_overflow(void);
115 uint64_t xbzrle_mig_pages_cache_miss(void);
117 void ram_handle_compressed(void *host
, uint8_t ch
, uint64_t size
);
120 * @migrate_add_blocker - prevent migration from proceeding
122 * @reason - an error to be returned whenever migration is attempted
124 void migrate_add_blocker(Error
*reason
);
127 * @migrate_del_blocker - remove a blocking error from migration
129 * @reason - the error blocking migration
131 void migrate_del_blocker(Error
*reason
);
133 bool migrate_rdma_pin_all(void);
134 bool migrate_zero_blocks(void);
136 bool migrate_auto_converge(void);
138 int xbzrle_encode_buffer(uint8_t *old_buf
, uint8_t *new_buf
, int slen
,
139 uint8_t *dst
, int dlen
);
140 int xbzrle_decode_buffer(uint8_t *src
, int slen
, uint8_t *dst
, int dlen
);
142 int migrate_use_xbzrle(void);
143 int64_t migrate_xbzrle_cache_size(void);
145 int64_t xbzrle_cache_resize(int64_t new_size
);
147 void ram_control_before_iterate(QEMUFile
*f
, uint64_t flags
);
148 void ram_control_after_iterate(QEMUFile
*f
, uint64_t flags
);
149 void ram_control_load_hook(QEMUFile
*f
, uint64_t flags
);
151 /* Whenever this is found in the data stream, the flags
152 * will be passed to ram_control_load_hook in the incoming-migration
153 * side. This lets before_ram_iterate/after_ram_iterate add
154 * transport-specific sections to the RAM migration data.
156 #define RAM_SAVE_FLAG_HOOK 0x80
158 #define RAM_SAVE_CONTROL_NOT_SUPP -1000
159 #define RAM_SAVE_CONTROL_DELAYED -2000
161 size_t ram_control_save_page(QEMUFile
*f
, ram_addr_t block_offset
,
162 ram_addr_t offset
, size_t size
,