4 * Copyright IBM, Corp. 2012
5 * Copyright Red Hat, Inc. 2012
6 * Copyright SUSE LINUX Products GmbH 2013
9 * Anthony Liguori <aliguori@us.ibm.com>
10 * Paolo Bonzini <pbonzini@redhat.com>
11 * Andreas Färber <afaerber@suse.de>
13 * This work is licensed under the terms of the GNU GPL, version 2 or later.
14 * See the COPYING file in the top-level directory.
17 #include "qemu/osdep.h"
19 #include <sys/socket.h>
23 #include "libqos/libqtest.h"
24 #include "qemu-common.h"
25 #include "qemu/ctype.h"
26 #include "qemu/cutils.h"
27 #include "qapi/error.h"
28 #include "qapi/qmp/json-parser.h"
29 #include "qapi/qmp/qdict.h"
30 #include "qapi/qmp/qjson.h"
31 #include "qapi/qmp/qlist.h"
32 #include "qapi/qmp/qstring.h"
35 #define SOCKET_TIMEOUT 50
36 #define SOCKET_MAX_FDS 16
39 typedef void (*QTestSendFn
)(QTestState
*s
, const char *buf
);
40 typedef void (*ExternalSendFn
)(void *s
, const char *buf
);
41 typedef GString
* (*QTestRecvFn
)(QTestState
*);
43 typedef struct QTestClientTransportOps
{
44 QTestSendFn send
; /* for sending qtest commands */
47 * use external_send to send qtest command strings through functions which
48 * do not accept a QTestState as the first parameter.
50 ExternalSendFn external_send
;
52 QTestRecvFn recv_line
; /* for receiving qtest command responses */
59 pid_t qemu_pid
; /* our child QEMU process */
63 bool irq_level
[MAX_IRQ
];
65 QTestTransportOps ops
;
66 GList
*pending_events
;
69 static GHookList abrt_hooks
;
70 static struct sigaction sigact_old
;
72 static int qtest_query_target_endianness(QTestState
*s
);
74 static void qtest_client_socket_send(QTestState
*, const char *buf
);
75 static void socket_send(int fd
, const char *buf
, size_t size
);
77 static GString
*qtest_client_socket_recv_line(QTestState
*);
79 static void qtest_client_set_tx_handler(QTestState
*s
, QTestSendFn send
);
80 static void qtest_client_set_rx_handler(QTestState
*s
, QTestRecvFn recv
);
82 static int init_socket(const char *socket_path
)
84 int sock
= qtest_socket_server(socket_path
);
85 qemu_set_cloexec(sock
);
89 static int socket_accept(int sock
)
91 struct sockaddr_un addr
;
94 struct timeval timeout
= { .tv_sec
= SOCKET_TIMEOUT
,
97 if (qemu_setsockopt(sock
, SOL_SOCKET
, SO_RCVTIMEO
,
98 (void *)&timeout
, sizeof(timeout
))) {
99 fprintf(stderr
, "%s failed to set SO_RCVTIMEO: %s\n",
100 __func__
, strerror(errno
));
106 addrlen
= sizeof(addr
);
107 ret
= accept(sock
, (struct sockaddr
*)&addr
, &addrlen
);
108 } while (ret
== -1 && errno
== EINTR
);
110 fprintf(stderr
, "%s failed: %s\n", __func__
, strerror(errno
));
117 bool qtest_probe_child(QTestState
*s
)
119 pid_t pid
= s
->qemu_pid
;
122 pid
= waitpid(pid
, &s
->wstatus
, WNOHANG
);
131 void qtest_set_expected_status(QTestState
*s
, int status
)
133 s
->expected_status
= status
;
136 void qtest_kill_qemu(QTestState
*s
)
138 pid_t pid
= s
->qemu_pid
;
141 /* Skip wait if qtest_probe_child already reaped. */
144 TFR(pid
= waitpid(s
->qemu_pid
, &s
->wstatus
, 0));
145 assert(pid
== s
->qemu_pid
);
150 * Check whether qemu exited with expected exit status; anything else is
151 * fishy and should be logged with as much detail as possible.
153 wstatus
= s
->wstatus
;
154 if (WIFEXITED(wstatus
) && WEXITSTATUS(wstatus
) != s
->expected_status
) {
155 fprintf(stderr
, "%s:%d: kill_qemu() tried to terminate QEMU "
156 "process but encountered exit status %d (expected %d)\n",
157 __FILE__
, __LINE__
, WEXITSTATUS(wstatus
), s
->expected_status
);
159 } else if (WIFSIGNALED(wstatus
)) {
160 int sig
= WTERMSIG(wstatus
);
161 const char *signame
= strsignal(sig
) ?: "unknown ???";
162 const char *dump
= WCOREDUMP(wstatus
) ? " (core dumped)" : "";
164 fprintf(stderr
, "%s:%d: kill_qemu() detected QEMU death "
165 "from signal %d (%s)%s\n",
166 __FILE__
, __LINE__
, sig
, signame
, dump
);
171 static void kill_qemu_hook_func(void *s
)
176 static void sigabrt_handler(int signo
)
178 g_hook_list_invoke(&abrt_hooks
, FALSE
);
181 static void setup_sigabrt_handler(void)
183 struct sigaction sigact
;
185 /* Catch SIGABRT to clean up on g_assert() failure */
186 sigact
= (struct sigaction
){
187 .sa_handler
= sigabrt_handler
,
188 .sa_flags
= SA_RESETHAND
,
190 sigemptyset(&sigact
.sa_mask
);
191 sigaction(SIGABRT
, &sigact
, &sigact_old
);
194 static void cleanup_sigabrt_handler(void)
196 sigaction(SIGABRT
, &sigact_old
, NULL
);
199 static bool hook_list_is_empty(GHookList
*hook_list
)
201 GHook
*hook
= g_hook_first_valid(hook_list
, TRUE
);
207 g_hook_unref(hook_list
, hook
);
211 void qtest_add_abrt_handler(GHookFunc fn
, const void *data
)
215 if (!abrt_hooks
.is_setup
) {
216 g_hook_list_init(&abrt_hooks
, sizeof(GHook
));
219 /* Only install SIGABRT handler once */
220 if (hook_list_is_empty(&abrt_hooks
)) {
221 setup_sigabrt_handler();
224 hook
= g_hook_alloc(&abrt_hooks
);
226 hook
->data
= (void *)data
;
228 g_hook_prepend(&abrt_hooks
, hook
);
231 void qtest_remove_abrt_handler(void *data
)
233 GHook
*hook
= g_hook_find_data(&abrt_hooks
, TRUE
, data
);
234 g_hook_destroy_link(&abrt_hooks
, hook
);
236 /* Uninstall SIGABRT handler on last instance */
237 if (hook_list_is_empty(&abrt_hooks
)) {
238 cleanup_sigabrt_handler();
242 static const char *qtest_qemu_binary(void)
244 const char *qemu_bin
;
246 qemu_bin
= getenv("QTEST_QEMU_BINARY");
248 fprintf(stderr
, "Environment variable QTEST_QEMU_BINARY required\n");
255 QTestState
*qtest_init_without_qmp_handshake(const char *extra_args
)
258 int sock
, qmpsock
, i
;
260 gchar
*qmp_socket_path
;
262 const char *qemu_binary
= qtest_qemu_binary();
264 s
= g_new(QTestState
, 1);
266 socket_path
= g_strdup_printf("/tmp/qtest-%d.sock", getpid());
267 qmp_socket_path
= g_strdup_printf("/tmp/qtest-%d.qmp", getpid());
269 /* It's possible that if an earlier test run crashed it might
270 * have left a stale unix socket lying around. Delete any
271 * stale old socket to avoid spurious test failures with
272 * tests/libqtest.c:70:init_socket: assertion failed (ret != -1): (-1 != -1)
275 unlink(qmp_socket_path
);
277 sock
= init_socket(socket_path
);
278 qmpsock
= init_socket(qmp_socket_path
);
280 qtest_client_set_rx_handler(s
, qtest_client_socket_recv_line
);
281 qtest_client_set_tx_handler(s
, qtest_client_socket_send
);
283 qtest_add_abrt_handler(kill_qemu_hook_func
, s
);
285 command
= g_strdup_printf("exec %s "
288 "-chardev socket,path=%s,id=char0 "
289 "-mon chardev=char0,mode=control "
292 " -accel qtest", qemu_binary
, socket_path
,
293 getenv("QTEST_LOG") ? "/dev/fd/2" : "/dev/null",
297 g_test_message("starting QEMU: %s", command
);
299 s
->pending_events
= NULL
;
301 s
->expected_status
= 0;
302 s
->qemu_pid
= fork();
303 if (s
->qemu_pid
== 0) {
304 g_setenv("QEMU_AUDIO_DRV", "none", true);
305 execlp("/bin/sh", "sh", "-c", command
, NULL
);
310 s
->fd
= socket_accept(sock
);
312 s
->qmp_fd
= socket_accept(qmpsock
);
315 unlink(qmp_socket_path
);
317 g_free(qmp_socket_path
);
319 g_assert(s
->fd
>= 0 && s
->qmp_fd
>= 0);
321 s
->rx
= g_string_new("");
322 for (i
= 0; i
< MAX_IRQ
; i
++) {
323 s
->irq_level
[i
] = false;
326 if (getenv("QTEST_STOP")) {
327 kill(s
->qemu_pid
, SIGSTOP
);
330 /* ask endianness of the target */
332 s
->big_endian
= qtest_query_target_endianness(s
);
337 QTestState
*qtest_init(const char *extra_args
)
339 QTestState
*s
= qtest_init_without_qmp_handshake(extra_args
);
342 /* Read the QMP greeting and then do the handshake */
343 greeting
= qtest_qmp_receive(s
);
344 qobject_unref(greeting
);
345 qobject_unref(qtest_qmp(s
, "{ 'execute': 'qmp_capabilities' }"));
350 QTestState
*qtest_vinitf(const char *fmt
, va_list ap
)
352 char *args
= g_strdup_vprintf(fmt
, ap
);
355 s
= qtest_init(args
);
360 QTestState
*qtest_initf(const char *fmt
, ...)
366 s
= qtest_vinitf(fmt
, ap
);
371 QTestState
*qtest_init_with_serial(const char *extra_args
, int *sock_fd
)
374 char *sock_path
, sock_dir
[] = "/tmp/qtest-serial-XXXXXX";
377 g_assert_true(mkdtemp(sock_dir
) != NULL
);
378 sock_path
= g_strdup_printf("%s/sock", sock_dir
);
380 sock_fd_init
= init_socket(sock_path
);
382 qts
= qtest_initf("-chardev socket,id=s0,path=%s -serial chardev:s0 %s",
383 sock_path
, extra_args
);
385 *sock_fd
= socket_accept(sock_fd_init
);
391 g_assert_true(*sock_fd
>= 0);
396 void qtest_quit(QTestState
*s
)
398 qtest_remove_abrt_handler(s
);
403 g_string_free(s
->rx
, true);
405 for (GList
*it
= s
->pending_events
; it
!= NULL
; it
= it
->next
) {
406 qobject_unref((QDict
*)it
->data
);
409 g_list_free(s
->pending_events
);
414 static void socket_send(int fd
, const char *buf
, size_t size
)
419 while (offset
< size
) {
422 len
= write(fd
, buf
+ offset
, size
- offset
);
423 if (len
== -1 && errno
== EINTR
) {
427 g_assert_cmpint(len
, >, 0);
433 static void qtest_client_socket_send(QTestState
*s
, const char *buf
)
435 socket_send(s
->fd
, buf
, strlen(buf
));
438 static void GCC_FMT_ATTR(2, 3) qtest_sendf(QTestState
*s
, const char *fmt
, ...)
443 gchar
*str
= g_strdup_vprintf(fmt
, ap
);
450 /* Sends a message and file descriptors to the socket.
451 * It's needed for qmp-commands like getfd/add-fd */
452 static void socket_send_fds(int socket_fd
, int *fds
, size_t fds_num
,
453 const char *buf
, size_t buf_size
)
456 struct msghdr msg
= { 0 };
457 char control
[CMSG_SPACE(sizeof(int) * SOCKET_MAX_FDS
)] = { 0 };
458 size_t fdsize
= sizeof(int) * fds_num
;
459 struct cmsghdr
*cmsg
;
460 struct iovec iov
= { .iov_base
= (char *)buf
, .iov_len
= buf_size
};
465 if (fds
&& fds_num
> 0) {
466 g_assert_cmpuint(fds_num
, <, SOCKET_MAX_FDS
);
468 msg
.msg_control
= control
;
469 msg
.msg_controllen
= CMSG_SPACE(fdsize
);
471 cmsg
= CMSG_FIRSTHDR(&msg
);
472 cmsg
->cmsg_len
= CMSG_LEN(fdsize
);
473 cmsg
->cmsg_level
= SOL_SOCKET
;
474 cmsg
->cmsg_type
= SCM_RIGHTS
;
475 memcpy(CMSG_DATA(cmsg
), fds
, fdsize
);
479 ret
= sendmsg(socket_fd
, &msg
, 0);
480 } while (ret
< 0 && errno
== EINTR
);
481 g_assert_cmpint(ret
, >, 0);
484 static GString
*qtest_client_socket_recv_line(QTestState
*s
)
490 while ((eol
= strchr(s
->rx
->str
, '\n')) == NULL
) {
494 len
= read(s
->fd
, buffer
, sizeof(buffer
));
495 if (len
== -1 && errno
== EINTR
) {
499 if (len
== -1 || len
== 0) {
500 fprintf(stderr
, "Broken pipe\n");
504 g_string_append_len(s
->rx
, buffer
, len
);
507 offset
= eol
- s
->rx
->str
;
508 line
= g_string_new_len(s
->rx
->str
, offset
);
509 g_string_erase(s
->rx
, 0, offset
+ 1);
514 static gchar
**qtest_rsp_args(QTestState
*s
, int expected_args
)
521 line
= s
->ops
.recv_line(s
);
522 words
= g_strsplit(line
->str
, " ", 0);
523 g_string_free(line
, TRUE
);
525 if (strcmp(words
[0], "IRQ") == 0) {
529 g_assert(words
[1] != NULL
);
530 g_assert(words
[2] != NULL
);
532 ret
= qemu_strtol(words
[2], NULL
, 0, &irq
);
534 g_assert_cmpint(irq
, >=, 0);
535 g_assert_cmpint(irq
, <, MAX_IRQ
);
537 if (strcmp(words
[1], "raise") == 0) {
538 s
->irq_level
[irq
] = true;
540 s
->irq_level
[irq
] = false;
547 g_assert(words
[0] != NULL
);
548 g_assert_cmpstr(words
[0], ==, "OK");
550 for (i
= 0; i
< expected_args
; i
++) {
551 g_assert(words
[i
] != NULL
);
557 static void qtest_rsp(QTestState
*s
)
559 gchar
**words
= qtest_rsp_args(s
, 0);
564 static int qtest_query_target_endianness(QTestState
*s
)
569 qtest_sendf(s
, "endianness\n");
570 args
= qtest_rsp_args(s
, 1);
571 g_assert(strcmp(args
[1], "big") == 0 || strcmp(args
[1], "little") == 0);
572 big_endian
= strcmp(args
[1], "big") == 0;
579 JSONMessageParser parser
;
583 static void qmp_response(void *opaque
, QObject
*obj
, Error
*err
)
585 QMPResponseParser
*qmp
= opaque
;
587 assert(!obj
!= !err
);
590 error_prepend(&err
, "QMP JSON response parsing failed: ");
591 error_report_err(err
);
595 g_assert(!qmp
->response
);
596 qmp
->response
= qobject_to(QDict
, obj
);
597 g_assert(qmp
->response
);
600 QDict
*qmp_fd_receive(int fd
)
602 QMPResponseParser qmp
;
603 bool log
= getenv("QTEST_LOG") != NULL
;
606 json_message_parser_init(&qmp
.parser
, qmp_response
, &qmp
, NULL
);
607 while (!qmp
.response
) {
611 len
= read(fd
, &c
, 1);
612 if (len
== -1 && errno
== EINTR
) {
616 if (len
== -1 || len
== 0) {
617 fprintf(stderr
, "Broken pipe\n");
622 len
= write(2, &c
, 1);
624 json_message_parser_feed(&qmp
.parser
, &c
, 1);
626 json_message_parser_destroy(&qmp
.parser
);
631 QDict
*qtest_qmp_receive(QTestState
*s
)
634 QDict
*response
= qtest_qmp_receive_dict(s
);
636 if (!qdict_get_try_str(response
, "event")) {
639 /* Stash the event for a later consumption */
640 s
->pending_events
= g_list_append(s
->pending_events
, response
);
644 QDict
*qtest_qmp_receive_dict(QTestState
*s
)
646 return qmp_fd_receive(s
->qmp_fd
);
649 int qtest_socket_server(const char *socket_path
)
651 struct sockaddr_un addr
;
655 sock
= socket(PF_UNIX
, SOCK_STREAM
, 0);
656 g_assert_cmpint(sock
, !=, -1);
658 addr
.sun_family
= AF_UNIX
;
659 snprintf(addr
.sun_path
, sizeof(addr
.sun_path
), "%s", socket_path
);
662 ret
= bind(sock
, (struct sockaddr
*)&addr
, sizeof(addr
));
663 } while (ret
== -1 && errno
== EINTR
);
664 g_assert_cmpint(ret
, !=, -1);
665 ret
= listen(sock
, 1);
666 g_assert_cmpint(ret
, !=, -1);
672 * Allow users to send a message without waiting for the reply,
673 * in the case that they choose to discard all replies up until
674 * a particular EVENT is received.
676 void qmp_fd_vsend_fds(int fd
, int *fds
, size_t fds_num
,
677 const char *fmt
, va_list ap
)
681 /* Going through qobject ensures we escape strings properly */
682 qobj
= qobject_from_vjsonf_nofail(fmt
, ap
);
684 /* No need to send anything for an empty QObject. */
686 int log
= getenv("QTEST_LOG") != NULL
;
687 GString
*str
= qobject_to_json(qobj
);
690 * BUG: QMP doesn't react to input until it sees a newline, an
691 * object, or an array. Work-around: give it a newline.
693 g_string_append_c(str
, '\n');
696 fprintf(stderr
, "%s", str
->str
);
698 /* Send QMP request */
699 if (fds
&& fds_num
> 0) {
700 socket_send_fds(fd
, fds
, fds_num
, str
->str
, str
->len
);
702 socket_send(fd
, str
->str
, str
->len
);
705 g_string_free(str
, true);
710 void qmp_fd_vsend(int fd
, const char *fmt
, va_list ap
)
712 qmp_fd_vsend_fds(fd
, NULL
, 0, fmt
, ap
);
715 void qtest_qmp_vsend_fds(QTestState
*s
, int *fds
, size_t fds_num
,
716 const char *fmt
, va_list ap
)
718 qmp_fd_vsend_fds(s
->qmp_fd
, fds
, fds_num
, fmt
, ap
);
721 void qtest_qmp_vsend(QTestState
*s
, const char *fmt
, va_list ap
)
723 qmp_fd_vsend_fds(s
->qmp_fd
, NULL
, 0, fmt
, ap
);
726 QDict
*qmp_fdv(int fd
, const char *fmt
, va_list ap
)
728 qmp_fd_vsend_fds(fd
, NULL
, 0, fmt
, ap
);
730 return qmp_fd_receive(fd
);
733 QDict
*qtest_vqmp_fds(QTestState
*s
, int *fds
, size_t fds_num
,
734 const char *fmt
, va_list ap
)
736 qtest_qmp_vsend_fds(s
, fds
, fds_num
, fmt
, ap
);
739 return qtest_qmp_receive(s
);
742 QDict
*qtest_vqmp(QTestState
*s
, const char *fmt
, va_list ap
)
744 qtest_qmp_vsend(s
, fmt
, ap
);
747 return qtest_qmp_receive(s
);
750 QDict
*qmp_fd(int fd
, const char *fmt
, ...)
756 response
= qmp_fdv(fd
, fmt
, ap
);
761 void qmp_fd_send(int fd
, const char *fmt
, ...)
766 qmp_fd_vsend(fd
, fmt
, ap
);
770 QDict
*qtest_qmp_fds(QTestState
*s
, int *fds
, size_t fds_num
,
771 const char *fmt
, ...)
777 response
= qtest_vqmp_fds(s
, fds
, fds_num
, fmt
, ap
);
782 QDict
*qtest_qmp(QTestState
*s
, const char *fmt
, ...)
788 response
= qtest_vqmp(s
, fmt
, ap
);
793 void qtest_qmp_send(QTestState
*s
, const char *fmt
, ...)
798 qtest_qmp_vsend(s
, fmt
, ap
);
802 void qmp_fd_vsend_raw(int fd
, const char *fmt
, va_list ap
)
804 bool log
= getenv("QTEST_LOG") != NULL
;
805 char *str
= g_strdup_vprintf(fmt
, ap
);
808 fprintf(stderr
, "%s", str
);
810 socket_send(fd
, str
, strlen(str
));
814 void qmp_fd_send_raw(int fd
, const char *fmt
, ...)
819 qmp_fd_vsend_raw(fd
, fmt
, ap
);
823 void qtest_qmp_send_raw(QTestState
*s
, const char *fmt
, ...)
828 qmp_fd_vsend_raw(s
->qmp_fd
, fmt
, ap
);
832 QDict
*qtest_qmp_event_ref(QTestState
*s
, const char *event
)
834 while (s
->pending_events
) {
836 GList
*first
= s
->pending_events
;
837 QDict
*response
= (QDict
*)first
->data
;
839 s
->pending_events
= g_list_delete_link(s
->pending_events
, first
);
841 if (!strcmp(qdict_get_str(response
, "event"), event
)) {
844 qobject_unref(response
);
849 QDict
*qtest_qmp_eventwait_ref(QTestState
*s
, const char *event
)
851 QDict
*response
= qtest_qmp_event_ref(s
, event
);
858 response
= qtest_qmp_receive_dict(s
);
859 if ((qdict_haskey(response
, "event")) &&
860 (strcmp(qdict_get_str(response
, "event"), event
) == 0)) {
863 qobject_unref(response
);
867 void qtest_qmp_eventwait(QTestState
*s
, const char *event
)
871 response
= qtest_qmp_eventwait_ref(s
, event
);
872 qobject_unref(response
);
875 char *qtest_vhmp(QTestState
*s
, const char *fmt
, va_list ap
)
881 cmd
= g_strdup_vprintf(fmt
, ap
);
882 resp
= qtest_qmp(s
, "{'execute': 'human-monitor-command',"
883 " 'arguments': {'command-line': %s}}",
885 ret
= g_strdup(qdict_get_try_str(resp
, "return"));
892 char *qtest_hmp(QTestState
*s
, const char *fmt
, ...)
898 ret
= qtest_vhmp(s
, fmt
, ap
);
903 const char *qtest_get_arch(void)
905 const char *qemu
= qtest_qemu_binary();
906 const char *end
= strrchr(qemu
, '-');
909 fprintf(stderr
, "Can't determine architecture from binary name.\n");
913 if (!strstr(qemu
, "-system-")) {
914 fprintf(stderr
, "QTEST_QEMU_BINARY must end with *-system-<arch> "
915 "where 'arch' is the target\narchitecture (x86_64, aarch64, "
923 bool qtest_get_irq(QTestState
*s
, int num
)
925 /* dummy operation in order to make sure irq is up to date */
928 return s
->irq_level
[num
];
931 void qtest_module_load(QTestState
*s
, const char *prefix
, const char *libname
)
933 qtest_sendf(s
, "module_load %s %s\n", prefix
, libname
);
937 static int64_t qtest_clock_rsp(QTestState
*s
)
941 words
= qtest_rsp_args(s
, 2);
942 clock
= g_ascii_strtoll(words
[1], NULL
, 0);
947 int64_t qtest_clock_step_next(QTestState
*s
)
949 qtest_sendf(s
, "clock_step\n");
950 return qtest_clock_rsp(s
);
953 int64_t qtest_clock_step(QTestState
*s
, int64_t step
)
955 qtest_sendf(s
, "clock_step %"PRIi64
"\n", step
);
956 return qtest_clock_rsp(s
);
959 int64_t qtest_clock_set(QTestState
*s
, int64_t val
)
961 qtest_sendf(s
, "clock_set %"PRIi64
"\n", val
);
962 return qtest_clock_rsp(s
);
965 void qtest_irq_intercept_out(QTestState
*s
, const char *qom_path
)
967 qtest_sendf(s
, "irq_intercept_out %s\n", qom_path
);
971 void qtest_irq_intercept_in(QTestState
*s
, const char *qom_path
)
973 qtest_sendf(s
, "irq_intercept_in %s\n", qom_path
);
977 void qtest_set_irq_in(QTestState
*s
, const char *qom_path
, const char *name
,
981 name
= "unnamed-gpio-in";
983 qtest_sendf(s
, "set_irq_in %s %s %d %d\n", qom_path
, name
, num
, level
);
987 static void qtest_out(QTestState
*s
, const char *cmd
, uint16_t addr
, uint32_t value
)
989 qtest_sendf(s
, "%s 0x%x 0x%x\n", cmd
, addr
, value
);
993 void qtest_outb(QTestState
*s
, uint16_t addr
, uint8_t value
)
995 qtest_out(s
, "outb", addr
, value
);
998 void qtest_outw(QTestState
*s
, uint16_t addr
, uint16_t value
)
1000 qtest_out(s
, "outw", addr
, value
);
1003 void qtest_outl(QTestState
*s
, uint16_t addr
, uint32_t value
)
1005 qtest_out(s
, "outl", addr
, value
);
1008 static uint32_t qtest_in(QTestState
*s
, const char *cmd
, uint16_t addr
)
1012 unsigned long value
;
1014 qtest_sendf(s
, "%s 0x%x\n", cmd
, addr
);
1015 args
= qtest_rsp_args(s
, 2);
1016 ret
= qemu_strtoul(args
[1], NULL
, 0, &value
);
1017 g_assert(!ret
&& value
<= UINT32_MAX
);
1023 uint8_t qtest_inb(QTestState
*s
, uint16_t addr
)
1025 return qtest_in(s
, "inb", addr
);
1028 uint16_t qtest_inw(QTestState
*s
, uint16_t addr
)
1030 return qtest_in(s
, "inw", addr
);
1033 uint32_t qtest_inl(QTestState
*s
, uint16_t addr
)
1035 return qtest_in(s
, "inl", addr
);
1038 static void qtest_write(QTestState
*s
, const char *cmd
, uint64_t addr
,
1041 qtest_sendf(s
, "%s 0x%" PRIx64
" 0x%" PRIx64
"\n", cmd
, addr
, value
);
1045 void qtest_writeb(QTestState
*s
, uint64_t addr
, uint8_t value
)
1047 qtest_write(s
, "writeb", addr
, value
);
1050 void qtest_writew(QTestState
*s
, uint64_t addr
, uint16_t value
)
1052 qtest_write(s
, "writew", addr
, value
);
1055 void qtest_writel(QTestState
*s
, uint64_t addr
, uint32_t value
)
1057 qtest_write(s
, "writel", addr
, value
);
1060 void qtest_writeq(QTestState
*s
, uint64_t addr
, uint64_t value
)
1062 qtest_write(s
, "writeq", addr
, value
);
1065 static uint64_t qtest_read(QTestState
*s
, const char *cmd
, uint64_t addr
)
1071 qtest_sendf(s
, "%s 0x%" PRIx64
"\n", cmd
, addr
);
1072 args
= qtest_rsp_args(s
, 2);
1073 ret
= qemu_strtou64(args
[1], NULL
, 0, &value
);
1080 uint8_t qtest_readb(QTestState
*s
, uint64_t addr
)
1082 return qtest_read(s
, "readb", addr
);
1085 uint16_t qtest_readw(QTestState
*s
, uint64_t addr
)
1087 return qtest_read(s
, "readw", addr
);
1090 uint32_t qtest_readl(QTestState
*s
, uint64_t addr
)
1092 return qtest_read(s
, "readl", addr
);
1095 uint64_t qtest_readq(QTestState
*s
, uint64_t addr
)
1097 return qtest_read(s
, "readq", addr
);
1100 static int hex2nib(char ch
)
1102 if (ch
>= '0' && ch
<= '9') {
1104 } else if (ch
>= 'a' && ch
<= 'f') {
1105 return 10 + (ch
- 'a');
1106 } else if (ch
>= 'A' && ch
<= 'F') {
1107 return 10 + (ch
- 'a');
1113 void qtest_memread(QTestState
*s
, uint64_t addr
, void *data
, size_t size
)
1115 uint8_t *ptr
= data
;
1123 qtest_sendf(s
, "read 0x%" PRIx64
" 0x%zx\n", addr
, size
);
1124 args
= qtest_rsp_args(s
, 2);
1126 for (i
= 0; i
< size
; i
++) {
1127 ptr
[i
] = hex2nib(args
[1][2 + (i
* 2)]) << 4;
1128 ptr
[i
] |= hex2nib(args
[1][2 + (i
* 2) + 1]);
1134 uint64_t qtest_rtas_call(QTestState
*s
, const char *name
,
1135 uint32_t nargs
, uint64_t args
,
1136 uint32_t nret
, uint64_t ret
)
1138 qtest_sendf(s
, "rtas %s %u 0x%"PRIx64
" %u 0x%"PRIx64
"\n",
1139 name
, nargs
, args
, nret
, ret
);
1144 void qtest_add_func(const char *str
, void (*fn
)(void))
1146 gchar
*path
= g_strdup_printf("/%s/%s", qtest_get_arch(), str
);
1147 g_test_add_func(path
, fn
);
1151 void qtest_add_data_func_full(const char *str
, void *data
,
1152 void (*fn
)(const void *),
1153 GDestroyNotify data_free_func
)
1155 gchar
*path
= g_strdup_printf("/%s/%s", qtest_get_arch(), str
);
1156 g_test_add_data_func_full(path
, data
, fn
, data_free_func
);
1160 void qtest_add_data_func(const char *str
, const void *data
,
1161 void (*fn
)(const void *))
1163 gchar
*path
= g_strdup_printf("/%s/%s", qtest_get_arch(), str
);
1164 g_test_add_data_func(path
, data
, fn
);
1168 void qtest_bufwrite(QTestState
*s
, uint64_t addr
, const void *data
, size_t size
)
1172 bdata
= g_base64_encode(data
, size
);
1173 qtest_sendf(s
, "b64write 0x%" PRIx64
" 0x%zx ", addr
, size
);
1174 s
->ops
.send(s
, bdata
);
1175 s
->ops
.send(s
, "\n");
1180 void qtest_bufread(QTestState
*s
, uint64_t addr
, void *data
, size_t size
)
1185 qtest_sendf(s
, "b64read 0x%" PRIx64
" 0x%zx\n", addr
, size
);
1186 args
= qtest_rsp_args(s
, 2);
1188 g_base64_decode_inplace(args
[1], &len
);
1190 fprintf(stderr
, "bufread: asked for %zu bytes but decoded %zu\n",
1192 len
= MIN(len
, size
);
1195 memcpy(data
, args
[1], len
);
1199 void qtest_memwrite(QTestState
*s
, uint64_t addr
, const void *data
, size_t size
)
1201 const uint8_t *ptr
= data
;
1209 enc
= g_malloc(2 * size
+ 1);
1211 for (i
= 0; i
< size
; i
++) {
1212 sprintf(&enc
[i
* 2], "%02x", ptr
[i
]);
1215 qtest_sendf(s
, "write 0x%" PRIx64
" 0x%zx 0x%s\n", addr
, size
, enc
);
1220 void qtest_memset(QTestState
*s
, uint64_t addr
, uint8_t pattern
, size_t size
)
1222 qtest_sendf(s
, "memset 0x%" PRIx64
" 0x%zx 0x%02x\n", addr
, size
, pattern
);
1226 void qtest_qmp_assert_success(QTestState
*qts
, const char *fmt
, ...)
1232 response
= qtest_vqmp(qts
, fmt
, ap
);
1236 if (!qdict_haskey(response
, "return")) {
1237 GString
*s
= qobject_to_json_pretty(QOBJECT(response
), true);
1238 g_test_message("%s", s
->str
);
1239 g_string_free(s
, true);
1241 g_assert(qdict_haskey(response
, "return"));
1242 qobject_unref(response
);
1245 bool qtest_big_endian(QTestState
*s
)
1247 return s
->big_endian
;
1250 static bool qtest_check_machine_version(const char *mname
, const char *basename
,
1251 int major
, int minor
)
1256 newname
= g_strdup_printf("%s-%i.%i", basename
, major
, minor
);
1257 is_equal
= g_str_equal(mname
, newname
);
1263 static bool qtest_is_old_versioned_machine(const char *mname
)
1265 const char *dash
= strrchr(mname
, '-');
1266 const char *dot
= strrchr(mname
, '.');
1269 const int major
= QEMU_VERSION_MAJOR
;
1270 const int minor
= QEMU_VERSION_MINOR
;
1273 if (dash
&& dot
&& dot
> dash
) {
1274 for (chr
= dash
+ 1; *chr
; chr
++) {
1275 if (!qemu_isdigit(*chr
) && *chr
!= '.') {
1280 * Now check if it is one of the latest versions. Check major + 1
1281 * and minor + 1 versions as well, since they might already exist
1282 * in the development branch.
1284 bname
= g_strdup(mname
);
1285 bname
[dash
- mname
] = 0;
1286 res
= !qtest_check_machine_version(mname
, bname
, major
+ 1, 0) &&
1287 !qtest_check_machine_version(mname
, bname
, major
, minor
+ 1) &&
1288 !qtest_check_machine_version(mname
, bname
, major
, minor
);
1295 void qtest_cb_for_every_machine(void (*cb
)(const char *machine
),
1296 bool skip_old_versioned
)
1298 QDict
*response
, *minfo
;
1300 const QListEntry
*p
;
1306 qts
= qtest_init("-machine none");
1307 response
= qtest_qmp(qts
, "{ 'execute': 'query-machines' }");
1309 list
= qdict_get_qlist(response
, "return");
1312 for (p
= qlist_first(list
); p
; p
= qlist_next(p
)) {
1313 minfo
= qobject_to(QDict
, qlist_entry_obj(p
));
1315 qobj
= qdict_get(minfo
, "name");
1317 qstr
= qobject_to(QString
, qobj
);
1319 mname
= qstring_get_str(qstr
);
1320 /* Ignore machines that cannot be used for qtests */
1321 if (!strncmp("xenfv", mname
, 5) || g_str_equal("xenpv", mname
)) {
1324 if (!skip_old_versioned
|| !qtest_is_old_versioned_machine(mname
)) {
1330 qobject_unref(response
);
1334 * Generic hot-plugging test via the device_add QMP commands.
1336 void qtest_qmp_device_add_qdict(QTestState
*qts
, const char *drv
,
1337 const QDict
*arguments
)
1340 QDict
*args
= arguments
? qdict_clone_shallow(arguments
) : qdict_new();
1342 g_assert(!qdict_haskey(args
, "driver"));
1343 qdict_put_str(args
, "driver", drv
);
1344 resp
= qtest_qmp(qts
, "{'execute': 'device_add', 'arguments': %p}", args
);
1346 g_assert(!qdict_haskey(resp
, "event")); /* We don't expect any events */
1347 g_assert(!qdict_haskey(resp
, "error"));
1348 qobject_unref(resp
);
1351 void qtest_qmp_device_add(QTestState
*qts
, const char *driver
, const char *id
,
1352 const char *fmt
, ...)
1358 args
= qdict_from_vjsonf_nofail(fmt
, ap
);
1361 g_assert(!qdict_haskey(args
, "id"));
1362 qdict_put_str(args
, "id", id
);
1364 qtest_qmp_device_add_qdict(qts
, driver
, args
);
1365 qobject_unref(args
);
1370 * Generic hot-unplugging test via the device_del QMP command.
1371 * Device deletion will get one response and one event. For example:
1373 * {'execute': 'device_del','arguments': { 'id': 'scsi-hd'}}
1375 * will get this one:
1377 * {"timestamp": {"seconds": 1505289667, "microseconds": 569862},
1378 * "event": "DEVICE_DELETED", "data": {"device": "scsi-hd",
1379 * "path": "/machine/peripheral/scsi-hd"}}
1385 void qtest_qmp_device_del(QTestState
*qts
, const char *id
)
1389 rsp
= qtest_qmp(qts
, "{'execute': 'device_del', 'arguments': {'id': %s}}",
1392 g_assert(qdict_haskey(rsp
, "return"));
1394 qtest_qmp_eventwait(qts
, "DEVICE_DELETED");
1397 bool qmp_rsp_is_err(QDict
*rsp
)
1399 QDict
*error
= qdict_get_qdict(rsp
, "error");
1404 void qmp_expect_error_and_unref(QDict
*rsp
, const char *class)
1406 QDict
*error
= qdict_get_qdict(rsp
, "error");
1408 g_assert_cmpstr(qdict_get_try_str(error
, "class"), ==, class);
1409 g_assert_nonnull(qdict_get_try_str(error
, "desc"));
1410 g_assert(!qdict_haskey(rsp
, "return"));
1415 static void qtest_client_set_tx_handler(QTestState
*s
,
1420 static void qtest_client_set_rx_handler(QTestState
*s
, QTestRecvFn recv
)
1422 s
->ops
.recv_line
= recv
;
1424 /* A type-safe wrapper for s->send() */
1425 static void send_wrapper(QTestState
*s
, const char *buf
)
1427 s
->ops
.external_send(s
, buf
);
1430 static GString
*qtest_client_inproc_recv_line(QTestState
*s
)
1436 eol
= strchr(s
->rx
->str
, '\n');
1437 offset
= eol
- s
->rx
->str
;
1438 line
= g_string_new_len(s
->rx
->str
, offset
);
1439 g_string_erase(s
->rx
, 0, offset
+ 1);
1443 QTestState
*qtest_inproc_init(QTestState
**s
, bool log
, const char* arch
,
1444 void (*send
)(void*, const char*))
1447 qts
= g_new0(QTestState
, 1);
1448 qts
->pending_events
= NULL
;
1449 *s
= qts
; /* Expose qts early on, since the query endianness relies on it */
1451 for (int i
= 0; i
< MAX_IRQ
; i
++) {
1452 qts
->irq_level
[i
] = false;
1455 qtest_client_set_rx_handler(qts
, qtest_client_inproc_recv_line
);
1457 /* send() may not have a matching protoype, so use a type-safe wrapper */
1458 qts
->ops
.external_send
= send
;
1459 qtest_client_set_tx_handler(qts
, send_wrapper
);
1461 qts
->big_endian
= qtest_query_target_endianness(qts
);
1464 * Set a dummy path for QTEST_QEMU_BINARY. Doesn't need to exist, but this
1465 * way, qtest_get_arch works for inproc qtest.
1467 gchar
*bin_path
= g_strconcat("/qemu-system-", arch
, NULL
);
1468 setenv("QTEST_QEMU_BINARY", bin_path
, 0);
1474 void qtest_client_inproc_recv(void *opaque
, const char *str
)
1476 QTestState
*qts
= *(QTestState
**)opaque
;
1479 qts
->rx
= g_string_new(NULL
);
1481 g_string_append(qts
->rx
, str
);