savevm.c

   1 /*
   2  * QEMU System Emulator
   3  *
   4  * Copyright (c) 2003-2008 Fabrice Bellard
   5  *
   6  * Permission is hereby granted, free of charge, to any person obtaining a copy
   7  * of this software and associated documentation files (the "Software"), to deal
   8  * in the Software without restriction, including without limitation the rights
   9  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  10  * copies of the Software, and to permit persons to whom the Software is
  11  * furnished to do so, subject to the following conditions:
  12  *
  13  * The above copyright notice and this permission notice shall be included in
  14  * all copies or substantial portions of the Software.
  15  *
  16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  17  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
  19  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  20  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  21  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  22  * THE SOFTWARE.
  23  */
  24
  25 #include "config-host.h"
  26 #include "qemu-common.h"
  27 #include "hw/boards.h"
  28 #include "hw/hw.h"
  29 #include "hw/qdev.h"
  30 #include "net/net.h"
  31 #include "monitor/monitor.h"
  32 #include "sysemu/sysemu.h"
  33 #include "qemu/timer.h"
  34 #include "audio/audio.h"
  35 #include "migration/migration.h"
  36 #include "qemu/sockets.h"
  37 #include "qemu/queue.h"
  38 #include "sysemu/cpus.h"
  39 #include "exec/memory.h"
  40 #include "qmp-commands.h"
  41 #include "trace.h"
  42 #include "qemu/iov.h"
  43 #include "block/snapshot.h"
  44 #include "block/qapi.h"
  45
  46
  47 #ifndef ETH_P_RARP
  48 #define ETH_P_RARP 0x8035
  49 #endif
  50 #define ARP_HTYPE_ETH 0x0001
  51 #define ARP_PTYPE_IP 0x0800
  52 #define ARP_OP_REQUEST_REV 0x3
  53
  54 static int announce_self_create(uint8_t *buf,
  55                                 uint8_t *mac_addr)
  56 {
  57     /* Ethernet header. */
  58     memset(buf, 0xff, 6);         /* destination MAC addr */
  59     memcpy(buf + 6, mac_addr, 6); /* source MAC addr */
  60     *(uint16_t *)(buf + 12) = htons(ETH_P_RARP); /* ethertype */
  61
  62     /* RARP header. */
  63     *(uint16_t *)(buf + 14) = htons(ARP_HTYPE_ETH); /* hardware addr space */
  64     *(uint16_t *)(buf + 16) = htons(ARP_PTYPE_IP); /* protocol addr space */
  65     *(buf + 18) = 6; /* hardware addr length (ethernet) */
  66     *(buf + 19) = 4; /* protocol addr length (IPv4) */
  67     *(uint16_t *)(buf + 20) = htons(ARP_OP_REQUEST_REV); /* opcode */
  68     memcpy(buf + 22, mac_addr, 6); /* source hw addr */
  69     memset(buf + 28, 0x00, 4);     /* source protocol addr */
  70     memcpy(buf + 32, mac_addr, 6); /* target hw addr */
  71     memset(buf + 38, 0x00, 4);     /* target protocol addr */
  72
  73     /* Padding to get up to 60 bytes (ethernet min packet size, minus FCS). */
  74     memset(buf + 42, 0x00, 18);
  75
  76     return 60; /* len (FCS will be added by hardware) */
  77 }
  78
  79 static void qemu_announce_self_iter(NICState *nic, void *opaque)
  80 {
  81     uint8_t buf[60];
  82     int len;
  83
  84     trace_qemu_announce_self_iter(qemu_ether_ntoa(&nic->conf->macaddr));
  85     len = announce_self_create(buf, nic->conf->macaddr.a);
  86
  87     qemu_send_packet_raw(qemu_get_queue(nic), buf, len);
  88 }
  89
  90
  91 static void qemu_announce_self_once(void *opaque)
  92 {
  93     static int count = SELF_ANNOUNCE_ROUNDS;
  94     QEMUTimer *timer = *(QEMUTimer **)opaque;
  95
  96     qemu_foreach_nic(qemu_announce_self_iter, NULL);
  97
  98     if (--count) {
  99         /* delay 50ms, 150ms, 250ms, ... */
 100         timer_mod(timer, qemu_clock_get_ms(QEMU_CLOCK_REALTIME) +
 101                   self_announce_delay(count));
 102     } else {
 103             timer_del(timer);
 104             timer_free(timer);
 105     }
 106 }
 107
 108 void qemu_announce_self(void)
 109 {
 110     static QEMUTimer *timer;
 111     timer = timer_new_ms(QEMU_CLOCK_REALTIME, qemu_announce_self_once, &timer);
 112     qemu_announce_self_once(&timer);
 113 }
 114
 115 /***********************************************************/
 116 /* savevm/loadvm support */
 117
 118 static ssize_t block_writev_buffer(void *opaque, struct iovec *iov, int iovcnt,
 119                                    int64_t pos)
 120 {
 121     int ret;
 122     QEMUIOVector qiov;
 123
 124     qemu_iovec_init_external(&qiov, iov, iovcnt);
 125     ret = bdrv_writev_vmstate(opaque, &qiov, pos);
 126     if (ret < 0) {
 127         return ret;
 128     }
 129
 130     return qiov.size;
 131 }
 132
 133 static int block_put_buffer(void *opaque, const uint8_t *buf,
 134                            int64_t pos, int size)
 135 {
 136     bdrv_save_vmstate(opaque, buf, pos, size);
 137     return size;
 138 }
 139
 140 static int block_get_buffer(void *opaque, uint8_t *buf, int64_t pos, int size)
 141 {
 142     return bdrv_load_vmstate(opaque, buf, pos, size);
 143 }
 144
 145 static int bdrv_fclose(void *opaque)
 146 {
 147     return bdrv_flush(opaque);
 148 }
 149
 150 static const QEMUFileOps bdrv_read_ops = {
 151     .get_buffer = block_get_buffer,
 152     .close =      bdrv_fclose
 153 };
 154
 155 static const QEMUFileOps bdrv_write_ops = {
 156     .put_buffer     = block_put_buffer,
 157     .writev_buffer  = block_writev_buffer,
 158     .close          = bdrv_fclose
 159 };
 160
 161 static QEMUFile *qemu_fopen_bdrv(BlockDriverState *bs, int is_writable)
 162 {
 163     if (is_writable) {
 164         return qemu_fopen_ops(bs, &bdrv_write_ops);
 165     }
 166     return qemu_fopen_ops(bs, &bdrv_read_ops);
 167 }
 168
 169
 170 /* QEMUFile timer support.
 171  * Not in qemu-file.c to not add qemu-timer.c as dependency to qemu-file.c
 172  */
 173
 174 void timer_put(QEMUFile *f, QEMUTimer *ts)
 175 {
 176     uint64_t expire_time;
 177
 178     expire_time = timer_expire_time_ns(ts);
 179     qemu_put_be64(f, expire_time);
 180 }
 181
 182 void timer_get(QEMUFile *f, QEMUTimer *ts)
 183 {
 184     uint64_t expire_time;
 185
 186     expire_time = qemu_get_be64(f);
 187     if (expire_time != -1) {
 188         timer_mod_ns(ts, expire_time);
 189     } else {
 190         timer_del(ts);
 191     }
 192 }
 193
 194
 195 /* VMState timer support.
 196  * Not in vmstate.c to not add qemu-timer.c as dependency to vmstate.c
 197  */
 198
 199 static int get_timer(QEMUFile *f, void *pv, size_t size)
 200 {
 201     QEMUTimer *v = pv;
 202     timer_get(f, v);
 203     return 0;
 204 }
 205
 206 static void put_timer(QEMUFile *f, void *pv, size_t size)
 207 {
 208     QEMUTimer *v = pv;
 209     timer_put(f, v);
 210 }
 211
 212 const VMStateInfo vmstate_info_timer = {
 213     .name = "timer",
 214     .get  = get_timer,
 215     .put  = put_timer,
 216 };
 217
 218
 219 typedef struct CompatEntry {
 220     char idstr[256];
 221     int instance_id;
 222 } CompatEntry;
 223
 224 typedef struct SaveStateEntry {
 225     QTAILQ_ENTRY(SaveStateEntry) entry;
 226     char idstr[256];
 227     int instance_id;
 228     int alias_id;
 229     int version_id;
 230     int section_id;
 231     SaveVMHandlers *ops;
 232     const VMStateDescription *vmsd;
 233     void *opaque;
 234     CompatEntry *compat;
 235     int is_ram;
 236 } SaveStateEntry;
 237
 238
 239 static QTAILQ_HEAD(savevm_handlers, SaveStateEntry) savevm_handlers =
 240     QTAILQ_HEAD_INITIALIZER(savevm_handlers);
 241 static int global_section_id;
 242
 243 static void dump_vmstate_vmsd(FILE *out_file,
 244                               const VMStateDescription *vmsd, int indent,
 245                               bool is_subsection);
 246
 247 static void dump_vmstate_vmsf(FILE *out_file, const VMStateField *field,
 248                               int indent)
 249 {
 250     fprintf(out_file, "%*s{\n", indent, "");
 251     indent += 2;
 252     fprintf(out_file, "%*s\"field\": \"%s\",\n", indent, "", field->name);
 253     fprintf(out_file, "%*s\"version_id\": %d,\n", indent, "",
 254             field->version_id);
 255     fprintf(out_file, "%*s\"field_exists\": %s,\n", indent, "",
 256             field->field_exists ? "true" : "false");
 257     fprintf(out_file, "%*s\"size\": %zu", indent, "", field->size);
 258     if (field->vmsd != NULL) {
 259         fprintf(out_file, ",\n");
 260         dump_vmstate_vmsd(out_file, field->vmsd, indent, false);
 261     }
 262     fprintf(out_file, "\n%*s}", indent - 2, "");
 263 }
 264
 265 static void dump_vmstate_vmss(FILE *out_file,
 266                               const VMStateSubsection *subsection,
 267                               int indent)
 268 {
 269     if (subsection->vmsd != NULL) {
 270         dump_vmstate_vmsd(out_file, subsection->vmsd, indent, true);
 271     }
 272 }
 273
 274 static void dump_vmstate_vmsd(FILE *out_file,
 275                               const VMStateDescription *vmsd, int indent,
 276                               bool is_subsection)
 277 {
 278     if (is_subsection) {
 279         fprintf(out_file, "%*s{\n", indent, "");
 280     } else {
 281         fprintf(out_file, "%*s\"%s\": {\n", indent, "", "Description");
 282     }
 283     indent += 2;
 284     fprintf(out_file, "%*s\"name\": \"%s\",\n", indent, "", vmsd->name);
 285     fprintf(out_file, "%*s\"version_id\": %d,\n", indent, "",
 286             vmsd->version_id);
 287     fprintf(out_file, "%*s\"minimum_version_id\": %d", indent, "",
 288             vmsd->minimum_version_id);
 289     if (vmsd->fields != NULL) {
 290         const VMStateField *field = vmsd->fields;
 291         bool first;
 292
 293         fprintf(out_file, ",\n%*s\"Fields\": [\n", indent, "");
 294         first = true;
 295         while (field->name != NULL) {
 296             if (field->flags & VMS_MUST_EXIST) {
 297                 /* Ignore VMSTATE_VALIDATE bits; these don't get migrated */
 298                 field++;
 299                 continue;
 300             }
 301             if (!first) {
 302                 fprintf(out_file, ",\n");
 303             }
 304             dump_vmstate_vmsf(out_file, field, indent + 2);
 305             field++;
 306             first = false;
 307         }
 308         fprintf(out_file, "\n%*s]", indent, "");
 309     }
 310     if (vmsd->subsections != NULL) {
 311         const VMStateSubsection *subsection = vmsd->subsections;
 312         bool first;
 313
 314         fprintf(out_file, ",\n%*s\"Subsections\": [\n", indent, "");
 315         first = true;
 316         while (subsection->vmsd != NULL) {
 317             if (!first) {
 318                 fprintf(out_file, ",\n");
 319             }
 320             dump_vmstate_vmss(out_file, subsection, indent + 2);
 321             subsection++;
 322             first = false;
 323         }
 324         fprintf(out_file, "\n%*s]", indent, "");
 325     }
 326     fprintf(out_file, "\n%*s}", indent - 2, "");
 327 }
 328
 329 static void dump_machine_type(FILE *out_file)
 330 {
 331     MachineClass *mc;
 332
 333     mc = MACHINE_GET_CLASS(current_machine);
 334
 335     fprintf(out_file, "  \"vmschkmachine\": {\n");
 336     fprintf(out_file, "    \"Name\": \"%s\"\n", mc->name);
 337     fprintf(out_file, "  },\n");
 338 }
 339
 340 void dump_vmstate_json_to_file(FILE *out_file)
 341 {
 342     GSList *list, *elt;
 343     bool first;
 344
 345     fprintf(out_file, "{\n");
 346     dump_machine_type(out_file);
 347
 348     first = true;
 349     list = object_class_get_list(TYPE_DEVICE, true);
 350     for (elt = list; elt; elt = elt->next) {
 351         DeviceClass *dc = OBJECT_CLASS_CHECK(DeviceClass, elt->data,
 352                                              TYPE_DEVICE);
 353         const char *name;
 354         int indent = 2;
 355
 356         if (!dc->vmsd) {
 357             continue;
 358         }
 359
 360         if (!first) {
 361             fprintf(out_file, ",\n");
 362         }
 363         name = object_class_get_name(OBJECT_CLASS(dc));
 364         fprintf(out_file, "%*s\"%s\": {\n", indent, "", name);
 365         indent += 2;
 366         fprintf(out_file, "%*s\"Name\": \"%s\",\n", indent, "", name);
 367         fprintf(out_file, "%*s\"version_id\": %d,\n", indent, "",
 368                 dc->vmsd->version_id);
 369         fprintf(out_file, "%*s\"minimum_version_id\": %d,\n", indent, "",
 370                 dc->vmsd->minimum_version_id);
 371
 372         dump_vmstate_vmsd(out_file, dc->vmsd, indent, false);
 373
 374         fprintf(out_file, "\n%*s}", indent - 2, "");
 375         first = false;
 376     }
 377     fprintf(out_file, "\n}\n");
 378     fclose(out_file);
 379 }
 380
 381 static int calculate_new_instance_id(const char *idstr)
 382 {
 383     SaveStateEntry *se;
 384     int instance_id = 0;
 385
 386     QTAILQ_FOREACH(se, &savevm_handlers, entry) {
 387         if (strcmp(idstr, se->idstr) == 0
 388             && instance_id <= se->instance_id) {
 389             instance_id = se->instance_id + 1;
 390         }
 391     }
 392     return instance_id;
 393 }
 394
 395 static int calculate_compat_instance_id(const char *idstr)
 396 {
 397     SaveStateEntry *se;
 398     int instance_id = 0;
 399
 400     QTAILQ_FOREACH(se, &savevm_handlers, entry) {
 401         if (!se->compat) {
 402             continue;
 403         }
 404
 405         if (strcmp(idstr, se->compat->idstr) == 0
 406             && instance_id <= se->compat->instance_id) {
 407             instance_id = se->compat->instance_id + 1;
 408         }
 409     }
 410     return instance_id;
 411 }
 412
 413 /* TODO: Individual devices generally have very little idea about the rest
 414    of the system, so instance_id should be removed/replaced.
 415    Meanwhile pass -1 as instance_id if you do not already have a clearly
 416    distinguishing id for all instances of your device class. */
 417 int register_savevm_live(DeviceState *dev,
 418                          const char *idstr,
 419                          int instance_id,
 420                          int version_id,
 421                          SaveVMHandlers *ops,
 422                          void *opaque)
 423 {
 424     SaveStateEntry *se;
 425
 426     se = g_malloc0(sizeof(SaveStateEntry));
 427     se->version_id = version_id;
 428     se->section_id = global_section_id++;
 429     se->ops = ops;
 430     se->opaque = opaque;
 431     se->vmsd = NULL;
 432     /* if this is a live_savem then set is_ram */
 433     if (ops->save_live_setup != NULL) {
 434         se->is_ram = 1;
 435     }
 436
 437     if (dev) {
 438         char *id = qdev_get_dev_path(dev);
 439         if (id) {
 440             pstrcpy(se->idstr, sizeof(se->idstr), id);
 441             pstrcat(se->idstr, sizeof(se->idstr), "/");
 442             g_free(id);
 443
 444             se->compat = g_malloc0(sizeof(CompatEntry));
 445             pstrcpy(se->compat->idstr, sizeof(se->compat->idstr), idstr);
 446             se->compat->instance_id = instance_id == -1 ?
 447                          calculate_compat_instance_id(idstr) : instance_id;
 448             instance_id = -1;
 449         }
 450     }
 451     pstrcat(se->idstr, sizeof(se->idstr), idstr);
 452
 453     if (instance_id == -1) {
 454         se->instance_id = calculate_new_instance_id(se->idstr);
 455     } else {
 456         se->instance_id = instance_id;
 457     }
 458     assert(!se->compat || se->instance_id == 0);
 459     /* add at the end of list */
 460     QTAILQ_INSERT_TAIL(&savevm_handlers, se, entry);
 461     return 0;
 462 }
 463
 464 int register_savevm(DeviceState *dev,
 465                     const char *idstr,
 466                     int instance_id,
 467                     int version_id,
 468                     SaveStateHandler *save_state,
 469                     LoadStateHandler *load_state,
 470                     void *opaque)
 471 {
 472     SaveVMHandlers *ops = g_malloc0(sizeof(SaveVMHandlers));
 473     ops->save_state = save_state;
 474     ops->load_state = load_state;
 475     return register_savevm_live(dev, idstr, instance_id, version_id,
 476                                 ops, opaque);
 477 }
 478
 479 void unregister_savevm(DeviceState *dev, const char *idstr, void *opaque)
 480 {
 481     SaveStateEntry *se, *new_se;
 482     char id[256] = "";
 483
 484     if (dev) {
 485         char *path = qdev_get_dev_path(dev);
 486         if (path) {
 487             pstrcpy(id, sizeof(id), path);
 488             pstrcat(id, sizeof(id), "/");
 489             g_free(path);
 490         }
 491     }
 492     pstrcat(id, sizeof(id), idstr);
 493
 494     QTAILQ_FOREACH_SAFE(se, &savevm_handlers, entry, new_se) {
 495         if (strcmp(se->idstr, id) == 0 && se->opaque == opaque) {
 496             QTAILQ_REMOVE(&savevm_handlers, se, entry);
 497             if (se->compat) {
 498                 g_free(se->compat);
 499             }
 500             g_free(se->ops);
 501             g_free(se);
 502         }
 503     }
 504 }
 505
 506 int vmstate_register_with_alias_id(DeviceState *dev, int instance_id,
 507                                    const VMStateDescription *vmsd,
 508                                    void *opaque, int alias_id,
 509                                    int required_for_version)
 510 {
 511     SaveStateEntry *se;
 512
 513     /* If this triggers, alias support can be dropped for the vmsd. */
 514     assert(alias_id == -1 || required_for_version >= vmsd->minimum_version_id);
 515
 516     se = g_malloc0(sizeof(SaveStateEntry));
 517     se->version_id = vmsd->version_id;
 518     se->section_id = global_section_id++;
 519     se->opaque = opaque;
 520     se->vmsd = vmsd;
 521     se->alias_id = alias_id;
 522
 523     if (dev) {
 524         char *id = qdev_get_dev_path(dev);
 525         if (id) {
 526             pstrcpy(se->idstr, sizeof(se->idstr), id);
 527             pstrcat(se->idstr, sizeof(se->idstr), "/");
 528             g_free(id);
 529
 530             se->compat = g_malloc0(sizeof(CompatEntry));
 531             pstrcpy(se->compat->idstr, sizeof(se->compat->idstr), vmsd->name);
 532             se->compat->instance_id = instance_id == -1 ?
 533                          calculate_compat_instance_id(vmsd->name) : instance_id;
 534             instance_id = -1;
 535         }
 536     }
 537     pstrcat(se->idstr, sizeof(se->idstr), vmsd->name);
 538
 539     if (instance_id == -1) {
 540         se->instance_id = calculate_new_instance_id(se->idstr);
 541     } else {
 542         se->instance_id = instance_id;
 543     }
 544     assert(!se->compat || se->instance_id == 0);
 545     /* add at the end of list */
 546     QTAILQ_INSERT_TAIL(&savevm_handlers, se, entry);
 547     return 0;
 548 }
 549
 550 void vmstate_unregister(DeviceState *dev, const VMStateDescription *vmsd,
 551                         void *opaque)
 552 {
 553     SaveStateEntry *se, *new_se;
 554
 555     QTAILQ_FOREACH_SAFE(se, &savevm_handlers, entry, new_se) {
 556         if (se->vmsd == vmsd && se->opaque == opaque) {
 557             QTAILQ_REMOVE(&savevm_handlers, se, entry);
 558             if (se->compat) {
 559                 g_free(se->compat);
 560             }
 561             g_free(se);
 562         }
 563     }
 564 }
 565
 566 static int vmstate_load(QEMUFile *f, SaveStateEntry *se, int version_id)
 567 {
 568     trace_vmstate_load(se->idstr, se->vmsd ? se->vmsd->name : "(old)");
 569     if (!se->vmsd) {         /* Old style */
 570         return se->ops->load_state(f, se->opaque, version_id);
 571     }
 572     return vmstate_load_state(f, se->vmsd, se->opaque, version_id);
 573 }
 574
 575 static void vmstate_save_old_style(QEMUFile *f, SaveStateEntry *se, QJSON *vmdesc)
 576 {
 577     int64_t old_offset, size;
 578
 579     old_offset = qemu_ftell_fast(f);
 580     se->ops->save_state(f, se->opaque);
 581     size = qemu_ftell_fast(f) - old_offset;
 582
 583     if (vmdesc) {
 584         json_prop_int(vmdesc, "size", size);
 585         json_start_array(vmdesc, "fields");
 586         json_start_object(vmdesc, NULL);
 587         json_prop_str(vmdesc, "name", "data");
 588         json_prop_int(vmdesc, "size", size);
 589         json_prop_str(vmdesc, "type", "buffer");
 590         json_end_object(vmdesc);
 591         json_end_array(vmdesc);
 592     }
 593 }
 594
 595 static void vmstate_save(QEMUFile *f, SaveStateEntry *se, QJSON *vmdesc)
 596 {
 597     trace_vmstate_save(se->idstr, se->vmsd ? se->vmsd->name : "(old)");
 598     if (!se->vmsd) {
 599         vmstate_save_old_style(f, se, vmdesc);
 600         return;
 601     }
 602     vmstate_save_state(f, se->vmsd, se->opaque, vmdesc);
 603 }
 604
 605 bool qemu_savevm_state_blocked(Error **errp)
 606 {
 607     SaveStateEntry *se;
 608
 609     QTAILQ_FOREACH(se, &savevm_handlers, entry) {
 610         if (se->vmsd && se->vmsd->unmigratable) {
 611             error_setg(errp, "State blocked by non-migratable device '%s'",
 612                        se->idstr);
 613             return true;
 614         }
 615     }
 616     return false;
 617 }
 618
 619 void qemu_savevm_state_begin(QEMUFile *f,
 620                              const MigrationParams *params)
 621 {
 622     SaveStateEntry *se;
 623     int ret;
 624
 625     trace_savevm_state_begin();
 626     QTAILQ_FOREACH(se, &savevm_handlers, entry) {
 627         if (!se->ops || !se->ops->set_params) {
 628             continue;
 629         }
 630         se->ops->set_params(params, se->opaque);
 631     }
 632
 633     qemu_put_be32(f, QEMU_VM_FILE_MAGIC);
 634     qemu_put_be32(f, QEMU_VM_FILE_VERSION);
 635
 636     QTAILQ_FOREACH(se, &savevm_handlers, entry) {
 637         int len;
 638
 639         if (!se->ops || !se->ops->save_live_setup) {
 640             continue;
 641         }
 642         if (se->ops && se->ops->is_active) {
 643             if (!se->ops->is_active(se->opaque)) {
 644                 continue;
 645             }
 646         }
 647         /* Section type */
 648         qemu_put_byte(f, QEMU_VM_SECTION_START);
 649         qemu_put_be32(f, se->section_id);
 650
 651         /* ID string */
 652         len = strlen(se->idstr);
 653         qemu_put_byte(f, len);
 654         qemu_put_buffer(f, (uint8_t *)se->idstr, len);
 655
 656         qemu_put_be32(f, se->instance_id);
 657         qemu_put_be32(f, se->version_id);
 658
 659         ret = se->ops->save_live_setup(f, se->opaque);
 660         if (ret < 0) {
 661             qemu_file_set_error(f, ret);
 662             break;
 663         }
 664     }
 665 }
 666
 667 /*
 668  * this function has three return values:
 669  *   negative: there was one error, and we have -errno.
 670  *   0 : We haven't finished, caller have to go again
 671  *   1 : We have finished, we can go to complete phase
 672  */
 673 int qemu_savevm_state_iterate(QEMUFile *f)
 674 {
 675     SaveStateEntry *se;
 676     int ret = 1;
 677
 678     trace_savevm_state_iterate();
 679     QTAILQ_FOREACH(se, &savevm_handlers, entry) {
 680         if (!se->ops || !se->ops->save_live_iterate) {
 681             continue;
 682         }
 683         if (se->ops && se->ops->is_active) {
 684             if (!se->ops->is_active(se->opaque)) {
 685                 continue;
 686             }
 687         }
 688         if (qemu_file_rate_limit(f)) {
 689             return 0;
 690         }
 691         trace_savevm_section_start(se->idstr, se->section_id);
 692         /* Section type */
 693         qemu_put_byte(f, QEMU_VM_SECTION_PART);
 694         qemu_put_be32(f, se->section_id);
 695
 696         ret = se->ops->save_live_iterate(f, se->opaque);
 697         trace_savevm_section_end(se->idstr, se->section_id, ret);
 698
 699         if (ret < 0) {
 700             qemu_file_set_error(f, ret);
 701         }
 702         if (ret <= 0) {
 703             /* Do not proceed to the next vmstate before this one reported
 704                completion of the current stage. This serializes the migration
 705                and reduces the probability that a faster changing state is
 706                synchronized over and over again. */
 707             break;
 708         }
 709     }
 710     return ret;
 711 }
 712
 713 void qemu_savevm_state_complete(QEMUFile *f)
 714 {
 715     QJSON *vmdesc;
 716     int vmdesc_len;
 717     SaveStateEntry *se;
 718     int ret;
 719
 720     trace_savevm_state_complete();
 721
 722     cpu_synchronize_all_states();
 723
 724     QTAILQ_FOREACH(se, &savevm_handlers, entry) {
 725         if (!se->ops || !se->ops->save_live_complete) {
 726             continue;
 727         }
 728         if (se->ops && se->ops->is_active) {
 729             if (!se->ops->is_active(se->opaque)) {
 730                 continue;
 731             }
 732         }
 733         trace_savevm_section_start(se->idstr, se->section_id);
 734         /* Section type */
 735         qemu_put_byte(f, QEMU_VM_SECTION_END);
 736         qemu_put_be32(f, se->section_id);
 737
 738         ret = se->ops->save_live_complete(f, se->opaque);
 739         trace_savevm_section_end(se->idstr, se->section_id, ret);
 740         if (ret < 0) {
 741             qemu_file_set_error(f, ret);
 742             return;
 743         }
 744     }
 745
 746     vmdesc = qjson_new();
 747     json_prop_int(vmdesc, "page_size", TARGET_PAGE_SIZE);
 748     json_start_array(vmdesc, "devices");
 749     QTAILQ_FOREACH(se, &savevm_handlers, entry) {
 750         int len;
 751
 752         if ((!se->ops || !se->ops->save_state) && !se->vmsd) {
 753             continue;
 754         }
 755         trace_savevm_section_start(se->idstr, se->section_id);
 756
 757         json_start_object(vmdesc, NULL);
 758         json_prop_str(vmdesc, "name", se->idstr);
 759         json_prop_int(vmdesc, "instance_id", se->instance_id);
 760
 761         /* Section type */
 762         qemu_put_byte(f, QEMU_VM_SECTION_FULL);
 763         qemu_put_be32(f, se->section_id);
 764
 765         /* ID string */
 766         len = strlen(se->idstr);
 767         qemu_put_byte(f, len);
 768         qemu_put_buffer(f, (uint8_t *)se->idstr, len);
 769
 770         qemu_put_be32(f, se->instance_id);
 771         qemu_put_be32(f, se->version_id);
 772
 773         vmstate_save(f, se, vmdesc);
 774
 775         json_end_object(vmdesc);
 776         trace_savevm_section_end(se->idstr, se->section_id, 0);
 777     }
 778
 779     qemu_put_byte(f, QEMU_VM_EOF);
 780
 781     json_end_array(vmdesc);
 782     qjson_finish(vmdesc);
 783     vmdesc_len = strlen(qjson_get_str(vmdesc));
 784
 785     qemu_put_byte(f, QEMU_VM_VMDESCRIPTION);
 786     qemu_put_be32(f, vmdesc_len);
 787     qemu_put_buffer(f, (uint8_t *)qjson_get_str(vmdesc), vmdesc_len);
 788     object_unref(OBJECT(vmdesc));
 789
 790     qemu_fflush(f);
 791 }
 792
 793 uint64_t qemu_savevm_state_pending(QEMUFile *f, uint64_t max_size)
 794 {
 795     SaveStateEntry *se;
 796     uint64_t ret = 0;
 797
 798     QTAILQ_FOREACH(se, &savevm_handlers, entry) {
 799         if (!se->ops || !se->ops->save_live_pending) {
 800             continue;
 801         }
 802         if (se->ops && se->ops->is_active) {
 803             if (!se->ops->is_active(se->opaque)) {
 804                 continue;
 805             }
 806         }
 807         ret += se->ops->save_live_pending(f, se->opaque, max_size);
 808     }
 809     return ret;
 810 }
 811
 812 void qemu_savevm_state_cancel(void)
 813 {
 814     SaveStateEntry *se;
 815
 816     trace_savevm_state_cancel();
 817     QTAILQ_FOREACH(se, &savevm_handlers, entry) {
 818         if (se->ops && se->ops->cancel) {
 819             se->ops->cancel(se->opaque);
 820         }
 821     }
 822 }
 823
 824 static int qemu_savevm_state(QEMUFile *f)
 825 {
 826     int ret;
 827     MigrationParams params = {
 828         .blk = 0,
 829         .shared = 0
 830     };
 831
 832     if (qemu_savevm_state_blocked(NULL)) {
 833         return -EINVAL;
 834     }
 835
 836     qemu_mutex_unlock_iothread();
 837     qemu_savevm_state_begin(f, &params);
 838     qemu_mutex_lock_iothread();
 839
 840     while (qemu_file_get_error(f) == 0) {
 841         if (qemu_savevm_state_iterate(f) > 0) {
 842             break;
 843         }
 844     }
 845
 846     ret = qemu_file_get_error(f);
 847     if (ret == 0) {
 848         qemu_savevm_state_complete(f);
 849         ret = qemu_file_get_error(f);
 850     }
 851     if (ret != 0) {
 852         qemu_savevm_state_cancel();
 853     }
 854     return ret;
 855 }
 856
 857 static int qemu_save_device_state(QEMUFile *f)
 858 {
 859     SaveStateEntry *se;
 860
 861     qemu_put_be32(f, QEMU_VM_FILE_MAGIC);
 862     qemu_put_be32(f, QEMU_VM_FILE_VERSION);
 863
 864     cpu_synchronize_all_states();
 865
 866     QTAILQ_FOREACH(se, &savevm_handlers, entry) {
 867         int len;
 868
 869         if (se->is_ram) {
 870             continue;
 871         }
 872         if ((!se->ops || !se->ops->save_state) && !se->vmsd) {
 873             continue;
 874         }
 875
 876         /* Section type */
 877         qemu_put_byte(f, QEMU_VM_SECTION_FULL);
 878         qemu_put_be32(f, se->section_id);
 879
 880         /* ID string */
 881         len = strlen(se->idstr);
 882         qemu_put_byte(f, len);
 883         qemu_put_buffer(f, (uint8_t *)se->idstr, len);
 884
 885         qemu_put_be32(f, se->instance_id);
 886         qemu_put_be32(f, se->version_id);
 887
 888         vmstate_save(f, se, NULL);
 889     }
 890
 891     qemu_put_byte(f, QEMU_VM_EOF);
 892
 893     return qemu_file_get_error(f);
 894 }
 895
 896 static SaveStateEntry *find_se(const char *idstr, int instance_id)
 897 {
 898     SaveStateEntry *se;
 899
 900     QTAILQ_FOREACH(se, &savevm_handlers, entry) {
 901         if (!strcmp(se->idstr, idstr) &&
 902             (instance_id == se->instance_id ||
 903              instance_id == se->alias_id))
 904             return se;
 905         /* Migrating from an older version? */
 906         if (strstr(se->idstr, idstr) && se->compat) {
 907             if (!strcmp(se->compat->idstr, idstr) &&
 908                 (instance_id == se->compat->instance_id ||
 909                  instance_id == se->alias_id))
 910                 return se;
 911         }
 912     }
 913     return NULL;
 914 }
 915
 916 typedef struct LoadStateEntry {
 917     QLIST_ENTRY(LoadStateEntry) entry;
 918     SaveStateEntry *se;
 919     int section_id;
 920     int version_id;
 921 } LoadStateEntry;
 922
 923 int qemu_loadvm_state(QEMUFile *f)
 924 {
 925     QLIST_HEAD(, LoadStateEntry) loadvm_handlers =
 926         QLIST_HEAD_INITIALIZER(loadvm_handlers);
 927     LoadStateEntry *le, *new_le;
 928     Error *local_err = NULL;
 929     uint8_t section_type;
 930     unsigned int v;
 931     int ret;
 932
 933     if (qemu_savevm_state_blocked(&local_err)) {
 934         error_report("%s", error_get_pretty(local_err));
 935         error_free(local_err);
 936         return -EINVAL;
 937     }
 938
 939     v = qemu_get_be32(f);
 940     if (v != QEMU_VM_FILE_MAGIC) {
 941         error_report("Not a migration stream");
 942         return -EINVAL;
 943     }
 944
 945     v = qemu_get_be32(f);
 946     if (v == QEMU_VM_FILE_VERSION_COMPAT) {
 947         error_report("SaveVM v2 format is obsolete and don't work anymore");
 948         return -ENOTSUP;
 949     }
 950     if (v != QEMU_VM_FILE_VERSION) {
 951         error_report("Unsupported migration stream version");
 952         return -ENOTSUP;
 953     }
 954
 955     while ((section_type = qemu_get_byte(f)) != QEMU_VM_EOF) {
 956         uint32_t instance_id, version_id, section_id;
 957         SaveStateEntry *se;
 958         char idstr[257];
 959         int len;
 960
 961         trace_qemu_loadvm_state_section(section_type);
 962         switch (section_type) {
 963         case QEMU_VM_SECTION_START:
 964         case QEMU_VM_SECTION_FULL:
 965             /* Read section start */
 966             section_id = qemu_get_be32(f);
 967             len = qemu_get_byte(f);
 968             qemu_get_buffer(f, (uint8_t *)idstr, len);
 969             idstr[len] = 0;
 970             instance_id = qemu_get_be32(f);
 971             version_id = qemu_get_be32(f);
 972
 973             trace_qemu_loadvm_state_section_startfull(section_id, idstr,
 974                                                       instance_id, version_id);
 975             /* Find savevm section */
 976             se = find_se(idstr, instance_id);
 977             if (se == NULL) {
 978                 error_report("Unknown savevm section or instance '%s' %d",
 979                              idstr, instance_id);
 980                 ret = -EINVAL;
 981                 goto out;
 982             }
 983
 984             /* Validate version */
 985             if (version_id > se->version_id) {
 986                 error_report("savevm: unsupported version %d for '%s' v%d",
 987                              version_id, idstr, se->version_id);
 988                 ret = -EINVAL;
 989                 goto out;
 990             }
 991
 992             /* Add entry */
 993             le = g_malloc0(sizeof(*le));
 994
 995             le->se = se;
 996             le->section_id = section_id;
 997             le->version_id = version_id;
 998             QLIST_INSERT_HEAD(&loadvm_handlers, le, entry);
 999
1000             ret = vmstate_load(f, le->se, le->version_id);
1001             if (ret < 0) {
1002                 error_report("error while loading state for instance 0x%x of"
1003                              " device '%s'", instance_id, idstr);
1004                 goto out;
1005             }
1006             break;
1007         case QEMU_VM_SECTION_PART:
1008         case QEMU_VM_SECTION_END:
1009             section_id = qemu_get_be32(f);
1010
1011             trace_qemu_loadvm_state_section_partend(section_id);
1012             QLIST_FOREACH(le, &loadvm_handlers, entry) {
1013                 if (le->section_id == section_id) {
1014                     break;
1015                 }
1016             }
1017             if (le == NULL) {
1018                 error_report("Unknown savevm section %d", section_id);
1019                 ret = -EINVAL;
1020                 goto out;
1021             }
1022
1023             ret = vmstate_load(f, le->se, le->version_id);
1024             if (ret < 0) {
1025                 error_report("error while loading state section id %d(%s)",
1026                              section_id, le->se->idstr);
1027                 goto out;
1028             }
1029             break;
1030         default:
1031             error_report("Unknown savevm section type %d", section_type);
1032             ret = -EINVAL;
1033             goto out;
1034         }
1035     }
1036
1037     cpu_synchronize_all_post_init();
1038
1039     ret = 0;
1040
1041 out:
1042     QLIST_FOREACH_SAFE(le, &loadvm_handlers, entry, new_le) {
1043         QLIST_REMOVE(le, entry);
1044         g_free(le);
1045     }
1046
1047     if (ret == 0) {
1048         ret = qemu_file_get_error(f);
1049     }
1050
1051     return ret;
1052 }
1053
1054 static BlockDriverState *find_vmstate_bs(void)
1055 {
1056     BlockDriverState *bs = NULL;
1057     while ((bs = bdrv_next(bs))) {
1058         if (bdrv_can_snapshot(bs)) {
1059             return bs;
1060         }
1061     }
1062     return NULL;
1063 }
1064
1065 /*
1066  * Deletes snapshots of a given name in all opened images.
1067  */
1068 static int del_existing_snapshots(Monitor *mon, const char *name)
1069 {
1070     BlockDriverState *bs;
1071     QEMUSnapshotInfo sn1, *snapshot = &sn1;
1072     Error *err = NULL;
1073
1074     bs = NULL;
1075     while ((bs = bdrv_next(bs))) {
1076         if (bdrv_can_snapshot(bs) &&
1077             bdrv_snapshot_find(bs, snapshot, name) >= 0) {
1078             bdrv_snapshot_delete_by_id_or_name(bs, name, &err);
1079             if (err) {
1080                 monitor_printf(mon,
1081                                "Error while deleting snapshot on device '%s':"
1082                                " %s\n",
1083                                bdrv_get_device_name(bs),
1084                                error_get_pretty(err));
1085                 error_free(err);
1086                 return -1;
1087             }
1088         }
1089     }
1090
1091     return 0;
1092 }
1093
1094 void do_savevm(Monitor *mon, const QDict *qdict)
1095 {
1096     BlockDriverState *bs, *bs1;
1097     QEMUSnapshotInfo sn1, *sn = &sn1, old_sn1, *old_sn = &old_sn1;
1098     int ret;
1099     QEMUFile *f;
1100     int saved_vm_running;
1101     uint64_t vm_state_size;
1102     qemu_timeval tv;
1103     struct tm tm;
1104     const char *name = qdict_get_try_str(qdict, "name");
1105
1106     /* Verify if there is a device that doesn't support snapshots and is writable */
1107     bs = NULL;
1108     while ((bs = bdrv_next(bs))) {
1109
1110         if (!bdrv_is_inserted(bs) || bdrv_is_read_only(bs)) {
1111             continue;
1112         }
1113
1114         if (!bdrv_can_snapshot(bs)) {
1115             monitor_printf(mon, "Device '%s' is writable but does not support snapshots.\n",
1116                                bdrv_get_device_name(bs));
1117             return;
1118         }
1119     }
1120
1121     bs = find_vmstate_bs();
1122     if (!bs) {
1123         monitor_printf(mon, "No block device can accept snapshots\n");
1124         return;
1125     }
1126
1127     saved_vm_running = runstate_is_running();
1128     vm_stop(RUN_STATE_SAVE_VM);
1129
1130     memset(sn, 0, sizeof(*sn));
1131
1132     /* fill auxiliary fields */
1133     qemu_gettimeofday(&tv);
1134     sn->date_sec = tv.tv_sec;
1135     sn->date_nsec = tv.tv_usec * 1000;
1136     sn->vm_clock_nsec = qemu_clock_get_ns(QEMU_CLOCK_VIRTUAL);
1137
1138     if (name) {
1139         ret = bdrv_snapshot_find(bs, old_sn, name);
1140         if (ret >= 0) {
1141             pstrcpy(sn->name, sizeof(sn->name), old_sn->name);
1142             pstrcpy(sn->id_str, sizeof(sn->id_str), old_sn->id_str);
1143         } else {
1144             pstrcpy(sn->name, sizeof(sn->name), name);
1145         }
1146     } else {
1147         /* cast below needed for OpenBSD where tv_sec is still 'long' */
1148         localtime_r((const time_t *)&tv.tv_sec, &tm);
1149         strftime(sn->name, sizeof(sn->name), "vm-%Y%m%d%H%M%S", &tm);
1150     }
1151
1152     /* Delete old snapshots of the same name */
1153     if (name && del_existing_snapshots(mon, name) < 0) {
1154         goto the_end;
1155     }
1156
1157     /* save the VM state */
1158     f = qemu_fopen_bdrv(bs, 1);
1159     if (!f) {
1160         monitor_printf(mon, "Could not open VM state file\n");
1161         goto the_end;
1162     }
1163     ret = qemu_savevm_state(f);
1164     vm_state_size = qemu_ftell(f);
1165     qemu_fclose(f);
1166     if (ret < 0) {
1167         monitor_printf(mon, "Error %d while writing VM\n", ret);
1168         goto the_end;
1169     }
1170
1171     /* create the snapshots */
1172
1173     bs1 = NULL;
1174     while ((bs1 = bdrv_next(bs1))) {
1175         if (bdrv_can_snapshot(bs1)) {
1176             /* Write VM state size only to the image that contains the state */
1177             sn->vm_state_size = (bs == bs1 ? vm_state_size : 0);
1178             ret = bdrv_snapshot_create(bs1, sn);
1179             if (ret < 0) {
1180                 monitor_printf(mon, "Error while creating snapshot on '%s'\n",
1181                                bdrv_get_device_name(bs1));
1182             }
1183         }
1184     }
1185
1186  the_end:
1187     if (saved_vm_running) {
1188         vm_start();
1189     }
1190 }
1191
1192 void qmp_xen_save_devices_state(const char *filename, Error **errp)
1193 {
1194     QEMUFile *f;
1195     int saved_vm_running;
1196     int ret;
1197
1198     saved_vm_running = runstate_is_running();
1199     vm_stop(RUN_STATE_SAVE_VM);
1200
1201     f = qemu_fopen(filename, "wb");
1202     if (!f) {
1203         error_setg_file_open(errp, errno, filename);
1204         goto the_end;
1205     }
1206     ret = qemu_save_device_state(f);
1207     qemu_fclose(f);
1208     if (ret < 0) {
1209         error_set(errp, QERR_IO_ERROR);
1210     }
1211
1212  the_end:
1213     if (saved_vm_running) {
1214         vm_start();
1215     }
1216 }
1217
1218 int load_vmstate(const char *name)
1219 {
1220     BlockDriverState *bs, *bs_vm_state;
1221     QEMUSnapshotInfo sn;
1222     QEMUFile *f;
1223     int ret;
1224
1225     bs_vm_state = find_vmstate_bs();
1226     if (!bs_vm_state) {
1227         error_report("No block device supports snapshots");
1228         return -ENOTSUP;
1229     }
1230
1231     /* Don't even try to load empty VM states */
1232     ret = bdrv_snapshot_find(bs_vm_state, &sn, name);
1233     if (ret < 0) {
1234         return ret;
1235     } else if (sn.vm_state_size == 0) {
1236         error_report("This is a disk-only snapshot. Revert to it offline "
1237             "using qemu-img.");
1238         return -EINVAL;
1239     }
1240
1241     /* Verify if there is any device that doesn't support snapshots and is
1242     writable and check if the requested snapshot is available too. */
1243     bs = NULL;
1244     while ((bs = bdrv_next(bs))) {
1245
1246         if (!bdrv_is_inserted(bs) || bdrv_is_read_only(bs)) {
1247             continue;
1248         }
1249
1250         if (!bdrv_can_snapshot(bs)) {
1251             error_report("Device '%s' is writable but does not support snapshots.",
1252                                bdrv_get_device_name(bs));
1253             return -ENOTSUP;
1254         }
1255
1256         ret = bdrv_snapshot_find(bs, &sn, name);
1257         if (ret < 0) {
1258             error_report("Device '%s' does not have the requested snapshot '%s'",
1259                            bdrv_get_device_name(bs), name);
1260             return ret;
1261         }
1262     }
1263
1264     /* Flush all IO requests so they don't interfere with the new state.  */
1265     bdrv_drain_all();
1266
1267     bs = NULL;
1268     while ((bs = bdrv_next(bs))) {
1269         if (bdrv_can_snapshot(bs)) {
1270             ret = bdrv_snapshot_goto(bs, name);
1271             if (ret < 0) {
1272                 error_report("Error %d while activating snapshot '%s' on '%s'",
1273                              ret, name, bdrv_get_device_name(bs));
1274                 return ret;
1275             }
1276         }
1277     }
1278
1279     /* restore the VM state */
1280     f = qemu_fopen_bdrv(bs_vm_state, 0);
1281     if (!f) {
1282         error_report("Could not open VM state file");
1283         return -EINVAL;
1284     }
1285
1286     qemu_system_reset(VMRESET_SILENT);
1287     ret = qemu_loadvm_state(f);
1288
1289     qemu_fclose(f);
1290     if (ret < 0) {
1291         error_report("Error %d while loading VM state", ret);
1292         return ret;
1293     }
1294
1295     return 0;
1296 }
1297
1298 void do_delvm(Monitor *mon, const QDict *qdict)
1299 {
1300     BlockDriverState *bs;
1301     Error *err;
1302     const char *name = qdict_get_str(qdict, "name");
1303
1304     if (!find_vmstate_bs()) {
1305         monitor_printf(mon, "No block device supports snapshots\n");
1306         return;
1307     }
1308
1309     bs = NULL;
1310     while ((bs = bdrv_next(bs))) {
1311         if (bdrv_can_snapshot(bs)) {
1312             err = NULL;
1313             bdrv_snapshot_delete_by_id_or_name(bs, name, &err);
1314             if (err) {
1315                 monitor_printf(mon,
1316                                "Error while deleting snapshot on device '%s':"
1317                                " %s\n",
1318                                bdrv_get_device_name(bs),
1319                                error_get_pretty(err));
1320                 error_free(err);
1321             }
1322         }
1323     }
1324 }
1325
1326 void do_info_snapshots(Monitor *mon, const QDict *qdict)
1327 {
1328     BlockDriverState *bs, *bs1;
1329     QEMUSnapshotInfo *sn_tab, *sn, s, *sn_info = &s;
1330     int nb_sns, i, ret, available;
1331     int total;
1332     int *available_snapshots;
1333
1334     bs = find_vmstate_bs();
1335     if (!bs) {
1336         monitor_printf(mon, "No available block device supports snapshots\n");
1337         return;
1338     }
1339
1340     nb_sns = bdrv_snapshot_list(bs, &sn_tab);
1341     if (nb_sns < 0) {
1342         monitor_printf(mon, "bdrv_snapshot_list: error %d\n", nb_sns);
1343         return;
1344     }
1345
1346     if (nb_sns == 0) {
1347         monitor_printf(mon, "There is no snapshot available.\n");
1348         return;
1349     }
1350
1351     available_snapshots = g_malloc0(sizeof(int) * nb_sns);
1352     total = 0;
1353     for (i = 0; i < nb_sns; i++) {
1354         sn = &sn_tab[i];
1355         available = 1;
1356         bs1 = NULL;
1357
1358         while ((bs1 = bdrv_next(bs1))) {
1359             if (bdrv_can_snapshot(bs1) && bs1 != bs) {
1360                 ret = bdrv_snapshot_find(bs1, sn_info, sn->id_str);
1361                 if (ret < 0) {
1362                     available = 0;
1363                     break;
1364                 }
1365             }
1366         }
1367
1368         if (available) {
1369             available_snapshots[total] = i;
1370             total++;
1371         }
1372     }
1373
1374     if (total > 0) {
1375         bdrv_snapshot_dump((fprintf_function)monitor_printf, mon, NULL);
1376         monitor_printf(mon, "\n");
1377         for (i = 0; i < total; i++) {
1378             sn = &sn_tab[available_snapshots[i]];
1379             bdrv_snapshot_dump((fprintf_function)monitor_printf, mon, sn);
1380             monitor_printf(mon, "\n");
1381         }
1382     } else {
1383         monitor_printf(mon, "There is no suitable snapshot available\n");
1384     }
1385
1386     g_free(sn_tab);
1387     g_free(available_snapshots);
1388
1389 }
1390
1391 void vmstate_register_ram(MemoryRegion *mr, DeviceState *dev)
1392 {
1393     qemu_ram_set_idstr(memory_region_get_ram_addr(mr) & TARGET_PAGE_MASK,
1394                        memory_region_name(mr), dev);
1395 }
1396
1397 void vmstate_unregister_ram(MemoryRegion *mr, DeviceState *dev)
1398 {
1399     qemu_ram_unset_idstr(memory_region_get_ram_addr(mr) & TARGET_PAGE_MASK);
1400 }
1401
1402 void vmstate_register_ram_global(MemoryRegion *mr)
1403 {
1404     vmstate_register_ram(mr, NULL);
1405 }