1 /* 2 * QEMU migration capabilities 3 * 4 * Copyright (c) 2012-2023 Red Hat Inc 5 * 6 * Authors: 7 * Orit Wasserman <owasserm@redhat.com> 8 * Juan Quintela <quintela@redhat.com> 9 * 10 * This work is licensed under the terms of the GNU GPL, version 2 or later. 11 * See the COPYING file in the top-level directory. 12 */ 13 14 #ifndef QEMU_MIGRATION_OPTIONS_H 15 #define QEMU_MIGRATION_OPTIONS_H 16 17 #include "hw/qdev-properties.h" 18 #include "hw/qdev-properties-system.h" 19 20 /* constants */ 21 22 /* Amount of time to allocate to each "chunk" of bandwidth-throttled 23 * data. */ 24 #define BUFFER_DELAY 100 25 #define XFER_LIMIT_RATIO (1000 / BUFFER_DELAY) 26 27 /* migration properties */ 28 29 extern Property migration_properties[]; 30 31 /* capabilities */ 32 33 bool migrate_auto_converge(void); 34 bool migrate_background_snapshot(void); 35 bool migrate_block(void); 36 bool migrate_colo(void); 37 bool migrate_compress(void); 38 bool migrate_dirty_bitmaps(void); 39 bool migrate_events(void); 40 bool migrate_ignore_shared(void); 41 bool migrate_late_block_activate(void); 42 bool migrate_multifd(void); 43 bool migrate_pause_before_switchover(void); 44 bool migrate_postcopy_blocktime(void); 45 bool migrate_postcopy_preempt(void); 46 bool migrate_postcopy_ram(void); 47 bool migrate_rdma_pin_all(void); 48 bool migrate_release_ram(void); 49 bool migrate_return_path(void); 50 bool migrate_validate_uuid(void); 51 bool migrate_xbzrle(void); 52 bool migrate_zero_blocks(void); 53 bool migrate_zero_copy_send(void); 54 55 /* 56 * pseudo capabilities 57 * 58 * These are functions that are used in a similar way to capabilities 59 * check, but they are not a capability. 60 */ 61 62 bool migrate_multifd_flush_after_each_section(void); 63 bool migrate_postcopy(void); 64 bool migrate_tls(void); 65 66 /* capabilities helpers */ 67 68 bool migrate_caps_check(bool *old_caps, bool *new_caps, Error **errp); 69 bool migrate_cap_set(int cap, bool value, Error **errp); 70 71 /* parameters */ 72 73 const BitmapMigrationNodeAliasList *migrate_block_bitmap_mapping(void); 74 bool migrate_block_incremental(void); 75 uint32_t migrate_checkpoint_delay(void); 76 int migrate_compress_level(void); 77 int migrate_compress_threads(void); 78 int migrate_compress_wait_thread(void); 79 uint8_t migrate_cpu_throttle_increment(void); 80 uint8_t migrate_cpu_throttle_initial(void); 81 bool migrate_cpu_throttle_tailslow(void); 82 int migrate_decompress_threads(void); 83 uint64_t migrate_downtime_limit(void); 84 uint8_t migrate_max_cpu_throttle(void); 85 uint64_t migrate_max_bandwidth(void); 86 int64_t migrate_max_postcopy_bandwidth(void); 87 int migrate_multifd_channels(void); 88 MultiFDCompression migrate_multifd_compression(void); 89 int migrate_multifd_zlib_level(void); 90 int migrate_multifd_zstd_level(void); 91 uint8_t migrate_throttle_trigger_threshold(void); 92 const char *migrate_tls_authz(void); 93 const char *migrate_tls_creds(void); 94 const char *migrate_tls_hostname(void); 95 uint64_t migrate_xbzrle_cache_size(void); 96 97 /* parameters setters */ 98 99 void migrate_set_block_incremental(bool value); 100 101 /* parameters helpers */ 102 103 bool migrate_params_check(MigrationParameters *params, Error **errp); 104 void migrate_params_init(MigrationParameters *params); 105 void block_cleanup_parameters(void); 106 107 #endif 108