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
25 #include "config-host.h"
26 #include "qemu-common.h"
30 #include "monitor/monitor.h"
31 #include "sysemu/sysemu.h"
32 #include "qemu/timer.h"
33 #include "audio/audio.h"
34 #include "migration/migration.h"
35 #include "qemu/sockets.h"
36 #include "qemu/queue.h"
37 #include "sysemu/cpus.h"
38 #include "exec/memory.h"
39 #include "qmp-commands.h"
41 #include "qemu/bitops.h"
44 #define SELF_ANNOUNCE_ROUNDS 5
47 #define ETH_P_RARP 0x8035
49 #define ARP_HTYPE_ETH 0x0001
50 #define ARP_PTYPE_IP 0x0800
51 #define ARP_OP_REQUEST_REV 0x3
53 static int announce_self_create(uint8_t *buf
,
56 /* Ethernet header. */
57 memset(buf
, 0xff, 6); /* destination MAC addr */
58 memcpy(buf
+ 6, mac_addr
, 6); /* source MAC addr */
59 *(uint16_t *)(buf
+ 12) = htons(ETH_P_RARP
); /* ethertype */
62 *(uint16_t *)(buf
+ 14) = htons(ARP_HTYPE_ETH
); /* hardware addr space */
63 *(uint16_t *)(buf
+ 16) = htons(ARP_PTYPE_IP
); /* protocol addr space */
64 *(buf
+ 18) = 6; /* hardware addr length (ethernet) */
65 *(buf
+ 19) = 4; /* protocol addr length (IPv4) */
66 *(uint16_t *)(buf
+ 20) = htons(ARP_OP_REQUEST_REV
); /* opcode */
67 memcpy(buf
+ 22, mac_addr
, 6); /* source hw addr */
68 memset(buf
+ 28, 0x00, 4); /* source protocol addr */
69 memcpy(buf
+ 32, mac_addr
, 6); /* target hw addr */
70 memset(buf
+ 38, 0x00, 4); /* target protocol addr */
72 /* Padding to get up to 60 bytes (ethernet min packet size, minus FCS). */
73 memset(buf
+ 42, 0x00, 18);
75 return 60; /* len (FCS will be added by hardware) */
78 static void qemu_announce_self_iter(NICState
*nic
, void *opaque
)
83 len
= announce_self_create(buf
, nic
->conf
->macaddr
.a
);
85 qemu_send_packet_raw(qemu_get_queue(nic
), buf
, len
);
89 static void qemu_announce_self_once(void *opaque
)
91 static int count
= SELF_ANNOUNCE_ROUNDS
;
92 QEMUTimer
*timer
= *(QEMUTimer
**)opaque
;
94 qemu_foreach_nic(qemu_announce_self_iter
, NULL
);
97 /* delay 50ms, 150ms, 250ms, ... */
98 qemu_mod_timer(timer
, qemu_get_clock_ms(rt_clock
) +
99 50 + (SELF_ANNOUNCE_ROUNDS
- count
- 1) * 100);
101 qemu_del_timer(timer
);
102 qemu_free_timer(timer
);
106 void qemu_announce_self(void)
108 static QEMUTimer
*timer
;
109 timer
= qemu_new_timer_ms(rt_clock
, qemu_announce_self_once
, &timer
);
110 qemu_announce_self_once(&timer
);
113 /***********************************************************/
114 /* savevm/loadvm support */
116 #define IO_BUF_SIZE 32768
117 #define MAX_IOV_SIZE MIN(IOV_MAX, 64)
120 const QEMUFileOps
*ops
;
127 int64_t pos
; /* start of buffer when writing, end of buffer
130 int buf_size
; /* 0 when writing */
131 uint8_t buf
[IO_BUF_SIZE
];
133 struct iovec iov
[MAX_IOV_SIZE
];
139 typedef struct QEMUFileStdio
145 typedef struct QEMUFileSocket
156 static void fd_coroutine_enter(void *opaque
)
158 FDYieldUntilData
*data
= opaque
;
159 qemu_set_fd_handler(data
->fd
, NULL
, NULL
, NULL
);
160 qemu_coroutine_enter(data
->co
, NULL
);
164 * Yield until a file descriptor becomes readable
166 * Note that this function clobbers the handlers for the file descriptor.
168 static void coroutine_fn
yield_until_fd_readable(int fd
)
170 FDYieldUntilData data
;
172 assert(qemu_in_coroutine());
173 data
.co
= qemu_coroutine_self();
175 qemu_set_fd_handler(fd
, fd_coroutine_enter
, NULL
, &data
);
176 qemu_coroutine_yield();
179 static ssize_t
socket_writev_buffer(void *opaque
, struct iovec
*iov
, int iovcnt
)
181 QEMUFileSocket
*s
= opaque
;
183 ssize_t size
= iov_size(iov
, iovcnt
);
185 len
= iov_send(s
->fd
, iov
, iovcnt
, 0, size
);
187 len
= -socket_error();
192 static int socket_get_fd(void *opaque
)
194 QEMUFileSocket
*s
= opaque
;
199 static int socket_get_buffer(void *opaque
, uint8_t *buf
, int64_t pos
, int size
)
201 QEMUFileSocket
*s
= opaque
;
205 len
= qemu_recv(s
->fd
, buf
, size
, 0);
209 if (socket_error() == EAGAIN
) {
210 yield_until_fd_readable(s
->fd
);
211 } else if (socket_error() != EINTR
) {
217 len
= -socket_error();
222 static int socket_put_buffer(void *opaque
, const uint8_t *buf
, int64_t pos
, int size
)
224 QEMUFileSocket
*s
= opaque
;
227 len
= qemu_send_full(s
->fd
, buf
, size
, 0);
229 len
= -socket_error();
234 static int socket_close(void *opaque
)
236 QEMUFileSocket
*s
= opaque
;
242 static int stdio_get_fd(void *opaque
)
244 QEMUFileStdio
*s
= opaque
;
246 return fileno(s
->stdio_file
);
249 static int stdio_put_buffer(void *opaque
, const uint8_t *buf
, int64_t pos
, int size
)
251 QEMUFileStdio
*s
= opaque
;
252 return fwrite(buf
, 1, size
, s
->stdio_file
);
255 static int stdio_get_buffer(void *opaque
, uint8_t *buf
, int64_t pos
, int size
)
257 QEMUFileStdio
*s
= opaque
;
258 FILE *fp
= s
->stdio_file
;
263 bytes
= fread(buf
, 1, size
, fp
);
264 if (bytes
!= 0 || !ferror(fp
)) {
267 if (errno
== EAGAIN
) {
268 yield_until_fd_readable(fileno(fp
));
269 } else if (errno
!= EINTR
) {
276 static int stdio_pclose(void *opaque
)
278 QEMUFileStdio
*s
= opaque
;
280 ret
= pclose(s
->stdio_file
);
283 } else if (!WIFEXITED(ret
) || WEXITSTATUS(ret
) != 0) {
284 /* close succeeded, but non-zero exit code: */
285 ret
= -EIO
; /* fake errno value */
291 static int stdio_fclose(void *opaque
)
293 QEMUFileStdio
*s
= opaque
;
296 if (s
->file
->ops
->put_buffer
|| s
->file
->ops
->writev_buffer
) {
297 int fd
= fileno(s
->stdio_file
);
300 ret
= fstat(fd
, &st
);
301 if (ret
== 0 && S_ISREG(st
.st_mode
)) {
303 * If the file handle is a regular file make sure the
304 * data is flushed to disk before signaling success.
313 if (fclose(s
->stdio_file
) == EOF
) {
320 static const QEMUFileOps stdio_pipe_read_ops
= {
321 .get_fd
= stdio_get_fd
,
322 .get_buffer
= stdio_get_buffer
,
323 .close
= stdio_pclose
326 static const QEMUFileOps stdio_pipe_write_ops
= {
327 .get_fd
= stdio_get_fd
,
328 .put_buffer
= stdio_put_buffer
,
329 .close
= stdio_pclose
332 QEMUFile
*qemu_popen_cmd(const char *command
, const char *mode
)
337 stdio_file
= popen(command
, mode
);
338 if (stdio_file
== NULL
) {
342 if (mode
== NULL
|| (mode
[0] != 'r' && mode
[0] != 'w') || mode
[1] != 0) {
343 fprintf(stderr
, "qemu_popen: Argument validity check failed\n");
347 s
= g_malloc0(sizeof(QEMUFileStdio
));
349 s
->stdio_file
= stdio_file
;
352 s
->file
= qemu_fopen_ops(s
, &stdio_pipe_read_ops
);
354 s
->file
= qemu_fopen_ops(s
, &stdio_pipe_write_ops
);
359 static const QEMUFileOps stdio_file_read_ops
= {
360 .get_fd
= stdio_get_fd
,
361 .get_buffer
= stdio_get_buffer
,
362 .close
= stdio_fclose
365 static const QEMUFileOps stdio_file_write_ops
= {
366 .get_fd
= stdio_get_fd
,
367 .put_buffer
= stdio_put_buffer
,
368 .close
= stdio_fclose
371 QEMUFile
*qemu_fdopen(int fd
, const char *mode
)
376 (mode
[0] != 'r' && mode
[0] != 'w') ||
377 mode
[1] != 'b' || mode
[2] != 0) {
378 fprintf(stderr
, "qemu_fdopen: Argument validity check failed\n");
382 s
= g_malloc0(sizeof(QEMUFileStdio
));
383 s
->stdio_file
= fdopen(fd
, mode
);
388 s
->file
= qemu_fopen_ops(s
, &stdio_file_read_ops
);
390 s
->file
= qemu_fopen_ops(s
, &stdio_file_write_ops
);
399 static const QEMUFileOps socket_read_ops
= {
400 .get_fd
= socket_get_fd
,
401 .get_buffer
= socket_get_buffer
,
402 .close
= socket_close
405 static const QEMUFileOps socket_write_ops
= {
406 .get_fd
= socket_get_fd
,
407 .put_buffer
= socket_put_buffer
,
408 .writev_buffer
= socket_writev_buffer
,
409 .close
= socket_close
412 QEMUFile
*qemu_fopen_socket(int fd
, const char *mode
)
414 QEMUFileSocket
*s
= g_malloc0(sizeof(QEMUFileSocket
));
417 (mode
[0] != 'r' && mode
[0] != 'w') ||
418 mode
[1] != 'b' || mode
[2] != 0) {
419 fprintf(stderr
, "qemu_fopen: Argument validity check failed\n");
424 if (mode
[0] == 'w') {
425 qemu_set_block(s
->fd
);
426 s
->file
= qemu_fopen_ops(s
, &socket_write_ops
);
428 s
->file
= qemu_fopen_ops(s
, &socket_read_ops
);
433 QEMUFile
*qemu_fopen(const char *filename
, const char *mode
)
438 (mode
[0] != 'r' && mode
[0] != 'w') ||
439 mode
[1] != 'b' || mode
[2] != 0) {
440 fprintf(stderr
, "qemu_fopen: Argument validity check failed\n");
444 s
= g_malloc0(sizeof(QEMUFileStdio
));
446 s
->stdio_file
= fopen(filename
, mode
);
451 s
->file
= qemu_fopen_ops(s
, &stdio_file_write_ops
);
453 s
->file
= qemu_fopen_ops(s
, &stdio_file_read_ops
);
461 static int block_put_buffer(void *opaque
, const uint8_t *buf
,
462 int64_t pos
, int size
)
464 bdrv_save_vmstate(opaque
, buf
, pos
, size
);
468 static int block_get_buffer(void *opaque
, uint8_t *buf
, int64_t pos
, int size
)
470 return bdrv_load_vmstate(opaque
, buf
, pos
, size
);
473 static int bdrv_fclose(void *opaque
)
475 return bdrv_flush(opaque
);
478 static const QEMUFileOps bdrv_read_ops
= {
479 .get_buffer
= block_get_buffer
,
483 static const QEMUFileOps bdrv_write_ops
= {
484 .put_buffer
= block_put_buffer
,
488 static QEMUFile
*qemu_fopen_bdrv(BlockDriverState
*bs
, int is_writable
)
491 return qemu_fopen_ops(bs
, &bdrv_write_ops
);
492 return qemu_fopen_ops(bs
, &bdrv_read_ops
);
495 QEMUFile
*qemu_fopen_ops(void *opaque
, const QEMUFileOps
*ops
)
499 f
= g_malloc0(sizeof(QEMUFile
));
507 int qemu_file_get_error(QEMUFile
*f
)
509 return f
->last_error
;
512 static void qemu_file_set_error(QEMUFile
*f
, int ret
)
514 if (f
->last_error
== 0) {
520 * Flushes QEMUFile buffer
522 * If there is writev_buffer QEMUFileOps it uses it otherwise uses
525 static void qemu_fflush(QEMUFile
*f
)
530 if (!f
->ops
->writev_buffer
&& !f
->ops
->put_buffer
) {
534 if (f
->is_write
&& f
->iovcnt
> 0) {
535 if (f
->ops
->writev_buffer
) {
536 ret
= f
->ops
->writev_buffer(f
->opaque
, f
->iov
, f
->iovcnt
);
541 for (i
= 0; i
< f
->iovcnt
&& ret
>= 0; i
++) {
542 ret
= f
->ops
->put_buffer(f
->opaque
, f
->iov
[i
].iov_base
, f
->pos
,
553 qemu_file_set_error(f
, ret
);
557 static void qemu_fill_buffer(QEMUFile
*f
)
562 if (!f
->ops
->get_buffer
)
568 pending
= f
->buf_size
- f
->buf_index
;
570 memmove(f
->buf
, f
->buf
+ f
->buf_index
, pending
);
573 f
->buf_size
= pending
;
575 len
= f
->ops
->get_buffer(f
->opaque
, f
->buf
+ pending
, f
->pos
,
576 IO_BUF_SIZE
- pending
);
580 } else if (len
== 0) {
581 qemu_file_set_error(f
, -EIO
);
582 } else if (len
!= -EAGAIN
)
583 qemu_file_set_error(f
, len
);
586 int qemu_get_fd(QEMUFile
*f
)
588 if (f
->ops
->get_fd
) {
589 return f
->ops
->get_fd(f
->opaque
);
596 * Returns negative error value if any error happened on previous operations or
597 * while closing the file. Returns 0 or positive number on success.
599 * The meaning of return value on success depends on the specific backend
602 int qemu_fclose(QEMUFile
*f
)
606 ret
= qemu_file_get_error(f
);
609 int ret2
= f
->ops
->close(f
->opaque
);
614 /* If any error was spotted before closing, we should report it
615 * instead of the close() return value.
624 static void add_to_iovec(QEMUFile
*f
, const uint8_t *buf
, int size
)
626 /* check for adjacent buffer and coalesce them */
627 if (f
->iovcnt
> 0 && buf
== f
->iov
[f
->iovcnt
- 1].iov_base
+
628 f
->iov
[f
->iovcnt
- 1].iov_len
) {
629 f
->iov
[f
->iovcnt
- 1].iov_len
+= size
;
631 f
->iov
[f
->iovcnt
].iov_base
= (uint8_t *)buf
;
632 f
->iov
[f
->iovcnt
++].iov_len
= size
;
636 void qemu_put_buffer_async(QEMUFile
*f
, const uint8_t *buf
, int size
)
642 if (f
->is_write
== 0 && f
->buf_index
> 0) {
644 "Attempted to write to buffer while read buffer is not empty\n");
648 add_to_iovec(f
, buf
, size
);
651 f
->bytes_xfer
+= size
;
653 if (f
->buf_index
>= IO_BUF_SIZE
|| f
->iovcnt
>= MAX_IOV_SIZE
) {
658 void qemu_put_buffer(QEMUFile
*f
, const uint8_t *buf
, int size
)
666 if (f
->is_write
== 0 && f
->buf_index
> 0) {
668 "Attempted to write to buffer while read buffer is not empty\n");
673 l
= IO_BUF_SIZE
- f
->buf_index
;
676 memcpy(f
->buf
+ f
->buf_index
, buf
, l
);
679 qemu_put_buffer_async(f
, f
->buf
+ (f
->buf_index
- l
), l
);
680 if (qemu_file_get_error(f
)) {
688 void qemu_put_byte(QEMUFile
*f
, int v
)
694 if (f
->is_write
== 0 && f
->buf_index
> 0) {
696 "Attempted to write to buffer while read buffer is not empty\n");
700 f
->buf
[f
->buf_index
++] = v
;
704 add_to_iovec(f
, f
->buf
+ (f
->buf_index
- 1), 1);
706 if (f
->buf_index
>= IO_BUF_SIZE
|| f
->iovcnt
>= MAX_IOV_SIZE
) {
711 static void qemu_file_skip(QEMUFile
*f
, int size
)
713 if (f
->buf_index
+ size
<= f
->buf_size
) {
714 f
->buf_index
+= size
;
718 static int qemu_peek_buffer(QEMUFile
*f
, uint8_t *buf
, int size
, size_t offset
)
727 index
= f
->buf_index
+ offset
;
728 pending
= f
->buf_size
- index
;
729 if (pending
< size
) {
731 index
= f
->buf_index
+ offset
;
732 pending
= f
->buf_size
- index
;
738 if (size
> pending
) {
742 memcpy(buf
, f
->buf
+ index
, size
);
746 int qemu_get_buffer(QEMUFile
*f
, uint8_t *buf
, int size
)
751 while (pending
> 0) {
754 res
= qemu_peek_buffer(f
, buf
, pending
, 0);
758 qemu_file_skip(f
, res
);
766 static int qemu_peek_byte(QEMUFile
*f
, int offset
)
768 int index
= f
->buf_index
+ offset
;
774 if (index
>= f
->buf_size
) {
776 index
= f
->buf_index
+ offset
;
777 if (index
>= f
->buf_size
) {
781 return f
->buf
[index
];
784 int qemu_get_byte(QEMUFile
*f
)
788 result
= qemu_peek_byte(f
, 0);
789 qemu_file_skip(f
, 1);
793 int64_t qemu_ftell(QEMUFile
*f
)
799 int qemu_file_rate_limit(QEMUFile
*f
)
801 if (qemu_file_get_error(f
)) {
804 if (f
->xfer_limit
> 0 && f
->bytes_xfer
> f
->xfer_limit
) {
810 int64_t qemu_file_get_rate_limit(QEMUFile
*f
)
812 return f
->xfer_limit
;
815 void qemu_file_set_rate_limit(QEMUFile
*f
, int64_t limit
)
817 f
->xfer_limit
= limit
;
820 void qemu_file_reset_rate_limit(QEMUFile
*f
)
825 void qemu_put_be16(QEMUFile
*f
, unsigned int v
)
827 qemu_put_byte(f
, v
>> 8);
831 void qemu_put_be32(QEMUFile
*f
, unsigned int v
)
833 qemu_put_byte(f
, v
>> 24);
834 qemu_put_byte(f
, v
>> 16);
835 qemu_put_byte(f
, v
>> 8);
839 void qemu_put_be64(QEMUFile
*f
, uint64_t v
)
841 qemu_put_be32(f
, v
>> 32);
845 unsigned int qemu_get_be16(QEMUFile
*f
)
848 v
= qemu_get_byte(f
) << 8;
849 v
|= qemu_get_byte(f
);
853 unsigned int qemu_get_be32(QEMUFile
*f
)
856 v
= qemu_get_byte(f
) << 24;
857 v
|= qemu_get_byte(f
) << 16;
858 v
|= qemu_get_byte(f
) << 8;
859 v
|= qemu_get_byte(f
);
863 uint64_t qemu_get_be64(QEMUFile
*f
)
866 v
= (uint64_t)qemu_get_be32(f
) << 32;
867 v
|= qemu_get_be32(f
);
874 void qemu_put_timer(QEMUFile
*f
, QEMUTimer
*ts
)
876 uint64_t expire_time
;
878 expire_time
= qemu_timer_expire_time_ns(ts
);
879 qemu_put_be64(f
, expire_time
);
882 void qemu_get_timer(QEMUFile
*f
, QEMUTimer
*ts
)
884 uint64_t expire_time
;
886 expire_time
= qemu_get_be64(f
);
887 if (expire_time
!= -1) {
888 qemu_mod_timer_ns(ts
, expire_time
);
897 static int get_bool(QEMUFile
*f
, void *pv
, size_t size
)
900 *v
= qemu_get_byte(f
);
904 static void put_bool(QEMUFile
*f
, void *pv
, size_t size
)
907 qemu_put_byte(f
, *v
);
910 const VMStateInfo vmstate_info_bool
= {
918 static int get_int8(QEMUFile
*f
, void *pv
, size_t size
)
925 static void put_int8(QEMUFile
*f
, void *pv
, size_t size
)
931 const VMStateInfo vmstate_info_int8
= {
939 static int get_int16(QEMUFile
*f
, void *pv
, size_t size
)
942 qemu_get_sbe16s(f
, v
);
946 static void put_int16(QEMUFile
*f
, void *pv
, size_t size
)
949 qemu_put_sbe16s(f
, v
);
952 const VMStateInfo vmstate_info_int16
= {
960 static int get_int32(QEMUFile
*f
, void *pv
, size_t size
)
963 qemu_get_sbe32s(f
, v
);
967 static void put_int32(QEMUFile
*f
, void *pv
, size_t size
)
970 qemu_put_sbe32s(f
, v
);
973 const VMStateInfo vmstate_info_int32
= {
979 /* 32 bit int. See that the received value is the same than the one
982 static int get_int32_equal(QEMUFile
*f
, void *pv
, size_t size
)
986 qemu_get_sbe32s(f
, &v2
);
993 const VMStateInfo vmstate_info_int32_equal
= {
994 .name
= "int32 equal",
995 .get
= get_int32_equal
,
999 /* 32 bit int. See that the received value is the less or the same
1000 than the one in the field */
1002 static int get_int32_le(QEMUFile
*f
, void *pv
, size_t size
)
1006 qemu_get_sbe32s(f
, &new);
1013 const VMStateInfo vmstate_info_int32_le
= {
1014 .name
= "int32 equal",
1015 .get
= get_int32_le
,
1021 static int get_int64(QEMUFile
*f
, void *pv
, size_t size
)
1024 qemu_get_sbe64s(f
, v
);
1028 static void put_int64(QEMUFile
*f
, void *pv
, size_t size
)
1031 qemu_put_sbe64s(f
, v
);
1034 const VMStateInfo vmstate_info_int64
= {
1040 /* 8 bit unsigned int */
1042 static int get_uint8(QEMUFile
*f
, void *pv
, size_t size
)
1049 static void put_uint8(QEMUFile
*f
, void *pv
, size_t size
)
1055 const VMStateInfo vmstate_info_uint8
= {
1061 /* 16 bit unsigned int */
1063 static int get_uint16(QEMUFile
*f
, void *pv
, size_t size
)
1066 qemu_get_be16s(f
, v
);
1070 static void put_uint16(QEMUFile
*f
, void *pv
, size_t size
)
1073 qemu_put_be16s(f
, v
);
1076 const VMStateInfo vmstate_info_uint16
= {
1082 /* 32 bit unsigned int */
1084 static int get_uint32(QEMUFile
*f
, void *pv
, size_t size
)
1087 qemu_get_be32s(f
, v
);
1091 static void put_uint32(QEMUFile
*f
, void *pv
, size_t size
)
1094 qemu_put_be32s(f
, v
);
1097 const VMStateInfo vmstate_info_uint32
= {
1103 /* 32 bit uint. See that the received value is the same than the one
1106 static int get_uint32_equal(QEMUFile
*f
, void *pv
, size_t size
)
1110 qemu_get_be32s(f
, &v2
);
1118 const VMStateInfo vmstate_info_uint32_equal
= {
1119 .name
= "uint32 equal",
1120 .get
= get_uint32_equal
,
1124 /* 64 bit unsigned int */
1126 static int get_uint64(QEMUFile
*f
, void *pv
, size_t size
)
1129 qemu_get_be64s(f
, v
);
1133 static void put_uint64(QEMUFile
*f
, void *pv
, size_t size
)
1136 qemu_put_be64s(f
, v
);
1139 const VMStateInfo vmstate_info_uint64
= {
1145 /* 64 bit unsigned int. See that the received value is the same than the one
1148 static int get_uint64_equal(QEMUFile
*f
, void *pv
, size_t size
)
1152 qemu_get_be64s(f
, &v2
);
1160 const VMStateInfo vmstate_info_uint64_equal
= {
1161 .name
= "int64 equal",
1162 .get
= get_uint64_equal
,
1166 /* 8 bit int. See that the received value is the same than the one
1169 static int get_uint8_equal(QEMUFile
*f
, void *pv
, size_t size
)
1173 qemu_get_8s(f
, &v2
);
1180 const VMStateInfo vmstate_info_uint8_equal
= {
1181 .name
= "uint8 equal",
1182 .get
= get_uint8_equal
,
1186 /* 16 bit unsigned int int. See that the received value is the same than the one
1189 static int get_uint16_equal(QEMUFile
*f
, void *pv
, size_t size
)
1193 qemu_get_be16s(f
, &v2
);
1200 const VMStateInfo vmstate_info_uint16_equal
= {
1201 .name
= "uint16 equal",
1202 .get
= get_uint16_equal
,
1206 /* floating point */
1208 static int get_float64(QEMUFile
*f
, void *pv
, size_t size
)
1212 *v
= make_float64(qemu_get_be64(f
));
1216 static void put_float64(QEMUFile
*f
, void *pv
, size_t size
)
1220 qemu_put_be64(f
, float64_val(*v
));
1223 const VMStateInfo vmstate_info_float64
= {
1231 static int get_timer(QEMUFile
*f
, void *pv
, size_t size
)
1234 qemu_get_timer(f
, v
);
1238 static void put_timer(QEMUFile
*f
, void *pv
, size_t size
)
1241 qemu_put_timer(f
, v
);
1244 const VMStateInfo vmstate_info_timer
= {
1250 /* uint8_t buffers */
1252 static int get_buffer(QEMUFile
*f
, void *pv
, size_t size
)
1255 qemu_get_buffer(f
, v
, size
);
1259 static void put_buffer(QEMUFile
*f
, void *pv
, size_t size
)
1262 qemu_put_buffer(f
, v
, size
);
1265 const VMStateInfo vmstate_info_buffer
= {
1271 /* unused buffers: space that was used for some fields that are
1272 not useful anymore */
1274 static int get_unused_buffer(QEMUFile
*f
, void *pv
, size_t size
)
1280 block_len
= MIN(sizeof(buf
), size
);
1282 qemu_get_buffer(f
, buf
, block_len
);
1287 static void put_unused_buffer(QEMUFile
*f
, void *pv
, size_t size
)
1289 static const uint8_t buf
[1024];
1293 block_len
= MIN(sizeof(buf
), size
);
1295 qemu_put_buffer(f
, buf
, block_len
);
1299 const VMStateInfo vmstate_info_unused_buffer
= {
1300 .name
= "unused_buffer",
1301 .get
= get_unused_buffer
,
1302 .put
= put_unused_buffer
,
1305 /* bitmaps (as defined by bitmap.h). Note that size here is the size
1306 * of the bitmap in bits. The on-the-wire format of a bitmap is 64
1307 * bit words with the bits in big endian order. The in-memory format
1308 * is an array of 'unsigned long', which may be either 32 or 64 bits.
1310 /* This is the number of 64 bit words sent over the wire */
1311 #define BITS_TO_U64S(nr) DIV_ROUND_UP(nr, 64)
1312 static int get_bitmap(QEMUFile
*f
, void *pv
, size_t size
)
1314 unsigned long *bmp
= pv
;
1316 for (i
= 0; i
< BITS_TO_U64S(size
); i
++) {
1317 uint64_t w
= qemu_get_be64(f
);
1319 if (sizeof(unsigned long) == 4 && idx
< BITS_TO_LONGS(size
)) {
1320 bmp
[idx
++] = w
>> 32;
1326 static void put_bitmap(QEMUFile
*f
, void *pv
, size_t size
)
1328 unsigned long *bmp
= pv
;
1330 for (i
= 0; i
< BITS_TO_U64S(size
); i
++) {
1331 uint64_t w
= bmp
[idx
++];
1332 if (sizeof(unsigned long) == 4 && idx
< BITS_TO_LONGS(size
)) {
1333 w
|= ((uint64_t)bmp
[idx
++]) << 32;
1335 qemu_put_be64(f
, w
);
1339 const VMStateInfo vmstate_info_bitmap
= {
1345 typedef struct CompatEntry
{
1350 typedef struct SaveStateEntry
{
1351 QTAILQ_ENTRY(SaveStateEntry
) entry
;
1357 SaveVMHandlers
*ops
;
1358 const VMStateDescription
*vmsd
;
1360 CompatEntry
*compat
;
1366 static QTAILQ_HEAD(savevm_handlers
, SaveStateEntry
) savevm_handlers
=
1367 QTAILQ_HEAD_INITIALIZER(savevm_handlers
);
1368 static int global_section_id
;
1370 static int calculate_new_instance_id(const char *idstr
)
1373 int instance_id
= 0;
1375 QTAILQ_FOREACH(se
, &savevm_handlers
, entry
) {
1376 if (strcmp(idstr
, se
->idstr
) == 0
1377 && instance_id
<= se
->instance_id
) {
1378 instance_id
= se
->instance_id
+ 1;
1384 static int calculate_compat_instance_id(const char *idstr
)
1387 int instance_id
= 0;
1389 QTAILQ_FOREACH(se
, &savevm_handlers
, entry
) {
1393 if (strcmp(idstr
, se
->compat
->idstr
) == 0
1394 && instance_id
<= se
->compat
->instance_id
) {
1395 instance_id
= se
->compat
->instance_id
+ 1;
1401 /* TODO: Individual devices generally have very little idea about the rest
1402 of the system, so instance_id should be removed/replaced.
1403 Meanwhile pass -1 as instance_id if you do not already have a clearly
1404 distinguishing id for all instances of your device class. */
1405 int register_savevm_live(DeviceState
*dev
,
1409 SaveVMHandlers
*ops
,
1414 se
= g_malloc0(sizeof(SaveStateEntry
));
1415 se
->version_id
= version_id
;
1416 se
->section_id
= global_section_id
++;
1418 se
->opaque
= opaque
;
1421 /* if this is a live_savem then set is_ram */
1422 if (ops
->save_live_setup
!= NULL
) {
1427 char *id
= qdev_get_dev_path(dev
);
1429 pstrcpy(se
->idstr
, sizeof(se
->idstr
), id
);
1430 pstrcat(se
->idstr
, sizeof(se
->idstr
), "/");
1433 se
->compat
= g_malloc0(sizeof(CompatEntry
));
1434 pstrcpy(se
->compat
->idstr
, sizeof(se
->compat
->idstr
), idstr
);
1435 se
->compat
->instance_id
= instance_id
== -1 ?
1436 calculate_compat_instance_id(idstr
) : instance_id
;
1440 pstrcat(se
->idstr
, sizeof(se
->idstr
), idstr
);
1442 if (instance_id
== -1) {
1443 se
->instance_id
= calculate_new_instance_id(se
->idstr
);
1445 se
->instance_id
= instance_id
;
1447 assert(!se
->compat
|| se
->instance_id
== 0);
1448 /* add at the end of list */
1449 QTAILQ_INSERT_TAIL(&savevm_handlers
, se
, entry
);
1453 int register_savevm(DeviceState
*dev
,
1457 SaveStateHandler
*save_state
,
1458 LoadStateHandler
*load_state
,
1461 SaveVMHandlers
*ops
= g_malloc0(sizeof(SaveVMHandlers
));
1462 ops
->save_state
= save_state
;
1463 ops
->load_state
= load_state
;
1464 return register_savevm_live(dev
, idstr
, instance_id
, version_id
,
1468 void unregister_savevm(DeviceState
*dev
, const char *idstr
, void *opaque
)
1470 SaveStateEntry
*se
, *new_se
;
1474 char *path
= qdev_get_dev_path(dev
);
1476 pstrcpy(id
, sizeof(id
), path
);
1477 pstrcat(id
, sizeof(id
), "/");
1481 pstrcat(id
, sizeof(id
), idstr
);
1483 QTAILQ_FOREACH_SAFE(se
, &savevm_handlers
, entry
, new_se
) {
1484 if (strcmp(se
->idstr
, id
) == 0 && se
->opaque
== opaque
) {
1485 QTAILQ_REMOVE(&savevm_handlers
, se
, entry
);
1495 int vmstate_register_with_alias_id(DeviceState
*dev
, int instance_id
,
1496 const VMStateDescription
*vmsd
,
1497 void *opaque
, int alias_id
,
1498 int required_for_version
)
1502 /* If this triggers, alias support can be dropped for the vmsd. */
1503 assert(alias_id
== -1 || required_for_version
>= vmsd
->minimum_version_id
);
1505 se
= g_malloc0(sizeof(SaveStateEntry
));
1506 se
->version_id
= vmsd
->version_id
;
1507 se
->section_id
= global_section_id
++;
1508 se
->opaque
= opaque
;
1510 se
->alias_id
= alias_id
;
1511 se
->no_migrate
= vmsd
->unmigratable
;
1514 char *id
= qdev_get_dev_path(dev
);
1516 pstrcpy(se
->idstr
, sizeof(se
->idstr
), id
);
1517 pstrcat(se
->idstr
, sizeof(se
->idstr
), "/");
1520 se
->compat
= g_malloc0(sizeof(CompatEntry
));
1521 pstrcpy(se
->compat
->idstr
, sizeof(se
->compat
->idstr
), vmsd
->name
);
1522 se
->compat
->instance_id
= instance_id
== -1 ?
1523 calculate_compat_instance_id(vmsd
->name
) : instance_id
;
1527 pstrcat(se
->idstr
, sizeof(se
->idstr
), vmsd
->name
);
1529 if (instance_id
== -1) {
1530 se
->instance_id
= calculate_new_instance_id(se
->idstr
);
1532 se
->instance_id
= instance_id
;
1534 assert(!se
->compat
|| se
->instance_id
== 0);
1535 /* add at the end of list */
1536 QTAILQ_INSERT_TAIL(&savevm_handlers
, se
, entry
);
1540 void vmstate_unregister(DeviceState
*dev
, const VMStateDescription
*vmsd
,
1543 SaveStateEntry
*se
, *new_se
;
1545 QTAILQ_FOREACH_SAFE(se
, &savevm_handlers
, entry
, new_se
) {
1546 if (se
->vmsd
== vmsd
&& se
->opaque
== opaque
) {
1547 QTAILQ_REMOVE(&savevm_handlers
, se
, entry
);
1556 static void vmstate_subsection_save(QEMUFile
*f
, const VMStateDescription
*vmsd
,
1558 static int vmstate_subsection_load(QEMUFile
*f
, const VMStateDescription
*vmsd
,
1561 int vmstate_load_state(QEMUFile
*f
, const VMStateDescription
*vmsd
,
1562 void *opaque
, int version_id
)
1564 VMStateField
*field
= vmsd
->fields
;
1567 if (version_id
> vmsd
->version_id
) {
1570 if (version_id
< vmsd
->minimum_version_id_old
) {
1573 if (version_id
< vmsd
->minimum_version_id
) {
1574 return vmsd
->load_state_old(f
, opaque
, version_id
);
1576 if (vmsd
->pre_load
) {
1577 int ret
= vmsd
->pre_load(opaque
);
1581 while(field
->name
) {
1582 if ((field
->field_exists
&&
1583 field
->field_exists(opaque
, version_id
)) ||
1584 (!field
->field_exists
&&
1585 field
->version_id
<= version_id
)) {
1586 void *base_addr
= opaque
+ field
->offset
;
1588 int size
= field
->size
;
1590 if (field
->flags
& VMS_VBUFFER
) {
1591 size
= *(int32_t *)(opaque
+field
->size_offset
);
1592 if (field
->flags
& VMS_MULTIPLY
) {
1593 size
*= field
->size
;
1596 if (field
->flags
& VMS_ARRAY
) {
1597 n_elems
= field
->num
;
1598 } else if (field
->flags
& VMS_VARRAY_INT32
) {
1599 n_elems
= *(int32_t *)(opaque
+field
->num_offset
);
1600 } else if (field
->flags
& VMS_VARRAY_UINT32
) {
1601 n_elems
= *(uint32_t *)(opaque
+field
->num_offset
);
1602 } else if (field
->flags
& VMS_VARRAY_UINT16
) {
1603 n_elems
= *(uint16_t *)(opaque
+field
->num_offset
);
1604 } else if (field
->flags
& VMS_VARRAY_UINT8
) {
1605 n_elems
= *(uint8_t *)(opaque
+field
->num_offset
);
1607 if (field
->flags
& VMS_POINTER
) {
1608 base_addr
= *(void **)base_addr
+ field
->start
;
1610 for (i
= 0; i
< n_elems
; i
++) {
1611 void *addr
= base_addr
+ size
* i
;
1613 if (field
->flags
& VMS_ARRAY_OF_POINTER
) {
1614 addr
= *(void **)addr
;
1616 if (field
->flags
& VMS_STRUCT
) {
1617 ret
= vmstate_load_state(f
, field
->vmsd
, addr
, field
->vmsd
->version_id
);
1619 ret
= field
->info
->get(f
, addr
, size
);
1629 ret
= vmstate_subsection_load(f
, vmsd
, opaque
);
1633 if (vmsd
->post_load
) {
1634 return vmsd
->post_load(opaque
, version_id
);
1639 void vmstate_save_state(QEMUFile
*f
, const VMStateDescription
*vmsd
,
1642 VMStateField
*field
= vmsd
->fields
;
1644 if (vmsd
->pre_save
) {
1645 vmsd
->pre_save(opaque
);
1647 while(field
->name
) {
1648 if (!field
->field_exists
||
1649 field
->field_exists(opaque
, vmsd
->version_id
)) {
1650 void *base_addr
= opaque
+ field
->offset
;
1652 int size
= field
->size
;
1654 if (field
->flags
& VMS_VBUFFER
) {
1655 size
= *(int32_t *)(opaque
+field
->size_offset
);
1656 if (field
->flags
& VMS_MULTIPLY
) {
1657 size
*= field
->size
;
1660 if (field
->flags
& VMS_ARRAY
) {
1661 n_elems
= field
->num
;
1662 } else if (field
->flags
& VMS_VARRAY_INT32
) {
1663 n_elems
= *(int32_t *)(opaque
+field
->num_offset
);
1664 } else if (field
->flags
& VMS_VARRAY_UINT32
) {
1665 n_elems
= *(uint32_t *)(opaque
+field
->num_offset
);
1666 } else if (field
->flags
& VMS_VARRAY_UINT16
) {
1667 n_elems
= *(uint16_t *)(opaque
+field
->num_offset
);
1668 } else if (field
->flags
& VMS_VARRAY_UINT8
) {
1669 n_elems
= *(uint8_t *)(opaque
+field
->num_offset
);
1671 if (field
->flags
& VMS_POINTER
) {
1672 base_addr
= *(void **)base_addr
+ field
->start
;
1674 for (i
= 0; i
< n_elems
; i
++) {
1675 void *addr
= base_addr
+ size
* i
;
1677 if (field
->flags
& VMS_ARRAY_OF_POINTER
) {
1678 addr
= *(void **)addr
;
1680 if (field
->flags
& VMS_STRUCT
) {
1681 vmstate_save_state(f
, field
->vmsd
, addr
);
1683 field
->info
->put(f
, addr
, size
);
1689 vmstate_subsection_save(f
, vmsd
, opaque
);
1692 static int vmstate_load(QEMUFile
*f
, SaveStateEntry
*se
, int version_id
)
1694 if (!se
->vmsd
) { /* Old style */
1695 return se
->ops
->load_state(f
, se
->opaque
, version_id
);
1697 return vmstate_load_state(f
, se
->vmsd
, se
->opaque
, version_id
);
1700 static void vmstate_save(QEMUFile
*f
, SaveStateEntry
*se
)
1702 if (!se
->vmsd
) { /* Old style */
1703 se
->ops
->save_state(f
, se
->opaque
);
1706 vmstate_save_state(f
,se
->vmsd
, se
->opaque
);
1709 #define QEMU_VM_FILE_MAGIC 0x5145564d
1710 #define QEMU_VM_FILE_VERSION_COMPAT 0x00000002
1711 #define QEMU_VM_FILE_VERSION 0x00000003
1713 #define QEMU_VM_EOF 0x00
1714 #define QEMU_VM_SECTION_START 0x01
1715 #define QEMU_VM_SECTION_PART 0x02
1716 #define QEMU_VM_SECTION_END 0x03
1717 #define QEMU_VM_SECTION_FULL 0x04
1718 #define QEMU_VM_SUBSECTION 0x05
1720 bool qemu_savevm_state_blocked(Error
**errp
)
1724 QTAILQ_FOREACH(se
, &savevm_handlers
, entry
) {
1725 if (se
->no_migrate
) {
1726 error_set(errp
, QERR_MIGRATION_NOT_SUPPORTED
, se
->idstr
);
1733 void qemu_savevm_state_begin(QEMUFile
*f
,
1734 const MigrationParams
*params
)
1739 QTAILQ_FOREACH(se
, &savevm_handlers
, entry
) {
1740 if (!se
->ops
|| !se
->ops
->set_params
) {
1743 se
->ops
->set_params(params
, se
->opaque
);
1746 qemu_put_be32(f
, QEMU_VM_FILE_MAGIC
);
1747 qemu_put_be32(f
, QEMU_VM_FILE_VERSION
);
1749 QTAILQ_FOREACH(se
, &savevm_handlers
, entry
) {
1752 if (!se
->ops
|| !se
->ops
->save_live_setup
) {
1755 if (se
->ops
&& se
->ops
->is_active
) {
1756 if (!se
->ops
->is_active(se
->opaque
)) {
1761 qemu_put_byte(f
, QEMU_VM_SECTION_START
);
1762 qemu_put_be32(f
, se
->section_id
);
1765 len
= strlen(se
->idstr
);
1766 qemu_put_byte(f
, len
);
1767 qemu_put_buffer(f
, (uint8_t *)se
->idstr
, len
);
1769 qemu_put_be32(f
, se
->instance_id
);
1770 qemu_put_be32(f
, se
->version_id
);
1772 ret
= se
->ops
->save_live_setup(f
, se
->opaque
);
1774 qemu_file_set_error(f
, ret
);
1781 * this function has three return values:
1782 * negative: there was one error, and we have -errno.
1783 * 0 : We haven't finished, caller have to go again
1784 * 1 : We have finished, we can go to complete phase
1786 int qemu_savevm_state_iterate(QEMUFile
*f
)
1791 QTAILQ_FOREACH(se
, &savevm_handlers
, entry
) {
1792 if (!se
->ops
|| !se
->ops
->save_live_iterate
) {
1795 if (se
->ops
&& se
->ops
->is_active
) {
1796 if (!se
->ops
->is_active(se
->opaque
)) {
1800 if (qemu_file_rate_limit(f
)) {
1803 trace_savevm_section_start();
1805 qemu_put_byte(f
, QEMU_VM_SECTION_PART
);
1806 qemu_put_be32(f
, se
->section_id
);
1808 ret
= se
->ops
->save_live_iterate(f
, se
->opaque
);
1809 trace_savevm_section_end(se
->section_id
);
1812 qemu_file_set_error(f
, ret
);
1815 /* Do not proceed to the next vmstate before this one reported
1816 completion of the current stage. This serializes the migration
1817 and reduces the probability that a faster changing state is
1818 synchronized over and over again. */
1825 void qemu_savevm_state_complete(QEMUFile
*f
)
1830 cpu_synchronize_all_states();
1832 QTAILQ_FOREACH(se
, &savevm_handlers
, entry
) {
1833 if (!se
->ops
|| !se
->ops
->save_live_complete
) {
1836 if (se
->ops
&& se
->ops
->is_active
) {
1837 if (!se
->ops
->is_active(se
->opaque
)) {
1841 trace_savevm_section_start();
1843 qemu_put_byte(f
, QEMU_VM_SECTION_END
);
1844 qemu_put_be32(f
, se
->section_id
);
1846 ret
= se
->ops
->save_live_complete(f
, se
->opaque
);
1847 trace_savevm_section_end(se
->section_id
);
1849 qemu_file_set_error(f
, ret
);
1854 QTAILQ_FOREACH(se
, &savevm_handlers
, entry
) {
1857 if ((!se
->ops
|| !se
->ops
->save_state
) && !se
->vmsd
) {
1860 trace_savevm_section_start();
1862 qemu_put_byte(f
, QEMU_VM_SECTION_FULL
);
1863 qemu_put_be32(f
, se
->section_id
);
1866 len
= strlen(se
->idstr
);
1867 qemu_put_byte(f
, len
);
1868 qemu_put_buffer(f
, (uint8_t *)se
->idstr
, len
);
1870 qemu_put_be32(f
, se
->instance_id
);
1871 qemu_put_be32(f
, se
->version_id
);
1873 vmstate_save(f
, se
);
1874 trace_savevm_section_end(se
->section_id
);
1877 qemu_put_byte(f
, QEMU_VM_EOF
);
1881 uint64_t qemu_savevm_state_pending(QEMUFile
*f
, uint64_t max_size
)
1886 QTAILQ_FOREACH(se
, &savevm_handlers
, entry
) {
1887 if (!se
->ops
|| !se
->ops
->save_live_pending
) {
1890 if (se
->ops
&& se
->ops
->is_active
) {
1891 if (!se
->ops
->is_active(se
->opaque
)) {
1895 ret
+= se
->ops
->save_live_pending(f
, se
->opaque
, max_size
);
1900 void qemu_savevm_state_cancel(void)
1904 QTAILQ_FOREACH(se
, &savevm_handlers
, entry
) {
1905 if (se
->ops
&& se
->ops
->cancel
) {
1906 se
->ops
->cancel(se
->opaque
);
1911 static int qemu_savevm_state(QEMUFile
*f
)
1914 MigrationParams params
= {
1919 if (qemu_savevm_state_blocked(NULL
)) {
1923 qemu_mutex_unlock_iothread();
1924 qemu_savevm_state_begin(f
, ¶ms
);
1925 qemu_mutex_lock_iothread();
1927 while (qemu_file_get_error(f
) == 0) {
1928 if (qemu_savevm_state_iterate(f
) > 0) {
1933 ret
= qemu_file_get_error(f
);
1935 qemu_savevm_state_complete(f
);
1936 ret
= qemu_file_get_error(f
);
1939 qemu_savevm_state_cancel();
1944 static int qemu_save_device_state(QEMUFile
*f
)
1948 qemu_put_be32(f
, QEMU_VM_FILE_MAGIC
);
1949 qemu_put_be32(f
, QEMU_VM_FILE_VERSION
);
1951 cpu_synchronize_all_states();
1953 QTAILQ_FOREACH(se
, &savevm_handlers
, entry
) {
1959 if ((!se
->ops
|| !se
->ops
->save_state
) && !se
->vmsd
) {
1964 qemu_put_byte(f
, QEMU_VM_SECTION_FULL
);
1965 qemu_put_be32(f
, se
->section_id
);
1968 len
= strlen(se
->idstr
);
1969 qemu_put_byte(f
, len
);
1970 qemu_put_buffer(f
, (uint8_t *)se
->idstr
, len
);
1972 qemu_put_be32(f
, se
->instance_id
);
1973 qemu_put_be32(f
, se
->version_id
);
1975 vmstate_save(f
, se
);
1978 qemu_put_byte(f
, QEMU_VM_EOF
);
1980 return qemu_file_get_error(f
);
1983 static SaveStateEntry
*find_se(const char *idstr
, int instance_id
)
1987 QTAILQ_FOREACH(se
, &savevm_handlers
, entry
) {
1988 if (!strcmp(se
->idstr
, idstr
) &&
1989 (instance_id
== se
->instance_id
||
1990 instance_id
== se
->alias_id
))
1992 /* Migrating from an older version? */
1993 if (strstr(se
->idstr
, idstr
) && se
->compat
) {
1994 if (!strcmp(se
->compat
->idstr
, idstr
) &&
1995 (instance_id
== se
->compat
->instance_id
||
1996 instance_id
== se
->alias_id
))
2003 static const VMStateDescription
*vmstate_get_subsection(const VMStateSubsection
*sub
, char *idstr
)
2005 while(sub
&& sub
->needed
) {
2006 if (strcmp(idstr
, sub
->vmsd
->name
) == 0) {
2014 static int vmstate_subsection_load(QEMUFile
*f
, const VMStateDescription
*vmsd
,
2017 while (qemu_peek_byte(f
, 0) == QEMU_VM_SUBSECTION
) {
2020 uint8_t version_id
, len
, size
;
2021 const VMStateDescription
*sub_vmsd
;
2023 len
= qemu_peek_byte(f
, 1);
2024 if (len
< strlen(vmsd
->name
) + 1) {
2025 /* subsection name has be be "section_name/a" */
2028 size
= qemu_peek_buffer(f
, (uint8_t *)idstr
, len
, 2);
2034 if (strncmp(vmsd
->name
, idstr
, strlen(vmsd
->name
)) != 0) {
2035 /* it don't have a valid subsection name */
2038 sub_vmsd
= vmstate_get_subsection(vmsd
->subsections
, idstr
);
2039 if (sub_vmsd
== NULL
) {
2042 qemu_file_skip(f
, 1); /* subsection */
2043 qemu_file_skip(f
, 1); /* len */
2044 qemu_file_skip(f
, len
); /* idstr */
2045 version_id
= qemu_get_be32(f
);
2047 ret
= vmstate_load_state(f
, sub_vmsd
, opaque
, version_id
);
2055 static void vmstate_subsection_save(QEMUFile
*f
, const VMStateDescription
*vmsd
,
2058 const VMStateSubsection
*sub
= vmsd
->subsections
;
2060 while (sub
&& sub
->needed
) {
2061 if (sub
->needed(opaque
)) {
2062 const VMStateDescription
*vmsd
= sub
->vmsd
;
2065 qemu_put_byte(f
, QEMU_VM_SUBSECTION
);
2066 len
= strlen(vmsd
->name
);
2067 qemu_put_byte(f
, len
);
2068 qemu_put_buffer(f
, (uint8_t *)vmsd
->name
, len
);
2069 qemu_put_be32(f
, vmsd
->version_id
);
2070 vmstate_save_state(f
, vmsd
, opaque
);
2076 typedef struct LoadStateEntry
{
2077 QLIST_ENTRY(LoadStateEntry
) entry
;
2083 int qemu_loadvm_state(QEMUFile
*f
)
2085 QLIST_HEAD(, LoadStateEntry
) loadvm_handlers
=
2086 QLIST_HEAD_INITIALIZER(loadvm_handlers
);
2087 LoadStateEntry
*le
, *new_le
;
2088 uint8_t section_type
;
2092 if (qemu_savevm_state_blocked(NULL
)) {
2096 v
= qemu_get_be32(f
);
2097 if (v
!= QEMU_VM_FILE_MAGIC
)
2100 v
= qemu_get_be32(f
);
2101 if (v
== QEMU_VM_FILE_VERSION_COMPAT
) {
2102 fprintf(stderr
, "SaveVM v2 format is obsolete and don't work anymore\n");
2105 if (v
!= QEMU_VM_FILE_VERSION
)
2108 while ((section_type
= qemu_get_byte(f
)) != QEMU_VM_EOF
) {
2109 uint32_t instance_id
, version_id
, section_id
;
2114 switch (section_type
) {
2115 case QEMU_VM_SECTION_START
:
2116 case QEMU_VM_SECTION_FULL
:
2117 /* Read section start */
2118 section_id
= qemu_get_be32(f
);
2119 len
= qemu_get_byte(f
);
2120 qemu_get_buffer(f
, (uint8_t *)idstr
, len
);
2122 instance_id
= qemu_get_be32(f
);
2123 version_id
= qemu_get_be32(f
);
2125 /* Find savevm section */
2126 se
= find_se(idstr
, instance_id
);
2128 fprintf(stderr
, "Unknown savevm section or instance '%s' %d\n", idstr
, instance_id
);
2133 /* Validate version */
2134 if (version_id
> se
->version_id
) {
2135 fprintf(stderr
, "savevm: unsupported version %d for '%s' v%d\n",
2136 version_id
, idstr
, se
->version_id
);
2142 le
= g_malloc0(sizeof(*le
));
2145 le
->section_id
= section_id
;
2146 le
->version_id
= version_id
;
2147 QLIST_INSERT_HEAD(&loadvm_handlers
, le
, entry
);
2149 ret
= vmstate_load(f
, le
->se
, le
->version_id
);
2151 fprintf(stderr
, "qemu: warning: error while loading state for instance 0x%x of device '%s'\n",
2152 instance_id
, idstr
);
2156 case QEMU_VM_SECTION_PART
:
2157 case QEMU_VM_SECTION_END
:
2158 section_id
= qemu_get_be32(f
);
2160 QLIST_FOREACH(le
, &loadvm_handlers
, entry
) {
2161 if (le
->section_id
== section_id
) {
2166 fprintf(stderr
, "Unknown savevm section %d\n", section_id
);
2171 ret
= vmstate_load(f
, le
->se
, le
->version_id
);
2173 fprintf(stderr
, "qemu: warning: error while loading state section id %d\n",
2179 fprintf(stderr
, "Unknown savevm section type %d\n", section_type
);
2185 cpu_synchronize_all_post_init();
2190 QLIST_FOREACH_SAFE(le
, &loadvm_handlers
, entry
, new_le
) {
2191 QLIST_REMOVE(le
, entry
);
2196 ret
= qemu_file_get_error(f
);
2202 static int bdrv_snapshot_find(BlockDriverState
*bs
, QEMUSnapshotInfo
*sn_info
,
2205 QEMUSnapshotInfo
*sn_tab
, *sn
;
2209 nb_sns
= bdrv_snapshot_list(bs
, &sn_tab
);
2212 for(i
= 0; i
< nb_sns
; i
++) {
2214 if (!strcmp(sn
->id_str
, name
) || !strcmp(sn
->name
, name
)) {
2225 * Deletes snapshots of a given name in all opened images.
2227 static int del_existing_snapshots(Monitor
*mon
, const char *name
)
2229 BlockDriverState
*bs
;
2230 QEMUSnapshotInfo sn1
, *snapshot
= &sn1
;
2234 while ((bs
= bdrv_next(bs
))) {
2235 if (bdrv_can_snapshot(bs
) &&
2236 bdrv_snapshot_find(bs
, snapshot
, name
) >= 0)
2238 ret
= bdrv_snapshot_delete(bs
, name
);
2241 "Error while deleting snapshot on '%s'\n",
2242 bdrv_get_device_name(bs
));
2251 void do_savevm(Monitor
*mon
, const QDict
*qdict
)
2253 BlockDriverState
*bs
, *bs1
;
2254 QEMUSnapshotInfo sn1
, *sn
= &sn1
, old_sn1
, *old_sn
= &old_sn1
;
2257 int saved_vm_running
;
2258 uint64_t vm_state_size
;
2261 const char *name
= qdict_get_try_str(qdict
, "name");
2263 /* Verify if there is a device that doesn't support snapshots and is writable */
2265 while ((bs
= bdrv_next(bs
))) {
2267 if (!bdrv_is_inserted(bs
) || bdrv_is_read_only(bs
)) {
2271 if (!bdrv_can_snapshot(bs
)) {
2272 monitor_printf(mon
, "Device '%s' is writable but does not support snapshots.\n",
2273 bdrv_get_device_name(bs
));
2278 bs
= bdrv_snapshots();
2280 monitor_printf(mon
, "No block device can accept snapshots\n");
2284 saved_vm_running
= runstate_is_running();
2285 vm_stop(RUN_STATE_SAVE_VM
);
2287 memset(sn
, 0, sizeof(*sn
));
2289 /* fill auxiliary fields */
2290 qemu_gettimeofday(&tv
);
2291 sn
->date_sec
= tv
.tv_sec
;
2292 sn
->date_nsec
= tv
.tv_usec
* 1000;
2293 sn
->vm_clock_nsec
= qemu_get_clock_ns(vm_clock
);
2296 ret
= bdrv_snapshot_find(bs
, old_sn
, name
);
2298 pstrcpy(sn
->name
, sizeof(sn
->name
), old_sn
->name
);
2299 pstrcpy(sn
->id_str
, sizeof(sn
->id_str
), old_sn
->id_str
);
2301 pstrcpy(sn
->name
, sizeof(sn
->name
), name
);
2304 /* cast below needed for OpenBSD where tv_sec is still 'long' */
2305 localtime_r((const time_t *)&tv
.tv_sec
, &tm
);
2306 strftime(sn
->name
, sizeof(sn
->name
), "vm-%Y%m%d%H%M%S", &tm
);
2309 /* Delete old snapshots of the same name */
2310 if (name
&& del_existing_snapshots(mon
, name
) < 0) {
2314 /* save the VM state */
2315 f
= qemu_fopen_bdrv(bs
, 1);
2317 monitor_printf(mon
, "Could not open VM state file\n");
2320 ret
= qemu_savevm_state(f
);
2321 vm_state_size
= qemu_ftell(f
);
2324 monitor_printf(mon
, "Error %d while writing VM\n", ret
);
2328 /* create the snapshots */
2331 while ((bs1
= bdrv_next(bs1
))) {
2332 if (bdrv_can_snapshot(bs1
)) {
2333 /* Write VM state size only to the image that contains the state */
2334 sn
->vm_state_size
= (bs
== bs1
? vm_state_size
: 0);
2335 ret
= bdrv_snapshot_create(bs1
, sn
);
2337 monitor_printf(mon
, "Error while creating snapshot on '%s'\n",
2338 bdrv_get_device_name(bs1
));
2344 if (saved_vm_running
)
2348 void qmp_xen_save_devices_state(const char *filename
, Error
**errp
)
2351 int saved_vm_running
;
2354 saved_vm_running
= runstate_is_running();
2355 vm_stop(RUN_STATE_SAVE_VM
);
2357 f
= qemu_fopen(filename
, "wb");
2359 error_set(errp
, QERR_OPEN_FILE_FAILED
, filename
);
2362 ret
= qemu_save_device_state(f
);
2365 error_set(errp
, QERR_IO_ERROR
);
2369 if (saved_vm_running
)
2373 int load_vmstate(const char *name
)
2375 BlockDriverState
*bs
, *bs_vm_state
;
2376 QEMUSnapshotInfo sn
;
2380 bs_vm_state
= bdrv_snapshots();
2382 error_report("No block device supports snapshots");
2386 /* Don't even try to load empty VM states */
2387 ret
= bdrv_snapshot_find(bs_vm_state
, &sn
, name
);
2390 } else if (sn
.vm_state_size
== 0) {
2391 error_report("This is a disk-only snapshot. Revert to it offline "
2396 /* Verify if there is any device that doesn't support snapshots and is
2397 writable and check if the requested snapshot is available too. */
2399 while ((bs
= bdrv_next(bs
))) {
2401 if (!bdrv_is_inserted(bs
) || bdrv_is_read_only(bs
)) {
2405 if (!bdrv_can_snapshot(bs
)) {
2406 error_report("Device '%s' is writable but does not support snapshots.",
2407 bdrv_get_device_name(bs
));
2411 ret
= bdrv_snapshot_find(bs
, &sn
, name
);
2413 error_report("Device '%s' does not have the requested snapshot '%s'",
2414 bdrv_get_device_name(bs
), name
);
2419 /* Flush all IO requests so they don't interfere with the new state. */
2423 while ((bs
= bdrv_next(bs
))) {
2424 if (bdrv_can_snapshot(bs
)) {
2425 ret
= bdrv_snapshot_goto(bs
, name
);
2427 error_report("Error %d while activating snapshot '%s' on '%s'",
2428 ret
, name
, bdrv_get_device_name(bs
));
2434 /* restore the VM state */
2435 f
= qemu_fopen_bdrv(bs_vm_state
, 0);
2437 error_report("Could not open VM state file");
2441 qemu_system_reset(VMRESET_SILENT
);
2442 ret
= qemu_loadvm_state(f
);
2446 error_report("Error %d while loading VM state", ret
);
2453 void do_delvm(Monitor
*mon
, const QDict
*qdict
)
2455 BlockDriverState
*bs
, *bs1
;
2457 const char *name
= qdict_get_str(qdict
, "name");
2459 bs
= bdrv_snapshots();
2461 monitor_printf(mon
, "No block device supports snapshots\n");
2466 while ((bs1
= bdrv_next(bs1
))) {
2467 if (bdrv_can_snapshot(bs1
)) {
2468 ret
= bdrv_snapshot_delete(bs1
, name
);
2470 if (ret
== -ENOTSUP
)
2472 "Snapshots not supported on device '%s'\n",
2473 bdrv_get_device_name(bs1
));
2475 monitor_printf(mon
, "Error %d while deleting snapshot on "
2476 "'%s'\n", ret
, bdrv_get_device_name(bs1
));
2482 void do_info_snapshots(Monitor
*mon
, const QDict
*qdict
)
2484 BlockDriverState
*bs
, *bs1
;
2485 QEMUSnapshotInfo
*sn_tab
, *sn
, s
, *sn_info
= &s
;
2486 int nb_sns
, i
, ret
, available
;
2488 int *available_snapshots
;
2491 bs
= bdrv_snapshots();
2493 monitor_printf(mon
, "No available block device supports snapshots\n");
2497 nb_sns
= bdrv_snapshot_list(bs
, &sn_tab
);
2499 monitor_printf(mon
, "bdrv_snapshot_list: error %d\n", nb_sns
);
2504 monitor_printf(mon
, "There is no snapshot available.\n");
2508 available_snapshots
= g_malloc0(sizeof(int) * nb_sns
);
2510 for (i
= 0; i
< nb_sns
; i
++) {
2515 while ((bs1
= bdrv_next(bs1
))) {
2516 if (bdrv_can_snapshot(bs1
) && bs1
!= bs
) {
2517 ret
= bdrv_snapshot_find(bs1
, sn_info
, sn
->id_str
);
2526 available_snapshots
[total
] = i
;
2532 monitor_printf(mon
, "%s\n", bdrv_snapshot_dump(buf
, sizeof(buf
), NULL
));
2533 for (i
= 0; i
< total
; i
++) {
2534 sn
= &sn_tab
[available_snapshots
[i
]];
2535 monitor_printf(mon
, "%s\n", bdrv_snapshot_dump(buf
, sizeof(buf
), sn
));
2538 monitor_printf(mon
, "There is no suitable snapshot available\n");
2542 g_free(available_snapshots
);
2546 void vmstate_register_ram(MemoryRegion
*mr
, DeviceState
*dev
)
2548 qemu_ram_set_idstr(memory_region_get_ram_addr(mr
) & TARGET_PAGE_MASK
,
2549 memory_region_name(mr
), dev
);
2552 void vmstate_unregister_ram(MemoryRegion
*mr
, DeviceState
*dev
)
2554 /* Nothing do to while the implementation is in RAMBlock */
2557 void vmstate_register_ram_global(MemoryRegion
*mr
)
2559 vmstate_register_ram(mr
, NULL
);