qemu/migration/block-dirty-bitmap.c
<<
>>
Prefs
   1/*
   2 * Block dirty bitmap postcopy migration
   3 *
   4 * Copyright IBM, Corp. 2009
   5 * Copyright (c) 2016-2017 Virtuozzo International GmbH. All rights reserved.
   6 *
   7 * Authors:
   8 *  Liran Schour   <lirans@il.ibm.com>
   9 *  Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com>
  10 *
  11 * This work is licensed under the terms of the GNU GPL, version 2.  See
  12 * the COPYING file in the top-level directory.
  13 * This file is derived from migration/block.c, so it's author and IBM copyright
  14 * are here, although content is quite different.
  15 *
  16 * Contributions after 2012-01-13 are licensed under the terms of the
  17 * GNU GPL, version 2 or (at your option) any later version.
  18 *
  19 *                                ***
  20 *
  21 * Here postcopy migration of dirty bitmaps is realized. Only QMP-addressable
  22 * bitmaps are migrated.
  23 *
  24 * Bitmap migration implies creating bitmap with the same name and granularity
  25 * in destination QEMU. If the bitmap with the same name (for the same node)
  26 * already exists on destination an error will be generated.
  27 *
  28 * format of migration:
  29 *
  30 * # Header (shared for different chunk types)
  31 * 1, 2 or 4 bytes: flags (see qemu_{put,put}_flags)
  32 * [ 1 byte: node name size ] \  flags & DEVICE_NAME
  33 * [ n bytes: node name     ] /
  34 * [ 1 byte: bitmap name size ] \  flags & BITMAP_NAME
  35 * [ n bytes: bitmap name     ] /
  36 *
  37 * # Start of bitmap migration (flags & START)
  38 * header
  39 * be64: granularity
  40 * 1 byte: bitmap flags (corresponds to BdrvDirtyBitmap)
  41 *   bit 0    -  bitmap is enabled
  42 *   bit 1    -  bitmap is persistent
  43 *   bit 2    -  bitmap is autoloading
  44 *   bits 3-7 - reserved, must be zero
  45 *
  46 * # Complete of bitmap migration (flags & COMPLETE)
  47 * header
  48 *
  49 * # Data chunk of bitmap migration
  50 * header
  51 * be64: start sector
  52 * be32: number of sectors
  53 * [ be64: buffer size  ] \ ! (flags & ZEROES)
  54 * [ n bytes: buffer    ] /
  55 *
  56 * The last chunk in stream should contain flags & EOS. The chunk may skip
  57 * device and/or bitmap names, assuming them to be the same with the previous
  58 * chunk.
  59 */
  60
  61#include "qemu/osdep.h"
  62#include "block/block.h"
  63#include "block/block_int.h"
  64#include "sysemu/block-backend.h"
  65#include "qemu/main-loop.h"
  66#include "qemu/error-report.h"
  67#include "migration/misc.h"
  68#include "migration/migration.h"
  69#include "qemu-file.h"
  70#include "migration/vmstate.h"
  71#include "migration/register.h"
  72#include "qemu/hbitmap.h"
  73#include "sysemu/sysemu.h"
  74#include "qemu/cutils.h"
  75#include "qapi/error.h"
  76#include "trace.h"
  77
  78#define CHUNK_SIZE     (1 << 10)
  79
  80/* Flags occupy one, two or four bytes (Big Endian). The size is determined as
  81 * follows:
  82 * in first (most significant) byte bit 8 is clear  -->  one byte
  83 * in first byte bit 8 is set    -->  two or four bytes, depending on second
  84 *                                    byte:
  85 *    | in second byte bit 8 is clear  -->  two bytes
  86 *    | in second byte bit 8 is set    -->  four bytes
  87 */
  88#define DIRTY_BITMAP_MIG_FLAG_EOS           0x01
  89#define DIRTY_BITMAP_MIG_FLAG_ZEROES        0x02
  90#define DIRTY_BITMAP_MIG_FLAG_BITMAP_NAME   0x04
  91#define DIRTY_BITMAP_MIG_FLAG_DEVICE_NAME   0x08
  92#define DIRTY_BITMAP_MIG_FLAG_START         0x10
  93#define DIRTY_BITMAP_MIG_FLAG_COMPLETE      0x20
  94#define DIRTY_BITMAP_MIG_FLAG_BITS          0x40
  95
  96#define DIRTY_BITMAP_MIG_EXTRA_FLAGS        0x80
  97
  98#define DIRTY_BITMAP_MIG_START_FLAG_ENABLED          0x01
  99#define DIRTY_BITMAP_MIG_START_FLAG_PERSISTENT       0x02
 100/* 0x04 was "AUTOLOAD" flags on elder versions, no it is ignored */
 101#define DIRTY_BITMAP_MIG_START_FLAG_RESERVED_MASK    0xf8
 102
 103typedef struct DirtyBitmapMigBitmapState {
 104    /* Written during setup phase. */
 105    BlockDriverState *bs;
 106    const char *node_name;
 107    BdrvDirtyBitmap *bitmap;
 108    uint64_t total_sectors;
 109    uint64_t sectors_per_chunk;
 110    QSIMPLEQ_ENTRY(DirtyBitmapMigBitmapState) entry;
 111    uint8_t flags;
 112
 113    /* For bulk phase. */
 114    bool bulk_completed;
 115    uint64_t cur_sector;
 116} DirtyBitmapMigBitmapState;
 117
 118typedef struct DirtyBitmapMigState {
 119    QSIMPLEQ_HEAD(, DirtyBitmapMigBitmapState) dbms_list;
 120
 121    bool bulk_completed;
 122    bool no_bitmaps;
 123
 124    /* for send_bitmap_bits() */
 125    BlockDriverState *prev_bs;
 126    BdrvDirtyBitmap *prev_bitmap;
 127} DirtyBitmapMigState;
 128
 129typedef struct DirtyBitmapLoadState {
 130    uint32_t flags;
 131    char node_name[256];
 132    char bitmap_name[256];
 133    BlockDriverState *bs;
 134    BdrvDirtyBitmap *bitmap;
 135} DirtyBitmapLoadState;
 136
 137static DirtyBitmapMigState dirty_bitmap_mig_state;
 138
 139typedef struct DirtyBitmapLoadBitmapState {
 140    BlockDriverState *bs;
 141    BdrvDirtyBitmap *bitmap;
 142    bool migrated;
 143} DirtyBitmapLoadBitmapState;
 144static GSList *enabled_bitmaps;
 145QemuMutex finish_lock;
 146
 147void init_dirty_bitmap_incoming_migration(void)
 148{
 149    qemu_mutex_init(&finish_lock);
 150}
 151
 152static uint32_t qemu_get_bitmap_flags(QEMUFile *f)
 153{
 154    uint8_t flags = qemu_get_byte(f);
 155    if (flags & DIRTY_BITMAP_MIG_EXTRA_FLAGS) {
 156        flags = flags << 8 | qemu_get_byte(f);
 157        if (flags & DIRTY_BITMAP_MIG_EXTRA_FLAGS) {
 158            flags = flags << 16 | qemu_get_be16(f);
 159        }
 160    }
 161
 162    return flags;
 163}
 164
 165static void qemu_put_bitmap_flags(QEMUFile *f, uint32_t flags)
 166{
 167    /* The code currently do not send flags more than one byte */
 168    assert(!(flags & (0xffffff00 | DIRTY_BITMAP_MIG_EXTRA_FLAGS)));
 169
 170    qemu_put_byte(f, flags);
 171}
 172
 173static void send_bitmap_header(QEMUFile *f, DirtyBitmapMigBitmapState *dbms,
 174                               uint32_t additional_flags)
 175{
 176    BlockDriverState *bs = dbms->bs;
 177    BdrvDirtyBitmap *bitmap = dbms->bitmap;
 178    uint32_t flags = additional_flags;
 179    trace_send_bitmap_header_enter();
 180
 181    if (bs != dirty_bitmap_mig_state.prev_bs) {
 182        dirty_bitmap_mig_state.prev_bs = bs;
 183        flags |= DIRTY_BITMAP_MIG_FLAG_DEVICE_NAME;
 184    }
 185
 186    if (bitmap != dirty_bitmap_mig_state.prev_bitmap) {
 187        dirty_bitmap_mig_state.prev_bitmap = bitmap;
 188        flags |= DIRTY_BITMAP_MIG_FLAG_BITMAP_NAME;
 189    }
 190
 191    qemu_put_bitmap_flags(f, flags);
 192
 193    if (flags & DIRTY_BITMAP_MIG_FLAG_DEVICE_NAME) {
 194        qemu_put_counted_string(f, dbms->node_name);
 195    }
 196
 197    if (flags & DIRTY_BITMAP_MIG_FLAG_BITMAP_NAME) {
 198        qemu_put_counted_string(f, bdrv_dirty_bitmap_name(bitmap));
 199    }
 200}
 201
 202static void send_bitmap_start(QEMUFile *f, DirtyBitmapMigBitmapState *dbms)
 203{
 204    send_bitmap_header(f, dbms, DIRTY_BITMAP_MIG_FLAG_START);
 205    qemu_put_be32(f, bdrv_dirty_bitmap_granularity(dbms->bitmap));
 206    qemu_put_byte(f, dbms->flags);
 207}
 208
 209static void send_bitmap_complete(QEMUFile *f, DirtyBitmapMigBitmapState *dbms)
 210{
 211    send_bitmap_header(f, dbms, DIRTY_BITMAP_MIG_FLAG_COMPLETE);
 212}
 213
 214static void send_bitmap_bits(QEMUFile *f, DirtyBitmapMigBitmapState *dbms,
 215                             uint64_t start_sector, uint32_t nr_sectors)
 216{
 217    /* align for buffer_is_zero() */
 218    uint64_t align = 4 * sizeof(long);
 219    uint64_t unaligned_size =
 220        bdrv_dirty_bitmap_serialization_size(
 221            dbms->bitmap, start_sector << BDRV_SECTOR_BITS,
 222            (uint64_t)nr_sectors << BDRV_SECTOR_BITS);
 223    uint64_t buf_size = QEMU_ALIGN_UP(unaligned_size, align);
 224    uint8_t *buf = g_malloc0(buf_size);
 225    uint32_t flags = DIRTY_BITMAP_MIG_FLAG_BITS;
 226
 227    bdrv_dirty_bitmap_serialize_part(
 228        dbms->bitmap, buf, start_sector << BDRV_SECTOR_BITS,
 229        (uint64_t)nr_sectors << BDRV_SECTOR_BITS);
 230
 231    if (buffer_is_zero(buf, buf_size)) {
 232        g_free(buf);
 233        buf = NULL;
 234        flags |= DIRTY_BITMAP_MIG_FLAG_ZEROES;
 235    }
 236
 237    trace_send_bitmap_bits(flags, start_sector, nr_sectors, buf_size);
 238
 239    send_bitmap_header(f, dbms, flags);
 240
 241    qemu_put_be64(f, start_sector);
 242    qemu_put_be32(f, nr_sectors);
 243
 244    /* if a block is zero we need to flush here since the network
 245     * bandwidth is now a lot higher than the storage device bandwidth.
 246     * thus if we queue zero blocks we slow down the migration. */
 247    if (flags & DIRTY_BITMAP_MIG_FLAG_ZEROES) {
 248        qemu_fflush(f);
 249    } else {
 250        qemu_put_be64(f, buf_size);
 251        qemu_put_buffer(f, buf, buf_size);
 252    }
 253
 254    g_free(buf);
 255}
 256
 257/* Called with iothread lock taken.  */
 258static void dirty_bitmap_mig_cleanup(void)
 259{
 260    DirtyBitmapMigBitmapState *dbms;
 261
 262    while ((dbms = QSIMPLEQ_FIRST(&dirty_bitmap_mig_state.dbms_list)) != NULL) {
 263        QSIMPLEQ_REMOVE_HEAD(&dirty_bitmap_mig_state.dbms_list, entry);
 264        bdrv_dirty_bitmap_set_busy(dbms->bitmap, false);
 265        bdrv_unref(dbms->bs);
 266        g_free(dbms);
 267    }
 268}
 269
 270/* Called with iothread lock taken. */
 271static int init_dirty_bitmap_migration(void)
 272{
 273    BlockDriverState *bs;
 274    BdrvDirtyBitmap *bitmap;
 275    DirtyBitmapMigBitmapState *dbms;
 276    BdrvNextIterator it;
 277    Error *local_err = NULL;
 278
 279    dirty_bitmap_mig_state.bulk_completed = false;
 280    dirty_bitmap_mig_state.prev_bs = NULL;
 281    dirty_bitmap_mig_state.prev_bitmap = NULL;
 282    dirty_bitmap_mig_state.no_bitmaps = false;
 283
 284    for (bs = bdrv_first(&it); bs; bs = bdrv_next(&it)) {
 285        const char *drive_name = bdrv_get_device_or_node_name(bs);
 286
 287        /* skip automatically inserted nodes */
 288        while (bs && bs->drv && bs->implicit) {
 289            bs = backing_bs(bs);
 290        }
 291
 292        for (bitmap = bdrv_dirty_bitmap_next(bs, NULL); bitmap;
 293             bitmap = bdrv_dirty_bitmap_next(bs, bitmap))
 294        {
 295            if (!bdrv_dirty_bitmap_name(bitmap)) {
 296                continue;
 297            }
 298
 299            if (drive_name == NULL) {
 300                error_report("Found bitmap '%s' in unnamed node %p. It can't "
 301                             "be migrated", bdrv_dirty_bitmap_name(bitmap), bs);
 302                goto fail;
 303            }
 304
 305            if (bdrv_dirty_bitmap_check(bitmap, BDRV_BITMAP_DEFAULT,
 306                                        &local_err)) {
 307                error_report_err(local_err);
 308                goto fail;
 309            }
 310
 311            bdrv_ref(bs);
 312            bdrv_dirty_bitmap_set_busy(bitmap, true);
 313
 314            dbms = g_new0(DirtyBitmapMigBitmapState, 1);
 315            dbms->bs = bs;
 316            dbms->node_name = drive_name;
 317            dbms->bitmap = bitmap;
 318            dbms->total_sectors = bdrv_nb_sectors(bs);
 319            dbms->sectors_per_chunk = CHUNK_SIZE * 8 *
 320                bdrv_dirty_bitmap_granularity(bitmap) >> BDRV_SECTOR_BITS;
 321            if (bdrv_dirty_bitmap_enabled(bitmap)) {
 322                dbms->flags |= DIRTY_BITMAP_MIG_START_FLAG_ENABLED;
 323            }
 324            if (bdrv_dirty_bitmap_get_persistence(bitmap)) {
 325                dbms->flags |= DIRTY_BITMAP_MIG_START_FLAG_PERSISTENT;
 326            }
 327
 328            QSIMPLEQ_INSERT_TAIL(&dirty_bitmap_mig_state.dbms_list,
 329                                 dbms, entry);
 330        }
 331    }
 332
 333    /* unset migration flags here, to not roll back it */
 334    QSIMPLEQ_FOREACH(dbms, &dirty_bitmap_mig_state.dbms_list, entry) {
 335        bdrv_dirty_bitmap_set_migration(dbms->bitmap, true);
 336    }
 337
 338    if (QSIMPLEQ_EMPTY(&dirty_bitmap_mig_state.dbms_list)) {
 339        dirty_bitmap_mig_state.no_bitmaps = true;
 340    }
 341
 342    return 0;
 343
 344fail:
 345    dirty_bitmap_mig_cleanup();
 346
 347    return -1;
 348}
 349
 350/* Called with no lock taken.  */
 351static void bulk_phase_send_chunk(QEMUFile *f, DirtyBitmapMigBitmapState *dbms)
 352{
 353    uint32_t nr_sectors = MIN(dbms->total_sectors - dbms->cur_sector,
 354                             dbms->sectors_per_chunk);
 355
 356    send_bitmap_bits(f, dbms, dbms->cur_sector, nr_sectors);
 357
 358    dbms->cur_sector += nr_sectors;
 359    if (dbms->cur_sector >= dbms->total_sectors) {
 360        dbms->bulk_completed = true;
 361    }
 362}
 363
 364/* Called with no lock taken.  */
 365static void bulk_phase(QEMUFile *f, bool limit)
 366{
 367    DirtyBitmapMigBitmapState *dbms;
 368
 369    QSIMPLEQ_FOREACH(dbms, &dirty_bitmap_mig_state.dbms_list, entry) {
 370        while (!dbms->bulk_completed) {
 371            bulk_phase_send_chunk(f, dbms);
 372            if (limit && qemu_file_rate_limit(f)) {
 373                return;
 374            }
 375        }
 376    }
 377
 378    dirty_bitmap_mig_state.bulk_completed = true;
 379}
 380
 381/* for SaveVMHandlers */
 382static void dirty_bitmap_save_cleanup(void *opaque)
 383{
 384    dirty_bitmap_mig_cleanup();
 385}
 386
 387static int dirty_bitmap_save_iterate(QEMUFile *f, void *opaque)
 388{
 389    trace_dirty_bitmap_save_iterate(migration_in_postcopy());
 390
 391    if (migration_in_postcopy() && !dirty_bitmap_mig_state.bulk_completed) {
 392        bulk_phase(f, true);
 393    }
 394
 395    qemu_put_bitmap_flags(f, DIRTY_BITMAP_MIG_FLAG_EOS);
 396
 397    return dirty_bitmap_mig_state.bulk_completed;
 398}
 399
 400/* Called with iothread lock taken.  */
 401
 402static int dirty_bitmap_save_complete(QEMUFile *f, void *opaque)
 403{
 404    DirtyBitmapMigBitmapState *dbms;
 405    trace_dirty_bitmap_save_complete_enter();
 406
 407    if (!dirty_bitmap_mig_state.bulk_completed) {
 408        bulk_phase(f, false);
 409    }
 410
 411    QSIMPLEQ_FOREACH(dbms, &dirty_bitmap_mig_state.dbms_list, entry) {
 412        send_bitmap_complete(f, dbms);
 413    }
 414
 415    qemu_put_bitmap_flags(f, DIRTY_BITMAP_MIG_FLAG_EOS);
 416
 417    trace_dirty_bitmap_save_complete_finish();
 418
 419    dirty_bitmap_mig_cleanup();
 420    return 0;
 421}
 422
 423static void dirty_bitmap_save_pending(QEMUFile *f, void *opaque,
 424                                      uint64_t max_size,
 425                                      uint64_t *res_precopy_only,
 426                                      uint64_t *res_compatible,
 427                                      uint64_t *res_postcopy_only)
 428{
 429    DirtyBitmapMigBitmapState *dbms;
 430    uint64_t pending = 0;
 431
 432    qemu_mutex_lock_iothread();
 433
 434    QSIMPLEQ_FOREACH(dbms, &dirty_bitmap_mig_state.dbms_list, entry) {
 435        uint64_t gran = bdrv_dirty_bitmap_granularity(dbms->bitmap);
 436        uint64_t sectors = dbms->bulk_completed ? 0 :
 437                           dbms->total_sectors - dbms->cur_sector;
 438
 439        pending += DIV_ROUND_UP(sectors * BDRV_SECTOR_SIZE, gran);
 440    }
 441
 442    qemu_mutex_unlock_iothread();
 443
 444    trace_dirty_bitmap_save_pending(pending, max_size);
 445
 446    *res_postcopy_only += pending;
 447}
 448
 449/* First occurrence of this bitmap. It should be created if doesn't exist */
 450static int dirty_bitmap_load_start(QEMUFile *f, DirtyBitmapLoadState *s)
 451{
 452    Error *local_err = NULL;
 453    uint32_t granularity = qemu_get_be32(f);
 454    uint8_t flags = qemu_get_byte(f);
 455
 456    if (s->bitmap) {
 457        error_report("Bitmap with the same name ('%s') already exists on "
 458                     "destination", bdrv_dirty_bitmap_name(s->bitmap));
 459        return -EINVAL;
 460    } else {
 461        s->bitmap = bdrv_create_dirty_bitmap(s->bs, granularity,
 462                                             s->bitmap_name, &local_err);
 463        if (!s->bitmap) {
 464            error_report_err(local_err);
 465            return -EINVAL;
 466        }
 467    }
 468
 469    if (flags & DIRTY_BITMAP_MIG_START_FLAG_RESERVED_MASK) {
 470        error_report("Unknown flags in migrated dirty bitmap header: %x",
 471                     flags);
 472        return -EINVAL;
 473    }
 474
 475    if (flags & DIRTY_BITMAP_MIG_START_FLAG_PERSISTENT) {
 476        bdrv_dirty_bitmap_set_persistence(s->bitmap, true);
 477    }
 478
 479    bdrv_disable_dirty_bitmap(s->bitmap);
 480    if (flags & DIRTY_BITMAP_MIG_START_FLAG_ENABLED) {
 481        DirtyBitmapLoadBitmapState *b;
 482
 483        bdrv_dirty_bitmap_create_successor(s->bs, s->bitmap, &local_err);
 484        if (local_err) {
 485            error_report_err(local_err);
 486            return -EINVAL;
 487        }
 488
 489        b = g_new(DirtyBitmapLoadBitmapState, 1);
 490        b->bs = s->bs;
 491        b->bitmap = s->bitmap;
 492        b->migrated = false;
 493        enabled_bitmaps = g_slist_prepend(enabled_bitmaps, b);
 494    }
 495
 496    return 0;
 497}
 498
 499void dirty_bitmap_mig_before_vm_start(void)
 500{
 501    GSList *item;
 502
 503    qemu_mutex_lock(&finish_lock);
 504
 505    for (item = enabled_bitmaps; item; item = g_slist_next(item)) {
 506        DirtyBitmapLoadBitmapState *b = item->data;
 507
 508        if (b->migrated) {
 509            bdrv_enable_dirty_bitmap_locked(b->bitmap);
 510        } else {
 511            bdrv_dirty_bitmap_enable_successor(b->bitmap);
 512        }
 513
 514        g_free(b);
 515    }
 516
 517    g_slist_free(enabled_bitmaps);
 518    enabled_bitmaps = NULL;
 519
 520    qemu_mutex_unlock(&finish_lock);
 521}
 522
 523static void dirty_bitmap_load_complete(QEMUFile *f, DirtyBitmapLoadState *s)
 524{
 525    GSList *item;
 526    trace_dirty_bitmap_load_complete();
 527    bdrv_dirty_bitmap_deserialize_finish(s->bitmap);
 528
 529    qemu_mutex_lock(&finish_lock);
 530
 531    for (item = enabled_bitmaps; item; item = g_slist_next(item)) {
 532        DirtyBitmapLoadBitmapState *b = item->data;
 533
 534        if (b->bitmap == s->bitmap) {
 535            b->migrated = true;
 536            break;
 537        }
 538    }
 539
 540    if (bdrv_dirty_bitmap_has_successor(s->bitmap)) {
 541        bdrv_dirty_bitmap_lock(s->bitmap);
 542        if (enabled_bitmaps == NULL) {
 543            /* in postcopy */
 544            bdrv_reclaim_dirty_bitmap_locked(s->bs, s->bitmap, &error_abort);
 545            bdrv_enable_dirty_bitmap_locked(s->bitmap);
 546        } else {
 547            /* target not started, successor must be empty */
 548            int64_t count = bdrv_get_dirty_count(s->bitmap);
 549            BdrvDirtyBitmap *ret = bdrv_reclaim_dirty_bitmap_locked(s->bs,
 550                                                                    s->bitmap,
 551                                                                    NULL);
 552            /* bdrv_reclaim_dirty_bitmap can fail only on no successor (it
 553             * must be) or on merge fail, but merge can't fail when second
 554             * bitmap is empty
 555             */
 556            assert(ret == s->bitmap &&
 557                   count == bdrv_get_dirty_count(s->bitmap));
 558        }
 559        bdrv_dirty_bitmap_unlock(s->bitmap);
 560    }
 561
 562    qemu_mutex_unlock(&finish_lock);
 563}
 564
 565static int dirty_bitmap_load_bits(QEMUFile *f, DirtyBitmapLoadState *s)
 566{
 567    uint64_t first_byte = qemu_get_be64(f) << BDRV_SECTOR_BITS;
 568    uint64_t nr_bytes = (uint64_t)qemu_get_be32(f) << BDRV_SECTOR_BITS;
 569    trace_dirty_bitmap_load_bits_enter(first_byte >> BDRV_SECTOR_BITS,
 570                                       nr_bytes >> BDRV_SECTOR_BITS);
 571
 572    if (s->flags & DIRTY_BITMAP_MIG_FLAG_ZEROES) {
 573        trace_dirty_bitmap_load_bits_zeroes();
 574        bdrv_dirty_bitmap_deserialize_zeroes(s->bitmap, first_byte, nr_bytes,
 575                                             false);
 576    } else {
 577        size_t ret;
 578        uint8_t *buf;
 579        uint64_t buf_size = qemu_get_be64(f);
 580        uint64_t needed_size =
 581            bdrv_dirty_bitmap_serialization_size(s->bitmap,
 582                                                 first_byte, nr_bytes);
 583
 584        if (needed_size > buf_size ||
 585            buf_size > QEMU_ALIGN_UP(needed_size, 4 * sizeof(long))
 586             /* Here used same alignment as in send_bitmap_bits */
 587        ) {
 588            error_report("Migrated bitmap granularity doesn't "
 589                         "match the destination bitmap '%s' granularity",
 590                         bdrv_dirty_bitmap_name(s->bitmap));
 591            return -EINVAL;
 592        }
 593
 594        buf = g_malloc(buf_size);
 595        ret = qemu_get_buffer(f, buf, buf_size);
 596        if (ret != buf_size) {
 597            error_report("Failed to read bitmap bits");
 598            g_free(buf);
 599            return -EIO;
 600        }
 601
 602        bdrv_dirty_bitmap_deserialize_part(s->bitmap, buf, first_byte, nr_bytes,
 603                                           false);
 604        g_free(buf);
 605    }
 606
 607    return 0;
 608}
 609
 610static int dirty_bitmap_load_header(QEMUFile *f, DirtyBitmapLoadState *s)
 611{
 612    Error *local_err = NULL;
 613    bool nothing;
 614    s->flags = qemu_get_bitmap_flags(f);
 615    trace_dirty_bitmap_load_header(s->flags);
 616
 617    nothing = s->flags == (s->flags & DIRTY_BITMAP_MIG_FLAG_EOS);
 618
 619    if (s->flags & DIRTY_BITMAP_MIG_FLAG_DEVICE_NAME) {
 620        if (!qemu_get_counted_string(f, s->node_name)) {
 621            error_report("Unable to read node name string");
 622            return -EINVAL;
 623        }
 624        s->bs = bdrv_lookup_bs(s->node_name, s->node_name, &local_err);
 625        if (!s->bs) {
 626            error_report_err(local_err);
 627            return -EINVAL;
 628        }
 629    } else if (!s->bs && !nothing) {
 630        error_report("Error: block device name is not set");
 631        return -EINVAL;
 632    }
 633
 634    if (s->flags & DIRTY_BITMAP_MIG_FLAG_BITMAP_NAME) {
 635        if (!qemu_get_counted_string(f, s->bitmap_name)) {
 636            error_report("Unable to read bitmap name string");
 637            return -EINVAL;
 638        }
 639        s->bitmap = bdrv_find_dirty_bitmap(s->bs, s->bitmap_name);
 640
 641        /* bitmap may be NULL here, it wouldn't be an error if it is the
 642         * first occurrence of the bitmap */
 643        if (!s->bitmap && !(s->flags & DIRTY_BITMAP_MIG_FLAG_START)) {
 644            error_report("Error: unknown dirty bitmap "
 645                         "'%s' for block device '%s'",
 646                         s->bitmap_name, s->node_name);
 647            return -EINVAL;
 648        }
 649    } else if (!s->bitmap && !nothing) {
 650        error_report("Error: block device name is not set");
 651        return -EINVAL;
 652    }
 653
 654    return 0;
 655}
 656
 657static int dirty_bitmap_load(QEMUFile *f, void *opaque, int version_id)
 658{
 659    static DirtyBitmapLoadState s;
 660    int ret = 0;
 661
 662    trace_dirty_bitmap_load_enter();
 663
 664    if (version_id != 1) {
 665        return -EINVAL;
 666    }
 667
 668    do {
 669        ret = dirty_bitmap_load_header(f, &s);
 670        if (ret < 0) {
 671            return ret;
 672        }
 673
 674        if (s.flags & DIRTY_BITMAP_MIG_FLAG_START) {
 675            ret = dirty_bitmap_load_start(f, &s);
 676        } else if (s.flags & DIRTY_BITMAP_MIG_FLAG_COMPLETE) {
 677            dirty_bitmap_load_complete(f, &s);
 678        } else if (s.flags & DIRTY_BITMAP_MIG_FLAG_BITS) {
 679            ret = dirty_bitmap_load_bits(f, &s);
 680        }
 681
 682        if (!ret) {
 683            ret = qemu_file_get_error(f);
 684        }
 685
 686        if (ret) {
 687            return ret;
 688        }
 689    } while (!(s.flags & DIRTY_BITMAP_MIG_FLAG_EOS));
 690
 691    trace_dirty_bitmap_load_success();
 692    return 0;
 693}
 694
 695static int dirty_bitmap_save_setup(QEMUFile *f, void *opaque)
 696{
 697    DirtyBitmapMigBitmapState *dbms = NULL;
 698    if (init_dirty_bitmap_migration() < 0) {
 699        return -1;
 700    }
 701
 702    QSIMPLEQ_FOREACH(dbms, &dirty_bitmap_mig_state.dbms_list, entry) {
 703        send_bitmap_start(f, dbms);
 704    }
 705    qemu_put_bitmap_flags(f, DIRTY_BITMAP_MIG_FLAG_EOS);
 706
 707    return 0;
 708}
 709
 710static bool dirty_bitmap_is_active(void *opaque)
 711{
 712    return migrate_dirty_bitmaps() && !dirty_bitmap_mig_state.no_bitmaps;
 713}
 714
 715static bool dirty_bitmap_is_active_iterate(void *opaque)
 716{
 717    return dirty_bitmap_is_active(opaque) && !runstate_is_running();
 718}
 719
 720static bool dirty_bitmap_has_postcopy(void *opaque)
 721{
 722    return true;
 723}
 724
 725static SaveVMHandlers savevm_dirty_bitmap_handlers = {
 726    .save_setup = dirty_bitmap_save_setup,
 727    .save_live_complete_postcopy = dirty_bitmap_save_complete,
 728    .save_live_complete_precopy = dirty_bitmap_save_complete,
 729    .has_postcopy = dirty_bitmap_has_postcopy,
 730    .save_live_pending = dirty_bitmap_save_pending,
 731    .save_live_iterate = dirty_bitmap_save_iterate,
 732    .is_active_iterate = dirty_bitmap_is_active_iterate,
 733    .load_state = dirty_bitmap_load,
 734    .save_cleanup = dirty_bitmap_save_cleanup,
 735    .is_active = dirty_bitmap_is_active,
 736};
 737
 738void dirty_bitmap_mig_init(void)
 739{
 740    QSIMPLEQ_INIT(&dirty_bitmap_mig_state.dbms_list);
 741
 742    register_savevm_live(NULL, "dirty-bitmap", 0, 1,
 743                         &savevm_dirty_bitmap_handlers,
 744                         &dirty_bitmap_mig_state);
 745}
 746