4 * Copyright (c) 2003-2004 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
28 #include "hw/pcmcia.h"
31 #include "hw/watchdog.h"
32 #include "hw/loader.h"
35 #include "net/slirp.h"
36 #include "qemu-char.h"
42 #include "audio/audio.h"
45 #include "qemu-timer.h"
46 #include "migration.h"
55 #include "json-streamer.h"
56 #include "json-parser.h"
61 //#define DEBUG_COMPLETION
67 * 'B' block device name
68 * 's' string (accept optional quote)
69 * 'O' option string of the form NAME=VALUE,...
70 * parsed according to QemuOptsList given by its name
71 * Example: 'device:O' uses qemu_device_opts.
72 * Restriction: only lists with empty desc are supported
73 * TODO lift the restriction
75 * 'l' target long (32 or 64 bit)
76 * 'M' just like 'l', except in user mode the value is
77 * multiplied by 2^20 (think Mebibyte)
79 * user mode accepts an optional G, g, M, m, K, k suffix,
80 * which multiplies the value by 2^30 for suffixes G and
81 * g, 2^20 for M and m, 2^10 for K and k
83 * user mode accepts an optional ms, us, ns suffix,
84 * which divides the value by 1e3, 1e6, 1e9, respectively
85 * '/' optional gdb-like print format (like "/10x")
87 * '?' optional type (for all types, except '/')
88 * '.' other form of optional type (for 'i' and 'l')
90 * user mode accepts "on" or "off"
91 * '-' optional parameter (eg. '-f')
95 typedef struct MonitorCompletionData MonitorCompletionData
;
96 struct MonitorCompletionData
{
98 void (*user_print
)(Monitor
*mon
, const QObject
*data
);
101 typedef struct mon_cmd_t
{
103 const char *args_type
;
106 void (*user_print
)(Monitor
*mon
, const QObject
*data
);
108 void (*info
)(Monitor
*mon
);
109 void (*info_new
)(Monitor
*mon
, QObject
**ret_data
);
110 int (*info_async
)(Monitor
*mon
, MonitorCompletion
*cb
, void *opaque
);
111 void (*cmd
)(Monitor
*mon
, const QDict
*qdict
);
112 int (*cmd_new
)(Monitor
*mon
, const QDict
*params
, QObject
**ret_data
);
113 int (*cmd_async
)(Monitor
*mon
, const QDict
*params
,
114 MonitorCompletion
*cb
, void *opaque
);
119 /* file descriptors passed via SCM_RIGHTS */
120 typedef struct mon_fd_t mon_fd_t
;
124 QLIST_ENTRY(mon_fd_t
) next
;
127 typedef struct MonitorControl
{
129 JSONMessageParser parser
;
134 CharDriverState
*chr
;
139 uint8_t outbuf
[1024];
144 BlockDriverCompletionFunc
*password_completion_cb
;
145 void *password_opaque
;
146 #ifdef CONFIG_DEBUG_MONITOR
150 QLIST_HEAD(,mon_fd_t
) fds
;
151 QLIST_ENTRY(Monitor
) entry
;
154 #ifdef CONFIG_DEBUG_MONITOR
155 #define MON_DEBUG(fmt, ...) do { \
156 fprintf(stderr, "Monitor: "); \
157 fprintf(stderr, fmt, ## __VA_ARGS__); } while (0)
159 static inline void mon_print_count_inc(Monitor
*mon
)
161 mon
->print_calls_nr
++;
164 static inline void mon_print_count_init(Monitor
*mon
)
166 mon
->print_calls_nr
= 0;
169 static inline int mon_print_count_get(const Monitor
*mon
)
171 return mon
->print_calls_nr
;
174 #else /* !CONFIG_DEBUG_MONITOR */
175 #define MON_DEBUG(fmt, ...) do { } while (0)
176 static inline void mon_print_count_inc(Monitor
*mon
) { }
177 static inline void mon_print_count_init(Monitor
*mon
) { }
178 static inline int mon_print_count_get(const Monitor
*mon
) { return 0; }
179 #endif /* CONFIG_DEBUG_MONITOR */
181 /* QMP checker flags */
182 #define QMP_ACCEPT_UNKNOWNS 1
184 static QLIST_HEAD(mon_list
, Monitor
) mon_list
;
186 static const mon_cmd_t mon_cmds
[];
187 static const mon_cmd_t info_cmds
[];
190 Monitor
*default_mon
;
192 static void monitor_command_cb(Monitor
*mon
, const char *cmdline
,
195 static inline int qmp_cmd_mode(const Monitor
*mon
)
197 return (mon
->mc
? mon
->mc
->command_mode
: 0);
200 /* Return true if in control mode, false otherwise */
201 static inline int monitor_ctrl_mode(const Monitor
*mon
)
203 return (mon
->flags
& MONITOR_USE_CONTROL
);
206 /* Return non-zero iff we have a current monitor, and it is in QMP mode. */
207 int monitor_cur_is_qmp(void)
209 return cur_mon
&& monitor_ctrl_mode(cur_mon
);
212 static void monitor_read_command(Monitor
*mon
, int show_prompt
)
217 readline_start(mon
->rs
, "(qemu) ", 0, monitor_command_cb
, NULL
);
219 readline_show_prompt(mon
->rs
);
222 static int monitor_read_password(Monitor
*mon
, ReadLineFunc
*readline_func
,
225 if (monitor_ctrl_mode(mon
)) {
226 qerror_report(QERR_MISSING_PARAMETER
, "password");
228 } else if (mon
->rs
) {
229 readline_start(mon
->rs
, "Password: ", 1, readline_func
, opaque
);
230 /* prompt is printed on return from the command handler */
233 monitor_printf(mon
, "terminal does not support password prompting\n");
238 void monitor_flush(Monitor
*mon
)
240 if (mon
&& mon
->outbuf_index
!= 0 && !mon
->mux_out
) {
241 qemu_chr_write(mon
->chr
, mon
->outbuf
, mon
->outbuf_index
);
242 mon
->outbuf_index
= 0;
246 /* flush at every end of line or if the buffer is full */
247 static void monitor_puts(Monitor
*mon
, const char *str
)
256 mon
->outbuf
[mon
->outbuf_index
++] = '\r';
257 mon
->outbuf
[mon
->outbuf_index
++] = c
;
258 if (mon
->outbuf_index
>= (sizeof(mon
->outbuf
) - 1)
264 void monitor_vprintf(Monitor
*mon
, const char *fmt
, va_list ap
)
271 mon_print_count_inc(mon
);
273 if (monitor_ctrl_mode(mon
)) {
277 vsnprintf(buf
, sizeof(buf
), fmt
, ap
);
278 monitor_puts(mon
, buf
);
281 void monitor_printf(Monitor
*mon
, const char *fmt
, ...)
285 monitor_vprintf(mon
, fmt
, ap
);
289 void monitor_print_filename(Monitor
*mon
, const char *filename
)
293 for (i
= 0; filename
[i
]; i
++) {
294 switch (filename
[i
]) {
298 monitor_printf(mon
, "\\%c", filename
[i
]);
301 monitor_printf(mon
, "\\t");
304 monitor_printf(mon
, "\\r");
307 monitor_printf(mon
, "\\n");
310 monitor_printf(mon
, "%c", filename
[i
]);
316 static int monitor_fprintf(FILE *stream
, const char *fmt
, ...)
320 monitor_vprintf((Monitor
*)stream
, fmt
, ap
);
325 static void monitor_user_noop(Monitor
*mon
, const QObject
*data
) { }
327 static inline int monitor_handler_ported(const mon_cmd_t
*cmd
)
329 return cmd
->user_print
!= NULL
;
332 static inline bool monitor_handler_is_async(const mon_cmd_t
*cmd
)
334 return cmd
->flags
& MONITOR_CMD_ASYNC
;
337 static inline bool monitor_cmd_user_only(const mon_cmd_t
*cmd
)
339 return (cmd
->flags
& MONITOR_CMD_USER_ONLY
);
342 static inline int monitor_has_error(const Monitor
*mon
)
344 return mon
->error
!= NULL
;
347 static void monitor_json_emitter(Monitor
*mon
, const QObject
*data
)
351 json
= qobject_to_json(data
);
352 assert(json
!= NULL
);
354 qstring_append_chr(json
, '\n');
355 monitor_puts(mon
, qstring_get_str(json
));
360 static void monitor_protocol_emitter(Monitor
*mon
, QObject
*data
)
366 if (!monitor_has_error(mon
)) {
367 /* success response */
369 qobject_incref(data
);
370 qdict_put_obj(qmp
, "return", data
);
372 /* return an empty QDict by default */
373 qdict_put(qmp
, "return", qdict_new());
377 qdict_put(mon
->error
->error
, "desc", qerror_human(mon
->error
));
378 qdict_put(qmp
, "error", mon
->error
->error
);
379 QINCREF(mon
->error
->error
);
385 qdict_put_obj(qmp
, "id", mon
->mc
->id
);
389 monitor_json_emitter(mon
, QOBJECT(qmp
));
393 static void timestamp_put(QDict
*qdict
)
399 err
= qemu_gettimeofday(&tv
);
403 obj
= qobject_from_jsonf("{ 'seconds': %" PRId64
", "
404 "'microseconds': %" PRId64
" }",
405 (int64_t) tv
.tv_sec
, (int64_t) tv
.tv_usec
);
406 qdict_put_obj(qdict
, "timestamp", obj
);
410 * monitor_protocol_event(): Generate a Monitor event
412 * Event-specific data can be emitted through the (optional) 'data' parameter.
414 void monitor_protocol_event(MonitorEvent event
, QObject
*data
)
417 const char *event_name
;
420 assert(event
< QEVENT_MAX
);
423 case QEVENT_SHUTDOWN
:
424 event_name
= "SHUTDOWN";
427 event_name
= "RESET";
429 case QEVENT_POWERDOWN
:
430 event_name
= "POWERDOWN";
436 event_name
= "RESUME";
438 case QEVENT_VNC_CONNECTED
:
439 event_name
= "VNC_CONNECTED";
441 case QEVENT_VNC_INITIALIZED
:
442 event_name
= "VNC_INITIALIZED";
444 case QEVENT_VNC_DISCONNECTED
:
445 event_name
= "VNC_DISCONNECTED";
447 case QEVENT_BLOCK_IO_ERROR
:
448 event_name
= "BLOCK_IO_ERROR";
450 case QEVENT_RTC_CHANGE
:
451 event_name
= "RTC_CHANGE";
453 case QEVENT_WATCHDOG
:
454 event_name
= "WATCHDOG";
463 qdict_put(qmp
, "event", qstring_from_str(event_name
));
465 qobject_incref(data
);
466 qdict_put_obj(qmp
, "data", data
);
469 QLIST_FOREACH(mon
, &mon_list
, entry
) {
470 if (monitor_ctrl_mode(mon
) && qmp_cmd_mode(mon
)) {
471 monitor_json_emitter(mon
, QOBJECT(qmp
));
477 static int do_qmp_capabilities(Monitor
*mon
, const QDict
*params
,
480 /* Will setup QMP capabilities in the future */
481 if (monitor_ctrl_mode(mon
)) {
482 mon
->mc
->command_mode
= 1;
488 static int compare_cmd(const char *name
, const char *list
)
490 const char *p
, *pstart
;
498 p
= pstart
+ strlen(pstart
);
499 if ((p
- pstart
) == len
&& !memcmp(pstart
, name
, len
))
508 static void help_cmd_dump(Monitor
*mon
, const mon_cmd_t
*cmds
,
509 const char *prefix
, const char *name
)
511 const mon_cmd_t
*cmd
;
513 for(cmd
= cmds
; cmd
->name
!= NULL
; cmd
++) {
514 if (!name
|| !strcmp(name
, cmd
->name
))
515 monitor_printf(mon
, "%s%s %s -- %s\n", prefix
, cmd
->name
,
516 cmd
->params
, cmd
->help
);
520 static void help_cmd(Monitor
*mon
, const char *name
)
522 if (name
&& !strcmp(name
, "info")) {
523 help_cmd_dump(mon
, info_cmds
, "info ", NULL
);
525 help_cmd_dump(mon
, mon_cmds
, "", name
);
526 if (name
&& !strcmp(name
, "log")) {
527 const CPULogItem
*item
;
528 monitor_printf(mon
, "Log items (comma separated):\n");
529 monitor_printf(mon
, "%-10s %s\n", "none", "remove all logs");
530 for(item
= cpu_log_items
; item
->mask
!= 0; item
++) {
531 monitor_printf(mon
, "%-10s %s\n", item
->name
, item
->help
);
537 static void do_help_cmd(Monitor
*mon
, const QDict
*qdict
)
539 help_cmd(mon
, qdict_get_try_str(qdict
, "name"));
542 static void user_monitor_complete(void *opaque
, QObject
*ret_data
)
544 MonitorCompletionData
*data
= (MonitorCompletionData
*)opaque
;
547 data
->user_print(data
->mon
, ret_data
);
549 monitor_resume(data
->mon
);
553 static void qmp_monitor_complete(void *opaque
, QObject
*ret_data
)
555 monitor_protocol_emitter(opaque
, ret_data
);
558 static int qmp_async_cmd_handler(Monitor
*mon
, const mon_cmd_t
*cmd
,
561 return cmd
->mhandler
.cmd_async(mon
, params
, qmp_monitor_complete
, mon
);
564 static void qmp_async_info_handler(Monitor
*mon
, const mon_cmd_t
*cmd
)
566 cmd
->mhandler
.info_async(mon
, qmp_monitor_complete
, mon
);
569 static void user_async_cmd_handler(Monitor
*mon
, const mon_cmd_t
*cmd
,
574 MonitorCompletionData
*cb_data
= qemu_malloc(sizeof(*cb_data
));
576 cb_data
->user_print
= cmd
->user_print
;
577 monitor_suspend(mon
);
578 ret
= cmd
->mhandler
.cmd_async(mon
, params
,
579 user_monitor_complete
, cb_data
);
586 static void user_async_info_handler(Monitor
*mon
, const mon_cmd_t
*cmd
)
590 MonitorCompletionData
*cb_data
= qemu_malloc(sizeof(*cb_data
));
592 cb_data
->user_print
= cmd
->user_print
;
593 monitor_suspend(mon
);
594 ret
= cmd
->mhandler
.info_async(mon
, user_monitor_complete
, cb_data
);
601 static int do_info(Monitor
*mon
, const QDict
*qdict
, QObject
**ret_data
)
603 const mon_cmd_t
*cmd
;
604 const char *item
= qdict_get_try_str(qdict
, "item");
607 assert(monitor_ctrl_mode(mon
) == 0);
611 for (cmd
= info_cmds
; cmd
->name
!= NULL
; cmd
++) {
612 if (compare_cmd(item
, cmd
->name
))
616 if (cmd
->name
== NULL
) {
617 if (monitor_ctrl_mode(mon
)) {
618 qerror_report(QERR_COMMAND_NOT_FOUND
, item
);
624 if (monitor_ctrl_mode(mon
) && monitor_cmd_user_only(cmd
)) {
625 qerror_report(QERR_COMMAND_NOT_FOUND
, item
);
629 if (monitor_handler_is_async(cmd
)) {
630 if (monitor_ctrl_mode(mon
)) {
631 qmp_async_info_handler(mon
, cmd
);
633 user_async_info_handler(mon
, cmd
);
636 * Indicate that this command is asynchronous and will not return any
637 * data (not even empty). Instead, the data will be returned via a
638 * completion callback.
640 *ret_data
= qobject_from_jsonf("{ '__mon_async': 'return' }");
641 } else if (monitor_handler_ported(cmd
)) {
642 cmd
->mhandler
.info_new(mon
, ret_data
);
644 if (!monitor_ctrl_mode(mon
)) {
646 * User Protocol function is called here, Monitor Protocol is
647 * handled by monitor_call_handler()
650 cmd
->user_print(mon
, *ret_data
);
653 if (monitor_ctrl_mode(mon
)) {
654 /* handler not converted yet */
655 qerror_report(QERR_COMMAND_NOT_FOUND
, item
);
658 cmd
->mhandler
.info(mon
);
665 help_cmd(mon
, "info");
669 static void do_info_version_print(Monitor
*mon
, const QObject
*data
)
673 qdict
= qobject_to_qdict(data
);
675 monitor_printf(mon
, "%s%s\n", qdict_get_str(qdict
, "qemu"),
676 qdict_get_str(qdict
, "package"));
679 static void do_info_version(Monitor
*mon
, QObject
**ret_data
)
681 *ret_data
= qobject_from_jsonf("{ 'qemu': %s, 'package': %s }",
682 QEMU_VERSION
, QEMU_PKGVERSION
);
685 static void do_info_name_print(Monitor
*mon
, const QObject
*data
)
689 qdict
= qobject_to_qdict(data
);
690 if (qdict_size(qdict
) == 0) {
694 monitor_printf(mon
, "%s\n", qdict_get_str(qdict
, "name"));
697 static void do_info_name(Monitor
*mon
, QObject
**ret_data
)
699 *ret_data
= qemu_name
? qobject_from_jsonf("{'name': %s }", qemu_name
) :
700 qobject_from_jsonf("{}");
703 static QObject
*get_cmd_dict(const char *name
)
707 /* Remove '|' from some commands */
708 p
= strchr(name
, '|');
715 return qobject_from_jsonf("{ 'name': %s }", p
);
718 static void do_info_commands(Monitor
*mon
, QObject
**ret_data
)
721 const mon_cmd_t
*cmd
;
723 cmd_list
= qlist_new();
725 for (cmd
= mon_cmds
; cmd
->name
!= NULL
; cmd
++) {
726 if (monitor_handler_ported(cmd
) && !monitor_cmd_user_only(cmd
) &&
727 !compare_cmd(cmd
->name
, "info")) {
728 qlist_append_obj(cmd_list
, get_cmd_dict(cmd
->name
));
732 for (cmd
= info_cmds
; cmd
->name
!= NULL
; cmd
++) {
733 if (monitor_handler_ported(cmd
) && !monitor_cmd_user_only(cmd
)) {
735 snprintf(buf
, sizeof(buf
), "query-%s", cmd
->name
);
736 qlist_append_obj(cmd_list
, get_cmd_dict(buf
));
740 *ret_data
= QOBJECT(cmd_list
);
743 static void do_info_uuid_print(Monitor
*mon
, const QObject
*data
)
745 monitor_printf(mon
, "%s\n", qdict_get_str(qobject_to_qdict(data
), "UUID"));
748 static void do_info_uuid(Monitor
*mon
, QObject
**ret_data
)
752 snprintf(uuid
, sizeof(uuid
), UUID_FMT
, qemu_uuid
[0], qemu_uuid
[1],
753 qemu_uuid
[2], qemu_uuid
[3], qemu_uuid
[4], qemu_uuid
[5],
754 qemu_uuid
[6], qemu_uuid
[7], qemu_uuid
[8], qemu_uuid
[9],
755 qemu_uuid
[10], qemu_uuid
[11], qemu_uuid
[12], qemu_uuid
[13],
756 qemu_uuid
[14], qemu_uuid
[15]);
757 *ret_data
= qobject_from_jsonf("{ 'UUID': %s }", uuid
);
760 /* get the current CPU defined by the user */
761 static int mon_set_cpu(int cpu_index
)
765 for(env
= first_cpu
; env
!= NULL
; env
= env
->next_cpu
) {
766 if (env
->cpu_index
== cpu_index
) {
767 cur_mon
->mon_cpu
= env
;
774 static CPUState
*mon_get_cpu(void)
776 if (!cur_mon
->mon_cpu
) {
779 cpu_synchronize_state(cur_mon
->mon_cpu
);
780 return cur_mon
->mon_cpu
;
783 static void do_info_registers(Monitor
*mon
)
788 cpu_dump_state(env
, (FILE *)mon
, monitor_fprintf
,
791 cpu_dump_state(env
, (FILE *)mon
, monitor_fprintf
,
796 static void print_cpu_iter(QObject
*obj
, void *opaque
)
800 Monitor
*mon
= opaque
;
802 assert(qobject_type(obj
) == QTYPE_QDICT
);
803 cpu
= qobject_to_qdict(obj
);
805 if (qdict_get_bool(cpu
, "current")) {
809 monitor_printf(mon
, "%c CPU #%d: ", active
, (int)qdict_get_int(cpu
, "CPU"));
811 #if defined(TARGET_I386)
812 monitor_printf(mon
, "pc=0x" TARGET_FMT_lx
,
813 (target_ulong
) qdict_get_int(cpu
, "pc"));
814 #elif defined(TARGET_PPC)
815 monitor_printf(mon
, "nip=0x" TARGET_FMT_lx
,
816 (target_long
) qdict_get_int(cpu
, "nip"));
817 #elif defined(TARGET_SPARC)
818 monitor_printf(mon
, "pc=0x " TARGET_FMT_lx
,
819 (target_long
) qdict_get_int(cpu
, "pc"));
820 monitor_printf(mon
, "npc=0x" TARGET_FMT_lx
,
821 (target_long
) qdict_get_int(cpu
, "npc"));
822 #elif defined(TARGET_MIPS)
823 monitor_printf(mon
, "PC=0x" TARGET_FMT_lx
,
824 (target_long
) qdict_get_int(cpu
, "PC"));
827 if (qdict_get_bool(cpu
, "halted")) {
828 monitor_printf(mon
, " (halted)");
831 monitor_printf(mon
, "\n");
834 static void monitor_print_cpus(Monitor
*mon
, const QObject
*data
)
838 assert(qobject_type(data
) == QTYPE_QLIST
);
839 cpu_list
= qobject_to_qlist(data
);
840 qlist_iter(cpu_list
, print_cpu_iter
, mon
);
843 static void do_info_cpus(Monitor
*mon
, QObject
**ret_data
)
848 cpu_list
= qlist_new();
850 /* just to set the default cpu if not already done */
853 for(env
= first_cpu
; env
!= NULL
; env
= env
->next_cpu
) {
857 cpu_synchronize_state(env
);
859 obj
= qobject_from_jsonf("{ 'CPU': %d, 'current': %i, 'halted': %i }",
860 env
->cpu_index
, env
== mon
->mon_cpu
,
863 cpu
= qobject_to_qdict(obj
);
865 #if defined(TARGET_I386)
866 qdict_put(cpu
, "pc", qint_from_int(env
->eip
+ env
->segs
[R_CS
].base
));
867 #elif defined(TARGET_PPC)
868 qdict_put(cpu
, "nip", qint_from_int(env
->nip
));
869 #elif defined(TARGET_SPARC)
870 qdict_put(cpu
, "pc", qint_from_int(env
->pc
));
871 qdict_put(cpu
, "npc", qint_from_int(env
->npc
));
872 #elif defined(TARGET_MIPS)
873 qdict_put(cpu
, "PC", qint_from_int(env
->active_tc
.PC
));
876 qlist_append(cpu_list
, cpu
);
879 *ret_data
= QOBJECT(cpu_list
);
882 static int do_cpu_set(Monitor
*mon
, const QDict
*qdict
, QObject
**ret_data
)
884 int index
= qdict_get_int(qdict
, "index");
885 if (mon_set_cpu(index
) < 0) {
886 qerror_report(QERR_INVALID_PARAMETER_VALUE
, "index",
893 static void do_info_jit(Monitor
*mon
)
895 dump_exec_info((FILE *)mon
, monitor_fprintf
);
898 static void do_info_history(Monitor
*mon
)
907 str
= readline_get_history(mon
->rs
, i
);
910 monitor_printf(mon
, "%d: '%s'\n", i
, str
);
915 #if defined(TARGET_PPC)
916 /* XXX: not implemented in other targets */
917 static void do_info_cpu_stats(Monitor
*mon
)
922 cpu_dump_statistics(env
, (FILE *)mon
, &monitor_fprintf
, 0);
927 * do_quit(): Quit QEMU execution
929 static int do_quit(Monitor
*mon
, const QDict
*qdict
, QObject
**ret_data
)
931 monitor_suspend(mon
);
933 qemu_system_shutdown_request();
938 static int change_vnc_password(const char *password
)
940 if (vnc_display_password(NULL
, password
) < 0) {
941 qerror_report(QERR_SET_PASSWD_FAILED
);
948 static void change_vnc_password_cb(Monitor
*mon
, const char *password
,
951 change_vnc_password(password
);
952 monitor_read_command(mon
, 1);
955 static int do_change_vnc(Monitor
*mon
, const char *target
, const char *arg
)
957 if (strcmp(target
, "passwd") == 0 ||
958 strcmp(target
, "password") == 0) {
961 strncpy(password
, arg
, sizeof(password
));
962 password
[sizeof(password
) - 1] = '\0';
963 return change_vnc_password(password
);
965 return monitor_read_password(mon
, change_vnc_password_cb
, NULL
);
968 if (vnc_display_open(NULL
, target
) < 0) {
969 qerror_report(QERR_VNC_SERVER_FAILED
, target
);
978 * do_change(): Change a removable medium, or VNC configuration
980 static int do_change(Monitor
*mon
, const QDict
*qdict
, QObject
**ret_data
)
982 const char *device
= qdict_get_str(qdict
, "device");
983 const char *target
= qdict_get_str(qdict
, "target");
984 const char *arg
= qdict_get_try_str(qdict
, "arg");
987 if (strcmp(device
, "vnc") == 0) {
988 ret
= do_change_vnc(mon
, target
, arg
);
990 ret
= do_change_block(mon
, device
, target
, arg
);
996 static int do_screen_dump(Monitor
*mon
, const QDict
*qdict
, QObject
**ret_data
)
998 vga_hw_screen_dump(qdict_get_str(qdict
, "filename"));
1002 static void do_logfile(Monitor
*mon
, const QDict
*qdict
)
1004 cpu_set_log_filename(qdict_get_str(qdict
, "filename"));
1007 static void do_log(Monitor
*mon
, const QDict
*qdict
)
1010 const char *items
= qdict_get_str(qdict
, "items");
1012 if (!strcmp(items
, "none")) {
1015 mask
= cpu_str_to_log_mask(items
);
1017 help_cmd(mon
, "log");
1024 static void do_singlestep(Monitor
*mon
, const QDict
*qdict
)
1026 const char *option
= qdict_get_try_str(qdict
, "option");
1027 if (!option
|| !strcmp(option
, "on")) {
1029 } else if (!strcmp(option
, "off")) {
1032 monitor_printf(mon
, "unexpected option %s\n", option
);
1037 * do_stop(): Stop VM execution
1039 static int do_stop(Monitor
*mon
, const QDict
*qdict
, QObject
**ret_data
)
1041 vm_stop(EXCP_INTERRUPT
);
1045 static void encrypted_bdrv_it(void *opaque
, BlockDriverState
*bs
);
1047 struct bdrv_iterate_context
{
1053 * do_cont(): Resume emulation.
1055 static int do_cont(Monitor
*mon
, const QDict
*qdict
, QObject
**ret_data
)
1057 struct bdrv_iterate_context context
= { mon
, 0 };
1059 if (incoming_expected
) {
1060 qerror_report(QERR_MIGRATION_EXPECTED
);
1063 bdrv_iterate(encrypted_bdrv_it
, &context
);
1064 /* only resume the vm if all keys are set and valid */
1073 static void bdrv_key_cb(void *opaque
, int err
)
1075 Monitor
*mon
= opaque
;
1077 /* another key was set successfully, retry to continue */
1079 do_cont(mon
, NULL
, NULL
);
1082 static void encrypted_bdrv_it(void *opaque
, BlockDriverState
*bs
)
1084 struct bdrv_iterate_context
*context
= opaque
;
1086 if (!context
->err
&& bdrv_key_required(bs
)) {
1087 context
->err
= -EBUSY
;
1088 monitor_read_bdrv_key_start(context
->mon
, bs
, bdrv_key_cb
,
1093 static void do_gdbserver(Monitor
*mon
, const QDict
*qdict
)
1095 const char *device
= qdict_get_try_str(qdict
, "device");
1097 device
= "tcp::" DEFAULT_GDBSTUB_PORT
;
1098 if (gdbserver_start(device
) < 0) {
1099 monitor_printf(mon
, "Could not open gdbserver on device '%s'\n",
1101 } else if (strcmp(device
, "none") == 0) {
1102 monitor_printf(mon
, "Disabled gdbserver\n");
1104 monitor_printf(mon
, "Waiting for gdb connection on device '%s'\n",
1109 static void do_watchdog_action(Monitor
*mon
, const QDict
*qdict
)
1111 const char *action
= qdict_get_str(qdict
, "action");
1112 if (select_watchdog_action(action
) == -1) {
1113 monitor_printf(mon
, "Unknown watchdog action '%s'\n", action
);
1117 static void monitor_printc(Monitor
*mon
, int c
)
1119 monitor_printf(mon
, "'");
1122 monitor_printf(mon
, "\\'");
1125 monitor_printf(mon
, "\\\\");
1128 monitor_printf(mon
, "\\n");
1131 monitor_printf(mon
, "\\r");
1134 if (c
>= 32 && c
<= 126) {
1135 monitor_printf(mon
, "%c", c
);
1137 monitor_printf(mon
, "\\x%02x", c
);
1141 monitor_printf(mon
, "'");
1144 static void memory_dump(Monitor
*mon
, int count
, int format
, int wsize
,
1145 target_phys_addr_t addr
, int is_physical
)
1148 int l
, line_size
, i
, max_digits
, len
;
1152 if (format
== 'i') {
1155 env
= mon_get_cpu();
1159 } else if (wsize
== 4) {
1162 /* as default we use the current CS size */
1165 #ifdef TARGET_X86_64
1166 if ((env
->efer
& MSR_EFER_LMA
) &&
1167 (env
->segs
[R_CS
].flags
& DESC_L_MASK
))
1171 if (!(env
->segs
[R_CS
].flags
& DESC_B_MASK
))
1176 monitor_disas(mon
, env
, addr
, count
, is_physical
, flags
);
1180 len
= wsize
* count
;
1189 max_digits
= (wsize
* 8 + 2) / 3;
1193 max_digits
= (wsize
* 8) / 4;
1197 max_digits
= (wsize
* 8 * 10 + 32) / 33;
1206 monitor_printf(mon
, TARGET_FMT_plx
":", addr
);
1208 monitor_printf(mon
, TARGET_FMT_lx
":", (target_ulong
)addr
);
1213 cpu_physical_memory_rw(addr
, buf
, l
, 0);
1215 env
= mon_get_cpu();
1216 if (cpu_memory_rw_debug(env
, addr
, buf
, l
, 0) < 0) {
1217 monitor_printf(mon
, " Cannot access memory\n");
1226 v
= ldub_raw(buf
+ i
);
1229 v
= lduw_raw(buf
+ i
);
1232 v
= (uint32_t)ldl_raw(buf
+ i
);
1235 v
= ldq_raw(buf
+ i
);
1238 monitor_printf(mon
, " ");
1241 monitor_printf(mon
, "%#*" PRIo64
, max_digits
, v
);
1244 monitor_printf(mon
, "0x%0*" PRIx64
, max_digits
, v
);
1247 monitor_printf(mon
, "%*" PRIu64
, max_digits
, v
);
1250 monitor_printf(mon
, "%*" PRId64
, max_digits
, v
);
1253 monitor_printc(mon
, v
);
1258 monitor_printf(mon
, "\n");
1264 static void do_memory_dump(Monitor
*mon
, const QDict
*qdict
)
1266 int count
= qdict_get_int(qdict
, "count");
1267 int format
= qdict_get_int(qdict
, "format");
1268 int size
= qdict_get_int(qdict
, "size");
1269 target_long addr
= qdict_get_int(qdict
, "addr");
1271 memory_dump(mon
, count
, format
, size
, addr
, 0);
1274 static void do_physical_memory_dump(Monitor
*mon
, const QDict
*qdict
)
1276 int count
= qdict_get_int(qdict
, "count");
1277 int format
= qdict_get_int(qdict
, "format");
1278 int size
= qdict_get_int(qdict
, "size");
1279 target_phys_addr_t addr
= qdict_get_int(qdict
, "addr");
1281 memory_dump(mon
, count
, format
, size
, addr
, 1);
1284 static void do_print(Monitor
*mon
, const QDict
*qdict
)
1286 int format
= qdict_get_int(qdict
, "format");
1287 target_phys_addr_t val
= qdict_get_int(qdict
, "val");
1289 #if TARGET_PHYS_ADDR_BITS == 32
1292 monitor_printf(mon
, "%#o", val
);
1295 monitor_printf(mon
, "%#x", val
);
1298 monitor_printf(mon
, "%u", val
);
1302 monitor_printf(mon
, "%d", val
);
1305 monitor_printc(mon
, val
);
1311 monitor_printf(mon
, "%#" PRIo64
, val
);
1314 monitor_printf(mon
, "%#" PRIx64
, val
);
1317 monitor_printf(mon
, "%" PRIu64
, val
);
1321 monitor_printf(mon
, "%" PRId64
, val
);
1324 monitor_printc(mon
, val
);
1328 monitor_printf(mon
, "\n");
1331 static int do_memory_save(Monitor
*mon
, const QDict
*qdict
, QObject
**ret_data
)
1334 uint32_t size
= qdict_get_int(qdict
, "size");
1335 const char *filename
= qdict_get_str(qdict
, "filename");
1336 target_long addr
= qdict_get_int(qdict
, "val");
1342 env
= mon_get_cpu();
1344 f
= fopen(filename
, "wb");
1346 qerror_report(QERR_OPEN_FILE_FAILED
, filename
);
1353 cpu_memory_rw_debug(env
, addr
, buf
, l
, 0);
1354 if (fwrite(buf
, 1, l
, f
) != l
) {
1355 monitor_printf(mon
, "fwrite() error in do_memory_save\n");
1369 static int do_physical_memory_save(Monitor
*mon
, const QDict
*qdict
,
1375 uint32_t size
= qdict_get_int(qdict
, "size");
1376 const char *filename
= qdict_get_str(qdict
, "filename");
1377 target_phys_addr_t addr
= qdict_get_int(qdict
, "val");
1380 f
= fopen(filename
, "wb");
1382 qerror_report(QERR_OPEN_FILE_FAILED
, filename
);
1389 cpu_physical_memory_rw(addr
, buf
, l
, 0);
1390 if (fwrite(buf
, 1, l
, f
) != l
) {
1391 monitor_printf(mon
, "fwrite() error in do_physical_memory_save\n");
1406 static void do_sum(Monitor
*mon
, const QDict
*qdict
)
1411 uint32_t start
= qdict_get_int(qdict
, "start");
1412 uint32_t size
= qdict_get_int(qdict
, "size");
1415 for(addr
= start
; addr
< (start
+ size
); addr
++) {
1416 cpu_physical_memory_rw(addr
, buf
, 1, 0);
1417 /* BSD sum algorithm ('sum' Unix command) */
1418 sum
= (sum
>> 1) | (sum
<< 15);
1421 monitor_printf(mon
, "%05d\n", sum
);
1429 static const KeyDef key_defs
[] = {
1431 { 0x36, "shift_r" },
1436 { 0xe4, "altgr_r" },
1456 { 0x0e, "backspace" },
1469 { 0x1a, "bracket_left" },
1470 { 0x1b, "bracket_right" },
1482 { 0x27, "semicolon" },
1483 { 0x28, "apostrophe" },
1484 { 0x29, "grave_accent" },
1486 { 0x2b, "backslash" },
1498 { 0x37, "asterisk" },
1501 { 0x3a, "caps_lock" },
1512 { 0x45, "num_lock" },
1513 { 0x46, "scroll_lock" },
1515 { 0xb5, "kp_divide" },
1516 { 0x37, "kp_multiply" },
1517 { 0x4a, "kp_subtract" },
1519 { 0x9c, "kp_enter" },
1520 { 0x53, "kp_decimal" },
1553 #if defined(TARGET_SPARC) && !defined(TARGET_SPARC64)
1568 { 0xfe, "compose" },
1573 static int get_keycode(const char *key
)
1579 for(p
= key_defs
; p
->name
!= NULL
; p
++) {
1580 if (!strcmp(key
, p
->name
))
1583 if (strstart(key
, "0x", NULL
)) {
1584 ret
= strtoul(key
, &endp
, 0);
1585 if (*endp
== '\0' && ret
>= 0x01 && ret
<= 0xff)
1591 #define MAX_KEYCODES 16
1592 static uint8_t keycodes
[MAX_KEYCODES
];
1593 static int nb_pending_keycodes
;
1594 static QEMUTimer
*key_timer
;
1596 static void release_keys(void *opaque
)
1600 while (nb_pending_keycodes
> 0) {
1601 nb_pending_keycodes
--;
1602 keycode
= keycodes
[nb_pending_keycodes
];
1604 kbd_put_keycode(0xe0);
1605 kbd_put_keycode(keycode
| 0x80);
1609 static void do_sendkey(Monitor
*mon
, const QDict
*qdict
)
1611 char keyname_buf
[16];
1613 int keyname_len
, keycode
, i
;
1614 const char *string
= qdict_get_str(qdict
, "string");
1615 int has_hold_time
= qdict_haskey(qdict
, "hold_time");
1616 int hold_time
= qdict_get_try_int(qdict
, "hold_time", -1);
1618 if (nb_pending_keycodes
> 0) {
1619 qemu_del_timer(key_timer
);
1626 separator
= strchr(string
, '-');
1627 keyname_len
= separator
? separator
- string
: strlen(string
);
1628 if (keyname_len
> 0) {
1629 pstrcpy(keyname_buf
, sizeof(keyname_buf
), string
);
1630 if (keyname_len
> sizeof(keyname_buf
) - 1) {
1631 monitor_printf(mon
, "invalid key: '%s...'\n", keyname_buf
);
1634 if (i
== MAX_KEYCODES
) {
1635 monitor_printf(mon
, "too many keys\n");
1638 keyname_buf
[keyname_len
] = 0;
1639 keycode
= get_keycode(keyname_buf
);
1641 monitor_printf(mon
, "unknown key: '%s'\n", keyname_buf
);
1644 keycodes
[i
++] = keycode
;
1648 string
= separator
+ 1;
1650 nb_pending_keycodes
= i
;
1651 /* key down events */
1652 for (i
= 0; i
< nb_pending_keycodes
; i
++) {
1653 keycode
= keycodes
[i
];
1655 kbd_put_keycode(0xe0);
1656 kbd_put_keycode(keycode
& 0x7f);
1658 /* delayed key up events */
1659 qemu_mod_timer(key_timer
, qemu_get_clock(vm_clock
) +
1660 muldiv64(get_ticks_per_sec(), hold_time
, 1000));
1663 static int mouse_button_state
;
1665 static void do_mouse_move(Monitor
*mon
, const QDict
*qdict
)
1668 const char *dx_str
= qdict_get_str(qdict
, "dx_str");
1669 const char *dy_str
= qdict_get_str(qdict
, "dy_str");
1670 const char *dz_str
= qdict_get_try_str(qdict
, "dz_str");
1671 dx
= strtol(dx_str
, NULL
, 0);
1672 dy
= strtol(dy_str
, NULL
, 0);
1675 dz
= strtol(dz_str
, NULL
, 0);
1676 kbd_mouse_event(dx
, dy
, dz
, mouse_button_state
);
1679 static void do_mouse_button(Monitor
*mon
, const QDict
*qdict
)
1681 int button_state
= qdict_get_int(qdict
, "button_state");
1682 mouse_button_state
= button_state
;
1683 kbd_mouse_event(0, 0, 0, mouse_button_state
);
1686 static void do_ioport_read(Monitor
*mon
, const QDict
*qdict
)
1688 int size
= qdict_get_int(qdict
, "size");
1689 int addr
= qdict_get_int(qdict
, "addr");
1690 int has_index
= qdict_haskey(qdict
, "index");
1695 int index
= qdict_get_int(qdict
, "index");
1696 cpu_outb(addr
& IOPORTS_MASK
, index
& 0xff);
1704 val
= cpu_inb(addr
);
1708 val
= cpu_inw(addr
);
1712 val
= cpu_inl(addr
);
1716 monitor_printf(mon
, "port%c[0x%04x] = %#0*x\n",
1717 suffix
, addr
, size
* 2, val
);
1720 static void do_ioport_write(Monitor
*mon
, const QDict
*qdict
)
1722 int size
= qdict_get_int(qdict
, "size");
1723 int addr
= qdict_get_int(qdict
, "addr");
1724 int val
= qdict_get_int(qdict
, "val");
1726 addr
&= IOPORTS_MASK
;
1731 cpu_outb(addr
, val
);
1734 cpu_outw(addr
, val
);
1737 cpu_outl(addr
, val
);
1742 static void do_boot_set(Monitor
*mon
, const QDict
*qdict
)
1745 const char *bootdevice
= qdict_get_str(qdict
, "bootdevice");
1747 res
= qemu_boot_set(bootdevice
);
1749 monitor_printf(mon
, "boot device list now set to %s\n", bootdevice
);
1750 } else if (res
> 0) {
1751 monitor_printf(mon
, "setting boot device list failed\n");
1753 monitor_printf(mon
, "no function defined to set boot device list for "
1754 "this architecture\n");
1759 * do_system_reset(): Issue a machine reset
1761 static int do_system_reset(Monitor
*mon
, const QDict
*qdict
,
1764 qemu_system_reset_request();
1769 * do_system_powerdown(): Issue a machine powerdown
1771 static int do_system_powerdown(Monitor
*mon
, const QDict
*qdict
,
1774 qemu_system_powerdown_request();
1778 #if defined(TARGET_I386)
1779 static void print_pte(Monitor
*mon
, uint32_t addr
, uint32_t pte
, uint32_t mask
)
1781 monitor_printf(mon
, "%08x: %08x %c%c%c%c%c%c%c%c\n",
1784 pte
& PG_GLOBAL_MASK
? 'G' : '-',
1785 pte
& PG_PSE_MASK
? 'P' : '-',
1786 pte
& PG_DIRTY_MASK
? 'D' : '-',
1787 pte
& PG_ACCESSED_MASK
? 'A' : '-',
1788 pte
& PG_PCD_MASK
? 'C' : '-',
1789 pte
& PG_PWT_MASK
? 'T' : '-',
1790 pte
& PG_USER_MASK
? 'U' : '-',
1791 pte
& PG_RW_MASK
? 'W' : '-');
1794 static void tlb_info(Monitor
*mon
)
1798 uint32_t pgd
, pde
, pte
;
1800 env
= mon_get_cpu();
1802 if (!(env
->cr
[0] & CR0_PG_MASK
)) {
1803 monitor_printf(mon
, "PG disabled\n");
1806 pgd
= env
->cr
[3] & ~0xfff;
1807 for(l1
= 0; l1
< 1024; l1
++) {
1808 cpu_physical_memory_read(pgd
+ l1
* 4, (uint8_t *)&pde
, 4);
1809 pde
= le32_to_cpu(pde
);
1810 if (pde
& PG_PRESENT_MASK
) {
1811 if ((pde
& PG_PSE_MASK
) && (env
->cr
[4] & CR4_PSE_MASK
)) {
1812 print_pte(mon
, (l1
<< 22), pde
, ~((1 << 20) - 1));
1814 for(l2
= 0; l2
< 1024; l2
++) {
1815 cpu_physical_memory_read((pde
& ~0xfff) + l2
* 4,
1816 (uint8_t *)&pte
, 4);
1817 pte
= le32_to_cpu(pte
);
1818 if (pte
& PG_PRESENT_MASK
) {
1819 print_pte(mon
, (l1
<< 22) + (l2
<< 12),
1829 static void mem_print(Monitor
*mon
, uint32_t *pstart
, int *plast_prot
,
1830 uint32_t end
, int prot
)
1833 prot1
= *plast_prot
;
1834 if (prot
!= prot1
) {
1835 if (*pstart
!= -1) {
1836 monitor_printf(mon
, "%08x-%08x %08x %c%c%c\n",
1837 *pstart
, end
, end
- *pstart
,
1838 prot1
& PG_USER_MASK
? 'u' : '-',
1840 prot1
& PG_RW_MASK
? 'w' : '-');
1850 static void mem_info(Monitor
*mon
)
1853 int l1
, l2
, prot
, last_prot
;
1854 uint32_t pgd
, pde
, pte
, start
, end
;
1856 env
= mon_get_cpu();
1858 if (!(env
->cr
[0] & CR0_PG_MASK
)) {
1859 monitor_printf(mon
, "PG disabled\n");
1862 pgd
= env
->cr
[3] & ~0xfff;
1865 for(l1
= 0; l1
< 1024; l1
++) {
1866 cpu_physical_memory_read(pgd
+ l1
* 4, (uint8_t *)&pde
, 4);
1867 pde
= le32_to_cpu(pde
);
1869 if (pde
& PG_PRESENT_MASK
) {
1870 if ((pde
& PG_PSE_MASK
) && (env
->cr
[4] & CR4_PSE_MASK
)) {
1871 prot
= pde
& (PG_USER_MASK
| PG_RW_MASK
| PG_PRESENT_MASK
);
1872 mem_print(mon
, &start
, &last_prot
, end
, prot
);
1874 for(l2
= 0; l2
< 1024; l2
++) {
1875 cpu_physical_memory_read((pde
& ~0xfff) + l2
* 4,
1876 (uint8_t *)&pte
, 4);
1877 pte
= le32_to_cpu(pte
);
1878 end
= (l1
<< 22) + (l2
<< 12);
1879 if (pte
& PG_PRESENT_MASK
) {
1880 prot
= pte
& (PG_USER_MASK
| PG_RW_MASK
| PG_PRESENT_MASK
);
1884 mem_print(mon
, &start
, &last_prot
, end
, prot
);
1889 mem_print(mon
, &start
, &last_prot
, end
, prot
);
1895 #if defined(TARGET_SH4)
1897 static void print_tlb(Monitor
*mon
, int idx
, tlb_t
*tlb
)
1899 monitor_printf(mon
, " tlb%i:\t"
1900 "asid=%hhu vpn=%x\tppn=%x\tsz=%hhu size=%u\t"
1901 "v=%hhu shared=%hhu cached=%hhu prot=%hhu "
1902 "dirty=%hhu writethrough=%hhu\n",
1904 tlb
->asid
, tlb
->vpn
, tlb
->ppn
, tlb
->sz
, tlb
->size
,
1905 tlb
->v
, tlb
->sh
, tlb
->c
, tlb
->pr
,
1909 static void tlb_info(Monitor
*mon
)
1911 CPUState
*env
= mon_get_cpu();
1914 monitor_printf (mon
, "ITLB:\n");
1915 for (i
= 0 ; i
< ITLB_SIZE
; i
++)
1916 print_tlb (mon
, i
, &env
->itlb
[i
]);
1917 monitor_printf (mon
, "UTLB:\n");
1918 for (i
= 0 ; i
< UTLB_SIZE
; i
++)
1919 print_tlb (mon
, i
, &env
->utlb
[i
]);
1924 static void do_info_kvm_print(Monitor
*mon
, const QObject
*data
)
1928 qdict
= qobject_to_qdict(data
);
1930 monitor_printf(mon
, "kvm support: ");
1931 if (qdict_get_bool(qdict
, "present")) {
1932 monitor_printf(mon
, "%s\n", qdict_get_bool(qdict
, "enabled") ?
1933 "enabled" : "disabled");
1935 monitor_printf(mon
, "not compiled\n");
1939 static void do_info_kvm(Monitor
*mon
, QObject
**ret_data
)
1942 *ret_data
= qobject_from_jsonf("{ 'enabled': %i, 'present': true }",
1945 *ret_data
= qobject_from_jsonf("{ 'enabled': false, 'present': false }");
1949 static void do_info_numa(Monitor
*mon
)
1954 monitor_printf(mon
, "%d nodes\n", nb_numa_nodes
);
1955 for (i
= 0; i
< nb_numa_nodes
; i
++) {
1956 monitor_printf(mon
, "node %d cpus:", i
);
1957 for (env
= first_cpu
; env
!= NULL
; env
= env
->next_cpu
) {
1958 if (env
->numa_node
== i
) {
1959 monitor_printf(mon
, " %d", env
->cpu_index
);
1962 monitor_printf(mon
, "\n");
1963 monitor_printf(mon
, "node %d size: %" PRId64
" MB\n", i
,
1968 #ifdef CONFIG_PROFILER
1973 static void do_info_profile(Monitor
*mon
)
1979 monitor_printf(mon
, "async time %" PRId64
" (%0.3f)\n",
1980 dev_time
, dev_time
/ (double)get_ticks_per_sec());
1981 monitor_printf(mon
, "qemu time %" PRId64
" (%0.3f)\n",
1982 qemu_time
, qemu_time
/ (double)get_ticks_per_sec());
1987 static void do_info_profile(Monitor
*mon
)
1989 monitor_printf(mon
, "Internal profiler not compiled\n");
1993 /* Capture support */
1994 static QLIST_HEAD (capture_list_head
, CaptureState
) capture_head
;
1996 static void do_info_capture(Monitor
*mon
)
2001 for (s
= capture_head
.lh_first
, i
= 0; s
; s
= s
->entries
.le_next
, ++i
) {
2002 monitor_printf(mon
, "[%d]: ", i
);
2003 s
->ops
.info (s
->opaque
);
2008 static void do_stop_capture(Monitor
*mon
, const QDict
*qdict
)
2011 int n
= qdict_get_int(qdict
, "n");
2014 for (s
= capture_head
.lh_first
, i
= 0; s
; s
= s
->entries
.le_next
, ++i
) {
2016 s
->ops
.destroy (s
->opaque
);
2017 QLIST_REMOVE (s
, entries
);
2024 static void do_wav_capture(Monitor
*mon
, const QDict
*qdict
)
2026 const char *path
= qdict_get_str(qdict
, "path");
2027 int has_freq
= qdict_haskey(qdict
, "freq");
2028 int freq
= qdict_get_try_int(qdict
, "freq", -1);
2029 int has_bits
= qdict_haskey(qdict
, "bits");
2030 int bits
= qdict_get_try_int(qdict
, "bits", -1);
2031 int has_channels
= qdict_haskey(qdict
, "nchannels");
2032 int nchannels
= qdict_get_try_int(qdict
, "nchannels", -1);
2035 s
= qemu_mallocz (sizeof (*s
));
2037 freq
= has_freq
? freq
: 44100;
2038 bits
= has_bits
? bits
: 16;
2039 nchannels
= has_channels
? nchannels
: 2;
2041 if (wav_start_capture (s
, path
, freq
, bits
, nchannels
)) {
2042 monitor_printf(mon
, "Faied to add wave capture\n");
2045 QLIST_INSERT_HEAD (&capture_head
, s
, entries
);
2049 #if defined(TARGET_I386)
2050 static void do_inject_nmi(Monitor
*mon
, const QDict
*qdict
)
2053 int cpu_index
= qdict_get_int(qdict
, "cpu_index");
2055 for (env
= first_cpu
; env
!= NULL
; env
= env
->next_cpu
)
2056 if (env
->cpu_index
== cpu_index
) {
2057 cpu_interrupt(env
, CPU_INTERRUPT_NMI
);
2063 static void do_info_status_print(Monitor
*mon
, const QObject
*data
)
2067 qdict
= qobject_to_qdict(data
);
2069 monitor_printf(mon
, "VM status: ");
2070 if (qdict_get_bool(qdict
, "running")) {
2071 monitor_printf(mon
, "running");
2072 if (qdict_get_bool(qdict
, "singlestep")) {
2073 monitor_printf(mon
, " (single step mode)");
2076 monitor_printf(mon
, "paused");
2079 monitor_printf(mon
, "\n");
2082 static void do_info_status(Monitor
*mon
, QObject
**ret_data
)
2084 *ret_data
= qobject_from_jsonf("{ 'running': %i, 'singlestep': %i }",
2085 vm_running
, singlestep
);
2088 static qemu_acl
*find_acl(Monitor
*mon
, const char *name
)
2090 qemu_acl
*acl
= qemu_acl_find(name
);
2093 monitor_printf(mon
, "acl: unknown list '%s'\n", name
);
2098 static void do_acl_show(Monitor
*mon
, const QDict
*qdict
)
2100 const char *aclname
= qdict_get_str(qdict
, "aclname");
2101 qemu_acl
*acl
= find_acl(mon
, aclname
);
2102 qemu_acl_entry
*entry
;
2106 monitor_printf(mon
, "policy: %s\n",
2107 acl
->defaultDeny
? "deny" : "allow");
2108 QTAILQ_FOREACH(entry
, &acl
->entries
, next
) {
2110 monitor_printf(mon
, "%d: %s %s\n", i
,
2111 entry
->deny
? "deny" : "allow", entry
->match
);
2116 static void do_acl_reset(Monitor
*mon
, const QDict
*qdict
)
2118 const char *aclname
= qdict_get_str(qdict
, "aclname");
2119 qemu_acl
*acl
= find_acl(mon
, aclname
);
2122 qemu_acl_reset(acl
);
2123 monitor_printf(mon
, "acl: removed all rules\n");
2127 static void do_acl_policy(Monitor
*mon
, const QDict
*qdict
)
2129 const char *aclname
= qdict_get_str(qdict
, "aclname");
2130 const char *policy
= qdict_get_str(qdict
, "policy");
2131 qemu_acl
*acl
= find_acl(mon
, aclname
);
2134 if (strcmp(policy
, "allow") == 0) {
2135 acl
->defaultDeny
= 0;
2136 monitor_printf(mon
, "acl: policy set to 'allow'\n");
2137 } else if (strcmp(policy
, "deny") == 0) {
2138 acl
->defaultDeny
= 1;
2139 monitor_printf(mon
, "acl: policy set to 'deny'\n");
2141 monitor_printf(mon
, "acl: unknown policy '%s', "
2142 "expected 'deny' or 'allow'\n", policy
);
2147 static void do_acl_add(Monitor
*mon
, const QDict
*qdict
)
2149 const char *aclname
= qdict_get_str(qdict
, "aclname");
2150 const char *match
= qdict_get_str(qdict
, "match");
2151 const char *policy
= qdict_get_str(qdict
, "policy");
2152 int has_index
= qdict_haskey(qdict
, "index");
2153 int index
= qdict_get_try_int(qdict
, "index", -1);
2154 qemu_acl
*acl
= find_acl(mon
, aclname
);
2158 if (strcmp(policy
, "allow") == 0) {
2160 } else if (strcmp(policy
, "deny") == 0) {
2163 monitor_printf(mon
, "acl: unknown policy '%s', "
2164 "expected 'deny' or 'allow'\n", policy
);
2168 ret
= qemu_acl_insert(acl
, deny
, match
, index
);
2170 ret
= qemu_acl_append(acl
, deny
, match
);
2172 monitor_printf(mon
, "acl: unable to add acl entry\n");
2174 monitor_printf(mon
, "acl: added rule at position %d\n", ret
);
2178 static void do_acl_remove(Monitor
*mon
, const QDict
*qdict
)
2180 const char *aclname
= qdict_get_str(qdict
, "aclname");
2181 const char *match
= qdict_get_str(qdict
, "match");
2182 qemu_acl
*acl
= find_acl(mon
, aclname
);
2186 ret
= qemu_acl_remove(acl
, match
);
2188 monitor_printf(mon
, "acl: no matching acl entry\n");
2190 monitor_printf(mon
, "acl: removed rule at position %d\n", ret
);
2194 #if defined(TARGET_I386)
2195 static void do_inject_mce(Monitor
*mon
, const QDict
*qdict
)
2198 int cpu_index
= qdict_get_int(qdict
, "cpu_index");
2199 int bank
= qdict_get_int(qdict
, "bank");
2200 uint64_t status
= qdict_get_int(qdict
, "status");
2201 uint64_t mcg_status
= qdict_get_int(qdict
, "mcg_status");
2202 uint64_t addr
= qdict_get_int(qdict
, "addr");
2203 uint64_t misc
= qdict_get_int(qdict
, "misc");
2205 for (cenv
= first_cpu
; cenv
!= NULL
; cenv
= cenv
->next_cpu
)
2206 if (cenv
->cpu_index
== cpu_index
&& cenv
->mcg_cap
) {
2207 cpu_inject_x86_mce(cenv
, bank
, status
, mcg_status
, addr
, misc
);
2213 static int do_getfd(Monitor
*mon
, const QDict
*qdict
, QObject
**ret_data
)
2215 const char *fdname
= qdict_get_str(qdict
, "fdname");
2219 fd
= qemu_chr_get_msgfd(mon
->chr
);
2221 qerror_report(QERR_FD_NOT_SUPPLIED
);
2225 if (qemu_isdigit(fdname
[0])) {
2226 qerror_report(QERR_INVALID_PARAMETER_VALUE
, "fdname",
2227 "a name not starting with a digit");
2231 QLIST_FOREACH(monfd
, &mon
->fds
, next
) {
2232 if (strcmp(monfd
->name
, fdname
) != 0) {
2241 monfd
= qemu_mallocz(sizeof(mon_fd_t
));
2242 monfd
->name
= qemu_strdup(fdname
);
2245 QLIST_INSERT_HEAD(&mon
->fds
, monfd
, next
);
2249 static int do_closefd(Monitor
*mon
, const QDict
*qdict
, QObject
**ret_data
)
2251 const char *fdname
= qdict_get_str(qdict
, "fdname");
2254 QLIST_FOREACH(monfd
, &mon
->fds
, next
) {
2255 if (strcmp(monfd
->name
, fdname
) != 0) {
2259 QLIST_REMOVE(monfd
, next
);
2261 qemu_free(monfd
->name
);
2266 qerror_report(QERR_FD_NOT_FOUND
, fdname
);
2270 static void do_loadvm(Monitor
*mon
, const QDict
*qdict
)
2272 int saved_vm_running
= vm_running
;
2273 const char *name
= qdict_get_str(qdict
, "name");
2277 if (load_vmstate(name
) >= 0 && saved_vm_running
)
2281 int monitor_get_fd(Monitor
*mon
, const char *fdname
)
2285 QLIST_FOREACH(monfd
, &mon
->fds
, next
) {
2288 if (strcmp(monfd
->name
, fdname
) != 0) {
2294 /* caller takes ownership of fd */
2295 QLIST_REMOVE(monfd
, next
);
2296 qemu_free(monfd
->name
);
2305 static const mon_cmd_t mon_cmds
[] = {
2306 #include "qemu-monitor.h"
2310 /* Please update qemu-monitor.hx when adding or changing commands */
2311 static const mon_cmd_t info_cmds
[] = {
2316 .help
= "show the version of QEMU",
2317 .user_print
= do_info_version_print
,
2318 .mhandler
.info_new
= do_info_version
,
2324 .help
= "list QMP available commands",
2325 .user_print
= monitor_user_noop
,
2326 .mhandler
.info_new
= do_info_commands
,
2332 .help
= "show the network state",
2333 .mhandler
.info
= do_info_network
,
2339 .help
= "show the character devices",
2340 .user_print
= qemu_chr_info_print
,
2341 .mhandler
.info_new
= qemu_chr_info
,
2347 .help
= "show the block devices",
2348 .user_print
= bdrv_info_print
,
2349 .mhandler
.info_new
= bdrv_info
,
2352 .name
= "blockstats",
2355 .help
= "show block device statistics",
2356 .user_print
= bdrv_stats_print
,
2357 .mhandler
.info_new
= bdrv_info_stats
,
2360 .name
= "registers",
2363 .help
= "show the cpu registers",
2364 .mhandler
.info
= do_info_registers
,
2370 .help
= "show infos for each CPU",
2371 .user_print
= monitor_print_cpus
,
2372 .mhandler
.info_new
= do_info_cpus
,
2378 .help
= "show the command line history",
2379 .mhandler
.info
= do_info_history
,
2385 .help
= "show the interrupts statistics (if available)",
2386 .mhandler
.info
= irq_info
,
2392 .help
= "show i8259 (PIC) state",
2393 .mhandler
.info
= pic_info
,
2399 .help
= "show PCI info",
2400 .user_print
= do_pci_info_print
,
2401 .mhandler
.info_new
= do_pci_info
,
2403 #if defined(TARGET_I386) || defined(TARGET_SH4)
2408 .help
= "show virtual to physical memory mappings",
2409 .mhandler
.info
= tlb_info
,
2412 #if defined(TARGET_I386)
2417 .help
= "show the active virtual memory mappings",
2418 .mhandler
.info
= mem_info
,
2425 .help
= "show dynamic compiler info",
2426 .mhandler
.info
= do_info_jit
,
2432 .help
= "show KVM information",
2433 .user_print
= do_info_kvm_print
,
2434 .mhandler
.info_new
= do_info_kvm
,
2440 .help
= "show NUMA information",
2441 .mhandler
.info
= do_info_numa
,
2447 .help
= "show guest USB devices",
2448 .mhandler
.info
= usb_info
,
2454 .help
= "show host USB devices",
2455 .mhandler
.info
= usb_host_info
,
2461 .help
= "show profiling information",
2462 .mhandler
.info
= do_info_profile
,
2468 .help
= "show capture information",
2469 .mhandler
.info
= do_info_capture
,
2472 .name
= "snapshots",
2475 .help
= "show the currently saved VM snapshots",
2476 .mhandler
.info
= do_info_snapshots
,
2482 .help
= "show the current VM status (running|paused)",
2483 .user_print
= do_info_status_print
,
2484 .mhandler
.info_new
= do_info_status
,
2490 .help
= "show guest PCMCIA status",
2491 .mhandler
.info
= pcmcia_info
,
2497 .help
= "show which guest mouse is receiving events",
2498 .user_print
= do_info_mice_print
,
2499 .mhandler
.info_new
= do_info_mice
,
2505 .help
= "show the vnc server status",
2506 .user_print
= do_info_vnc_print
,
2507 .mhandler
.info_new
= do_info_vnc
,
2513 .help
= "show the current VM name",
2514 .user_print
= do_info_name_print
,
2515 .mhandler
.info_new
= do_info_name
,
2521 .help
= "show the current VM UUID",
2522 .user_print
= do_info_uuid_print
,
2523 .mhandler
.info_new
= do_info_uuid
,
2525 #if defined(TARGET_PPC)
2530 .help
= "show CPU statistics",
2531 .mhandler
.info
= do_info_cpu_stats
,
2534 #if defined(CONFIG_SLIRP)
2539 .help
= "show user network stack connection states",
2540 .mhandler
.info
= do_info_usernet
,
2547 .help
= "show migration status",
2548 .user_print
= do_info_migrate_print
,
2549 .mhandler
.info_new
= do_info_migrate
,
2555 .help
= "show balloon information",
2556 .user_print
= monitor_print_balloon
,
2557 .mhandler
.info_async
= do_info_balloon
,
2558 .flags
= MONITOR_CMD_ASYNC
,
2564 .help
= "show device tree",
2565 .mhandler
.info
= do_info_qtree
,
2571 .help
= "show qdev device model list",
2572 .mhandler
.info
= do_info_qdm
,
2578 .help
= "show roms",
2579 .mhandler
.info
= do_info_roms
,
2586 /*******************************************************************/
2588 static const char *pch
;
2589 static jmp_buf expr_env
;
2594 typedef struct MonitorDef
{
2597 target_long (*get_value
)(const struct MonitorDef
*md
, int val
);
2601 #if defined(TARGET_I386)
2602 static target_long
monitor_get_pc (const struct MonitorDef
*md
, int val
)
2604 CPUState
*env
= mon_get_cpu();
2605 return env
->eip
+ env
->segs
[R_CS
].base
;
2609 #if defined(TARGET_PPC)
2610 static target_long
monitor_get_ccr (const struct MonitorDef
*md
, int val
)
2612 CPUState
*env
= mon_get_cpu();
2617 for (i
= 0; i
< 8; i
++)
2618 u
|= env
->crf
[i
] << (32 - (4 * i
));
2623 static target_long
monitor_get_msr (const struct MonitorDef
*md
, int val
)
2625 CPUState
*env
= mon_get_cpu();
2629 static target_long
monitor_get_xer (const struct MonitorDef
*md
, int val
)
2631 CPUState
*env
= mon_get_cpu();
2635 static target_long
monitor_get_decr (const struct MonitorDef
*md
, int val
)
2637 CPUState
*env
= mon_get_cpu();
2638 return cpu_ppc_load_decr(env
);
2641 static target_long
monitor_get_tbu (const struct MonitorDef
*md
, int val
)
2643 CPUState
*env
= mon_get_cpu();
2644 return cpu_ppc_load_tbu(env
);
2647 static target_long
monitor_get_tbl (const struct MonitorDef
*md
, int val
)
2649 CPUState
*env
= mon_get_cpu();
2650 return cpu_ppc_load_tbl(env
);
2654 #if defined(TARGET_SPARC)
2655 #ifndef TARGET_SPARC64
2656 static target_long
monitor_get_psr (const struct MonitorDef
*md
, int val
)
2658 CPUState
*env
= mon_get_cpu();
2660 return cpu_get_psr(env
);
2664 static target_long
monitor_get_reg(const struct MonitorDef
*md
, int val
)
2666 CPUState
*env
= mon_get_cpu();
2667 return env
->regwptr
[val
];
2671 static const MonitorDef monitor_defs
[] = {
2674 #define SEG(name, seg) \
2675 { name, offsetof(CPUState, segs[seg].selector), NULL, MD_I32 },\
2676 { name ".base", offsetof(CPUState, segs[seg].base) },\
2677 { name ".limit", offsetof(CPUState, segs[seg].limit), NULL, MD_I32 },
2679 { "eax", offsetof(CPUState
, regs
[0]) },
2680 { "ecx", offsetof(CPUState
, regs
[1]) },
2681 { "edx", offsetof(CPUState
, regs
[2]) },
2682 { "ebx", offsetof(CPUState
, regs
[3]) },
2683 { "esp|sp", offsetof(CPUState
, regs
[4]) },
2684 { "ebp|fp", offsetof(CPUState
, regs
[5]) },
2685 { "esi", offsetof(CPUState
, regs
[6]) },
2686 { "edi", offsetof(CPUState
, regs
[7]) },
2687 #ifdef TARGET_X86_64
2688 { "r8", offsetof(CPUState
, regs
[8]) },
2689 { "r9", offsetof(CPUState
, regs
[9]) },
2690 { "r10", offsetof(CPUState
, regs
[10]) },
2691 { "r11", offsetof(CPUState
, regs
[11]) },
2692 { "r12", offsetof(CPUState
, regs
[12]) },
2693 { "r13", offsetof(CPUState
, regs
[13]) },
2694 { "r14", offsetof(CPUState
, regs
[14]) },
2695 { "r15", offsetof(CPUState
, regs
[15]) },
2697 { "eflags", offsetof(CPUState
, eflags
) },
2698 { "eip", offsetof(CPUState
, eip
) },
2705 { "pc", 0, monitor_get_pc
, },
2706 #elif defined(TARGET_PPC)
2707 /* General purpose registers */
2708 { "r0", offsetof(CPUState
, gpr
[0]) },
2709 { "r1", offsetof(CPUState
, gpr
[1]) },
2710 { "r2", offsetof(CPUState
, gpr
[2]) },
2711 { "r3", offsetof(CPUState
, gpr
[3]) },
2712 { "r4", offsetof(CPUState
, gpr
[4]) },
2713 { "r5", offsetof(CPUState
, gpr
[5]) },
2714 { "r6", offsetof(CPUState
, gpr
[6]) },
2715 { "r7", offsetof(CPUState
, gpr
[7]) },
2716 { "r8", offsetof(CPUState
, gpr
[8]) },
2717 { "r9", offsetof(CPUState
, gpr
[9]) },
2718 { "r10", offsetof(CPUState
, gpr
[10]) },
2719 { "r11", offsetof(CPUState
, gpr
[11]) },
2720 { "r12", offsetof(CPUState
, gpr
[12]) },
2721 { "r13", offsetof(CPUState
, gpr
[13]) },
2722 { "r14", offsetof(CPUState
, gpr
[14]) },
2723 { "r15", offsetof(CPUState
, gpr
[15]) },
2724 { "r16", offsetof(CPUState
, gpr
[16]) },
2725 { "r17", offsetof(CPUState
, gpr
[17]) },
2726 { "r18", offsetof(CPUState
, gpr
[18]) },
2727 { "r19", offsetof(CPUState
, gpr
[19]) },
2728 { "r20", offsetof(CPUState
, gpr
[20]) },
2729 { "r21", offsetof(CPUState
, gpr
[21]) },
2730 { "r22", offsetof(CPUState
, gpr
[22]) },
2731 { "r23", offsetof(CPUState
, gpr
[23]) },
2732 { "r24", offsetof(CPUState
, gpr
[24]) },
2733 { "r25", offsetof(CPUState
, gpr
[25]) },
2734 { "r26", offsetof(CPUState
, gpr
[26]) },
2735 { "r27", offsetof(CPUState
, gpr
[27]) },
2736 { "r28", offsetof(CPUState
, gpr
[28]) },
2737 { "r29", offsetof(CPUState
, gpr
[29]) },
2738 { "r30", offsetof(CPUState
, gpr
[30]) },
2739 { "r31", offsetof(CPUState
, gpr
[31]) },
2740 /* Floating point registers */
2741 { "f0", offsetof(CPUState
, fpr
[0]) },
2742 { "f1", offsetof(CPUState
, fpr
[1]) },
2743 { "f2", offsetof(CPUState
, fpr
[2]) },
2744 { "f3", offsetof(CPUState
, fpr
[3]) },
2745 { "f4", offsetof(CPUState
, fpr
[4]) },
2746 { "f5", offsetof(CPUState
, fpr
[5]) },
2747 { "f6", offsetof(CPUState
, fpr
[6]) },
2748 { "f7", offsetof(CPUState
, fpr
[7]) },
2749 { "f8", offsetof(CPUState
, fpr
[8]) },
2750 { "f9", offsetof(CPUState
, fpr
[9]) },
2751 { "f10", offsetof(CPUState
, fpr
[10]) },
2752 { "f11", offsetof(CPUState
, fpr
[11]) },
2753 { "f12", offsetof(CPUState
, fpr
[12]) },
2754 { "f13", offsetof(CPUState
, fpr
[13]) },
2755 { "f14", offsetof(CPUState
, fpr
[14]) },
2756 { "f15", offsetof(CPUState
, fpr
[15]) },
2757 { "f16", offsetof(CPUState
, fpr
[16]) },
2758 { "f17", offsetof(CPUState
, fpr
[17]) },
2759 { "f18", offsetof(CPUState
, fpr
[18]) },
2760 { "f19", offsetof(CPUState
, fpr
[19]) },
2761 { "f20", offsetof(CPUState
, fpr
[20]) },
2762 { "f21", offsetof(CPUState
, fpr
[21]) },
2763 { "f22", offsetof(CPUState
, fpr
[22]) },
2764 { "f23", offsetof(CPUState
, fpr
[23]) },
2765 { "f24", offsetof(CPUState
, fpr
[24]) },
2766 { "f25", offsetof(CPUState
, fpr
[25]) },
2767 { "f26", offsetof(CPUState
, fpr
[26]) },
2768 { "f27", offsetof(CPUState
, fpr
[27]) },
2769 { "f28", offsetof(CPUState
, fpr
[28]) },
2770 { "f29", offsetof(CPUState
, fpr
[29]) },
2771 { "f30", offsetof(CPUState
, fpr
[30]) },
2772 { "f31", offsetof(CPUState
, fpr
[31]) },
2773 { "fpscr", offsetof(CPUState
, fpscr
) },
2774 /* Next instruction pointer */
2775 { "nip|pc", offsetof(CPUState
, nip
) },
2776 { "lr", offsetof(CPUState
, lr
) },
2777 { "ctr", offsetof(CPUState
, ctr
) },
2778 { "decr", 0, &monitor_get_decr
, },
2779 { "ccr", 0, &monitor_get_ccr
, },
2780 /* Machine state register */
2781 { "msr", 0, &monitor_get_msr
, },
2782 { "xer", 0, &monitor_get_xer
, },
2783 { "tbu", 0, &monitor_get_tbu
, },
2784 { "tbl", 0, &monitor_get_tbl
, },
2785 #if defined(TARGET_PPC64)
2786 /* Address space register */
2787 { "asr", offsetof(CPUState
, asr
) },
2789 /* Segment registers */
2790 { "sdr1", offsetof(CPUState
, sdr1
) },
2791 { "sr0", offsetof(CPUState
, sr
[0]) },
2792 { "sr1", offsetof(CPUState
, sr
[1]) },
2793 { "sr2", offsetof(CPUState
, sr
[2]) },
2794 { "sr3", offsetof(CPUState
, sr
[3]) },
2795 { "sr4", offsetof(CPUState
, sr
[4]) },
2796 { "sr5", offsetof(CPUState
, sr
[5]) },
2797 { "sr6", offsetof(CPUState
, sr
[6]) },
2798 { "sr7", offsetof(CPUState
, sr
[7]) },
2799 { "sr8", offsetof(CPUState
, sr
[8]) },
2800 { "sr9", offsetof(CPUState
, sr
[9]) },
2801 { "sr10", offsetof(CPUState
, sr
[10]) },
2802 { "sr11", offsetof(CPUState
, sr
[11]) },
2803 { "sr12", offsetof(CPUState
, sr
[12]) },
2804 { "sr13", offsetof(CPUState
, sr
[13]) },
2805 { "sr14", offsetof(CPUState
, sr
[14]) },
2806 { "sr15", offsetof(CPUState
, sr
[15]) },
2807 /* Too lazy to put BATs and SPRs ... */
2808 #elif defined(TARGET_SPARC)
2809 { "g0", offsetof(CPUState
, gregs
[0]) },
2810 { "g1", offsetof(CPUState
, gregs
[1]) },
2811 { "g2", offsetof(CPUState
, gregs
[2]) },
2812 { "g3", offsetof(CPUState
, gregs
[3]) },
2813 { "g4", offsetof(CPUState
, gregs
[4]) },
2814 { "g5", offsetof(CPUState
, gregs
[5]) },
2815 { "g6", offsetof(CPUState
, gregs
[6]) },
2816 { "g7", offsetof(CPUState
, gregs
[7]) },
2817 { "o0", 0, monitor_get_reg
},
2818 { "o1", 1, monitor_get_reg
},
2819 { "o2", 2, monitor_get_reg
},
2820 { "o3", 3, monitor_get_reg
},
2821 { "o4", 4, monitor_get_reg
},
2822 { "o5", 5, monitor_get_reg
},
2823 { "o6", 6, monitor_get_reg
},
2824 { "o7", 7, monitor_get_reg
},
2825 { "l0", 8, monitor_get_reg
},
2826 { "l1", 9, monitor_get_reg
},
2827 { "l2", 10, monitor_get_reg
},
2828 { "l3", 11, monitor_get_reg
},
2829 { "l4", 12, monitor_get_reg
},
2830 { "l5", 13, monitor_get_reg
},
2831 { "l6", 14, monitor_get_reg
},
2832 { "l7", 15, monitor_get_reg
},
2833 { "i0", 16, monitor_get_reg
},
2834 { "i1", 17, monitor_get_reg
},
2835 { "i2", 18, monitor_get_reg
},
2836 { "i3", 19, monitor_get_reg
},
2837 { "i4", 20, monitor_get_reg
},
2838 { "i5", 21, monitor_get_reg
},
2839 { "i6", 22, monitor_get_reg
},
2840 { "i7", 23, monitor_get_reg
},
2841 { "pc", offsetof(CPUState
, pc
) },
2842 { "npc", offsetof(CPUState
, npc
) },
2843 { "y", offsetof(CPUState
, y
) },
2844 #ifndef TARGET_SPARC64
2845 { "psr", 0, &monitor_get_psr
, },
2846 { "wim", offsetof(CPUState
, wim
) },
2848 { "tbr", offsetof(CPUState
, tbr
) },
2849 { "fsr", offsetof(CPUState
, fsr
) },
2850 { "f0", offsetof(CPUState
, fpr
[0]) },
2851 { "f1", offsetof(CPUState
, fpr
[1]) },
2852 { "f2", offsetof(CPUState
, fpr
[2]) },
2853 { "f3", offsetof(CPUState
, fpr
[3]) },
2854 { "f4", offsetof(CPUState
, fpr
[4]) },
2855 { "f5", offsetof(CPUState
, fpr
[5]) },
2856 { "f6", offsetof(CPUState
, fpr
[6]) },
2857 { "f7", offsetof(CPUState
, fpr
[7]) },
2858 { "f8", offsetof(CPUState
, fpr
[8]) },
2859 { "f9", offsetof(CPUState
, fpr
[9]) },
2860 { "f10", offsetof(CPUState
, fpr
[10]) },
2861 { "f11", offsetof(CPUState
, fpr
[11]) },
2862 { "f12", offsetof(CPUState
, fpr
[12]) },
2863 { "f13", offsetof(CPUState
, fpr
[13]) },
2864 { "f14", offsetof(CPUState
, fpr
[14]) },
2865 { "f15", offsetof(CPUState
, fpr
[15]) },
2866 { "f16", offsetof(CPUState
, fpr
[16]) },
2867 { "f17", offsetof(CPUState
, fpr
[17]) },
2868 { "f18", offsetof(CPUState
, fpr
[18]) },
2869 { "f19", offsetof(CPUState
, fpr
[19]) },
2870 { "f20", offsetof(CPUState
, fpr
[20]) },
2871 { "f21", offsetof(CPUState
, fpr
[21]) },
2872 { "f22", offsetof(CPUState
, fpr
[22]) },
2873 { "f23", offsetof(CPUState
, fpr
[23]) },
2874 { "f24", offsetof(CPUState
, fpr
[24]) },
2875 { "f25", offsetof(CPUState
, fpr
[25]) },
2876 { "f26", offsetof(CPUState
, fpr
[26]) },
2877 { "f27", offsetof(CPUState
, fpr
[27]) },
2878 { "f28", offsetof(CPUState
, fpr
[28]) },
2879 { "f29", offsetof(CPUState
, fpr
[29]) },
2880 { "f30", offsetof(CPUState
, fpr
[30]) },
2881 { "f31", offsetof(CPUState
, fpr
[31]) },
2882 #ifdef TARGET_SPARC64
2883 { "f32", offsetof(CPUState
, fpr
[32]) },
2884 { "f34", offsetof(CPUState
, fpr
[34]) },
2885 { "f36", offsetof(CPUState
, fpr
[36]) },
2886 { "f38", offsetof(CPUState
, fpr
[38]) },
2887 { "f40", offsetof(CPUState
, fpr
[40]) },
2888 { "f42", offsetof(CPUState
, fpr
[42]) },
2889 { "f44", offsetof(CPUState
, fpr
[44]) },
2890 { "f46", offsetof(CPUState
, fpr
[46]) },
2891 { "f48", offsetof(CPUState
, fpr
[48]) },
2892 { "f50", offsetof(CPUState
, fpr
[50]) },
2893 { "f52", offsetof(CPUState
, fpr
[52]) },
2894 { "f54", offsetof(CPUState
, fpr
[54]) },
2895 { "f56", offsetof(CPUState
, fpr
[56]) },
2896 { "f58", offsetof(CPUState
, fpr
[58]) },
2897 { "f60", offsetof(CPUState
, fpr
[60]) },
2898 { "f62", offsetof(CPUState
, fpr
[62]) },
2899 { "asi", offsetof(CPUState
, asi
) },
2900 { "pstate", offsetof(CPUState
, pstate
) },
2901 { "cansave", offsetof(CPUState
, cansave
) },
2902 { "canrestore", offsetof(CPUState
, canrestore
) },
2903 { "otherwin", offsetof(CPUState
, otherwin
) },
2904 { "wstate", offsetof(CPUState
, wstate
) },
2905 { "cleanwin", offsetof(CPUState
, cleanwin
) },
2906 { "fprs", offsetof(CPUState
, fprs
) },
2912 static void expr_error(Monitor
*mon
, const char *msg
)
2914 monitor_printf(mon
, "%s\n", msg
);
2915 longjmp(expr_env
, 1);
2918 /* return 0 if OK, -1 if not found */
2919 static int get_monitor_def(target_long
*pval
, const char *name
)
2921 const MonitorDef
*md
;
2924 for(md
= monitor_defs
; md
->name
!= NULL
; md
++) {
2925 if (compare_cmd(name
, md
->name
)) {
2926 if (md
->get_value
) {
2927 *pval
= md
->get_value(md
, md
->offset
);
2929 CPUState
*env
= mon_get_cpu();
2930 ptr
= (uint8_t *)env
+ md
->offset
;
2933 *pval
= *(int32_t *)ptr
;
2936 *pval
= *(target_long
*)ptr
;
2949 static void next(void)
2953 while (qemu_isspace(*pch
))
2958 static int64_t expr_sum(Monitor
*mon
);
2960 static int64_t expr_unary(Monitor
*mon
)
2969 n
= expr_unary(mon
);
2973 n
= -expr_unary(mon
);
2977 n
= ~expr_unary(mon
);
2983 expr_error(mon
, "')' expected");
2990 expr_error(mon
, "character constant expected");
2994 expr_error(mon
, "missing terminating \' character");
3004 while ((*pch
>= 'a' && *pch
<= 'z') ||
3005 (*pch
>= 'A' && *pch
<= 'Z') ||
3006 (*pch
>= '0' && *pch
<= '9') ||
3007 *pch
== '_' || *pch
== '.') {
3008 if ((q
- buf
) < sizeof(buf
) - 1)
3012 while (qemu_isspace(*pch
))
3015 ret
= get_monitor_def(®
, buf
);
3017 expr_error(mon
, "unknown register");
3022 expr_error(mon
, "unexpected end of expression");
3026 #if TARGET_PHYS_ADDR_BITS > 32
3027 n
= strtoull(pch
, &p
, 0);
3029 n
= strtoul(pch
, &p
, 0);
3032 expr_error(mon
, "invalid char in expression");
3035 while (qemu_isspace(*pch
))
3043 static int64_t expr_prod(Monitor
*mon
)
3048 val
= expr_unary(mon
);
3051 if (op
!= '*' && op
!= '/' && op
!= '%')
3054 val2
= expr_unary(mon
);
3063 expr_error(mon
, "division by zero");
3074 static int64_t expr_logic(Monitor
*mon
)
3079 val
= expr_prod(mon
);
3082 if (op
!= '&' && op
!= '|' && op
!= '^')
3085 val2
= expr_prod(mon
);
3102 static int64_t expr_sum(Monitor
*mon
)
3107 val
= expr_logic(mon
);
3110 if (op
!= '+' && op
!= '-')
3113 val2
= expr_logic(mon
);
3122 static int get_expr(Monitor
*mon
, int64_t *pval
, const char **pp
)
3125 if (setjmp(expr_env
)) {
3129 while (qemu_isspace(*pch
))
3131 *pval
= expr_sum(mon
);
3136 static int get_double(Monitor
*mon
, double *pval
, const char **pp
)
3138 const char *p
= *pp
;
3142 d
= strtod(p
, &tailp
);
3144 monitor_printf(mon
, "Number expected\n");
3147 if (d
!= d
|| d
- d
!= 0) {
3148 /* NaN or infinity */
3149 monitor_printf(mon
, "Bad number\n");
3157 static int get_str(char *buf
, int buf_size
, const char **pp
)
3165 while (qemu_isspace(*p
))
3175 while (*p
!= '\0' && *p
!= '\"') {
3191 qemu_printf("unsupported escape code: '\\%c'\n", c
);
3194 if ((q
- buf
) < buf_size
- 1) {
3198 if ((q
- buf
) < buf_size
- 1) {
3205 qemu_printf("unterminated string\n");
3210 while (*p
!= '\0' && !qemu_isspace(*p
)) {
3211 if ((q
- buf
) < buf_size
- 1) {
3223 * Store the command-name in cmdname, and return a pointer to
3224 * the remaining of the command string.
3226 static const char *get_command_name(const char *cmdline
,
3227 char *cmdname
, size_t nlen
)
3230 const char *p
, *pstart
;
3233 while (qemu_isspace(*p
))
3238 while (*p
!= '\0' && *p
!= '/' && !qemu_isspace(*p
))
3243 memcpy(cmdname
, pstart
, len
);
3244 cmdname
[len
] = '\0';
3249 * Read key of 'type' into 'key' and return the current
3252 static char *key_get_info(const char *type
, char **key
)
3260 p
= strchr(type
, ':');
3267 str
= qemu_malloc(len
+ 1);
3268 memcpy(str
, type
, len
);
3275 static int default_fmt_format
= 'x';
3276 static int default_fmt_size
= 4;
3280 static int is_valid_option(const char *c
, const char *typestr
)
3288 typestr
= strstr(typestr
, option
);
3289 return (typestr
!= NULL
);
3292 static const mon_cmd_t
*monitor_find_command(const char *cmdname
)
3294 const mon_cmd_t
*cmd
;
3296 for (cmd
= mon_cmds
; cmd
->name
!= NULL
; cmd
++) {
3297 if (compare_cmd(cmdname
, cmd
->name
)) {
3305 static const mon_cmd_t
*monitor_parse_command(Monitor
*mon
,
3306 const char *cmdline
,
3309 const char *p
, *typestr
;
3311 const mon_cmd_t
*cmd
;
3317 monitor_printf(mon
, "command='%s'\n", cmdline
);
3320 /* extract the command name */
3321 p
= get_command_name(cmdline
, cmdname
, sizeof(cmdname
));
3325 cmd
= monitor_find_command(cmdname
);
3327 monitor_printf(mon
, "unknown command: '%s'\n", cmdname
);
3331 /* parse the parameters */
3332 typestr
= cmd
->args_type
;
3334 typestr
= key_get_info(typestr
, &key
);
3346 while (qemu_isspace(*p
))
3348 if (*typestr
== '?') {
3351 /* no optional string: NULL argument */
3355 ret
= get_str(buf
, sizeof(buf
), &p
);
3359 monitor_printf(mon
, "%s: filename expected\n",
3363 monitor_printf(mon
, "%s: block device name expected\n",
3367 monitor_printf(mon
, "%s: string expected\n", cmdname
);
3372 qdict_put(qdict
, key
, qstring_from_str(buf
));
3377 QemuOptsList
*opts_list
;
3380 opts_list
= qemu_find_opts(key
);
3381 if (!opts_list
|| opts_list
->desc
->name
) {
3384 while (qemu_isspace(*p
)) {
3389 if (get_str(buf
, sizeof(buf
), &p
) < 0) {
3392 opts
= qemu_opts_parse(opts_list
, buf
, 1);
3396 qemu_opts_to_qdict(opts
, qdict
);
3397 qemu_opts_del(opts
);
3402 int count
, format
, size
;
3404 while (qemu_isspace(*p
))
3410 if (qemu_isdigit(*p
)) {
3412 while (qemu_isdigit(*p
)) {
3413 count
= count
* 10 + (*p
- '0');
3451 if (*p
!= '\0' && !qemu_isspace(*p
)) {
3452 monitor_printf(mon
, "invalid char in format: '%c'\n",
3457 format
= default_fmt_format
;
3458 if (format
!= 'i') {
3459 /* for 'i', not specifying a size gives -1 as size */
3461 size
= default_fmt_size
;
3462 default_fmt_size
= size
;
3464 default_fmt_format
= format
;
3467 format
= default_fmt_format
;
3468 if (format
!= 'i') {
3469 size
= default_fmt_size
;
3474 qdict_put(qdict
, "count", qint_from_int(count
));
3475 qdict_put(qdict
, "format", qint_from_int(format
));
3476 qdict_put(qdict
, "size", qint_from_int(size
));
3485 while (qemu_isspace(*p
))
3487 if (*typestr
== '?' || *typestr
== '.') {
3488 if (*typestr
== '?') {
3496 while (qemu_isspace(*p
))
3505 if (get_expr(mon
, &val
, &p
))
3507 /* Check if 'i' is greater than 32-bit */
3508 if ((c
== 'i') && ((val
>> 32) & 0xffffffff)) {
3509 monitor_printf(mon
, "\'%s\' has failed: ", cmdname
);
3510 monitor_printf(mon
, "integer is for 32-bit values\n");
3512 } else if (c
== 'M') {
3515 qdict_put(qdict
, key
, qint_from_int(val
));
3523 while (qemu_isspace(*p
))
3525 if (*typestr
== '?') {
3531 if (get_double(mon
, &val
, &p
) < 0) {
3534 if (c
== 'f' && *p
) {
3537 val
*= 1 << 10; p
++; break;
3539 val
*= 1 << 20; p
++; break;
3541 val
*= 1 << 30; p
++; break;
3544 if (c
== 'T' && p
[0] && p
[1] == 's') {
3547 val
/= 1e3
; p
+= 2; break;
3549 val
/= 1e6
; p
+= 2; break;
3551 val
/= 1e9
; p
+= 2; break;
3554 if (*p
&& !qemu_isspace(*p
)) {
3555 monitor_printf(mon
, "Unknown unit suffix\n");
3558 qdict_put(qdict
, key
, qfloat_from_double(val
));
3566 while (qemu_isspace(*p
)) {
3570 while (qemu_isgraph(*p
)) {
3573 if (p
- beg
== 2 && !memcmp(beg
, "on", p
- beg
)) {
3575 } else if (p
- beg
== 3 && !memcmp(beg
, "off", p
- beg
)) {
3578 monitor_printf(mon
, "Expected 'on' or 'off'\n");
3581 qdict_put(qdict
, key
, qbool_from_int(val
));
3586 const char *tmp
= p
;
3593 while (qemu_isspace(*p
))
3598 if(!is_valid_option(p
, typestr
)) {
3600 monitor_printf(mon
, "%s: unsupported option -%c\n",
3612 qdict_put(qdict
, key
, qbool_from_int(1));
3619 monitor_printf(mon
, "%s: unknown type '%c'\n", cmdname
, c
);
3625 /* check that all arguments were parsed */
3626 while (qemu_isspace(*p
))
3629 monitor_printf(mon
, "%s: extraneous characters at the end of line\n",
3641 void monitor_set_error(Monitor
*mon
, QError
*qerror
)
3643 /* report only the first error */
3645 mon
->error
= qerror
;
3647 MON_DEBUG("Additional error report at %s:%d\n",
3648 qerror
->file
, qerror
->linenr
);
3653 static int is_async_return(const QObject
*data
)
3655 if (data
&& qobject_type(data
) == QTYPE_QDICT
) {
3656 return qdict_haskey(qobject_to_qdict(data
), "__mon_async");
3662 static void handler_audit(Monitor
*mon
, const mon_cmd_t
*cmd
, int ret
)
3664 if (monitor_ctrl_mode(mon
)) {
3665 if (ret
&& !monitor_has_error(mon
)) {
3667 * If it returns failure, it must have passed on error.
3669 * Action: Report an internal error to the client if in QMP.
3671 qerror_report(QERR_UNDEFINED_ERROR
);
3672 MON_DEBUG("command '%s' returned failure but did not pass an error\n",
3676 #ifdef CONFIG_DEBUG_MONITOR
3677 if (!ret
&& monitor_has_error(mon
)) {
3679 * If it returns success, it must not have passed an error.
3681 * Action: Report the passed error to the client.
3683 MON_DEBUG("command '%s' returned success but passed an error\n",
3687 if (mon_print_count_get(mon
) > 0 && strcmp(cmd
->name
, "info") != 0) {
3689 * Handlers should not call Monitor print functions.
3691 * Action: Ignore them in QMP.
3693 * (XXX: we don't check any 'info' or 'query' command here
3694 * because the user print function _is_ called by do_info(), hence
3695 * we will trigger this check. This problem will go away when we
3696 * make 'query' commands real and kill do_info())
3698 MON_DEBUG("command '%s' called print functions %d time(s)\n",
3699 cmd
->name
, mon_print_count_get(mon
));
3703 assert(!monitor_has_error(mon
));
3704 QDECREF(mon
->error
);
3709 static void monitor_call_handler(Monitor
*mon
, const mon_cmd_t
*cmd
,
3710 const QDict
*params
)
3713 QObject
*data
= NULL
;
3715 mon_print_count_init(mon
);
3717 ret
= cmd
->mhandler
.cmd_new(mon
, params
, &data
);
3718 handler_audit(mon
, cmd
, ret
);
3720 if (is_async_return(data
)) {
3722 * Asynchronous commands have no initial return data but they can
3723 * generate errors. Data is returned via the async completion handler.
3725 if (monitor_ctrl_mode(mon
) && monitor_has_error(mon
)) {
3726 monitor_protocol_emitter(mon
, NULL
);
3728 } else if (monitor_ctrl_mode(mon
)) {
3729 /* Monitor Protocol */
3730 monitor_protocol_emitter(mon
, data
);
3734 cmd
->user_print(mon
, data
);
3737 qobject_decref(data
);
3740 static void handle_user_command(Monitor
*mon
, const char *cmdline
)
3743 const mon_cmd_t
*cmd
;
3745 qdict
= qdict_new();
3747 cmd
= monitor_parse_command(mon
, cmdline
, qdict
);
3751 if (monitor_handler_is_async(cmd
)) {
3752 user_async_cmd_handler(mon
, cmd
, qdict
);
3753 } else if (monitor_handler_ported(cmd
)) {
3754 monitor_call_handler(mon
, cmd
, qdict
);
3756 cmd
->mhandler
.cmd(mon
, qdict
);
3763 static void cmd_completion(const char *name
, const char *list
)
3765 const char *p
, *pstart
;
3774 p
= pstart
+ strlen(pstart
);
3776 if (len
> sizeof(cmd
) - 2)
3777 len
= sizeof(cmd
) - 2;
3778 memcpy(cmd
, pstart
, len
);
3780 if (name
[0] == '\0' || !strncmp(name
, cmd
, strlen(name
))) {
3781 readline_add_completion(cur_mon
->rs
, cmd
);
3789 static void file_completion(const char *input
)
3794 char file
[1024], file_prefix
[1024];
3798 p
= strrchr(input
, '/');
3801 pstrcpy(file_prefix
, sizeof(file_prefix
), input
);
3802 pstrcpy(path
, sizeof(path
), ".");
3804 input_path_len
= p
- input
+ 1;
3805 memcpy(path
, input
, input_path_len
);
3806 if (input_path_len
> sizeof(path
) - 1)
3807 input_path_len
= sizeof(path
) - 1;
3808 path
[input_path_len
] = '\0';
3809 pstrcpy(file_prefix
, sizeof(file_prefix
), p
+ 1);
3811 #ifdef DEBUG_COMPLETION
3812 monitor_printf(cur_mon
, "input='%s' path='%s' prefix='%s'\n",
3813 input
, path
, file_prefix
);
3815 ffs
= opendir(path
);
3823 if (strstart(d
->d_name
, file_prefix
, NULL
)) {
3824 memcpy(file
, input
, input_path_len
);
3825 if (input_path_len
< sizeof(file
))
3826 pstrcpy(file
+ input_path_len
, sizeof(file
) - input_path_len
,
3828 /* stat the file to find out if it's a directory.
3829 * In that case add a slash to speed up typing long paths
3832 if(S_ISDIR(sb
.st_mode
))
3833 pstrcat(file
, sizeof(file
), "/");
3834 readline_add_completion(cur_mon
->rs
, file
);
3840 static void block_completion_it(void *opaque
, BlockDriverState
*bs
)
3842 const char *name
= bdrv_get_device_name(bs
);
3843 const char *input
= opaque
;
3845 if (input
[0] == '\0' ||
3846 !strncmp(name
, (char *)input
, strlen(input
))) {
3847 readline_add_completion(cur_mon
->rs
, name
);
3851 /* NOTE: this parser is an approximate form of the real command parser */
3852 static void parse_cmdline(const char *cmdline
,
3853 int *pnb_args
, char **args
)
3862 while (qemu_isspace(*p
))
3866 if (nb_args
>= MAX_ARGS
)
3868 ret
= get_str(buf
, sizeof(buf
), &p
);
3869 args
[nb_args
] = qemu_strdup(buf
);
3874 *pnb_args
= nb_args
;
3877 static const char *next_arg_type(const char *typestr
)
3879 const char *p
= strchr(typestr
, ':');
3880 return (p
!= NULL
? ++p
: typestr
);
3883 static void monitor_find_completion(const char *cmdline
)
3885 const char *cmdname
;
3886 char *args
[MAX_ARGS
];
3887 int nb_args
, i
, len
;
3888 const char *ptype
, *str
;
3889 const mon_cmd_t
*cmd
;
3892 parse_cmdline(cmdline
, &nb_args
, args
);
3893 #ifdef DEBUG_COMPLETION
3894 for(i
= 0; i
< nb_args
; i
++) {
3895 monitor_printf(cur_mon
, "arg%d = '%s'\n", i
, (char *)args
[i
]);
3899 /* if the line ends with a space, it means we want to complete the
3901 len
= strlen(cmdline
);
3902 if (len
> 0 && qemu_isspace(cmdline
[len
- 1])) {
3903 if (nb_args
>= MAX_ARGS
) {
3906 args
[nb_args
++] = qemu_strdup("");
3909 /* command completion */
3914 readline_set_completion_index(cur_mon
->rs
, strlen(cmdname
));
3915 for(cmd
= mon_cmds
; cmd
->name
!= NULL
; cmd
++) {
3916 cmd_completion(cmdname
, cmd
->name
);
3919 /* find the command */
3920 for (cmd
= mon_cmds
; cmd
->name
!= NULL
; cmd
++) {
3921 if (compare_cmd(args
[0], cmd
->name
)) {
3929 ptype
= next_arg_type(cmd
->args_type
);
3930 for(i
= 0; i
< nb_args
- 2; i
++) {
3931 if (*ptype
!= '\0') {
3932 ptype
= next_arg_type(ptype
);
3933 while (*ptype
== '?')
3934 ptype
= next_arg_type(ptype
);
3937 str
= args
[nb_args
- 1];
3938 if (*ptype
== '-' && ptype
[1] != '\0') {
3939 ptype
= next_arg_type(ptype
);
3943 /* file completion */
3944 readline_set_completion_index(cur_mon
->rs
, strlen(str
));
3945 file_completion(str
);
3948 /* block device name completion */
3949 readline_set_completion_index(cur_mon
->rs
, strlen(str
));
3950 bdrv_iterate(block_completion_it
, (void *)str
);
3953 /* XXX: more generic ? */
3954 if (!strcmp(cmd
->name
, "info")) {
3955 readline_set_completion_index(cur_mon
->rs
, strlen(str
));
3956 for(cmd
= info_cmds
; cmd
->name
!= NULL
; cmd
++) {
3957 cmd_completion(str
, cmd
->name
);
3959 } else if (!strcmp(cmd
->name
, "sendkey")) {
3960 char *sep
= strrchr(str
, '-');
3963 readline_set_completion_index(cur_mon
->rs
, strlen(str
));
3964 for(key
= key_defs
; key
->name
!= NULL
; key
++) {
3965 cmd_completion(str
, key
->name
);
3967 } else if (!strcmp(cmd
->name
, "help|?")) {
3968 readline_set_completion_index(cur_mon
->rs
, strlen(str
));
3969 for (cmd
= mon_cmds
; cmd
->name
!= NULL
; cmd
++) {
3970 cmd_completion(str
, cmd
->name
);
3980 for (i
= 0; i
< nb_args
; i
++) {
3985 static int monitor_can_read(void *opaque
)
3987 Monitor
*mon
= opaque
;
3989 return (mon
->suspend_cnt
== 0) ? 1 : 0;
3992 static int invalid_qmp_mode(const Monitor
*mon
, const char *cmd_name
)
3994 int is_cap
= compare_cmd(cmd_name
, "qmp_capabilities");
3995 return (qmp_cmd_mode(mon
) ? is_cap
: !is_cap
);
3999 * Argument validation rules:
4001 * 1. The argument must exist in cmd_args qdict
4002 * 2. The argument type must be the expected one
4004 * Special case: If the argument doesn't exist in cmd_args and
4005 * the QMP_ACCEPT_UNKNOWNS flag is set, then the
4006 * checking is skipped for it.
4008 static int check_client_args_type(const QDict
*client_args
,
4009 const QDict
*cmd_args
, int flags
)
4011 const QDictEntry
*ent
;
4013 for (ent
= qdict_first(client_args
); ent
;ent
= qdict_next(client_args
,ent
)){
4016 const QObject
*client_arg
= qdict_entry_value(ent
);
4017 const char *client_arg_name
= qdict_entry_key(ent
);
4019 obj
= qdict_get(cmd_args
, client_arg_name
);
4021 if (flags
& QMP_ACCEPT_UNKNOWNS
) {
4022 /* handler accepts unknowns */
4025 /* client arg doesn't exist */
4026 qerror_report(QERR_INVALID_PARAMETER
, client_arg_name
);
4030 arg_type
= qobject_to_qstring(obj
);
4031 assert(arg_type
!= NULL
);
4033 /* check if argument's type is correct */
4034 switch (qstring_get_str(arg_type
)[0]) {
4038 if (qobject_type(client_arg
) != QTYPE_QSTRING
) {
4039 qerror_report(QERR_INVALID_PARAMETER_TYPE
, client_arg_name
,
4047 if (qobject_type(client_arg
) != QTYPE_QINT
) {
4048 qerror_report(QERR_INVALID_PARAMETER_TYPE
, client_arg_name
,
4055 if (qobject_type(client_arg
) != QTYPE_QINT
&&
4056 qobject_type(client_arg
) != QTYPE_QFLOAT
) {
4057 qerror_report(QERR_INVALID_PARAMETER_TYPE
, client_arg_name
,
4064 if (qobject_type(client_arg
) != QTYPE_QBOOL
) {
4065 qerror_report(QERR_INVALID_PARAMETER_TYPE
, client_arg_name
,
4071 assert(flags
& QMP_ACCEPT_UNKNOWNS
);
4076 * These types are not supported by QMP and thus are not
4077 * handled here. Fall through.
4088 * - Check if the client has passed all mandatory args
4089 * - Set special flags for argument validation
4091 static int check_mandatory_args(const QDict
*cmd_args
,
4092 const QDict
*client_args
, int *flags
)
4094 const QDictEntry
*ent
;
4096 for (ent
= qdict_first(cmd_args
); ent
; ent
= qdict_next(cmd_args
, ent
)) {
4097 const char *cmd_arg_name
= qdict_entry_key(ent
);
4098 QString
*type
= qobject_to_qstring(qdict_entry_value(ent
));
4099 assert(type
!= NULL
);
4101 if (qstring_get_str(type
)[0] == 'O') {
4102 assert((*flags
& QMP_ACCEPT_UNKNOWNS
) == 0);
4103 *flags
|= QMP_ACCEPT_UNKNOWNS
;
4104 } else if (qstring_get_str(type
)[0] != '-' &&
4105 qstring_get_str(type
)[1] != '?' &&
4106 !qdict_haskey(client_args
, cmd_arg_name
)) {
4107 qerror_report(QERR_MISSING_PARAMETER
, cmd_arg_name
);
4115 static QDict
*qdict_from_args_type(const char *args_type
)
4119 QString
*key
, *type
, *cur_qs
;
4121 assert(args_type
!= NULL
);
4123 qdict
= qdict_new();
4125 if (args_type
== NULL
|| args_type
[0] == '\0') {
4126 /* no args, empty qdict */
4130 key
= qstring_new();
4131 type
= qstring_new();
4136 switch (args_type
[i
]) {
4139 qdict_put(qdict
, qstring_get_str(key
), type
);
4141 if (args_type
[i
] == '\0') {
4144 type
= qstring_new(); /* qdict has ref */
4145 cur_qs
= key
= qstring_new();
4151 qstring_append_chr(cur_qs
, args_type
[i
]);
4161 * Client argument checking rules:
4163 * 1. Client must provide all mandatory arguments
4164 * 2. Each argument provided by the client must be expected
4165 * 3. Each argument provided by the client must have the type expected
4168 static int qmp_check_client_args(const mon_cmd_t
*cmd
, QDict
*client_args
)
4173 cmd_args
= qdict_from_args_type(cmd
->args_type
);
4176 err
= check_mandatory_args(cmd_args
, client_args
, &flags
);
4181 err
= check_client_args_type(client_args
, cmd_args
, flags
);
4189 * Input object checking rules
4191 * 1. Input object must be a dict
4192 * 2. The "execute" key must exist
4193 * 3. The "execute" key must be a string
4194 * 4. If the "arguments" key exists, it must be a dict
4195 * 5. If the "id" key exists, it can be anything (ie. json-value)
4196 * 6. Any argument not listed above is considered invalid
4198 static QDict
*qmp_check_input_obj(QObject
*input_obj
)
4200 const QDictEntry
*ent
;
4201 int has_exec_key
= 0;
4204 if (qobject_type(input_obj
) != QTYPE_QDICT
) {
4205 qerror_report(QERR_QMP_BAD_INPUT_OBJECT
, "object");
4209 input_dict
= qobject_to_qdict(input_obj
);
4211 for (ent
= qdict_first(input_dict
); ent
; ent
= qdict_next(input_dict
, ent
)){
4212 const char *arg_name
= qdict_entry_key(ent
);
4213 const QObject
*arg_obj
= qdict_entry_value(ent
);
4215 if (!strcmp(arg_name
, "execute")) {
4216 if (qobject_type(arg_obj
) != QTYPE_QSTRING
) {
4217 qerror_report(QERR_QMP_BAD_INPUT_OBJECT_MEMBER
, "execute",
4222 } else if (!strcmp(arg_name
, "arguments")) {
4223 if (qobject_type(arg_obj
) != QTYPE_QDICT
) {
4224 qerror_report(QERR_QMP_BAD_INPUT_OBJECT_MEMBER
, "arguments",
4228 } else if (!strcmp(arg_name
, "id")) {
4229 /* FIXME: check duplicated IDs for async commands */
4231 qerror_report(QERR_QMP_EXTRA_MEMBER
, arg_name
);
4236 if (!has_exec_key
) {
4237 qerror_report(QERR_QMP_BAD_INPUT_OBJECT
, "execute");
4244 static void handle_qmp_command(JSONMessageParser
*parser
, QList
*tokens
)
4248 QDict
*input
, *args
;
4249 const mon_cmd_t
*cmd
;
4250 Monitor
*mon
= cur_mon
;
4251 const char *cmd_name
, *info_item
;
4253 args
= input
= NULL
;
4255 obj
= json_parser_parse(tokens
, NULL
);
4257 // FIXME: should be triggered in json_parser_parse()
4258 qerror_report(QERR_JSON_PARSING
);
4262 input
= qmp_check_input_obj(obj
);
4264 qobject_decref(obj
);
4268 mon
->mc
->id
= qdict_get(input
, "id");
4269 qobject_incref(mon
->mc
->id
);
4271 cmd_name
= qdict_get_str(input
, "execute");
4272 if (invalid_qmp_mode(mon
, cmd_name
)) {
4273 qerror_report(QERR_COMMAND_NOT_FOUND
, cmd_name
);
4278 * XXX: We need this special case until we get info handlers
4279 * converted into 'query-' commands
4281 if (compare_cmd(cmd_name
, "info")) {
4282 qerror_report(QERR_COMMAND_NOT_FOUND
, cmd_name
);
4284 } else if (strstart(cmd_name
, "query-", &info_item
)) {
4285 cmd
= monitor_find_command("info");
4286 qdict_put_obj(input
, "arguments",
4287 qobject_from_jsonf("{ 'item': %s }", info_item
));
4289 cmd
= monitor_find_command(cmd_name
);
4290 if (!cmd
|| !monitor_handler_ported(cmd
)
4291 || monitor_cmd_user_only(cmd
)) {
4292 qerror_report(QERR_COMMAND_NOT_FOUND
, cmd_name
);
4297 obj
= qdict_get(input
, "arguments");
4301 args
= qobject_to_qdict(obj
);
4305 err
= qmp_check_client_args(cmd
, args
);
4310 if (monitor_handler_is_async(cmd
)) {
4311 err
= qmp_async_cmd_handler(mon
, cmd
, args
);
4313 /* emit the error response */
4317 monitor_call_handler(mon
, cmd
, args
);
4323 monitor_protocol_emitter(mon
, NULL
);
4330 * monitor_control_read(): Read and handle QMP input
4332 static void monitor_control_read(void *opaque
, const uint8_t *buf
, int size
)
4334 Monitor
*old_mon
= cur_mon
;
4338 json_message_parser_feed(&cur_mon
->mc
->parser
, (const char *) buf
, size
);
4343 static void monitor_read(void *opaque
, const uint8_t *buf
, int size
)
4345 Monitor
*old_mon
= cur_mon
;
4351 for (i
= 0; i
< size
; i
++)
4352 readline_handle_byte(cur_mon
->rs
, buf
[i
]);
4354 if (size
== 0 || buf
[size
- 1] != 0)
4355 monitor_printf(cur_mon
, "corrupted command\n");
4357 handle_user_command(cur_mon
, (char *)buf
);
4363 static void monitor_command_cb(Monitor
*mon
, const char *cmdline
, void *opaque
)
4365 monitor_suspend(mon
);
4366 handle_user_command(mon
, cmdline
);
4367 monitor_resume(mon
);
4370 int monitor_suspend(Monitor
*mon
)
4378 void monitor_resume(Monitor
*mon
)
4382 if (--mon
->suspend_cnt
== 0)
4383 readline_show_prompt(mon
->rs
);
4386 static QObject
*get_qmp_greeting(void)
4390 do_info_version(NULL
, &ver
);
4391 return qobject_from_jsonf("{'QMP':{'version': %p,'capabilities': []}}",ver
);
4395 * monitor_control_event(): Print QMP gretting
4397 static void monitor_control_event(void *opaque
, int event
)
4400 Monitor
*mon
= opaque
;
4403 case CHR_EVENT_OPENED
:
4404 mon
->mc
->command_mode
= 0;
4405 json_message_parser_init(&mon
->mc
->parser
, handle_qmp_command
);
4406 data
= get_qmp_greeting();
4407 monitor_json_emitter(mon
, data
);
4408 qobject_decref(data
);
4410 case CHR_EVENT_CLOSED
:
4411 json_message_parser_destroy(&mon
->mc
->parser
);
4416 static void monitor_event(void *opaque
, int event
)
4418 Monitor
*mon
= opaque
;
4421 case CHR_EVENT_MUX_IN
:
4423 if (mon
->reset_seen
) {
4424 readline_restart(mon
->rs
);
4425 monitor_resume(mon
);
4428 mon
->suspend_cnt
= 0;
4432 case CHR_EVENT_MUX_OUT
:
4433 if (mon
->reset_seen
) {
4434 if (mon
->suspend_cnt
== 0) {
4435 monitor_printf(mon
, "\n");
4438 monitor_suspend(mon
);
4445 case CHR_EVENT_OPENED
:
4446 monitor_printf(mon
, "QEMU %s monitor - type 'help' for more "
4447 "information\n", QEMU_VERSION
);
4448 if (!mon
->mux_out
) {
4449 readline_show_prompt(mon
->rs
);
4451 mon
->reset_seen
= 1;
4465 void monitor_init(CharDriverState
*chr
, int flags
)
4467 static int is_first_init
= 1;
4470 if (is_first_init
) {
4471 key_timer
= qemu_new_timer(vm_clock
, release_keys
, NULL
);
4475 mon
= qemu_mallocz(sizeof(*mon
));
4479 if (flags
& MONITOR_USE_READLINE
) {
4480 mon
->rs
= readline_init(mon
, monitor_find_completion
);
4481 monitor_read_command(mon
, 0);
4484 if (monitor_ctrl_mode(mon
)) {
4485 mon
->mc
= qemu_mallocz(sizeof(MonitorControl
));
4486 /* Control mode requires special handlers */
4487 qemu_chr_add_handlers(chr
, monitor_can_read
, monitor_control_read
,
4488 monitor_control_event
, mon
);
4490 qemu_chr_add_handlers(chr
, monitor_can_read
, monitor_read
,
4491 monitor_event
, mon
);
4494 QLIST_INSERT_HEAD(&mon_list
, mon
, entry
);
4495 if (!default_mon
|| (flags
& MONITOR_IS_DEFAULT
))
4499 static void bdrv_password_cb(Monitor
*mon
, const char *password
, void *opaque
)
4501 BlockDriverState
*bs
= opaque
;
4504 if (bdrv_set_key(bs
, password
) != 0) {
4505 monitor_printf(mon
, "invalid password\n");
4508 if (mon
->password_completion_cb
)
4509 mon
->password_completion_cb(mon
->password_opaque
, ret
);
4511 monitor_read_command(mon
, 1);
4514 int monitor_read_bdrv_key_start(Monitor
*mon
, BlockDriverState
*bs
,
4515 BlockDriverCompletionFunc
*completion_cb
,
4520 if (!bdrv_key_required(bs
)) {
4522 completion_cb(opaque
, 0);
4526 if (monitor_ctrl_mode(mon
)) {
4527 qerror_report(QERR_DEVICE_ENCRYPTED
, bdrv_get_device_name(bs
));
4531 monitor_printf(mon
, "%s (%s) is encrypted.\n", bdrv_get_device_name(bs
),
4532 bdrv_get_encrypted_filename(bs
));
4534 mon
->password_completion_cb
= completion_cb
;
4535 mon
->password_opaque
= opaque
;
4537 err
= monitor_read_password(mon
, bdrv_password_cb
, bs
);
4539 if (err
&& completion_cb
)
4540 completion_cb(opaque
, err
);