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
) {
2282 int monitor_get_fd(Monitor
*mon
, const char *fdname
)
2286 QLIST_FOREACH(monfd
, &mon
->fds
, next
) {
2289 if (strcmp(monfd
->name
, fdname
) != 0) {
2295 /* caller takes ownership of fd */
2296 QLIST_REMOVE(monfd
, next
);
2297 qemu_free(monfd
->name
);
2306 static const mon_cmd_t mon_cmds
[] = {
2307 #include "qemu-monitor.h"
2311 /* Please update qemu-monitor.hx when adding or changing commands */
2312 static const mon_cmd_t info_cmds
[] = {
2317 .help
= "show the version of QEMU",
2318 .user_print
= do_info_version_print
,
2319 .mhandler
.info_new
= do_info_version
,
2325 .help
= "list QMP available commands",
2326 .user_print
= monitor_user_noop
,
2327 .mhandler
.info_new
= do_info_commands
,
2333 .help
= "show the network state",
2334 .mhandler
.info
= do_info_network
,
2340 .help
= "show the character devices",
2341 .user_print
= qemu_chr_info_print
,
2342 .mhandler
.info_new
= qemu_chr_info
,
2348 .help
= "show the block devices",
2349 .user_print
= bdrv_info_print
,
2350 .mhandler
.info_new
= bdrv_info
,
2353 .name
= "blockstats",
2356 .help
= "show block device statistics",
2357 .user_print
= bdrv_stats_print
,
2358 .mhandler
.info_new
= bdrv_info_stats
,
2361 .name
= "registers",
2364 .help
= "show the cpu registers",
2365 .mhandler
.info
= do_info_registers
,
2371 .help
= "show infos for each CPU",
2372 .user_print
= monitor_print_cpus
,
2373 .mhandler
.info_new
= do_info_cpus
,
2379 .help
= "show the command line history",
2380 .mhandler
.info
= do_info_history
,
2386 .help
= "show the interrupts statistics (if available)",
2387 .mhandler
.info
= irq_info
,
2393 .help
= "show i8259 (PIC) state",
2394 .mhandler
.info
= pic_info
,
2400 .help
= "show PCI info",
2401 .user_print
= do_pci_info_print
,
2402 .mhandler
.info_new
= do_pci_info
,
2404 #if defined(TARGET_I386) || defined(TARGET_SH4)
2409 .help
= "show virtual to physical memory mappings",
2410 .mhandler
.info
= tlb_info
,
2413 #if defined(TARGET_I386)
2418 .help
= "show the active virtual memory mappings",
2419 .mhandler
.info
= mem_info
,
2426 .help
= "show dynamic compiler info",
2427 .mhandler
.info
= do_info_jit
,
2433 .help
= "show KVM information",
2434 .user_print
= do_info_kvm_print
,
2435 .mhandler
.info_new
= do_info_kvm
,
2441 .help
= "show NUMA information",
2442 .mhandler
.info
= do_info_numa
,
2448 .help
= "show guest USB devices",
2449 .mhandler
.info
= usb_info
,
2455 .help
= "show host USB devices",
2456 .mhandler
.info
= usb_host_info
,
2462 .help
= "show profiling information",
2463 .mhandler
.info
= do_info_profile
,
2469 .help
= "show capture information",
2470 .mhandler
.info
= do_info_capture
,
2473 .name
= "snapshots",
2476 .help
= "show the currently saved VM snapshots",
2477 .mhandler
.info
= do_info_snapshots
,
2483 .help
= "show the current VM status (running|paused)",
2484 .user_print
= do_info_status_print
,
2485 .mhandler
.info_new
= do_info_status
,
2491 .help
= "show guest PCMCIA status",
2492 .mhandler
.info
= pcmcia_info
,
2498 .help
= "show which guest mouse is receiving events",
2499 .user_print
= do_info_mice_print
,
2500 .mhandler
.info_new
= do_info_mice
,
2506 .help
= "show the vnc server status",
2507 .user_print
= do_info_vnc_print
,
2508 .mhandler
.info_new
= do_info_vnc
,
2514 .help
= "show the current VM name",
2515 .user_print
= do_info_name_print
,
2516 .mhandler
.info_new
= do_info_name
,
2522 .help
= "show the current VM UUID",
2523 .user_print
= do_info_uuid_print
,
2524 .mhandler
.info_new
= do_info_uuid
,
2526 #if defined(TARGET_PPC)
2531 .help
= "show CPU statistics",
2532 .mhandler
.info
= do_info_cpu_stats
,
2535 #if defined(CONFIG_SLIRP)
2540 .help
= "show user network stack connection states",
2541 .mhandler
.info
= do_info_usernet
,
2548 .help
= "show migration status",
2549 .user_print
= do_info_migrate_print
,
2550 .mhandler
.info_new
= do_info_migrate
,
2556 .help
= "show balloon information",
2557 .user_print
= monitor_print_balloon
,
2558 .mhandler
.info_async
= do_info_balloon
,
2559 .flags
= MONITOR_CMD_ASYNC
,
2565 .help
= "show device tree",
2566 .mhandler
.info
= do_info_qtree
,
2572 .help
= "show qdev device model list",
2573 .mhandler
.info
= do_info_qdm
,
2579 .help
= "show roms",
2580 .mhandler
.info
= do_info_roms
,
2587 /*******************************************************************/
2589 static const char *pch
;
2590 static jmp_buf expr_env
;
2595 typedef struct MonitorDef
{
2598 target_long (*get_value
)(const struct MonitorDef
*md
, int val
);
2602 #if defined(TARGET_I386)
2603 static target_long
monitor_get_pc (const struct MonitorDef
*md
, int val
)
2605 CPUState
*env
= mon_get_cpu();
2606 return env
->eip
+ env
->segs
[R_CS
].base
;
2610 #if defined(TARGET_PPC)
2611 static target_long
monitor_get_ccr (const struct MonitorDef
*md
, int val
)
2613 CPUState
*env
= mon_get_cpu();
2618 for (i
= 0; i
< 8; i
++)
2619 u
|= env
->crf
[i
] << (32 - (4 * i
));
2624 static target_long
monitor_get_msr (const struct MonitorDef
*md
, int val
)
2626 CPUState
*env
= mon_get_cpu();
2630 static target_long
monitor_get_xer (const struct MonitorDef
*md
, int val
)
2632 CPUState
*env
= mon_get_cpu();
2636 static target_long
monitor_get_decr (const struct MonitorDef
*md
, int val
)
2638 CPUState
*env
= mon_get_cpu();
2639 return cpu_ppc_load_decr(env
);
2642 static target_long
monitor_get_tbu (const struct MonitorDef
*md
, int val
)
2644 CPUState
*env
= mon_get_cpu();
2645 return cpu_ppc_load_tbu(env
);
2648 static target_long
monitor_get_tbl (const struct MonitorDef
*md
, int val
)
2650 CPUState
*env
= mon_get_cpu();
2651 return cpu_ppc_load_tbl(env
);
2655 #if defined(TARGET_SPARC)
2656 #ifndef TARGET_SPARC64
2657 static target_long
monitor_get_psr (const struct MonitorDef
*md
, int val
)
2659 CPUState
*env
= mon_get_cpu();
2661 return cpu_get_psr(env
);
2665 static target_long
monitor_get_reg(const struct MonitorDef
*md
, int val
)
2667 CPUState
*env
= mon_get_cpu();
2668 return env
->regwptr
[val
];
2672 static const MonitorDef monitor_defs
[] = {
2675 #define SEG(name, seg) \
2676 { name, offsetof(CPUState, segs[seg].selector), NULL, MD_I32 },\
2677 { name ".base", offsetof(CPUState, segs[seg].base) },\
2678 { name ".limit", offsetof(CPUState, segs[seg].limit), NULL, MD_I32 },
2680 { "eax", offsetof(CPUState
, regs
[0]) },
2681 { "ecx", offsetof(CPUState
, regs
[1]) },
2682 { "edx", offsetof(CPUState
, regs
[2]) },
2683 { "ebx", offsetof(CPUState
, regs
[3]) },
2684 { "esp|sp", offsetof(CPUState
, regs
[4]) },
2685 { "ebp|fp", offsetof(CPUState
, regs
[5]) },
2686 { "esi", offsetof(CPUState
, regs
[6]) },
2687 { "edi", offsetof(CPUState
, regs
[7]) },
2688 #ifdef TARGET_X86_64
2689 { "r8", offsetof(CPUState
, regs
[8]) },
2690 { "r9", offsetof(CPUState
, regs
[9]) },
2691 { "r10", offsetof(CPUState
, regs
[10]) },
2692 { "r11", offsetof(CPUState
, regs
[11]) },
2693 { "r12", offsetof(CPUState
, regs
[12]) },
2694 { "r13", offsetof(CPUState
, regs
[13]) },
2695 { "r14", offsetof(CPUState
, regs
[14]) },
2696 { "r15", offsetof(CPUState
, regs
[15]) },
2698 { "eflags", offsetof(CPUState
, eflags
) },
2699 { "eip", offsetof(CPUState
, eip
) },
2706 { "pc", 0, monitor_get_pc
, },
2707 #elif defined(TARGET_PPC)
2708 /* General purpose registers */
2709 { "r0", offsetof(CPUState
, gpr
[0]) },
2710 { "r1", offsetof(CPUState
, gpr
[1]) },
2711 { "r2", offsetof(CPUState
, gpr
[2]) },
2712 { "r3", offsetof(CPUState
, gpr
[3]) },
2713 { "r4", offsetof(CPUState
, gpr
[4]) },
2714 { "r5", offsetof(CPUState
, gpr
[5]) },
2715 { "r6", offsetof(CPUState
, gpr
[6]) },
2716 { "r7", offsetof(CPUState
, gpr
[7]) },
2717 { "r8", offsetof(CPUState
, gpr
[8]) },
2718 { "r9", offsetof(CPUState
, gpr
[9]) },
2719 { "r10", offsetof(CPUState
, gpr
[10]) },
2720 { "r11", offsetof(CPUState
, gpr
[11]) },
2721 { "r12", offsetof(CPUState
, gpr
[12]) },
2722 { "r13", offsetof(CPUState
, gpr
[13]) },
2723 { "r14", offsetof(CPUState
, gpr
[14]) },
2724 { "r15", offsetof(CPUState
, gpr
[15]) },
2725 { "r16", offsetof(CPUState
, gpr
[16]) },
2726 { "r17", offsetof(CPUState
, gpr
[17]) },
2727 { "r18", offsetof(CPUState
, gpr
[18]) },
2728 { "r19", offsetof(CPUState
, gpr
[19]) },
2729 { "r20", offsetof(CPUState
, gpr
[20]) },
2730 { "r21", offsetof(CPUState
, gpr
[21]) },
2731 { "r22", offsetof(CPUState
, gpr
[22]) },
2732 { "r23", offsetof(CPUState
, gpr
[23]) },
2733 { "r24", offsetof(CPUState
, gpr
[24]) },
2734 { "r25", offsetof(CPUState
, gpr
[25]) },
2735 { "r26", offsetof(CPUState
, gpr
[26]) },
2736 { "r27", offsetof(CPUState
, gpr
[27]) },
2737 { "r28", offsetof(CPUState
, gpr
[28]) },
2738 { "r29", offsetof(CPUState
, gpr
[29]) },
2739 { "r30", offsetof(CPUState
, gpr
[30]) },
2740 { "r31", offsetof(CPUState
, gpr
[31]) },
2741 /* Floating point registers */
2742 { "f0", offsetof(CPUState
, fpr
[0]) },
2743 { "f1", offsetof(CPUState
, fpr
[1]) },
2744 { "f2", offsetof(CPUState
, fpr
[2]) },
2745 { "f3", offsetof(CPUState
, fpr
[3]) },
2746 { "f4", offsetof(CPUState
, fpr
[4]) },
2747 { "f5", offsetof(CPUState
, fpr
[5]) },
2748 { "f6", offsetof(CPUState
, fpr
[6]) },
2749 { "f7", offsetof(CPUState
, fpr
[7]) },
2750 { "f8", offsetof(CPUState
, fpr
[8]) },
2751 { "f9", offsetof(CPUState
, fpr
[9]) },
2752 { "f10", offsetof(CPUState
, fpr
[10]) },
2753 { "f11", offsetof(CPUState
, fpr
[11]) },
2754 { "f12", offsetof(CPUState
, fpr
[12]) },
2755 { "f13", offsetof(CPUState
, fpr
[13]) },
2756 { "f14", offsetof(CPUState
, fpr
[14]) },
2757 { "f15", offsetof(CPUState
, fpr
[15]) },
2758 { "f16", offsetof(CPUState
, fpr
[16]) },
2759 { "f17", offsetof(CPUState
, fpr
[17]) },
2760 { "f18", offsetof(CPUState
, fpr
[18]) },
2761 { "f19", offsetof(CPUState
, fpr
[19]) },
2762 { "f20", offsetof(CPUState
, fpr
[20]) },
2763 { "f21", offsetof(CPUState
, fpr
[21]) },
2764 { "f22", offsetof(CPUState
, fpr
[22]) },
2765 { "f23", offsetof(CPUState
, fpr
[23]) },
2766 { "f24", offsetof(CPUState
, fpr
[24]) },
2767 { "f25", offsetof(CPUState
, fpr
[25]) },
2768 { "f26", offsetof(CPUState
, fpr
[26]) },
2769 { "f27", offsetof(CPUState
, fpr
[27]) },
2770 { "f28", offsetof(CPUState
, fpr
[28]) },
2771 { "f29", offsetof(CPUState
, fpr
[29]) },
2772 { "f30", offsetof(CPUState
, fpr
[30]) },
2773 { "f31", offsetof(CPUState
, fpr
[31]) },
2774 { "fpscr", offsetof(CPUState
, fpscr
) },
2775 /* Next instruction pointer */
2776 { "nip|pc", offsetof(CPUState
, nip
) },
2777 { "lr", offsetof(CPUState
, lr
) },
2778 { "ctr", offsetof(CPUState
, ctr
) },
2779 { "decr", 0, &monitor_get_decr
, },
2780 { "ccr", 0, &monitor_get_ccr
, },
2781 /* Machine state register */
2782 { "msr", 0, &monitor_get_msr
, },
2783 { "xer", 0, &monitor_get_xer
, },
2784 { "tbu", 0, &monitor_get_tbu
, },
2785 { "tbl", 0, &monitor_get_tbl
, },
2786 #if defined(TARGET_PPC64)
2787 /* Address space register */
2788 { "asr", offsetof(CPUState
, asr
) },
2790 /* Segment registers */
2791 { "sdr1", offsetof(CPUState
, sdr1
) },
2792 { "sr0", offsetof(CPUState
, sr
[0]) },
2793 { "sr1", offsetof(CPUState
, sr
[1]) },
2794 { "sr2", offsetof(CPUState
, sr
[2]) },
2795 { "sr3", offsetof(CPUState
, sr
[3]) },
2796 { "sr4", offsetof(CPUState
, sr
[4]) },
2797 { "sr5", offsetof(CPUState
, sr
[5]) },
2798 { "sr6", offsetof(CPUState
, sr
[6]) },
2799 { "sr7", offsetof(CPUState
, sr
[7]) },
2800 { "sr8", offsetof(CPUState
, sr
[8]) },
2801 { "sr9", offsetof(CPUState
, sr
[9]) },
2802 { "sr10", offsetof(CPUState
, sr
[10]) },
2803 { "sr11", offsetof(CPUState
, sr
[11]) },
2804 { "sr12", offsetof(CPUState
, sr
[12]) },
2805 { "sr13", offsetof(CPUState
, sr
[13]) },
2806 { "sr14", offsetof(CPUState
, sr
[14]) },
2807 { "sr15", offsetof(CPUState
, sr
[15]) },
2808 /* Too lazy to put BATs and SPRs ... */
2809 #elif defined(TARGET_SPARC)
2810 { "g0", offsetof(CPUState
, gregs
[0]) },
2811 { "g1", offsetof(CPUState
, gregs
[1]) },
2812 { "g2", offsetof(CPUState
, gregs
[2]) },
2813 { "g3", offsetof(CPUState
, gregs
[3]) },
2814 { "g4", offsetof(CPUState
, gregs
[4]) },
2815 { "g5", offsetof(CPUState
, gregs
[5]) },
2816 { "g6", offsetof(CPUState
, gregs
[6]) },
2817 { "g7", offsetof(CPUState
, gregs
[7]) },
2818 { "o0", 0, monitor_get_reg
},
2819 { "o1", 1, monitor_get_reg
},
2820 { "o2", 2, monitor_get_reg
},
2821 { "o3", 3, monitor_get_reg
},
2822 { "o4", 4, monitor_get_reg
},
2823 { "o5", 5, monitor_get_reg
},
2824 { "o6", 6, monitor_get_reg
},
2825 { "o7", 7, monitor_get_reg
},
2826 { "l0", 8, monitor_get_reg
},
2827 { "l1", 9, monitor_get_reg
},
2828 { "l2", 10, monitor_get_reg
},
2829 { "l3", 11, monitor_get_reg
},
2830 { "l4", 12, monitor_get_reg
},
2831 { "l5", 13, monitor_get_reg
},
2832 { "l6", 14, monitor_get_reg
},
2833 { "l7", 15, monitor_get_reg
},
2834 { "i0", 16, monitor_get_reg
},
2835 { "i1", 17, monitor_get_reg
},
2836 { "i2", 18, monitor_get_reg
},
2837 { "i3", 19, monitor_get_reg
},
2838 { "i4", 20, monitor_get_reg
},
2839 { "i5", 21, monitor_get_reg
},
2840 { "i6", 22, monitor_get_reg
},
2841 { "i7", 23, monitor_get_reg
},
2842 { "pc", offsetof(CPUState
, pc
) },
2843 { "npc", offsetof(CPUState
, npc
) },
2844 { "y", offsetof(CPUState
, y
) },
2845 #ifndef TARGET_SPARC64
2846 { "psr", 0, &monitor_get_psr
, },
2847 { "wim", offsetof(CPUState
, wim
) },
2849 { "tbr", offsetof(CPUState
, tbr
) },
2850 { "fsr", offsetof(CPUState
, fsr
) },
2851 { "f0", offsetof(CPUState
, fpr
[0]) },
2852 { "f1", offsetof(CPUState
, fpr
[1]) },
2853 { "f2", offsetof(CPUState
, fpr
[2]) },
2854 { "f3", offsetof(CPUState
, fpr
[3]) },
2855 { "f4", offsetof(CPUState
, fpr
[4]) },
2856 { "f5", offsetof(CPUState
, fpr
[5]) },
2857 { "f6", offsetof(CPUState
, fpr
[6]) },
2858 { "f7", offsetof(CPUState
, fpr
[7]) },
2859 { "f8", offsetof(CPUState
, fpr
[8]) },
2860 { "f9", offsetof(CPUState
, fpr
[9]) },
2861 { "f10", offsetof(CPUState
, fpr
[10]) },
2862 { "f11", offsetof(CPUState
, fpr
[11]) },
2863 { "f12", offsetof(CPUState
, fpr
[12]) },
2864 { "f13", offsetof(CPUState
, fpr
[13]) },
2865 { "f14", offsetof(CPUState
, fpr
[14]) },
2866 { "f15", offsetof(CPUState
, fpr
[15]) },
2867 { "f16", offsetof(CPUState
, fpr
[16]) },
2868 { "f17", offsetof(CPUState
, fpr
[17]) },
2869 { "f18", offsetof(CPUState
, fpr
[18]) },
2870 { "f19", offsetof(CPUState
, fpr
[19]) },
2871 { "f20", offsetof(CPUState
, fpr
[20]) },
2872 { "f21", offsetof(CPUState
, fpr
[21]) },
2873 { "f22", offsetof(CPUState
, fpr
[22]) },
2874 { "f23", offsetof(CPUState
, fpr
[23]) },
2875 { "f24", offsetof(CPUState
, fpr
[24]) },
2876 { "f25", offsetof(CPUState
, fpr
[25]) },
2877 { "f26", offsetof(CPUState
, fpr
[26]) },
2878 { "f27", offsetof(CPUState
, fpr
[27]) },
2879 { "f28", offsetof(CPUState
, fpr
[28]) },
2880 { "f29", offsetof(CPUState
, fpr
[29]) },
2881 { "f30", offsetof(CPUState
, fpr
[30]) },
2882 { "f31", offsetof(CPUState
, fpr
[31]) },
2883 #ifdef TARGET_SPARC64
2884 { "f32", offsetof(CPUState
, fpr
[32]) },
2885 { "f34", offsetof(CPUState
, fpr
[34]) },
2886 { "f36", offsetof(CPUState
, fpr
[36]) },
2887 { "f38", offsetof(CPUState
, fpr
[38]) },
2888 { "f40", offsetof(CPUState
, fpr
[40]) },
2889 { "f42", offsetof(CPUState
, fpr
[42]) },
2890 { "f44", offsetof(CPUState
, fpr
[44]) },
2891 { "f46", offsetof(CPUState
, fpr
[46]) },
2892 { "f48", offsetof(CPUState
, fpr
[48]) },
2893 { "f50", offsetof(CPUState
, fpr
[50]) },
2894 { "f52", offsetof(CPUState
, fpr
[52]) },
2895 { "f54", offsetof(CPUState
, fpr
[54]) },
2896 { "f56", offsetof(CPUState
, fpr
[56]) },
2897 { "f58", offsetof(CPUState
, fpr
[58]) },
2898 { "f60", offsetof(CPUState
, fpr
[60]) },
2899 { "f62", offsetof(CPUState
, fpr
[62]) },
2900 { "asi", offsetof(CPUState
, asi
) },
2901 { "pstate", offsetof(CPUState
, pstate
) },
2902 { "cansave", offsetof(CPUState
, cansave
) },
2903 { "canrestore", offsetof(CPUState
, canrestore
) },
2904 { "otherwin", offsetof(CPUState
, otherwin
) },
2905 { "wstate", offsetof(CPUState
, wstate
) },
2906 { "cleanwin", offsetof(CPUState
, cleanwin
) },
2907 { "fprs", offsetof(CPUState
, fprs
) },
2913 static void expr_error(Monitor
*mon
, const char *msg
)
2915 monitor_printf(mon
, "%s\n", msg
);
2916 longjmp(expr_env
, 1);
2919 /* return 0 if OK, -1 if not found */
2920 static int get_monitor_def(target_long
*pval
, const char *name
)
2922 const MonitorDef
*md
;
2925 for(md
= monitor_defs
; md
->name
!= NULL
; md
++) {
2926 if (compare_cmd(name
, md
->name
)) {
2927 if (md
->get_value
) {
2928 *pval
= md
->get_value(md
, md
->offset
);
2930 CPUState
*env
= mon_get_cpu();
2931 ptr
= (uint8_t *)env
+ md
->offset
;
2934 *pval
= *(int32_t *)ptr
;
2937 *pval
= *(target_long
*)ptr
;
2950 static void next(void)
2954 while (qemu_isspace(*pch
))
2959 static int64_t expr_sum(Monitor
*mon
);
2961 static int64_t expr_unary(Monitor
*mon
)
2970 n
= expr_unary(mon
);
2974 n
= -expr_unary(mon
);
2978 n
= ~expr_unary(mon
);
2984 expr_error(mon
, "')' expected");
2991 expr_error(mon
, "character constant expected");
2995 expr_error(mon
, "missing terminating \' character");
3005 while ((*pch
>= 'a' && *pch
<= 'z') ||
3006 (*pch
>= 'A' && *pch
<= 'Z') ||
3007 (*pch
>= '0' && *pch
<= '9') ||
3008 *pch
== '_' || *pch
== '.') {
3009 if ((q
- buf
) < sizeof(buf
) - 1)
3013 while (qemu_isspace(*pch
))
3016 ret
= get_monitor_def(®
, buf
);
3018 expr_error(mon
, "unknown register");
3023 expr_error(mon
, "unexpected end of expression");
3027 #if TARGET_PHYS_ADDR_BITS > 32
3028 n
= strtoull(pch
, &p
, 0);
3030 n
= strtoul(pch
, &p
, 0);
3033 expr_error(mon
, "invalid char in expression");
3036 while (qemu_isspace(*pch
))
3044 static int64_t expr_prod(Monitor
*mon
)
3049 val
= expr_unary(mon
);
3052 if (op
!= '*' && op
!= '/' && op
!= '%')
3055 val2
= expr_unary(mon
);
3064 expr_error(mon
, "division by zero");
3075 static int64_t expr_logic(Monitor
*mon
)
3080 val
= expr_prod(mon
);
3083 if (op
!= '&' && op
!= '|' && op
!= '^')
3086 val2
= expr_prod(mon
);
3103 static int64_t expr_sum(Monitor
*mon
)
3108 val
= expr_logic(mon
);
3111 if (op
!= '+' && op
!= '-')
3114 val2
= expr_logic(mon
);
3123 static int get_expr(Monitor
*mon
, int64_t *pval
, const char **pp
)
3126 if (setjmp(expr_env
)) {
3130 while (qemu_isspace(*pch
))
3132 *pval
= expr_sum(mon
);
3137 static int get_double(Monitor
*mon
, double *pval
, const char **pp
)
3139 const char *p
= *pp
;
3143 d
= strtod(p
, &tailp
);
3145 monitor_printf(mon
, "Number expected\n");
3148 if (d
!= d
|| d
- d
!= 0) {
3149 /* NaN or infinity */
3150 monitor_printf(mon
, "Bad number\n");
3158 static int get_str(char *buf
, int buf_size
, const char **pp
)
3166 while (qemu_isspace(*p
))
3176 while (*p
!= '\0' && *p
!= '\"') {
3192 qemu_printf("unsupported escape code: '\\%c'\n", c
);
3195 if ((q
- buf
) < buf_size
- 1) {
3199 if ((q
- buf
) < buf_size
- 1) {
3206 qemu_printf("unterminated string\n");
3211 while (*p
!= '\0' && !qemu_isspace(*p
)) {
3212 if ((q
- buf
) < buf_size
- 1) {
3224 * Store the command-name in cmdname, and return a pointer to
3225 * the remaining of the command string.
3227 static const char *get_command_name(const char *cmdline
,
3228 char *cmdname
, size_t nlen
)
3231 const char *p
, *pstart
;
3234 while (qemu_isspace(*p
))
3239 while (*p
!= '\0' && *p
!= '/' && !qemu_isspace(*p
))
3244 memcpy(cmdname
, pstart
, len
);
3245 cmdname
[len
] = '\0';
3250 * Read key of 'type' into 'key' and return the current
3253 static char *key_get_info(const char *type
, char **key
)
3261 p
= strchr(type
, ':');
3268 str
= qemu_malloc(len
+ 1);
3269 memcpy(str
, type
, len
);
3276 static int default_fmt_format
= 'x';
3277 static int default_fmt_size
= 4;
3281 static int is_valid_option(const char *c
, const char *typestr
)
3289 typestr
= strstr(typestr
, option
);
3290 return (typestr
!= NULL
);
3293 static const mon_cmd_t
*monitor_find_command(const char *cmdname
)
3295 const mon_cmd_t
*cmd
;
3297 for (cmd
= mon_cmds
; cmd
->name
!= NULL
; cmd
++) {
3298 if (compare_cmd(cmdname
, cmd
->name
)) {
3306 static const mon_cmd_t
*monitor_parse_command(Monitor
*mon
,
3307 const char *cmdline
,
3310 const char *p
, *typestr
;
3312 const mon_cmd_t
*cmd
;
3318 monitor_printf(mon
, "command='%s'\n", cmdline
);
3321 /* extract the command name */
3322 p
= get_command_name(cmdline
, cmdname
, sizeof(cmdname
));
3326 cmd
= monitor_find_command(cmdname
);
3328 monitor_printf(mon
, "unknown command: '%s'\n", cmdname
);
3332 /* parse the parameters */
3333 typestr
= cmd
->args_type
;
3335 typestr
= key_get_info(typestr
, &key
);
3347 while (qemu_isspace(*p
))
3349 if (*typestr
== '?') {
3352 /* no optional string: NULL argument */
3356 ret
= get_str(buf
, sizeof(buf
), &p
);
3360 monitor_printf(mon
, "%s: filename expected\n",
3364 monitor_printf(mon
, "%s: block device name expected\n",
3368 monitor_printf(mon
, "%s: string expected\n", cmdname
);
3373 qdict_put(qdict
, key
, qstring_from_str(buf
));
3378 QemuOptsList
*opts_list
;
3381 opts_list
= qemu_find_opts(key
);
3382 if (!opts_list
|| opts_list
->desc
->name
) {
3385 while (qemu_isspace(*p
)) {
3390 if (get_str(buf
, sizeof(buf
), &p
) < 0) {
3393 opts
= qemu_opts_parse(opts_list
, buf
, 1);
3397 qemu_opts_to_qdict(opts
, qdict
);
3398 qemu_opts_del(opts
);
3403 int count
, format
, size
;
3405 while (qemu_isspace(*p
))
3411 if (qemu_isdigit(*p
)) {
3413 while (qemu_isdigit(*p
)) {
3414 count
= count
* 10 + (*p
- '0');
3452 if (*p
!= '\0' && !qemu_isspace(*p
)) {
3453 monitor_printf(mon
, "invalid char in format: '%c'\n",
3458 format
= default_fmt_format
;
3459 if (format
!= 'i') {
3460 /* for 'i', not specifying a size gives -1 as size */
3462 size
= default_fmt_size
;
3463 default_fmt_size
= size
;
3465 default_fmt_format
= format
;
3468 format
= default_fmt_format
;
3469 if (format
!= 'i') {
3470 size
= default_fmt_size
;
3475 qdict_put(qdict
, "count", qint_from_int(count
));
3476 qdict_put(qdict
, "format", qint_from_int(format
));
3477 qdict_put(qdict
, "size", qint_from_int(size
));
3486 while (qemu_isspace(*p
))
3488 if (*typestr
== '?' || *typestr
== '.') {
3489 if (*typestr
== '?') {
3497 while (qemu_isspace(*p
))
3506 if (get_expr(mon
, &val
, &p
))
3508 /* Check if 'i' is greater than 32-bit */
3509 if ((c
== 'i') && ((val
>> 32) & 0xffffffff)) {
3510 monitor_printf(mon
, "\'%s\' has failed: ", cmdname
);
3511 monitor_printf(mon
, "integer is for 32-bit values\n");
3513 } else if (c
== 'M') {
3516 qdict_put(qdict
, key
, qint_from_int(val
));
3524 while (qemu_isspace(*p
))
3526 if (*typestr
== '?') {
3532 if (get_double(mon
, &val
, &p
) < 0) {
3535 if (c
== 'f' && *p
) {
3538 val
*= 1 << 10; p
++; break;
3540 val
*= 1 << 20; p
++; break;
3542 val
*= 1 << 30; p
++; break;
3545 if (c
== 'T' && p
[0] && p
[1] == 's') {
3548 val
/= 1e3
; p
+= 2; break;
3550 val
/= 1e6
; p
+= 2; break;
3552 val
/= 1e9
; p
+= 2; break;
3555 if (*p
&& !qemu_isspace(*p
)) {
3556 monitor_printf(mon
, "Unknown unit suffix\n");
3559 qdict_put(qdict
, key
, qfloat_from_double(val
));
3567 while (qemu_isspace(*p
)) {
3571 while (qemu_isgraph(*p
)) {
3574 if (p
- beg
== 2 && !memcmp(beg
, "on", p
- beg
)) {
3576 } else if (p
- beg
== 3 && !memcmp(beg
, "off", p
- beg
)) {
3579 monitor_printf(mon
, "Expected 'on' or 'off'\n");
3582 qdict_put(qdict
, key
, qbool_from_int(val
));
3587 const char *tmp
= p
;
3594 while (qemu_isspace(*p
))
3599 if(!is_valid_option(p
, typestr
)) {
3601 monitor_printf(mon
, "%s: unsupported option -%c\n",
3613 qdict_put(qdict
, key
, qbool_from_int(1));
3620 monitor_printf(mon
, "%s: unknown type '%c'\n", cmdname
, c
);
3626 /* check that all arguments were parsed */
3627 while (qemu_isspace(*p
))
3630 monitor_printf(mon
, "%s: extraneous characters at the end of line\n",
3642 void monitor_set_error(Monitor
*mon
, QError
*qerror
)
3644 /* report only the first error */
3646 mon
->error
= qerror
;
3648 MON_DEBUG("Additional error report at %s:%d\n",
3649 qerror
->file
, qerror
->linenr
);
3654 static int is_async_return(const QObject
*data
)
3656 if (data
&& qobject_type(data
) == QTYPE_QDICT
) {
3657 return qdict_haskey(qobject_to_qdict(data
), "__mon_async");
3663 static void handler_audit(Monitor
*mon
, const mon_cmd_t
*cmd
, int ret
)
3665 if (monitor_ctrl_mode(mon
)) {
3666 if (ret
&& !monitor_has_error(mon
)) {
3668 * If it returns failure, it must have passed on error.
3670 * Action: Report an internal error to the client if in QMP.
3672 qerror_report(QERR_UNDEFINED_ERROR
);
3673 MON_DEBUG("command '%s' returned failure but did not pass an error\n",
3677 #ifdef CONFIG_DEBUG_MONITOR
3678 if (!ret
&& monitor_has_error(mon
)) {
3680 * If it returns success, it must not have passed an error.
3682 * Action: Report the passed error to the client.
3684 MON_DEBUG("command '%s' returned success but passed an error\n",
3688 if (mon_print_count_get(mon
) > 0 && strcmp(cmd
->name
, "info") != 0) {
3690 * Handlers should not call Monitor print functions.
3692 * Action: Ignore them in QMP.
3694 * (XXX: we don't check any 'info' or 'query' command here
3695 * because the user print function _is_ called by do_info(), hence
3696 * we will trigger this check. This problem will go away when we
3697 * make 'query' commands real and kill do_info())
3699 MON_DEBUG("command '%s' called print functions %d time(s)\n",
3700 cmd
->name
, mon_print_count_get(mon
));
3704 assert(!monitor_has_error(mon
));
3705 QDECREF(mon
->error
);
3710 static void monitor_call_handler(Monitor
*mon
, const mon_cmd_t
*cmd
,
3711 const QDict
*params
)
3714 QObject
*data
= NULL
;
3716 mon_print_count_init(mon
);
3718 ret
= cmd
->mhandler
.cmd_new(mon
, params
, &data
);
3719 handler_audit(mon
, cmd
, ret
);
3721 if (is_async_return(data
)) {
3723 * Asynchronous commands have no initial return data but they can
3724 * generate errors. Data is returned via the async completion handler.
3726 if (monitor_ctrl_mode(mon
) && monitor_has_error(mon
)) {
3727 monitor_protocol_emitter(mon
, NULL
);
3729 } else if (monitor_ctrl_mode(mon
)) {
3730 /* Monitor Protocol */
3731 monitor_protocol_emitter(mon
, data
);
3735 cmd
->user_print(mon
, data
);
3738 qobject_decref(data
);
3741 static void handle_user_command(Monitor
*mon
, const char *cmdline
)
3744 const mon_cmd_t
*cmd
;
3746 qdict
= qdict_new();
3748 cmd
= monitor_parse_command(mon
, cmdline
, qdict
);
3752 if (monitor_handler_is_async(cmd
)) {
3753 user_async_cmd_handler(mon
, cmd
, qdict
);
3754 } else if (monitor_handler_ported(cmd
)) {
3755 monitor_call_handler(mon
, cmd
, qdict
);
3757 cmd
->mhandler
.cmd(mon
, qdict
);
3764 static void cmd_completion(const char *name
, const char *list
)
3766 const char *p
, *pstart
;
3775 p
= pstart
+ strlen(pstart
);
3777 if (len
> sizeof(cmd
) - 2)
3778 len
= sizeof(cmd
) - 2;
3779 memcpy(cmd
, pstart
, len
);
3781 if (name
[0] == '\0' || !strncmp(name
, cmd
, strlen(name
))) {
3782 readline_add_completion(cur_mon
->rs
, cmd
);
3790 static void file_completion(const char *input
)
3795 char file
[1024], file_prefix
[1024];
3799 p
= strrchr(input
, '/');
3802 pstrcpy(file_prefix
, sizeof(file_prefix
), input
);
3803 pstrcpy(path
, sizeof(path
), ".");
3805 input_path_len
= p
- input
+ 1;
3806 memcpy(path
, input
, input_path_len
);
3807 if (input_path_len
> sizeof(path
) - 1)
3808 input_path_len
= sizeof(path
) - 1;
3809 path
[input_path_len
] = '\0';
3810 pstrcpy(file_prefix
, sizeof(file_prefix
), p
+ 1);
3812 #ifdef DEBUG_COMPLETION
3813 monitor_printf(cur_mon
, "input='%s' path='%s' prefix='%s'\n",
3814 input
, path
, file_prefix
);
3816 ffs
= opendir(path
);
3824 if (strstart(d
->d_name
, file_prefix
, NULL
)) {
3825 memcpy(file
, input
, input_path_len
);
3826 if (input_path_len
< sizeof(file
))
3827 pstrcpy(file
+ input_path_len
, sizeof(file
) - input_path_len
,
3829 /* stat the file to find out if it's a directory.
3830 * In that case add a slash to speed up typing long paths
3833 if(S_ISDIR(sb
.st_mode
))
3834 pstrcat(file
, sizeof(file
), "/");
3835 readline_add_completion(cur_mon
->rs
, file
);
3841 static void block_completion_it(void *opaque
, BlockDriverState
*bs
)
3843 const char *name
= bdrv_get_device_name(bs
);
3844 const char *input
= opaque
;
3846 if (input
[0] == '\0' ||
3847 !strncmp(name
, (char *)input
, strlen(input
))) {
3848 readline_add_completion(cur_mon
->rs
, name
);
3852 /* NOTE: this parser is an approximate form of the real command parser */
3853 static void parse_cmdline(const char *cmdline
,
3854 int *pnb_args
, char **args
)
3863 while (qemu_isspace(*p
))
3867 if (nb_args
>= MAX_ARGS
)
3869 ret
= get_str(buf
, sizeof(buf
), &p
);
3870 args
[nb_args
] = qemu_strdup(buf
);
3875 *pnb_args
= nb_args
;
3878 static const char *next_arg_type(const char *typestr
)
3880 const char *p
= strchr(typestr
, ':');
3881 return (p
!= NULL
? ++p
: typestr
);
3884 static void monitor_find_completion(const char *cmdline
)
3886 const char *cmdname
;
3887 char *args
[MAX_ARGS
];
3888 int nb_args
, i
, len
;
3889 const char *ptype
, *str
;
3890 const mon_cmd_t
*cmd
;
3893 parse_cmdline(cmdline
, &nb_args
, args
);
3894 #ifdef DEBUG_COMPLETION
3895 for(i
= 0; i
< nb_args
; i
++) {
3896 monitor_printf(cur_mon
, "arg%d = '%s'\n", i
, (char *)args
[i
]);
3900 /* if the line ends with a space, it means we want to complete the
3902 len
= strlen(cmdline
);
3903 if (len
> 0 && qemu_isspace(cmdline
[len
- 1])) {
3904 if (nb_args
>= MAX_ARGS
) {
3907 args
[nb_args
++] = qemu_strdup("");
3910 /* command completion */
3915 readline_set_completion_index(cur_mon
->rs
, strlen(cmdname
));
3916 for(cmd
= mon_cmds
; cmd
->name
!= NULL
; cmd
++) {
3917 cmd_completion(cmdname
, cmd
->name
);
3920 /* find the command */
3921 for (cmd
= mon_cmds
; cmd
->name
!= NULL
; cmd
++) {
3922 if (compare_cmd(args
[0], cmd
->name
)) {
3930 ptype
= next_arg_type(cmd
->args_type
);
3931 for(i
= 0; i
< nb_args
- 2; i
++) {
3932 if (*ptype
!= '\0') {
3933 ptype
= next_arg_type(ptype
);
3934 while (*ptype
== '?')
3935 ptype
= next_arg_type(ptype
);
3938 str
= args
[nb_args
- 1];
3939 if (*ptype
== '-' && ptype
[1] != '\0') {
3940 ptype
= next_arg_type(ptype
);
3944 /* file completion */
3945 readline_set_completion_index(cur_mon
->rs
, strlen(str
));
3946 file_completion(str
);
3949 /* block device name completion */
3950 readline_set_completion_index(cur_mon
->rs
, strlen(str
));
3951 bdrv_iterate(block_completion_it
, (void *)str
);
3954 /* XXX: more generic ? */
3955 if (!strcmp(cmd
->name
, "info")) {
3956 readline_set_completion_index(cur_mon
->rs
, strlen(str
));
3957 for(cmd
= info_cmds
; cmd
->name
!= NULL
; cmd
++) {
3958 cmd_completion(str
, cmd
->name
);
3960 } else if (!strcmp(cmd
->name
, "sendkey")) {
3961 char *sep
= strrchr(str
, '-');
3964 readline_set_completion_index(cur_mon
->rs
, strlen(str
));
3965 for(key
= key_defs
; key
->name
!= NULL
; key
++) {
3966 cmd_completion(str
, key
->name
);
3968 } else if (!strcmp(cmd
->name
, "help|?")) {
3969 readline_set_completion_index(cur_mon
->rs
, strlen(str
));
3970 for (cmd
= mon_cmds
; cmd
->name
!= NULL
; cmd
++) {
3971 cmd_completion(str
, cmd
->name
);
3981 for (i
= 0; i
< nb_args
; i
++) {
3986 static int monitor_can_read(void *opaque
)
3988 Monitor
*mon
= opaque
;
3990 return (mon
->suspend_cnt
== 0) ? 1 : 0;
3993 static int invalid_qmp_mode(const Monitor
*mon
, const char *cmd_name
)
3995 int is_cap
= compare_cmd(cmd_name
, "qmp_capabilities");
3996 return (qmp_cmd_mode(mon
) ? is_cap
: !is_cap
);
4000 * Argument validation rules:
4002 * 1. The argument must exist in cmd_args qdict
4003 * 2. The argument type must be the expected one
4005 * Special case: If the argument doesn't exist in cmd_args and
4006 * the QMP_ACCEPT_UNKNOWNS flag is set, then the
4007 * checking is skipped for it.
4009 static int check_client_args_type(const QDict
*client_args
,
4010 const QDict
*cmd_args
, int flags
)
4012 const QDictEntry
*ent
;
4014 for (ent
= qdict_first(client_args
); ent
;ent
= qdict_next(client_args
,ent
)){
4017 const QObject
*client_arg
= qdict_entry_value(ent
);
4018 const char *client_arg_name
= qdict_entry_key(ent
);
4020 obj
= qdict_get(cmd_args
, client_arg_name
);
4022 if (flags
& QMP_ACCEPT_UNKNOWNS
) {
4023 /* handler accepts unknowns */
4026 /* client arg doesn't exist */
4027 qerror_report(QERR_INVALID_PARAMETER
, client_arg_name
);
4031 arg_type
= qobject_to_qstring(obj
);
4032 assert(arg_type
!= NULL
);
4034 /* check if argument's type is correct */
4035 switch (qstring_get_str(arg_type
)[0]) {
4039 if (qobject_type(client_arg
) != QTYPE_QSTRING
) {
4040 qerror_report(QERR_INVALID_PARAMETER_TYPE
, client_arg_name
,
4048 if (qobject_type(client_arg
) != QTYPE_QINT
) {
4049 qerror_report(QERR_INVALID_PARAMETER_TYPE
, client_arg_name
,
4056 if (qobject_type(client_arg
) != QTYPE_QINT
&&
4057 qobject_type(client_arg
) != QTYPE_QFLOAT
) {
4058 qerror_report(QERR_INVALID_PARAMETER_TYPE
, client_arg_name
,
4065 if (qobject_type(client_arg
) != QTYPE_QBOOL
) {
4066 qerror_report(QERR_INVALID_PARAMETER_TYPE
, client_arg_name
,
4072 assert(flags
& QMP_ACCEPT_UNKNOWNS
);
4077 * These types are not supported by QMP and thus are not
4078 * handled here. Fall through.
4089 * - Check if the client has passed all mandatory args
4090 * - Set special flags for argument validation
4092 static int check_mandatory_args(const QDict
*cmd_args
,
4093 const QDict
*client_args
, int *flags
)
4095 const QDictEntry
*ent
;
4097 for (ent
= qdict_first(cmd_args
); ent
; ent
= qdict_next(cmd_args
, ent
)) {
4098 const char *cmd_arg_name
= qdict_entry_key(ent
);
4099 QString
*type
= qobject_to_qstring(qdict_entry_value(ent
));
4100 assert(type
!= NULL
);
4102 if (qstring_get_str(type
)[0] == 'O') {
4103 assert((*flags
& QMP_ACCEPT_UNKNOWNS
) == 0);
4104 *flags
|= QMP_ACCEPT_UNKNOWNS
;
4105 } else if (qstring_get_str(type
)[0] != '-' &&
4106 qstring_get_str(type
)[1] != '?' &&
4107 !qdict_haskey(client_args
, cmd_arg_name
)) {
4108 qerror_report(QERR_MISSING_PARAMETER
, cmd_arg_name
);
4116 static QDict
*qdict_from_args_type(const char *args_type
)
4120 QString
*key
, *type
, *cur_qs
;
4122 assert(args_type
!= NULL
);
4124 qdict
= qdict_new();
4126 if (args_type
== NULL
|| args_type
[0] == '\0') {
4127 /* no args, empty qdict */
4131 key
= qstring_new();
4132 type
= qstring_new();
4137 switch (args_type
[i
]) {
4140 qdict_put(qdict
, qstring_get_str(key
), type
);
4142 if (args_type
[i
] == '\0') {
4145 type
= qstring_new(); /* qdict has ref */
4146 cur_qs
= key
= qstring_new();
4152 qstring_append_chr(cur_qs
, args_type
[i
]);
4162 * Client argument checking rules:
4164 * 1. Client must provide all mandatory arguments
4165 * 2. Each argument provided by the client must be expected
4166 * 3. Each argument provided by the client must have the type expected
4169 static int qmp_check_client_args(const mon_cmd_t
*cmd
, QDict
*client_args
)
4174 cmd_args
= qdict_from_args_type(cmd
->args_type
);
4177 err
= check_mandatory_args(cmd_args
, client_args
, &flags
);
4182 err
= check_client_args_type(client_args
, cmd_args
, flags
);
4190 * Input object checking rules
4192 * 1. Input object must be a dict
4193 * 2. The "execute" key must exist
4194 * 3. The "execute" key must be a string
4195 * 4. If the "arguments" key exists, it must be a dict
4196 * 5. If the "id" key exists, it can be anything (ie. json-value)
4197 * 6. Any argument not listed above is considered invalid
4199 static QDict
*qmp_check_input_obj(QObject
*input_obj
)
4201 const QDictEntry
*ent
;
4202 int has_exec_key
= 0;
4205 if (qobject_type(input_obj
) != QTYPE_QDICT
) {
4206 qerror_report(QERR_QMP_BAD_INPUT_OBJECT
, "object");
4210 input_dict
= qobject_to_qdict(input_obj
);
4212 for (ent
= qdict_first(input_dict
); ent
; ent
= qdict_next(input_dict
, ent
)){
4213 const char *arg_name
= qdict_entry_key(ent
);
4214 const QObject
*arg_obj
= qdict_entry_value(ent
);
4216 if (!strcmp(arg_name
, "execute")) {
4217 if (qobject_type(arg_obj
) != QTYPE_QSTRING
) {
4218 qerror_report(QERR_QMP_BAD_INPUT_OBJECT_MEMBER
, "execute",
4223 } else if (!strcmp(arg_name
, "arguments")) {
4224 if (qobject_type(arg_obj
) != QTYPE_QDICT
) {
4225 qerror_report(QERR_QMP_BAD_INPUT_OBJECT_MEMBER
, "arguments",
4229 } else if (!strcmp(arg_name
, "id")) {
4230 /* FIXME: check duplicated IDs for async commands */
4232 qerror_report(QERR_QMP_EXTRA_MEMBER
, arg_name
);
4237 if (!has_exec_key
) {
4238 qerror_report(QERR_QMP_BAD_INPUT_OBJECT
, "execute");
4245 static void handle_qmp_command(JSONMessageParser
*parser
, QList
*tokens
)
4249 QDict
*input
, *args
;
4250 const mon_cmd_t
*cmd
;
4251 Monitor
*mon
= cur_mon
;
4252 const char *cmd_name
, *info_item
;
4254 args
= input
= NULL
;
4256 obj
= json_parser_parse(tokens
, NULL
);
4258 // FIXME: should be triggered in json_parser_parse()
4259 qerror_report(QERR_JSON_PARSING
);
4263 input
= qmp_check_input_obj(obj
);
4265 qobject_decref(obj
);
4269 mon
->mc
->id
= qdict_get(input
, "id");
4270 qobject_incref(mon
->mc
->id
);
4272 cmd_name
= qdict_get_str(input
, "execute");
4273 if (invalid_qmp_mode(mon
, cmd_name
)) {
4274 qerror_report(QERR_COMMAND_NOT_FOUND
, cmd_name
);
4279 * XXX: We need this special case until we get info handlers
4280 * converted into 'query-' commands
4282 if (compare_cmd(cmd_name
, "info")) {
4283 qerror_report(QERR_COMMAND_NOT_FOUND
, cmd_name
);
4285 } else if (strstart(cmd_name
, "query-", &info_item
)) {
4286 cmd
= monitor_find_command("info");
4287 qdict_put_obj(input
, "arguments",
4288 qobject_from_jsonf("{ 'item': %s }", info_item
));
4290 cmd
= monitor_find_command(cmd_name
);
4291 if (!cmd
|| !monitor_handler_ported(cmd
)
4292 || monitor_cmd_user_only(cmd
)) {
4293 qerror_report(QERR_COMMAND_NOT_FOUND
, cmd_name
);
4298 obj
= qdict_get(input
, "arguments");
4302 args
= qobject_to_qdict(obj
);
4306 err
= qmp_check_client_args(cmd
, args
);
4311 if (monitor_handler_is_async(cmd
)) {
4312 err
= qmp_async_cmd_handler(mon
, cmd
, args
);
4314 /* emit the error response */
4318 monitor_call_handler(mon
, cmd
, args
);
4324 monitor_protocol_emitter(mon
, NULL
);
4331 * monitor_control_read(): Read and handle QMP input
4333 static void monitor_control_read(void *opaque
, const uint8_t *buf
, int size
)
4335 Monitor
*old_mon
= cur_mon
;
4339 json_message_parser_feed(&cur_mon
->mc
->parser
, (const char *) buf
, size
);
4344 static void monitor_read(void *opaque
, const uint8_t *buf
, int size
)
4346 Monitor
*old_mon
= cur_mon
;
4352 for (i
= 0; i
< size
; i
++)
4353 readline_handle_byte(cur_mon
->rs
, buf
[i
]);
4355 if (size
== 0 || buf
[size
- 1] != 0)
4356 monitor_printf(cur_mon
, "corrupted command\n");
4358 handle_user_command(cur_mon
, (char *)buf
);
4364 static void monitor_command_cb(Monitor
*mon
, const char *cmdline
, void *opaque
)
4366 monitor_suspend(mon
);
4367 handle_user_command(mon
, cmdline
);
4368 monitor_resume(mon
);
4371 int monitor_suspend(Monitor
*mon
)
4379 void monitor_resume(Monitor
*mon
)
4383 if (--mon
->suspend_cnt
== 0)
4384 readline_show_prompt(mon
->rs
);
4387 static QObject
*get_qmp_greeting(void)
4391 do_info_version(NULL
, &ver
);
4392 return qobject_from_jsonf("{'QMP':{'version': %p,'capabilities': []}}",ver
);
4396 * monitor_control_event(): Print QMP gretting
4398 static void monitor_control_event(void *opaque
, int event
)
4401 Monitor
*mon
= opaque
;
4404 case CHR_EVENT_OPENED
:
4405 mon
->mc
->command_mode
= 0;
4406 json_message_parser_init(&mon
->mc
->parser
, handle_qmp_command
);
4407 data
= get_qmp_greeting();
4408 monitor_json_emitter(mon
, data
);
4409 qobject_decref(data
);
4411 case CHR_EVENT_CLOSED
:
4412 json_message_parser_destroy(&mon
->mc
->parser
);
4417 static void monitor_event(void *opaque
, int event
)
4419 Monitor
*mon
= opaque
;
4422 case CHR_EVENT_MUX_IN
:
4424 if (mon
->reset_seen
) {
4425 readline_restart(mon
->rs
);
4426 monitor_resume(mon
);
4429 mon
->suspend_cnt
= 0;
4433 case CHR_EVENT_MUX_OUT
:
4434 if (mon
->reset_seen
) {
4435 if (mon
->suspend_cnt
== 0) {
4436 monitor_printf(mon
, "\n");
4439 monitor_suspend(mon
);
4446 case CHR_EVENT_OPENED
:
4447 monitor_printf(mon
, "QEMU %s monitor - type 'help' for more "
4448 "information\n", QEMU_VERSION
);
4449 if (!mon
->mux_out
) {
4450 readline_show_prompt(mon
->rs
);
4452 mon
->reset_seen
= 1;
4466 void monitor_init(CharDriverState
*chr
, int flags
)
4468 static int is_first_init
= 1;
4471 if (is_first_init
) {
4472 key_timer
= qemu_new_timer(vm_clock
, release_keys
, NULL
);
4476 mon
= qemu_mallocz(sizeof(*mon
));
4480 if (flags
& MONITOR_USE_READLINE
) {
4481 mon
->rs
= readline_init(mon
, monitor_find_completion
);
4482 monitor_read_command(mon
, 0);
4485 if (monitor_ctrl_mode(mon
)) {
4486 mon
->mc
= qemu_mallocz(sizeof(MonitorControl
));
4487 /* Control mode requires special handlers */
4488 qemu_chr_add_handlers(chr
, monitor_can_read
, monitor_control_read
,
4489 monitor_control_event
, mon
);
4491 qemu_chr_add_handlers(chr
, monitor_can_read
, monitor_read
,
4492 monitor_event
, mon
);
4495 QLIST_INSERT_HEAD(&mon_list
, mon
, entry
);
4496 if (!default_mon
|| (flags
& MONITOR_IS_DEFAULT
))
4500 static void bdrv_password_cb(Monitor
*mon
, const char *password
, void *opaque
)
4502 BlockDriverState
*bs
= opaque
;
4505 if (bdrv_set_key(bs
, password
) != 0) {
4506 monitor_printf(mon
, "invalid password\n");
4509 if (mon
->password_completion_cb
)
4510 mon
->password_completion_cb(mon
->password_opaque
, ret
);
4512 monitor_read_command(mon
, 1);
4515 int monitor_read_bdrv_key_start(Monitor
*mon
, BlockDriverState
*bs
,
4516 BlockDriverCompletionFunc
*completion_cb
,
4521 if (!bdrv_key_required(bs
)) {
4523 completion_cb(opaque
, 0);
4527 if (monitor_ctrl_mode(mon
)) {
4528 qerror_report(QERR_DEVICE_ENCRYPTED
, bdrv_get_device_name(bs
));
4532 monitor_printf(mon
, "%s (%s) is encrypted.\n", bdrv_get_device_name(bs
),
4533 bdrv_get_encrypted_filename(bs
));
4535 mon
->password_completion_cb
= completion_cb
;
4536 mon
->password_opaque
= opaque
;
4538 err
= monitor_read_password(mon
, bdrv_password_cb
, bs
);
4540 if (err
&& completion_cb
)
4541 completion_cb(opaque
, err
);