4 * Copyright (c) 2003-2008 Fabrice Bellard
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:
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
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
32 /* Needed early for CONFIG_BSD etc. */
33 #include "config-host.h"
36 #include <sys/times.h>
40 #include <sys/ioctl.h>
41 #include <sys/resource.h>
42 #include <sys/socket.h>
43 #include <netinet/in.h>
45 #include <arpa/inet.h>
48 #include <sys/select.h>
51 #if defined(__FreeBSD__) || defined(__FreeBSD_kernel__) || defined(__DragonFly__)
59 #include <linux/rtc.h>
67 #include <sys/timeb.h>
69 #define getopt_long_only getopt_long
70 #define memalign(align, size) malloc(size)
73 #include "qemu-common.h"
79 #include "qemu-timer.h"
80 #include "qemu-char.h"
82 #include "audio/audio.h"
83 #include "migration.h"
84 #include "qemu_socket.h"
85 #include "qemu-queue.h"
87 #define SELF_ANNOUNCE_ROUNDS 5
90 #define ETH_P_RARP 0x8035
92 #define ARP_HTYPE_ETH 0x0001
93 #define ARP_PTYPE_IP 0x0800
94 #define ARP_OP_REQUEST_REV 0x3
96 static int announce_self_create(uint8_t *buf
,
99 /* Ethernet header. */
100 memset(buf
, 0xff, 6); /* destination MAC addr */
101 memcpy(buf
+ 6, mac_addr
, 6); /* source MAC addr */
102 *(uint16_t *)(buf
+ 12) = htons(ETH_P_RARP
); /* ethertype */
105 *(uint16_t *)(buf
+ 14) = htons(ARP_HTYPE_ETH
); /* hardware addr space */
106 *(uint16_t *)(buf
+ 16) = htons(ARP_PTYPE_IP
); /* protocol addr space */
107 *(buf
+ 18) = 6; /* hardware addr length (ethernet) */
108 *(buf
+ 19) = 4; /* protocol addr length (IPv4) */
109 *(uint16_t *)(buf
+ 20) = htons(ARP_OP_REQUEST_REV
); /* opcode */
110 memcpy(buf
+ 22, mac_addr
, 6); /* source hw addr */
111 memset(buf
+ 28, 0x00, 4); /* source protocol addr */
112 memcpy(buf
+ 32, mac_addr
, 6); /* target hw addr */
113 memset(buf
+ 38, 0x00, 4); /* target protocol addr */
115 /* Padding to get up to 60 bytes (ethernet min packet size, minus FCS). */
116 memset(buf
+ 42, 0x00, 18);
118 return 60; /* len (FCS will be added by hardware) */
121 static void qemu_announce_self_iter(NICState
*nic
, void *opaque
)
126 len
= announce_self_create(buf
, nic
->conf
->macaddr
.a
);
128 qemu_send_packet_raw(&nic
->nc
, buf
, len
);
132 static void qemu_announce_self_once(void *opaque
)
134 static int count
= SELF_ANNOUNCE_ROUNDS
;
135 QEMUTimer
*timer
= *(QEMUTimer
**)opaque
;
137 qemu_foreach_nic(qemu_announce_self_iter
, NULL
);
140 /* delay 50ms, 150ms, 250ms, ... */
141 qemu_mod_timer(timer
, qemu_get_clock(rt_clock
) +
142 50 + (SELF_ANNOUNCE_ROUNDS
- count
- 1) * 100);
144 qemu_del_timer(timer
);
145 qemu_free_timer(timer
);
149 void qemu_announce_self(void)
151 static QEMUTimer
*timer
;
152 timer
= qemu_new_timer(rt_clock
, qemu_announce_self_once
, &timer
);
153 qemu_announce_self_once(&timer
);
156 /***********************************************************/
157 /* savevm/loadvm support */
159 #define IO_BUF_SIZE 32768
162 QEMUFilePutBufferFunc
*put_buffer
;
163 QEMUFileGetBufferFunc
*get_buffer
;
164 QEMUFileCloseFunc
*close
;
165 QEMUFileRateLimit
*rate_limit
;
166 QEMUFileSetRateLimit
*set_rate_limit
;
167 QEMUFileGetRateLimit
*get_rate_limit
;
171 int64_t buf_offset
; /* start of buffer when writing, end of buffer
174 int buf_size
; /* 0 when writing */
175 uint8_t buf
[IO_BUF_SIZE
];
180 typedef struct QEMUFileStdio
186 typedef struct QEMUFileSocket
192 static int socket_get_buffer(void *opaque
, uint8_t *buf
, int64_t pos
, int size
)
194 QEMUFileSocket
*s
= opaque
;
198 len
= recv(s
->fd
, (void *)buf
, size
, 0);
199 } while (len
== -1 && socket_error() == EINTR
);
202 len
= -socket_error();
207 static int socket_close(void *opaque
)
209 QEMUFileSocket
*s
= opaque
;
214 static int stdio_put_buffer(void *opaque
, const uint8_t *buf
, int64_t pos
, int size
)
216 QEMUFileStdio
*s
= opaque
;
217 return fwrite(buf
, 1, size
, s
->stdio_file
);
220 static int stdio_get_buffer(void *opaque
, uint8_t *buf
, int64_t pos
, int size
)
222 QEMUFileStdio
*s
= opaque
;
223 FILE *fp
= s
->stdio_file
;
228 bytes
= fread(buf
, 1, size
, fp
);
229 } while ((bytes
== 0) && ferror(fp
) && (errno
== EINTR
));
233 static int stdio_pclose(void *opaque
)
235 QEMUFileStdio
*s
= opaque
;
237 ret
= pclose(s
->stdio_file
);
242 static int stdio_fclose(void *opaque
)
244 QEMUFileStdio
*s
= opaque
;
245 fclose(s
->stdio_file
);
250 QEMUFile
*qemu_popen(FILE *stdio_file
, const char *mode
)
254 if (stdio_file
== NULL
|| mode
== NULL
|| (mode
[0] != 'r' && mode
[0] != 'w') || mode
[1] != 0) {
255 fprintf(stderr
, "qemu_popen: Argument validity check failed\n");
259 s
= qemu_mallocz(sizeof(QEMUFileStdio
));
261 s
->stdio_file
= stdio_file
;
264 s
->file
= qemu_fopen_ops(s
, NULL
, stdio_get_buffer
, stdio_pclose
,
267 s
->file
= qemu_fopen_ops(s
, stdio_put_buffer
, NULL
, stdio_pclose
,
273 QEMUFile
*qemu_popen_cmd(const char *command
, const char *mode
)
277 popen_file
= popen(command
, mode
);
278 if(popen_file
== NULL
) {
282 return qemu_popen(popen_file
, mode
);
285 int qemu_stdio_fd(QEMUFile
*f
)
290 p
= (QEMUFileStdio
*)f
->opaque
;
291 fd
= fileno(p
->stdio_file
);
296 QEMUFile
*qemu_fdopen(int fd
, const char *mode
)
301 (mode
[0] != 'r' && mode
[0] != 'w') ||
302 mode
[1] != 'b' || mode
[2] != 0) {
303 fprintf(stderr
, "qemu_fdopen: Argument validity check failed\n");
307 s
= qemu_mallocz(sizeof(QEMUFileStdio
));
308 s
->stdio_file
= fdopen(fd
, mode
);
313 s
->file
= qemu_fopen_ops(s
, NULL
, stdio_get_buffer
, stdio_fclose
,
316 s
->file
= qemu_fopen_ops(s
, stdio_put_buffer
, NULL
, stdio_fclose
,
326 QEMUFile
*qemu_fopen_socket(int fd
)
328 QEMUFileSocket
*s
= qemu_mallocz(sizeof(QEMUFileSocket
));
331 s
->file
= qemu_fopen_ops(s
, NULL
, socket_get_buffer
, socket_close
,
336 static int file_put_buffer(void *opaque
, const uint8_t *buf
,
337 int64_t pos
, int size
)
339 QEMUFileStdio
*s
= opaque
;
340 fseek(s
->stdio_file
, pos
, SEEK_SET
);
341 return fwrite(buf
, 1, size
, s
->stdio_file
);
344 static int file_get_buffer(void *opaque
, uint8_t *buf
, int64_t pos
, int size
)
346 QEMUFileStdio
*s
= opaque
;
347 fseek(s
->stdio_file
, pos
, SEEK_SET
);
348 return fread(buf
, 1, size
, s
->stdio_file
);
351 QEMUFile
*qemu_fopen(const char *filename
, const char *mode
)
356 (mode
[0] != 'r' && mode
[0] != 'w') ||
357 mode
[1] != 'b' || mode
[2] != 0) {
358 fprintf(stderr
, "qemu_fopen: Argument validity check failed\n");
362 s
= qemu_mallocz(sizeof(QEMUFileStdio
));
364 s
->stdio_file
= fopen(filename
, mode
);
369 s
->file
= qemu_fopen_ops(s
, file_put_buffer
, NULL
, stdio_fclose
,
372 s
->file
= qemu_fopen_ops(s
, NULL
, file_get_buffer
, stdio_fclose
,
381 static int block_put_buffer(void *opaque
, const uint8_t *buf
,
382 int64_t pos
, int size
)
384 bdrv_save_vmstate(opaque
, buf
, pos
, size
);
388 static int block_get_buffer(void *opaque
, uint8_t *buf
, int64_t pos
, int size
)
390 return bdrv_load_vmstate(opaque
, buf
, pos
, size
);
393 static int bdrv_fclose(void *opaque
)
398 static QEMUFile
*qemu_fopen_bdrv(BlockDriverState
*bs
, int is_writable
)
401 return qemu_fopen_ops(bs
, block_put_buffer
, NULL
, bdrv_fclose
,
403 return qemu_fopen_ops(bs
, NULL
, block_get_buffer
, bdrv_fclose
, NULL
, NULL
, NULL
);
406 QEMUFile
*qemu_fopen_ops(void *opaque
, QEMUFilePutBufferFunc
*put_buffer
,
407 QEMUFileGetBufferFunc
*get_buffer
,
408 QEMUFileCloseFunc
*close
,
409 QEMUFileRateLimit
*rate_limit
,
410 QEMUFileSetRateLimit
*set_rate_limit
,
411 QEMUFileGetRateLimit
*get_rate_limit
)
415 f
= qemu_mallocz(sizeof(QEMUFile
));
418 f
->put_buffer
= put_buffer
;
419 f
->get_buffer
= get_buffer
;
421 f
->rate_limit
= rate_limit
;
422 f
->set_rate_limit
= set_rate_limit
;
423 f
->get_rate_limit
= get_rate_limit
;
429 int qemu_file_has_error(QEMUFile
*f
)
434 void qemu_file_set_error(QEMUFile
*f
)
439 void qemu_fflush(QEMUFile
*f
)
444 if (f
->is_write
&& f
->buf_index
> 0) {
447 len
= f
->put_buffer(f
->opaque
, f
->buf
, f
->buf_offset
, f
->buf_index
);
449 f
->buf_offset
+= f
->buf_index
;
456 static void qemu_fill_buffer(QEMUFile
*f
)
466 len
= f
->get_buffer(f
->opaque
, f
->buf
, f
->buf_offset
, IO_BUF_SIZE
);
470 f
->buf_offset
+= len
;
471 } else if (len
!= -EAGAIN
)
475 int qemu_fclose(QEMUFile
*f
)
480 ret
= f
->close(f
->opaque
);
485 void qemu_file_put_notify(QEMUFile
*f
)
487 f
->put_buffer(f
->opaque
, NULL
, 0, 0);
490 void qemu_put_buffer(QEMUFile
*f
, const uint8_t *buf
, int size
)
494 if (!f
->has_error
&& f
->is_write
== 0 && f
->buf_index
> 0) {
496 "Attempted to write to buffer while read buffer is not empty\n");
500 while (!f
->has_error
&& size
> 0) {
501 l
= IO_BUF_SIZE
- f
->buf_index
;
504 memcpy(f
->buf
+ f
->buf_index
, buf
, l
);
509 if (f
->buf_index
>= IO_BUF_SIZE
)
514 void qemu_put_byte(QEMUFile
*f
, int v
)
516 if (!f
->has_error
&& f
->is_write
== 0 && f
->buf_index
> 0) {
518 "Attempted to write to buffer while read buffer is not empty\n");
522 f
->buf
[f
->buf_index
++] = v
;
524 if (f
->buf_index
>= IO_BUF_SIZE
)
528 int qemu_get_buffer(QEMUFile
*f
, uint8_t *buf
, int size1
)
537 l
= f
->buf_size
- f
->buf_index
;
540 l
= f
->buf_size
- f
->buf_index
;
546 memcpy(buf
, f
->buf
+ f
->buf_index
, l
);
554 int qemu_get_byte(QEMUFile
*f
)
559 if (f
->buf_index
>= f
->buf_size
) {
561 if (f
->buf_index
>= f
->buf_size
)
564 return f
->buf
[f
->buf_index
++];
567 int64_t qemu_ftell(QEMUFile
*f
)
569 return f
->buf_offset
- f
->buf_size
+ f
->buf_index
;
572 int64_t qemu_fseek(QEMUFile
*f
, int64_t pos
, int whence
)
574 if (whence
== SEEK_SET
) {
576 } else if (whence
== SEEK_CUR
) {
577 pos
+= qemu_ftell(f
);
579 /* SEEK_END not supported */
593 int qemu_file_rate_limit(QEMUFile
*f
)
596 return f
->rate_limit(f
->opaque
);
601 size_t qemu_file_get_rate_limit(QEMUFile
*f
)
603 if (f
->get_rate_limit
)
604 return f
->get_rate_limit(f
->opaque
);
609 size_t qemu_file_set_rate_limit(QEMUFile
*f
, size_t new_rate
)
611 /* any failed or completed migration keeps its state to allow probing of
612 * migration data, but has no associated file anymore */
613 if (f
&& f
->set_rate_limit
)
614 return f
->set_rate_limit(f
->opaque
, new_rate
);
619 void qemu_put_be16(QEMUFile
*f
, unsigned int v
)
621 qemu_put_byte(f
, v
>> 8);
625 void qemu_put_be32(QEMUFile
*f
, unsigned int v
)
627 qemu_put_byte(f
, v
>> 24);
628 qemu_put_byte(f
, v
>> 16);
629 qemu_put_byte(f
, v
>> 8);
633 void qemu_put_be64(QEMUFile
*f
, uint64_t v
)
635 qemu_put_be32(f
, v
>> 32);
639 unsigned int qemu_get_be16(QEMUFile
*f
)
642 v
= qemu_get_byte(f
) << 8;
643 v
|= qemu_get_byte(f
);
647 unsigned int qemu_get_be32(QEMUFile
*f
)
650 v
= qemu_get_byte(f
) << 24;
651 v
|= qemu_get_byte(f
) << 16;
652 v
|= qemu_get_byte(f
) << 8;
653 v
|= qemu_get_byte(f
);
657 uint64_t qemu_get_be64(QEMUFile
*f
)
660 v
= (uint64_t)qemu_get_be32(f
) << 32;
661 v
|= qemu_get_be32(f
);
667 static int get_int8(QEMUFile
*f
, void *pv
, size_t size
)
674 static void put_int8(QEMUFile
*f
, void *pv
, size_t size
)
680 const VMStateInfo vmstate_info_int8
= {
688 static int get_int16(QEMUFile
*f
, void *pv
, size_t size
)
691 qemu_get_sbe16s(f
, v
);
695 static void put_int16(QEMUFile
*f
, void *pv
, size_t size
)
698 qemu_put_sbe16s(f
, v
);
701 const VMStateInfo vmstate_info_int16
= {
709 static int get_int32(QEMUFile
*f
, void *pv
, size_t size
)
712 qemu_get_sbe32s(f
, v
);
716 static void put_int32(QEMUFile
*f
, void *pv
, size_t size
)
719 qemu_put_sbe32s(f
, v
);
722 const VMStateInfo vmstate_info_int32
= {
728 /* 32 bit int. See that the received value is the same than the one
731 static int get_int32_equal(QEMUFile
*f
, void *pv
, size_t size
)
735 qemu_get_sbe32s(f
, &v2
);
742 const VMStateInfo vmstate_info_int32_equal
= {
743 .name
= "int32 equal",
744 .get
= get_int32_equal
,
748 /* 32 bit int. See that the received value is the less or the same
749 than the one in the field */
751 static int get_int32_le(QEMUFile
*f
, void *pv
, size_t size
)
755 qemu_get_sbe32s(f
, &new);
762 const VMStateInfo vmstate_info_int32_le
= {
763 .name
= "int32 equal",
770 static int get_int64(QEMUFile
*f
, void *pv
, size_t size
)
773 qemu_get_sbe64s(f
, v
);
777 static void put_int64(QEMUFile
*f
, void *pv
, size_t size
)
780 qemu_put_sbe64s(f
, v
);
783 const VMStateInfo vmstate_info_int64
= {
789 /* 8 bit unsigned int */
791 static int get_uint8(QEMUFile
*f
, void *pv
, size_t size
)
798 static void put_uint8(QEMUFile
*f
, void *pv
, size_t size
)
804 const VMStateInfo vmstate_info_uint8
= {
810 /* 16 bit unsigned int */
812 static int get_uint16(QEMUFile
*f
, void *pv
, size_t size
)
815 qemu_get_be16s(f
, v
);
819 static void put_uint16(QEMUFile
*f
, void *pv
, size_t size
)
822 qemu_put_be16s(f
, v
);
825 const VMStateInfo vmstate_info_uint16
= {
831 /* 32 bit unsigned int */
833 static int get_uint32(QEMUFile
*f
, void *pv
, size_t size
)
836 qemu_get_be32s(f
, v
);
840 static void put_uint32(QEMUFile
*f
, void *pv
, size_t size
)
843 qemu_put_be32s(f
, v
);
846 const VMStateInfo vmstate_info_uint32
= {
852 /* 64 bit unsigned int */
854 static int get_uint64(QEMUFile
*f
, void *pv
, size_t size
)
857 qemu_get_be64s(f
, v
);
861 static void put_uint64(QEMUFile
*f
, void *pv
, size_t size
)
864 qemu_put_be64s(f
, v
);
867 const VMStateInfo vmstate_info_uint64
= {
873 /* 8 bit int. See that the received value is the same than the one
876 static int get_uint8_equal(QEMUFile
*f
, void *pv
, size_t size
)
887 const VMStateInfo vmstate_info_uint8_equal
= {
888 .name
= "uint8 equal",
889 .get
= get_uint8_equal
,
893 /* 16 bit unsigned int int. See that the received value is the same than the one
896 static int get_uint16_equal(QEMUFile
*f
, void *pv
, size_t size
)
900 qemu_get_be16s(f
, &v2
);
907 const VMStateInfo vmstate_info_uint16_equal
= {
908 .name
= "uint16 equal",
909 .get
= get_uint16_equal
,
915 static int get_timer(QEMUFile
*f
, void *pv
, size_t size
)
918 qemu_get_timer(f
, v
);
922 static void put_timer(QEMUFile
*f
, void *pv
, size_t size
)
925 qemu_put_timer(f
, v
);
928 const VMStateInfo vmstate_info_timer
= {
934 /* uint8_t buffers */
936 static int get_buffer(QEMUFile
*f
, void *pv
, size_t size
)
939 qemu_get_buffer(f
, v
, size
);
943 static void put_buffer(QEMUFile
*f
, void *pv
, size_t size
)
946 qemu_put_buffer(f
, v
, size
);
949 const VMStateInfo vmstate_info_buffer
= {
955 /* unused buffers: space that was used for some fields that are
956 not usefull anymore */
958 static int get_unused_buffer(QEMUFile
*f
, void *pv
, size_t size
)
964 block_len
= MIN(sizeof(buf
), size
);
966 qemu_get_buffer(f
, buf
, block_len
);
971 static void put_unused_buffer(QEMUFile
*f
, void *pv
, size_t size
)
973 static const uint8_t buf
[1024];
977 block_len
= MIN(sizeof(buf
), size
);
979 qemu_put_buffer(f
, buf
, block_len
);
983 const VMStateInfo vmstate_info_unused_buffer
= {
984 .name
= "unused_buffer",
985 .get
= get_unused_buffer
,
986 .put
= put_unused_buffer
,
989 typedef struct CompatEntry
{
994 typedef struct SaveStateEntry
{
995 QTAILQ_ENTRY(SaveStateEntry
) entry
;
1001 SaveSetParamsHandler
*set_params
;
1002 SaveLiveStateHandler
*save_live_state
;
1003 SaveStateHandler
*save_state
;
1004 LoadStateHandler
*load_state
;
1005 const VMStateDescription
*vmsd
;
1007 CompatEntry
*compat
;
1011 static QTAILQ_HEAD(savevm_handlers
, SaveStateEntry
) savevm_handlers
=
1012 QTAILQ_HEAD_INITIALIZER(savevm_handlers
);
1013 static int global_section_id
;
1015 static int calculate_new_instance_id(const char *idstr
)
1018 int instance_id
= 0;
1020 QTAILQ_FOREACH(se
, &savevm_handlers
, entry
) {
1021 if (strcmp(idstr
, se
->idstr
) == 0
1022 && instance_id
<= se
->instance_id
) {
1023 instance_id
= se
->instance_id
+ 1;
1029 static int calculate_compat_instance_id(const char *idstr
)
1032 int instance_id
= 0;
1034 QTAILQ_FOREACH(se
, &savevm_handlers
, entry
) {
1038 if (strcmp(idstr
, se
->compat
->idstr
) == 0
1039 && instance_id
<= se
->compat
->instance_id
) {
1040 instance_id
= se
->compat
->instance_id
+ 1;
1046 /* TODO: Individual devices generally have very little idea about the rest
1047 of the system, so instance_id should be removed/replaced.
1048 Meanwhile pass -1 as instance_id if you do not already have a clearly
1049 distinguishing id for all instances of your device class. */
1050 int register_savevm_live(DeviceState
*dev
,
1054 SaveSetParamsHandler
*set_params
,
1055 SaveLiveStateHandler
*save_live_state
,
1056 SaveStateHandler
*save_state
,
1057 LoadStateHandler
*load_state
,
1062 se
= qemu_mallocz(sizeof(SaveStateEntry
));
1063 se
->version_id
= version_id
;
1064 se
->section_id
= global_section_id
++;
1065 se
->set_params
= set_params
;
1066 se
->save_live_state
= save_live_state
;
1067 se
->save_state
= save_state
;
1068 se
->load_state
= load_state
;
1069 se
->opaque
= opaque
;
1072 if (dev
&& dev
->parent_bus
&& dev
->parent_bus
->info
->get_dev_path
) {
1073 char *id
= dev
->parent_bus
->info
->get_dev_path(dev
);
1075 pstrcpy(se
->idstr
, sizeof(se
->idstr
), id
);
1076 pstrcat(se
->idstr
, sizeof(se
->idstr
), "/");
1079 se
->compat
= qemu_mallocz(sizeof(CompatEntry
));
1080 pstrcpy(se
->compat
->idstr
, sizeof(se
->compat
->idstr
), idstr
);
1081 se
->compat
->instance_id
= instance_id
== -1 ?
1082 calculate_compat_instance_id(idstr
) : instance_id
;
1086 pstrcat(se
->idstr
, sizeof(se
->idstr
), idstr
);
1088 if (instance_id
== -1) {
1089 se
->instance_id
= calculate_new_instance_id(se
->idstr
);
1091 se
->instance_id
= instance_id
;
1093 assert(!se
->compat
|| se
->instance_id
== 0);
1094 /* add at the end of list */
1095 QTAILQ_INSERT_TAIL(&savevm_handlers
, se
, entry
);
1099 int register_savevm(DeviceState
*dev
,
1103 SaveStateHandler
*save_state
,
1104 LoadStateHandler
*load_state
,
1107 return register_savevm_live(dev
, idstr
, instance_id
, version_id
,
1108 NULL
, NULL
, save_state
, load_state
, opaque
);
1111 void unregister_savevm(DeviceState
*dev
, const char *idstr
, void *opaque
)
1113 SaveStateEntry
*se
, *new_se
;
1116 if (dev
&& dev
->parent_bus
&& dev
->parent_bus
->info
->get_dev_path
) {
1117 char *path
= dev
->parent_bus
->info
->get_dev_path(dev
);
1119 pstrcpy(id
, sizeof(id
), path
);
1120 pstrcat(id
, sizeof(id
), "/");
1124 pstrcat(id
, sizeof(id
), idstr
);
1126 QTAILQ_FOREACH_SAFE(se
, &savevm_handlers
, entry
, new_se
) {
1127 if (strcmp(se
->idstr
, id
) == 0 && se
->opaque
== opaque
) {
1128 QTAILQ_REMOVE(&savevm_handlers
, se
, entry
);
1134 int vmstate_register_with_alias_id(DeviceState
*dev
, int instance_id
,
1135 const VMStateDescription
*vmsd
,
1136 void *opaque
, int alias_id
,
1137 int required_for_version
)
1141 /* If this triggers, alias support can be dropped for the vmsd. */
1142 assert(alias_id
== -1 || required_for_version
>= vmsd
->minimum_version_id
);
1144 se
= qemu_mallocz(sizeof(SaveStateEntry
));
1145 se
->version_id
= vmsd
->version_id
;
1146 se
->section_id
= global_section_id
++;
1147 se
->save_live_state
= NULL
;
1148 se
->save_state
= NULL
;
1149 se
->load_state
= NULL
;
1150 se
->opaque
= opaque
;
1152 se
->alias_id
= alias_id
;
1154 if (dev
&& dev
->parent_bus
&& dev
->parent_bus
->info
->get_dev_path
) {
1155 char *id
= dev
->parent_bus
->info
->get_dev_path(dev
);
1157 pstrcpy(se
->idstr
, sizeof(se
->idstr
), id
);
1158 pstrcat(se
->idstr
, sizeof(se
->idstr
), "/");
1161 se
->compat
= qemu_mallocz(sizeof(CompatEntry
));
1162 pstrcpy(se
->compat
->idstr
, sizeof(se
->compat
->idstr
), vmsd
->name
);
1163 se
->compat
->instance_id
= instance_id
== -1 ?
1164 calculate_compat_instance_id(vmsd
->name
) : instance_id
;
1168 pstrcat(se
->idstr
, sizeof(se
->idstr
), vmsd
->name
);
1170 if (instance_id
== -1) {
1171 se
->instance_id
= calculate_new_instance_id(se
->idstr
);
1173 se
->instance_id
= instance_id
;
1175 assert(!se
->compat
|| se
->instance_id
== 0);
1176 /* add at the end of list */
1177 QTAILQ_INSERT_TAIL(&savevm_handlers
, se
, entry
);
1181 int vmstate_register(DeviceState
*dev
, int instance_id
,
1182 const VMStateDescription
*vmsd
, void *opaque
)
1184 return vmstate_register_with_alias_id(dev
, instance_id
, vmsd
,
1188 void vmstate_unregister(DeviceState
*dev
, const VMStateDescription
*vmsd
,
1191 SaveStateEntry
*se
, *new_se
;
1193 QTAILQ_FOREACH_SAFE(se
, &savevm_handlers
, entry
, new_se
) {
1194 if (se
->vmsd
== vmsd
&& se
->opaque
== opaque
) {
1195 QTAILQ_REMOVE(&savevm_handlers
, se
, entry
);
1201 int vmstate_load_state(QEMUFile
*f
, const VMStateDescription
*vmsd
,
1202 void *opaque
, int version_id
)
1204 VMStateField
*field
= vmsd
->fields
;
1206 if (version_id
> vmsd
->version_id
) {
1209 if (version_id
< vmsd
->minimum_version_id_old
) {
1212 if (version_id
< vmsd
->minimum_version_id
) {
1213 return vmsd
->load_state_old(f
, opaque
, version_id
);
1215 if (vmsd
->pre_load
) {
1216 int ret
= vmsd
->pre_load(opaque
);
1220 while(field
->name
) {
1221 if ((field
->field_exists
&&
1222 field
->field_exists(opaque
, version_id
)) ||
1223 (!field
->field_exists
&&
1224 field
->version_id
<= version_id
)) {
1225 void *base_addr
= opaque
+ field
->offset
;
1226 int ret
, i
, n_elems
= 1;
1227 int size
= field
->size
;
1229 if (field
->flags
& VMS_VBUFFER
) {
1230 size
= *(int32_t *)(opaque
+field
->size_offset
);
1231 if (field
->flags
& VMS_MULTIPLY
) {
1232 size
*= field
->size
;
1235 if (field
->flags
& VMS_ARRAY
) {
1236 n_elems
= field
->num
;
1237 } else if (field
->flags
& VMS_VARRAY_INT32
) {
1238 n_elems
= *(int32_t *)(opaque
+field
->num_offset
);
1239 } else if (field
->flags
& VMS_VARRAY_UINT16
) {
1240 n_elems
= *(uint16_t *)(opaque
+field
->num_offset
);
1242 if (field
->flags
& VMS_POINTER
) {
1243 base_addr
= *(void **)base_addr
+ field
->start
;
1245 for (i
= 0; i
< n_elems
; i
++) {
1246 void *addr
= base_addr
+ size
* i
;
1248 if (field
->flags
& VMS_ARRAY_OF_POINTER
) {
1249 addr
= *(void **)addr
;
1251 if (field
->flags
& VMS_STRUCT
) {
1252 ret
= vmstate_load_state(f
, field
->vmsd
, addr
, field
->vmsd
->version_id
);
1254 ret
= field
->info
->get(f
, addr
, size
);
1264 if (vmsd
->post_load
) {
1265 return vmsd
->post_load(opaque
, version_id
);
1270 void vmstate_save_state(QEMUFile
*f
, const VMStateDescription
*vmsd
,
1273 VMStateField
*field
= vmsd
->fields
;
1275 if (vmsd
->pre_save
) {
1276 vmsd
->pre_save(opaque
);
1278 while(field
->name
) {
1279 if (!field
->field_exists
||
1280 field
->field_exists(opaque
, vmsd
->version_id
)) {
1281 void *base_addr
= opaque
+ field
->offset
;
1283 int size
= field
->size
;
1285 if (field
->flags
& VMS_VBUFFER
) {
1286 size
= *(int32_t *)(opaque
+field
->size_offset
);
1287 if (field
->flags
& VMS_MULTIPLY
) {
1288 size
*= field
->size
;
1291 if (field
->flags
& VMS_ARRAY
) {
1292 n_elems
= field
->num
;
1293 } else if (field
->flags
& VMS_VARRAY_INT32
) {
1294 n_elems
= *(int32_t *)(opaque
+field
->num_offset
);
1295 } else if (field
->flags
& VMS_VARRAY_UINT16
) {
1296 n_elems
= *(uint16_t *)(opaque
+field
->num_offset
);
1298 if (field
->flags
& VMS_POINTER
) {
1299 base_addr
= *(void **)base_addr
+ field
->start
;
1301 for (i
= 0; i
< n_elems
; i
++) {
1302 void *addr
= base_addr
+ size
* i
;
1304 if (field
->flags
& VMS_ARRAY_OF_POINTER
) {
1305 addr
= *(void **)addr
;
1307 if (field
->flags
& VMS_STRUCT
) {
1308 vmstate_save_state(f
, field
->vmsd
, addr
);
1310 field
->info
->put(f
, addr
, size
);
1318 static int vmstate_load(QEMUFile
*f
, SaveStateEntry
*se
, int version_id
)
1320 if (!se
->vmsd
) { /* Old style */
1321 return se
->load_state(f
, se
->opaque
, version_id
);
1323 return vmstate_load_state(f
, se
->vmsd
, se
->opaque
, version_id
);
1326 static void vmstate_save(QEMUFile
*f
, SaveStateEntry
*se
)
1328 if (!se
->vmsd
) { /* Old style */
1329 se
->save_state(f
, se
->opaque
);
1332 vmstate_save_state(f
,se
->vmsd
, se
->opaque
);
1335 #define QEMU_VM_FILE_MAGIC 0x5145564d
1336 #define QEMU_VM_FILE_VERSION_COMPAT 0x00000002
1337 #define QEMU_VM_FILE_VERSION 0x00000003
1339 #define QEMU_VM_EOF 0x00
1340 #define QEMU_VM_SECTION_START 0x01
1341 #define QEMU_VM_SECTION_PART 0x02
1342 #define QEMU_VM_SECTION_END 0x03
1343 #define QEMU_VM_SECTION_FULL 0x04
1345 int qemu_savevm_state_begin(Monitor
*mon
, QEMUFile
*f
, int blk_enable
,
1350 QTAILQ_FOREACH(se
, &savevm_handlers
, entry
) {
1351 if(se
->set_params
== NULL
) {
1354 se
->set_params(blk_enable
, shared
, se
->opaque
);
1357 qemu_put_be32(f
, QEMU_VM_FILE_MAGIC
);
1358 qemu_put_be32(f
, QEMU_VM_FILE_VERSION
);
1360 QTAILQ_FOREACH(se
, &savevm_handlers
, entry
) {
1363 if (se
->save_live_state
== NULL
)
1367 qemu_put_byte(f
, QEMU_VM_SECTION_START
);
1368 qemu_put_be32(f
, se
->section_id
);
1371 len
= strlen(se
->idstr
);
1372 qemu_put_byte(f
, len
);
1373 qemu_put_buffer(f
, (uint8_t *)se
->idstr
, len
);
1375 qemu_put_be32(f
, se
->instance_id
);
1376 qemu_put_be32(f
, se
->version_id
);
1378 se
->save_live_state(mon
, f
, QEMU_VM_SECTION_START
, se
->opaque
);
1381 if (qemu_file_has_error(f
)) {
1382 qemu_savevm_state_cancel(mon
, f
);
1389 int qemu_savevm_state_iterate(Monitor
*mon
, QEMUFile
*f
)
1394 QTAILQ_FOREACH(se
, &savevm_handlers
, entry
) {
1395 if (se
->save_live_state
== NULL
)
1399 qemu_put_byte(f
, QEMU_VM_SECTION_PART
);
1400 qemu_put_be32(f
, se
->section_id
);
1402 ret
= se
->save_live_state(mon
, f
, QEMU_VM_SECTION_PART
, se
->opaque
);
1404 /* Do not proceed to the next vmstate before this one reported
1405 completion of the current stage. This serializes the migration
1406 and reduces the probability that a faster changing state is
1407 synchronized over and over again. */
1415 if (qemu_file_has_error(f
)) {
1416 qemu_savevm_state_cancel(mon
, f
);
1423 int qemu_savevm_state_complete(Monitor
*mon
, QEMUFile
*f
)
1427 cpu_synchronize_all_states();
1429 QTAILQ_FOREACH(se
, &savevm_handlers
, entry
) {
1430 if (se
->save_live_state
== NULL
)
1434 qemu_put_byte(f
, QEMU_VM_SECTION_END
);
1435 qemu_put_be32(f
, se
->section_id
);
1437 se
->save_live_state(mon
, f
, QEMU_VM_SECTION_END
, se
->opaque
);
1440 QTAILQ_FOREACH(se
, &savevm_handlers
, entry
) {
1443 if (se
->save_state
== NULL
&& se
->vmsd
== NULL
)
1447 qemu_put_byte(f
, QEMU_VM_SECTION_FULL
);
1448 qemu_put_be32(f
, se
->section_id
);
1451 len
= strlen(se
->idstr
);
1452 qemu_put_byte(f
, len
);
1453 qemu_put_buffer(f
, (uint8_t *)se
->idstr
, len
);
1455 qemu_put_be32(f
, se
->instance_id
);
1456 qemu_put_be32(f
, se
->version_id
);
1458 vmstate_save(f
, se
);
1461 qemu_put_byte(f
, QEMU_VM_EOF
);
1463 if (qemu_file_has_error(f
))
1469 void qemu_savevm_state_cancel(Monitor
*mon
, QEMUFile
*f
)
1473 QTAILQ_FOREACH(se
, &savevm_handlers
, entry
) {
1474 if (se
->save_live_state
) {
1475 se
->save_live_state(mon
, f
, -1, se
->opaque
);
1480 static int qemu_savevm_state(Monitor
*mon
, QEMUFile
*f
)
1482 int saved_vm_running
;
1485 saved_vm_running
= vm_running
;
1490 ret
= qemu_savevm_state_begin(mon
, f
, 0, 0);
1495 ret
= qemu_savevm_state_iterate(mon
, f
);
1500 ret
= qemu_savevm_state_complete(mon
, f
);
1503 if (qemu_file_has_error(f
))
1506 if (!ret
&& saved_vm_running
)
1512 static SaveStateEntry
*find_se(const char *idstr
, int instance_id
)
1516 QTAILQ_FOREACH(se
, &savevm_handlers
, entry
) {
1517 if (!strcmp(se
->idstr
, idstr
) &&
1518 (instance_id
== se
->instance_id
||
1519 instance_id
== se
->alias_id
))
1521 /* Migrating from an older version? */
1522 if (strstr(se
->idstr
, idstr
) && se
->compat
) {
1523 if (!strcmp(se
->compat
->idstr
, idstr
) &&
1524 (instance_id
== se
->compat
->instance_id
||
1525 instance_id
== se
->alias_id
))
1532 typedef struct LoadStateEntry
{
1533 QLIST_ENTRY(LoadStateEntry
) entry
;
1539 int qemu_loadvm_state(QEMUFile
*f
)
1541 QLIST_HEAD(, LoadStateEntry
) loadvm_handlers
=
1542 QLIST_HEAD_INITIALIZER(loadvm_handlers
);
1543 LoadStateEntry
*le
, *new_le
;
1544 uint8_t section_type
;
1548 v
= qemu_get_be32(f
);
1549 if (v
!= QEMU_VM_FILE_MAGIC
)
1552 v
= qemu_get_be32(f
);
1553 if (v
== QEMU_VM_FILE_VERSION_COMPAT
) {
1554 fprintf(stderr
, "SaveVM v2 format is obsolete and don't work anymore\n");
1557 if (v
!= QEMU_VM_FILE_VERSION
)
1560 while ((section_type
= qemu_get_byte(f
)) != QEMU_VM_EOF
) {
1561 uint32_t instance_id
, version_id
, section_id
;
1566 switch (section_type
) {
1567 case QEMU_VM_SECTION_START
:
1568 case QEMU_VM_SECTION_FULL
:
1569 /* Read section start */
1570 section_id
= qemu_get_be32(f
);
1571 len
= qemu_get_byte(f
);
1572 qemu_get_buffer(f
, (uint8_t *)idstr
, len
);
1574 instance_id
= qemu_get_be32(f
);
1575 version_id
= qemu_get_be32(f
);
1577 /* Find savevm section */
1578 se
= find_se(idstr
, instance_id
);
1580 fprintf(stderr
, "Unknown savevm section or instance '%s' %d\n", idstr
, instance_id
);
1585 /* Validate version */
1586 if (version_id
> se
->version_id
) {
1587 fprintf(stderr
, "savevm: unsupported version %d for '%s' v%d\n",
1588 version_id
, idstr
, se
->version_id
);
1594 le
= qemu_mallocz(sizeof(*le
));
1597 le
->section_id
= section_id
;
1598 le
->version_id
= version_id
;
1599 QLIST_INSERT_HEAD(&loadvm_handlers
, le
, entry
);
1601 ret
= vmstate_load(f
, le
->se
, le
->version_id
);
1603 fprintf(stderr
, "qemu: warning: error while loading state for instance 0x%x of device '%s'\n",
1604 instance_id
, idstr
);
1608 case QEMU_VM_SECTION_PART
:
1609 case QEMU_VM_SECTION_END
:
1610 section_id
= qemu_get_be32(f
);
1612 QLIST_FOREACH(le
, &loadvm_handlers
, entry
) {
1613 if (le
->section_id
== section_id
) {
1618 fprintf(stderr
, "Unknown savevm section %d\n", section_id
);
1623 ret
= vmstate_load(f
, le
->se
, le
->version_id
);
1625 fprintf(stderr
, "qemu: warning: error while loading state section id %d\n",
1631 fprintf(stderr
, "Unknown savevm section type %d\n", section_type
);
1637 cpu_synchronize_all_post_init();
1642 QLIST_FOREACH_SAFE(le
, &loadvm_handlers
, entry
, new_le
) {
1643 QLIST_REMOVE(le
, entry
);
1647 if (qemu_file_has_error(f
))
1653 static int bdrv_snapshot_find(BlockDriverState
*bs
, QEMUSnapshotInfo
*sn_info
,
1656 QEMUSnapshotInfo
*sn_tab
, *sn
;
1660 nb_sns
= bdrv_snapshot_list(bs
, &sn_tab
);
1663 for(i
= 0; i
< nb_sns
; i
++) {
1665 if (!strcmp(sn
->id_str
, name
) || !strcmp(sn
->name
, name
)) {
1676 * Deletes snapshots of a given name in all opened images.
1678 static int del_existing_snapshots(Monitor
*mon
, const char *name
)
1680 BlockDriverState
*bs
;
1681 QEMUSnapshotInfo sn1
, *snapshot
= &sn1
;
1685 while ((bs
= bdrv_next(bs
))) {
1686 if (bdrv_can_snapshot(bs
) &&
1687 bdrv_snapshot_find(bs
, snapshot
, name
) >= 0)
1689 ret
= bdrv_snapshot_delete(bs
, name
);
1692 "Error while deleting snapshot on '%s'\n",
1693 bdrv_get_device_name(bs
));
1702 void do_savevm(Monitor
*mon
, const QDict
*qdict
)
1704 BlockDriverState
*bs
, *bs1
;
1705 QEMUSnapshotInfo sn1
, *sn
= &sn1
, old_sn1
, *old_sn
= &old_sn1
;
1708 int saved_vm_running
;
1709 uint32_t vm_state_size
;
1715 const char *name
= qdict_get_try_str(qdict
, "name");
1717 /* Verify if there is a device that doesn't support snapshots and is writable */
1719 while ((bs
= bdrv_next(bs
))) {
1721 if (bdrv_is_removable(bs
) || bdrv_is_read_only(bs
)) {
1725 if (!bdrv_can_snapshot(bs
)) {
1726 monitor_printf(mon
, "Device '%s' is writable but does not support snapshots.\n",
1727 bdrv_get_device_name(bs
));
1732 bs
= bdrv_snapshots();
1734 monitor_printf(mon
, "No block device can accept snapshots\n");
1737 /* ??? Should this occur after vm_stop? */
1740 saved_vm_running
= vm_running
;
1743 memset(sn
, 0, sizeof(*sn
));
1745 ret
= bdrv_snapshot_find(bs
, old_sn
, name
);
1747 pstrcpy(sn
->name
, sizeof(sn
->name
), old_sn
->name
);
1748 pstrcpy(sn
->id_str
, sizeof(sn
->id_str
), old_sn
->id_str
);
1750 pstrcpy(sn
->name
, sizeof(sn
->name
), name
);
1754 /* fill auxiliary fields */
1757 sn
->date_sec
= tb
.time
;
1758 sn
->date_nsec
= tb
.millitm
* 1000000;
1760 gettimeofday(&tv
, NULL
);
1761 sn
->date_sec
= tv
.tv_sec
;
1762 sn
->date_nsec
= tv
.tv_usec
* 1000;
1764 sn
->vm_clock_nsec
= qemu_get_clock(vm_clock
);
1766 /* Delete old snapshots of the same name */
1767 if (name
&& del_existing_snapshots(mon
, name
) < 0) {
1771 /* save the VM state */
1772 f
= qemu_fopen_bdrv(bs
, 1);
1774 monitor_printf(mon
, "Could not open VM state file\n");
1777 ret
= qemu_savevm_state(mon
, f
);
1778 vm_state_size
= qemu_ftell(f
);
1781 monitor_printf(mon
, "Error %d while writing VM\n", ret
);
1785 /* create the snapshots */
1788 while ((bs1
= bdrv_next(bs1
))) {
1789 if (bdrv_can_snapshot(bs1
)) {
1790 /* Write VM state size only to the image that contains the state */
1791 sn
->vm_state_size
= (bs
== bs1
? vm_state_size
: 0);
1792 ret
= bdrv_snapshot_create(bs1
, sn
);
1794 monitor_printf(mon
, "Error while creating snapshot on '%s'\n",
1795 bdrv_get_device_name(bs1
));
1801 if (saved_vm_running
)
1805 int load_vmstate(const char *name
)
1807 BlockDriverState
*bs
, *bs1
;
1808 QEMUSnapshotInfo sn
;
1812 /* Verify if there is a device that doesn't support snapshots and is writable */
1814 while ((bs
= bdrv_next(bs
))) {
1816 if (bdrv_is_removable(bs
) || bdrv_is_read_only(bs
)) {
1820 if (!bdrv_can_snapshot(bs
)) {
1821 error_report("Device '%s' is writable but does not support snapshots.",
1822 bdrv_get_device_name(bs
));
1827 bs
= bdrv_snapshots();
1829 error_report("No block device supports snapshots");
1833 /* Flush all IO requests so they don't interfere with the new state. */
1837 while ((bs1
= bdrv_next(bs1
))) {
1838 if (bdrv_can_snapshot(bs1
)) {
1839 ret
= bdrv_snapshot_goto(bs1
, name
);
1843 error_report("%sSnapshots not supported on device '%s'",
1844 bs
!= bs1
? "Warning: " : "",
1845 bdrv_get_device_name(bs1
));
1848 error_report("%sCould not find snapshot '%s' on device '%s'",
1849 bs
!= bs1
? "Warning: " : "",
1850 name
, bdrv_get_device_name(bs1
));
1853 error_report("%sError %d while activating snapshot on '%s'",
1854 bs
!= bs1
? "Warning: " : "",
1855 ret
, bdrv_get_device_name(bs1
));
1858 /* fatal on snapshot block device */
1865 /* Don't even try to load empty VM states */
1866 ret
= bdrv_snapshot_find(bs
, &sn
, name
);
1867 if ((ret
>= 0) && (sn
.vm_state_size
== 0))
1870 /* restore the VM state */
1871 f
= qemu_fopen_bdrv(bs
, 0);
1873 error_report("Could not open VM state file");
1876 ret
= qemu_loadvm_state(f
);
1879 error_report("Error %d while loading VM state", ret
);
1885 void do_delvm(Monitor
*mon
, const QDict
*qdict
)
1887 BlockDriverState
*bs
, *bs1
;
1889 const char *name
= qdict_get_str(qdict
, "name");
1891 bs
= bdrv_snapshots();
1893 monitor_printf(mon
, "No block device supports snapshots\n");
1898 while ((bs1
= bdrv_next(bs1
))) {
1899 if (bdrv_can_snapshot(bs1
)) {
1900 ret
= bdrv_snapshot_delete(bs1
, name
);
1902 if (ret
== -ENOTSUP
)
1904 "Snapshots not supported on device '%s'\n",
1905 bdrv_get_device_name(bs1
));
1907 monitor_printf(mon
, "Error %d while deleting snapshot on "
1908 "'%s'\n", ret
, bdrv_get_device_name(bs1
));
1914 void do_info_snapshots(Monitor
*mon
)
1916 BlockDriverState
*bs
, *bs1
;
1917 QEMUSnapshotInfo
*sn_tab
, *sn
;
1921 bs
= bdrv_snapshots();
1923 monitor_printf(mon
, "No available block device supports snapshots\n");
1926 monitor_printf(mon
, "Snapshot devices:");
1928 while ((bs1
= bdrv_next(bs1
))) {
1929 if (bdrv_can_snapshot(bs1
)) {
1931 monitor_printf(mon
, " %s", bdrv_get_device_name(bs1
));
1934 monitor_printf(mon
, "\n");
1936 nb_sns
= bdrv_snapshot_list(bs
, &sn_tab
);
1938 monitor_printf(mon
, "bdrv_snapshot_list: error %d\n", nb_sns
);
1941 monitor_printf(mon
, "Snapshot list (from %s):\n",
1942 bdrv_get_device_name(bs
));
1943 monitor_printf(mon
, "%s\n", bdrv_snapshot_dump(buf
, sizeof(buf
), NULL
));
1944 for(i
= 0; i
< nb_sns
; i
++) {
1946 monitor_printf(mon
, "%s\n", bdrv_snapshot_dump(buf
, sizeof(buf
), sn
));