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"
62 //#define DEBUG_COMPLETION
68 * 'B' block device name
69 * 's' string (accept optional quote)
70 * 'O' option string of the form NAME=VALUE,...
71 * parsed according to QemuOptsList given by its name
72 * Example: 'device:O' uses qemu_device_opts.
73 * Restriction: only lists with empty desc are supported
74 * TODO lift the restriction
76 * 'l' target long (32 or 64 bit)
77 * 'M' just like 'l', except in user mode the value is
78 * multiplied by 2^20 (think Mebibyte)
80 * user mode accepts an optional G, g, M, m, K, k suffix,
81 * which multiplies the value by 2^30 for suffixes G and
82 * g, 2^20 for M and m, 2^10 for K and k
84 * user mode accepts an optional ms, us, ns suffix,
85 * which divides the value by 1e3, 1e6, 1e9, respectively
86 * '/' optional gdb-like print format (like "/10x")
88 * '?' optional type (for all types, except '/')
89 * '.' other form of optional type (for 'i' and 'l')
91 * user mode accepts "on" or "off"
92 * '-' optional parameter (eg. '-f')
96 typedef struct MonitorCompletionData MonitorCompletionData
;
97 struct MonitorCompletionData
{
99 void (*user_print
)(Monitor
*mon
, const QObject
*data
);
102 typedef struct mon_cmd_t
{
104 const char *args_type
;
107 void (*user_print
)(Monitor
*mon
, const QObject
*data
);
109 void (*info
)(Monitor
*mon
);
110 void (*info_new
)(Monitor
*mon
, QObject
**ret_data
);
111 int (*info_async
)(Monitor
*mon
, MonitorCompletion
*cb
, void *opaque
);
112 void (*cmd
)(Monitor
*mon
, const QDict
*qdict
);
113 int (*cmd_new
)(Monitor
*mon
, const QDict
*params
, QObject
**ret_data
);
114 int (*cmd_async
)(Monitor
*mon
, const QDict
*params
,
115 MonitorCompletion
*cb
, void *opaque
);
120 /* file descriptors passed via SCM_RIGHTS */
121 typedef struct mon_fd_t mon_fd_t
;
125 QLIST_ENTRY(mon_fd_t
) next
;
128 typedef struct MonitorControl
{
130 JSONMessageParser parser
;
135 CharDriverState
*chr
;
140 uint8_t outbuf
[1024];
145 BlockDriverCompletionFunc
*password_completion_cb
;
146 void *password_opaque
;
147 #ifdef CONFIG_DEBUG_MONITOR
151 QLIST_HEAD(,mon_fd_t
) fds
;
152 QLIST_ENTRY(Monitor
) entry
;
155 #ifdef CONFIG_DEBUG_MONITOR
156 #define MON_DEBUG(fmt, ...) do { \
157 fprintf(stderr, "Monitor: "); \
158 fprintf(stderr, fmt, ## __VA_ARGS__); } while (0)
160 static inline void mon_print_count_inc(Monitor
*mon
)
162 mon
->print_calls_nr
++;
165 static inline void mon_print_count_init(Monitor
*mon
)
167 mon
->print_calls_nr
= 0;
170 static inline int mon_print_count_get(const Monitor
*mon
)
172 return mon
->print_calls_nr
;
175 #else /* !CONFIG_DEBUG_MONITOR */
176 #define MON_DEBUG(fmt, ...) do { } while (0)
177 static inline void mon_print_count_inc(Monitor
*mon
) { }
178 static inline void mon_print_count_init(Monitor
*mon
) { }
179 static inline int mon_print_count_get(const Monitor
*mon
) { return 0; }
180 #endif /* CONFIG_DEBUG_MONITOR */
182 /* QMP checker flags */
183 #define QMP_ACCEPT_UNKNOWNS 1
185 static QLIST_HEAD(mon_list
, Monitor
) mon_list
;
187 static const mon_cmd_t mon_cmds
[];
188 static const mon_cmd_t info_cmds
[];
191 Monitor
*default_mon
;
193 static void monitor_command_cb(Monitor
*mon
, const char *cmdline
,
196 static inline int qmp_cmd_mode(const Monitor
*mon
)
198 return (mon
->mc
? mon
->mc
->command_mode
: 0);
201 /* Return true if in control mode, false otherwise */
202 static inline int monitor_ctrl_mode(const Monitor
*mon
)
204 return (mon
->flags
& MONITOR_USE_CONTROL
);
207 /* Return non-zero iff we have a current monitor, and it is in QMP mode. */
208 int monitor_cur_is_qmp(void)
210 return cur_mon
&& monitor_ctrl_mode(cur_mon
);
213 static void monitor_read_command(Monitor
*mon
, int show_prompt
)
218 readline_start(mon
->rs
, "(qemu) ", 0, monitor_command_cb
, NULL
);
220 readline_show_prompt(mon
->rs
);
223 static int monitor_read_password(Monitor
*mon
, ReadLineFunc
*readline_func
,
226 if (monitor_ctrl_mode(mon
)) {
227 qerror_report(QERR_MISSING_PARAMETER
, "password");
229 } else if (mon
->rs
) {
230 readline_start(mon
->rs
, "Password: ", 1, readline_func
, opaque
);
231 /* prompt is printed on return from the command handler */
234 monitor_printf(mon
, "terminal does not support password prompting\n");
239 void monitor_flush(Monitor
*mon
)
241 if (mon
&& mon
->outbuf_index
!= 0 && !mon
->mux_out
) {
242 qemu_chr_write(mon
->chr
, mon
->outbuf
, mon
->outbuf_index
);
243 mon
->outbuf_index
= 0;
247 /* flush at every end of line or if the buffer is full */
248 static void monitor_puts(Monitor
*mon
, const char *str
)
257 mon
->outbuf
[mon
->outbuf_index
++] = '\r';
258 mon
->outbuf
[mon
->outbuf_index
++] = c
;
259 if (mon
->outbuf_index
>= (sizeof(mon
->outbuf
) - 1)
265 void monitor_vprintf(Monitor
*mon
, const char *fmt
, va_list ap
)
272 mon_print_count_inc(mon
);
274 if (monitor_ctrl_mode(mon
)) {
278 vsnprintf(buf
, sizeof(buf
), fmt
, ap
);
279 monitor_puts(mon
, buf
);
282 void monitor_printf(Monitor
*mon
, const char *fmt
, ...)
286 monitor_vprintf(mon
, fmt
, ap
);
290 void monitor_print_filename(Monitor
*mon
, const char *filename
)
294 for (i
= 0; filename
[i
]; i
++) {
295 switch (filename
[i
]) {
299 monitor_printf(mon
, "\\%c", filename
[i
]);
302 monitor_printf(mon
, "\\t");
305 monitor_printf(mon
, "\\r");
308 monitor_printf(mon
, "\\n");
311 monitor_printf(mon
, "%c", filename
[i
]);
317 static int monitor_fprintf(FILE *stream
, const char *fmt
, ...)
321 monitor_vprintf((Monitor
*)stream
, fmt
, ap
);
326 static void monitor_user_noop(Monitor
*mon
, const QObject
*data
) { }
328 static inline int monitor_handler_ported(const mon_cmd_t
*cmd
)
330 return cmd
->user_print
!= NULL
;
333 static inline bool monitor_handler_is_async(const mon_cmd_t
*cmd
)
335 return cmd
->flags
& MONITOR_CMD_ASYNC
;
338 static inline bool monitor_cmd_user_only(const mon_cmd_t
*cmd
)
340 return (cmd
->flags
& MONITOR_CMD_USER_ONLY
);
343 static inline int monitor_has_error(const Monitor
*mon
)
345 return mon
->error
!= NULL
;
348 static void monitor_json_emitter(Monitor
*mon
, const QObject
*data
)
352 json
= qobject_to_json(data
);
353 assert(json
!= NULL
);
355 qstring_append_chr(json
, '\n');
356 monitor_puts(mon
, qstring_get_str(json
));
361 static void monitor_protocol_emitter(Monitor
*mon
, QObject
*data
)
367 if (!monitor_has_error(mon
)) {
368 /* success response */
370 qobject_incref(data
);
371 qdict_put_obj(qmp
, "return", data
);
373 /* return an empty QDict by default */
374 qdict_put(qmp
, "return", qdict_new());
378 qdict_put(mon
->error
->error
, "desc", qerror_human(mon
->error
));
379 qdict_put(qmp
, "error", mon
->error
->error
);
380 QINCREF(mon
->error
->error
);
386 qdict_put_obj(qmp
, "id", mon
->mc
->id
);
390 monitor_json_emitter(mon
, QOBJECT(qmp
));
394 static void timestamp_put(QDict
*qdict
)
400 err
= qemu_gettimeofday(&tv
);
404 obj
= qobject_from_jsonf("{ 'seconds': %" PRId64
", "
405 "'microseconds': %" PRId64
" }",
406 (int64_t) tv
.tv_sec
, (int64_t) tv
.tv_usec
);
407 qdict_put_obj(qdict
, "timestamp", obj
);
411 * monitor_protocol_event(): Generate a Monitor event
413 * Event-specific data can be emitted through the (optional) 'data' parameter.
415 void monitor_protocol_event(MonitorEvent event
, QObject
*data
)
418 const char *event_name
;
421 assert(event
< QEVENT_MAX
);
424 case QEVENT_SHUTDOWN
:
425 event_name
= "SHUTDOWN";
428 event_name
= "RESET";
430 case QEVENT_POWERDOWN
:
431 event_name
= "POWERDOWN";
437 event_name
= "RESUME";
439 case QEVENT_VNC_CONNECTED
:
440 event_name
= "VNC_CONNECTED";
442 case QEVENT_VNC_INITIALIZED
:
443 event_name
= "VNC_INITIALIZED";
445 case QEVENT_VNC_DISCONNECTED
:
446 event_name
= "VNC_DISCONNECTED";
448 case QEVENT_BLOCK_IO_ERROR
:
449 event_name
= "BLOCK_IO_ERROR";
451 case QEVENT_RTC_CHANGE
:
452 event_name
= "RTC_CHANGE";
454 case QEVENT_WATCHDOG
:
455 event_name
= "WATCHDOG";
464 qdict_put(qmp
, "event", qstring_from_str(event_name
));
466 qobject_incref(data
);
467 qdict_put_obj(qmp
, "data", data
);
470 QLIST_FOREACH(mon
, &mon_list
, entry
) {
471 if (monitor_ctrl_mode(mon
) && qmp_cmd_mode(mon
)) {
472 monitor_json_emitter(mon
, QOBJECT(qmp
));
478 static int do_qmp_capabilities(Monitor
*mon
, const QDict
*params
,
481 /* Will setup QMP capabilities in the future */
482 if (monitor_ctrl_mode(mon
)) {
483 mon
->mc
->command_mode
= 1;
489 static int compare_cmd(const char *name
, const char *list
)
491 const char *p
, *pstart
;
499 p
= pstart
+ strlen(pstart
);
500 if ((p
- pstart
) == len
&& !memcmp(pstart
, name
, len
))
509 static void help_cmd_dump(Monitor
*mon
, const mon_cmd_t
*cmds
,
510 const char *prefix
, const char *name
)
512 const mon_cmd_t
*cmd
;
514 for(cmd
= cmds
; cmd
->name
!= NULL
; cmd
++) {
515 if (!name
|| !strcmp(name
, cmd
->name
))
516 monitor_printf(mon
, "%s%s %s -- %s\n", prefix
, cmd
->name
,
517 cmd
->params
, cmd
->help
);
521 static void help_cmd(Monitor
*mon
, const char *name
)
523 if (name
&& !strcmp(name
, "info")) {
524 help_cmd_dump(mon
, info_cmds
, "info ", NULL
);
526 help_cmd_dump(mon
, mon_cmds
, "", name
);
527 if (name
&& !strcmp(name
, "log")) {
528 const CPULogItem
*item
;
529 monitor_printf(mon
, "Log items (comma separated):\n");
530 monitor_printf(mon
, "%-10s %s\n", "none", "remove all logs");
531 for(item
= cpu_log_items
; item
->mask
!= 0; item
++) {
532 monitor_printf(mon
, "%-10s %s\n", item
->name
, item
->help
);
538 static void do_help_cmd(Monitor
*mon
, const QDict
*qdict
)
540 help_cmd(mon
, qdict_get_try_str(qdict
, "name"));
543 static void user_monitor_complete(void *opaque
, QObject
*ret_data
)
545 MonitorCompletionData
*data
= (MonitorCompletionData
*)opaque
;
548 data
->user_print(data
->mon
, ret_data
);
550 monitor_resume(data
->mon
);
554 static void qmp_monitor_complete(void *opaque
, QObject
*ret_data
)
556 monitor_protocol_emitter(opaque
, ret_data
);
559 static int qmp_async_cmd_handler(Monitor
*mon
, const mon_cmd_t
*cmd
,
562 return cmd
->mhandler
.cmd_async(mon
, params
, qmp_monitor_complete
, mon
);
565 static void qmp_async_info_handler(Monitor
*mon
, const mon_cmd_t
*cmd
)
567 cmd
->mhandler
.info_async(mon
, qmp_monitor_complete
, mon
);
570 static void user_async_cmd_handler(Monitor
*mon
, const mon_cmd_t
*cmd
,
575 MonitorCompletionData
*cb_data
= qemu_malloc(sizeof(*cb_data
));
577 cb_data
->user_print
= cmd
->user_print
;
578 monitor_suspend(mon
);
579 ret
= cmd
->mhandler
.cmd_async(mon
, params
,
580 user_monitor_complete
, cb_data
);
587 static void user_async_info_handler(Monitor
*mon
, const mon_cmd_t
*cmd
)
591 MonitorCompletionData
*cb_data
= qemu_malloc(sizeof(*cb_data
));
593 cb_data
->user_print
= cmd
->user_print
;
594 monitor_suspend(mon
);
595 ret
= cmd
->mhandler
.info_async(mon
, user_monitor_complete
, cb_data
);
602 static int do_info(Monitor
*mon
, const QDict
*qdict
, QObject
**ret_data
)
604 const mon_cmd_t
*cmd
;
605 const char *item
= qdict_get_try_str(qdict
, "item");
608 assert(monitor_ctrl_mode(mon
) == 0);
612 for (cmd
= info_cmds
; cmd
->name
!= NULL
; cmd
++) {
613 if (compare_cmd(item
, cmd
->name
))
617 if (cmd
->name
== NULL
) {
618 if (monitor_ctrl_mode(mon
)) {
619 qerror_report(QERR_COMMAND_NOT_FOUND
, item
);
625 if (monitor_ctrl_mode(mon
) && monitor_cmd_user_only(cmd
)) {
626 qerror_report(QERR_COMMAND_NOT_FOUND
, item
);
630 if (monitor_handler_is_async(cmd
)) {
631 if (monitor_ctrl_mode(mon
)) {
632 qmp_async_info_handler(mon
, cmd
);
634 user_async_info_handler(mon
, cmd
);
637 * Indicate that this command is asynchronous and will not return any
638 * data (not even empty). Instead, the data will be returned via a
639 * completion callback.
641 *ret_data
= qobject_from_jsonf("{ '__mon_async': 'return' }");
642 } else if (monitor_handler_ported(cmd
)) {
643 cmd
->mhandler
.info_new(mon
, ret_data
);
645 if (!monitor_ctrl_mode(mon
)) {
647 * User Protocol function is called here, Monitor Protocol is
648 * handled by monitor_call_handler()
651 cmd
->user_print(mon
, *ret_data
);
654 if (monitor_ctrl_mode(mon
)) {
655 /* handler not converted yet */
656 qerror_report(QERR_COMMAND_NOT_FOUND
, item
);
659 cmd
->mhandler
.info(mon
);
666 help_cmd(mon
, "info");
670 static void do_info_version_print(Monitor
*mon
, const QObject
*data
)
675 qdict
= qobject_to_qdict(data
);
676 qemu
= qdict_get_qdict(qdict
, "qemu");
678 monitor_printf(mon
, "%" PRId64
".%" PRId64
".%" PRId64
"%s\n",
679 qdict_get_int(qemu
, "major"),
680 qdict_get_int(qemu
, "minor"),
681 qdict_get_int(qemu
, "micro"),
682 qdict_get_str(qdict
, "package"));
685 static void do_info_version(Monitor
*mon
, QObject
**ret_data
)
687 const char *version
= QEMU_VERSION
;
688 int major
= 0, minor
= 0, micro
= 0;
691 major
= strtol(version
, &tmp
, 10);
693 minor
= strtol(tmp
, &tmp
, 10);
695 micro
= strtol(tmp
, &tmp
, 10);
697 *ret_data
= qobject_from_jsonf("{ 'qemu': { 'major': %d, 'minor': %d, \
698 'micro': %d }, 'package': %s }", major
, minor
, micro
, QEMU_PKGVERSION
);
701 static void do_info_name_print(Monitor
*mon
, const QObject
*data
)
705 qdict
= qobject_to_qdict(data
);
706 if (qdict_size(qdict
) == 0) {
710 monitor_printf(mon
, "%s\n", qdict_get_str(qdict
, "name"));
713 static void do_info_name(Monitor
*mon
, QObject
**ret_data
)
715 *ret_data
= qemu_name
? qobject_from_jsonf("{'name': %s }", qemu_name
) :
716 qobject_from_jsonf("{}");
719 static QObject
*get_cmd_dict(const char *name
)
723 /* Remove '|' from some commands */
724 p
= strchr(name
, '|');
731 return qobject_from_jsonf("{ 'name': %s }", p
);
734 static void do_info_commands(Monitor
*mon
, QObject
**ret_data
)
737 const mon_cmd_t
*cmd
;
739 cmd_list
= qlist_new();
741 for (cmd
= mon_cmds
; cmd
->name
!= NULL
; cmd
++) {
742 if (monitor_handler_ported(cmd
) && !monitor_cmd_user_only(cmd
) &&
743 !compare_cmd(cmd
->name
, "info")) {
744 qlist_append_obj(cmd_list
, get_cmd_dict(cmd
->name
));
748 for (cmd
= info_cmds
; cmd
->name
!= NULL
; cmd
++) {
749 if (monitor_handler_ported(cmd
) && !monitor_cmd_user_only(cmd
)) {
751 snprintf(buf
, sizeof(buf
), "query-%s", cmd
->name
);
752 qlist_append_obj(cmd_list
, get_cmd_dict(buf
));
756 *ret_data
= QOBJECT(cmd_list
);
759 static void do_info_uuid_print(Monitor
*mon
, const QObject
*data
)
761 monitor_printf(mon
, "%s\n", qdict_get_str(qobject_to_qdict(data
), "UUID"));
764 static void do_info_uuid(Monitor
*mon
, QObject
**ret_data
)
768 snprintf(uuid
, sizeof(uuid
), UUID_FMT
, qemu_uuid
[0], qemu_uuid
[1],
769 qemu_uuid
[2], qemu_uuid
[3], qemu_uuid
[4], qemu_uuid
[5],
770 qemu_uuid
[6], qemu_uuid
[7], qemu_uuid
[8], qemu_uuid
[9],
771 qemu_uuid
[10], qemu_uuid
[11], qemu_uuid
[12], qemu_uuid
[13],
772 qemu_uuid
[14], qemu_uuid
[15]);
773 *ret_data
= qobject_from_jsonf("{ 'UUID': %s }", uuid
);
776 /* get the current CPU defined by the user */
777 static int mon_set_cpu(int cpu_index
)
781 for(env
= first_cpu
; env
!= NULL
; env
= env
->next_cpu
) {
782 if (env
->cpu_index
== cpu_index
) {
783 cur_mon
->mon_cpu
= env
;
790 static CPUState
*mon_get_cpu(void)
792 if (!cur_mon
->mon_cpu
) {
795 cpu_synchronize_state(cur_mon
->mon_cpu
);
796 return cur_mon
->mon_cpu
;
799 static void do_info_registers(Monitor
*mon
)
804 cpu_dump_state(env
, (FILE *)mon
, monitor_fprintf
,
807 cpu_dump_state(env
, (FILE *)mon
, monitor_fprintf
,
812 static void print_cpu_iter(QObject
*obj
, void *opaque
)
816 Monitor
*mon
= opaque
;
818 assert(qobject_type(obj
) == QTYPE_QDICT
);
819 cpu
= qobject_to_qdict(obj
);
821 if (qdict_get_bool(cpu
, "current")) {
825 monitor_printf(mon
, "%c CPU #%d: ", active
, (int)qdict_get_int(cpu
, "CPU"));
827 #if defined(TARGET_I386)
828 monitor_printf(mon
, "pc=0x" TARGET_FMT_lx
,
829 (target_ulong
) qdict_get_int(cpu
, "pc"));
830 #elif defined(TARGET_PPC)
831 monitor_printf(mon
, "nip=0x" TARGET_FMT_lx
,
832 (target_long
) qdict_get_int(cpu
, "nip"));
833 #elif defined(TARGET_SPARC)
834 monitor_printf(mon
, "pc=0x " TARGET_FMT_lx
,
835 (target_long
) qdict_get_int(cpu
, "pc"));
836 monitor_printf(mon
, "npc=0x" TARGET_FMT_lx
,
837 (target_long
) qdict_get_int(cpu
, "npc"));
838 #elif defined(TARGET_MIPS)
839 monitor_printf(mon
, "PC=0x" TARGET_FMT_lx
,
840 (target_long
) qdict_get_int(cpu
, "PC"));
843 if (qdict_get_bool(cpu
, "halted")) {
844 monitor_printf(mon
, " (halted)");
847 monitor_printf(mon
, " thread_id=%" PRId64
" ",
848 qdict_get_int(cpu
, "thread_id"));
850 monitor_printf(mon
, "\n");
853 static void monitor_print_cpus(Monitor
*mon
, const QObject
*data
)
857 assert(qobject_type(data
) == QTYPE_QLIST
);
858 cpu_list
= qobject_to_qlist(data
);
859 qlist_iter(cpu_list
, print_cpu_iter
, mon
);
862 static void do_info_cpus(Monitor
*mon
, QObject
**ret_data
)
867 cpu_list
= qlist_new();
869 /* just to set the default cpu if not already done */
872 for(env
= first_cpu
; env
!= NULL
; env
= env
->next_cpu
) {
876 cpu_synchronize_state(env
);
878 obj
= qobject_from_jsonf("{ 'CPU': %d, 'current': %i, 'halted': %i }",
879 env
->cpu_index
, env
== mon
->mon_cpu
,
882 cpu
= qobject_to_qdict(obj
);
884 #if defined(TARGET_I386)
885 qdict_put(cpu
, "pc", qint_from_int(env
->eip
+ env
->segs
[R_CS
].base
));
886 #elif defined(TARGET_PPC)
887 qdict_put(cpu
, "nip", qint_from_int(env
->nip
));
888 #elif defined(TARGET_SPARC)
889 qdict_put(cpu
, "pc", qint_from_int(env
->pc
));
890 qdict_put(cpu
, "npc", qint_from_int(env
->npc
));
891 #elif defined(TARGET_MIPS)
892 qdict_put(cpu
, "PC", qint_from_int(env
->active_tc
.PC
));
894 qdict_put(cpu
, "thread_id", qint_from_int(env
->thread_id
));
896 qlist_append(cpu_list
, cpu
);
899 *ret_data
= QOBJECT(cpu_list
);
902 static int do_cpu_set(Monitor
*mon
, const QDict
*qdict
, QObject
**ret_data
)
904 int index
= qdict_get_int(qdict
, "index");
905 if (mon_set_cpu(index
) < 0) {
906 qerror_report(QERR_INVALID_PARAMETER_VALUE
, "index",
913 static void do_cpu_set_nr(Monitor
*mon
, const QDict
*qdict
)
918 status
= qdict_get_str(qdict
, "state");
919 value
= qdict_get_int(qdict
, "cpu");
921 if (!strcmp(status
, "online"))
923 else if (!strcmp(status
, "offline"))
926 monitor_printf(mon
, "invalid status: %s\n", status
);
929 #if defined(TARGET_I386) || defined(TARGET_X86_64)
930 qemu_system_cpu_hot_add(value
, state
);
934 static void do_info_jit(Monitor
*mon
)
936 dump_exec_info((FILE *)mon
, monitor_fprintf
);
939 static void do_info_history(Monitor
*mon
)
948 str
= readline_get_history(mon
->rs
, i
);
951 monitor_printf(mon
, "%d: '%s'\n", i
, str
);
956 #if defined(TARGET_PPC)
957 /* XXX: not implemented in other targets */
958 static void do_info_cpu_stats(Monitor
*mon
)
963 cpu_dump_statistics(env
, (FILE *)mon
, &monitor_fprintf
, 0);
968 * do_quit(): Quit QEMU execution
970 static int do_quit(Monitor
*mon
, const QDict
*qdict
, QObject
**ret_data
)
972 monitor_suspend(mon
);
974 qemu_system_shutdown_request();
979 static int change_vnc_password(const char *password
)
981 if (vnc_display_password(NULL
, password
) < 0) {
982 qerror_report(QERR_SET_PASSWD_FAILED
);
989 static void change_vnc_password_cb(Monitor
*mon
, const char *password
,
992 change_vnc_password(password
);
993 monitor_read_command(mon
, 1);
996 static int do_change_vnc(Monitor
*mon
, const char *target
, const char *arg
)
998 if (strcmp(target
, "passwd") == 0 ||
999 strcmp(target
, "password") == 0) {
1002 strncpy(password
, arg
, sizeof(password
));
1003 password
[sizeof(password
) - 1] = '\0';
1004 return change_vnc_password(password
);
1006 return monitor_read_password(mon
, change_vnc_password_cb
, NULL
);
1009 if (vnc_display_open(NULL
, target
) < 0) {
1010 qerror_report(QERR_VNC_SERVER_FAILED
, target
);
1019 * do_change(): Change a removable medium, or VNC configuration
1021 static int do_change(Monitor
*mon
, const QDict
*qdict
, QObject
**ret_data
)
1023 const char *device
= qdict_get_str(qdict
, "device");
1024 const char *target
= qdict_get_str(qdict
, "target");
1025 const char *arg
= qdict_get_try_str(qdict
, "arg");
1028 if (strcmp(device
, "vnc") == 0) {
1029 ret
= do_change_vnc(mon
, target
, arg
);
1031 ret
= do_change_block(mon
, device
, target
, arg
);
1037 static int do_screen_dump(Monitor
*mon
, const QDict
*qdict
, QObject
**ret_data
)
1039 vga_hw_screen_dump(qdict_get_str(qdict
, "filename"));
1043 static void do_logfile(Monitor
*mon
, const QDict
*qdict
)
1045 cpu_set_log_filename(qdict_get_str(qdict
, "filename"));
1048 static void do_log(Monitor
*mon
, const QDict
*qdict
)
1051 const char *items
= qdict_get_str(qdict
, "items");
1053 if (!strcmp(items
, "none")) {
1056 mask
= cpu_str_to_log_mask(items
);
1058 help_cmd(mon
, "log");
1065 static void do_singlestep(Monitor
*mon
, const QDict
*qdict
)
1067 const char *option
= qdict_get_try_str(qdict
, "option");
1068 if (!option
|| !strcmp(option
, "on")) {
1070 } else if (!strcmp(option
, "off")) {
1073 monitor_printf(mon
, "unexpected option %s\n", option
);
1078 * do_stop(): Stop VM execution
1080 static int do_stop(Monitor
*mon
, const QDict
*qdict
, QObject
**ret_data
)
1082 vm_stop(EXCP_INTERRUPT
);
1086 static void encrypted_bdrv_it(void *opaque
, BlockDriverState
*bs
);
1088 struct bdrv_iterate_context
{
1094 * do_cont(): Resume emulation.
1096 static int do_cont(Monitor
*mon
, const QDict
*qdict
, QObject
**ret_data
)
1098 struct bdrv_iterate_context context
= { mon
, 0 };
1100 if (incoming_expected
) {
1101 qerror_report(QERR_MIGRATION_EXPECTED
);
1104 bdrv_iterate(encrypted_bdrv_it
, &context
);
1105 /* only resume the vm if all keys are set and valid */
1114 static void bdrv_key_cb(void *opaque
, int err
)
1116 Monitor
*mon
= opaque
;
1118 /* another key was set successfully, retry to continue */
1120 do_cont(mon
, NULL
, NULL
);
1123 static void encrypted_bdrv_it(void *opaque
, BlockDriverState
*bs
)
1125 struct bdrv_iterate_context
*context
= opaque
;
1127 if (!context
->err
&& bdrv_key_required(bs
)) {
1128 context
->err
= -EBUSY
;
1129 monitor_read_bdrv_key_start(context
->mon
, bs
, bdrv_key_cb
,
1134 static void do_gdbserver(Monitor
*mon
, const QDict
*qdict
)
1136 const char *device
= qdict_get_try_str(qdict
, "device");
1138 device
= "tcp::" DEFAULT_GDBSTUB_PORT
;
1139 if (gdbserver_start(device
) < 0) {
1140 monitor_printf(mon
, "Could not open gdbserver on device '%s'\n",
1142 } else if (strcmp(device
, "none") == 0) {
1143 monitor_printf(mon
, "Disabled gdbserver\n");
1145 monitor_printf(mon
, "Waiting for gdb connection on device '%s'\n",
1150 static void do_watchdog_action(Monitor
*mon
, const QDict
*qdict
)
1152 const char *action
= qdict_get_str(qdict
, "action");
1153 if (select_watchdog_action(action
) == -1) {
1154 monitor_printf(mon
, "Unknown watchdog action '%s'\n", action
);
1158 static void monitor_printc(Monitor
*mon
, int c
)
1160 monitor_printf(mon
, "'");
1163 monitor_printf(mon
, "\\'");
1166 monitor_printf(mon
, "\\\\");
1169 monitor_printf(mon
, "\\n");
1172 monitor_printf(mon
, "\\r");
1175 if (c
>= 32 && c
<= 126) {
1176 monitor_printf(mon
, "%c", c
);
1178 monitor_printf(mon
, "\\x%02x", c
);
1182 monitor_printf(mon
, "'");
1185 static void memory_dump(Monitor
*mon
, int count
, int format
, int wsize
,
1186 target_phys_addr_t addr
, int is_physical
)
1189 int l
, line_size
, i
, max_digits
, len
;
1193 if (format
== 'i') {
1196 env
= mon_get_cpu();
1200 } else if (wsize
== 4) {
1203 /* as default we use the current CS size */
1206 #ifdef TARGET_X86_64
1207 if ((env
->efer
& MSR_EFER_LMA
) &&
1208 (env
->segs
[R_CS
].flags
& DESC_L_MASK
))
1212 if (!(env
->segs
[R_CS
].flags
& DESC_B_MASK
))
1217 monitor_disas(mon
, env
, addr
, count
, is_physical
, flags
);
1221 len
= wsize
* count
;
1230 max_digits
= (wsize
* 8 + 2) / 3;
1234 max_digits
= (wsize
* 8) / 4;
1238 max_digits
= (wsize
* 8 * 10 + 32) / 33;
1247 monitor_printf(mon
, TARGET_FMT_plx
":", addr
);
1249 monitor_printf(mon
, TARGET_FMT_lx
":", (target_ulong
)addr
);
1254 cpu_physical_memory_rw(addr
, buf
, l
, 0);
1256 env
= mon_get_cpu();
1257 if (cpu_memory_rw_debug(env
, addr
, buf
, l
, 0) < 0) {
1258 monitor_printf(mon
, " Cannot access memory\n");
1267 v
= ldub_raw(buf
+ i
);
1270 v
= lduw_raw(buf
+ i
);
1273 v
= (uint32_t)ldl_raw(buf
+ i
);
1276 v
= ldq_raw(buf
+ i
);
1279 monitor_printf(mon
, " ");
1282 monitor_printf(mon
, "%#*" PRIo64
, max_digits
, v
);
1285 monitor_printf(mon
, "0x%0*" PRIx64
, max_digits
, v
);
1288 monitor_printf(mon
, "%*" PRIu64
, max_digits
, v
);
1291 monitor_printf(mon
, "%*" PRId64
, max_digits
, v
);
1294 monitor_printc(mon
, v
);
1299 monitor_printf(mon
, "\n");
1305 static void do_memory_dump(Monitor
*mon
, const QDict
*qdict
)
1307 int count
= qdict_get_int(qdict
, "count");
1308 int format
= qdict_get_int(qdict
, "format");
1309 int size
= qdict_get_int(qdict
, "size");
1310 target_long addr
= qdict_get_int(qdict
, "addr");
1312 memory_dump(mon
, count
, format
, size
, addr
, 0);
1315 static void do_physical_memory_dump(Monitor
*mon
, const QDict
*qdict
)
1317 int count
= qdict_get_int(qdict
, "count");
1318 int format
= qdict_get_int(qdict
, "format");
1319 int size
= qdict_get_int(qdict
, "size");
1320 target_phys_addr_t addr
= qdict_get_int(qdict
, "addr");
1322 memory_dump(mon
, count
, format
, size
, addr
, 1);
1325 static void do_print(Monitor
*mon
, const QDict
*qdict
)
1327 int format
= qdict_get_int(qdict
, "format");
1328 target_phys_addr_t val
= qdict_get_int(qdict
, "val");
1330 #if TARGET_PHYS_ADDR_BITS == 32
1333 monitor_printf(mon
, "%#o", val
);
1336 monitor_printf(mon
, "%#x", val
);
1339 monitor_printf(mon
, "%u", val
);
1343 monitor_printf(mon
, "%d", val
);
1346 monitor_printc(mon
, val
);
1352 monitor_printf(mon
, "%#" PRIo64
, val
);
1355 monitor_printf(mon
, "%#" PRIx64
, val
);
1358 monitor_printf(mon
, "%" PRIu64
, val
);
1362 monitor_printf(mon
, "%" PRId64
, val
);
1365 monitor_printc(mon
, val
);
1369 monitor_printf(mon
, "\n");
1372 static int do_memory_save(Monitor
*mon
, const QDict
*qdict
, QObject
**ret_data
)
1375 uint32_t size
= qdict_get_int(qdict
, "size");
1376 const char *filename
= qdict_get_str(qdict
, "filename");
1377 target_long addr
= qdict_get_int(qdict
, "val");
1383 env
= mon_get_cpu();
1385 f
= fopen(filename
, "wb");
1387 qerror_report(QERR_OPEN_FILE_FAILED
, filename
);
1394 cpu_memory_rw_debug(env
, addr
, buf
, l
, 0);
1395 if (fwrite(buf
, 1, l
, f
) != l
) {
1396 monitor_printf(mon
, "fwrite() error in do_memory_save\n");
1410 static int do_physical_memory_save(Monitor
*mon
, const QDict
*qdict
,
1416 uint32_t size
= qdict_get_int(qdict
, "size");
1417 const char *filename
= qdict_get_str(qdict
, "filename");
1418 target_phys_addr_t addr
= qdict_get_int(qdict
, "val");
1421 f
= fopen(filename
, "wb");
1423 qerror_report(QERR_OPEN_FILE_FAILED
, filename
);
1430 cpu_physical_memory_rw(addr
, buf
, l
, 0);
1431 if (fwrite(buf
, 1, l
, f
) != l
) {
1432 monitor_printf(mon
, "fwrite() error in do_physical_memory_save\n");
1447 static void do_sum(Monitor
*mon
, const QDict
*qdict
)
1452 uint32_t start
= qdict_get_int(qdict
, "start");
1453 uint32_t size
= qdict_get_int(qdict
, "size");
1456 for(addr
= start
; addr
< (start
+ size
); addr
++) {
1457 cpu_physical_memory_rw(addr
, buf
, 1, 0);
1458 /* BSD sum algorithm ('sum' Unix command) */
1459 sum
= (sum
>> 1) | (sum
<< 15);
1462 monitor_printf(mon
, "%05d\n", sum
);
1470 static const KeyDef key_defs
[] = {
1472 { 0x36, "shift_r" },
1477 { 0xe4, "altgr_r" },
1497 { 0x0e, "backspace" },
1510 { 0x1a, "bracket_left" },
1511 { 0x1b, "bracket_right" },
1523 { 0x27, "semicolon" },
1524 { 0x28, "apostrophe" },
1525 { 0x29, "grave_accent" },
1527 { 0x2b, "backslash" },
1539 { 0x37, "asterisk" },
1542 { 0x3a, "caps_lock" },
1553 { 0x45, "num_lock" },
1554 { 0x46, "scroll_lock" },
1556 { 0xb5, "kp_divide" },
1557 { 0x37, "kp_multiply" },
1558 { 0x4a, "kp_subtract" },
1560 { 0x9c, "kp_enter" },
1561 { 0x53, "kp_decimal" },
1594 #if defined(TARGET_SPARC) && !defined(TARGET_SPARC64)
1609 { 0xfe, "compose" },
1614 static int get_keycode(const char *key
)
1620 for(p
= key_defs
; p
->name
!= NULL
; p
++) {
1621 if (!strcmp(key
, p
->name
))
1624 if (strstart(key
, "0x", NULL
)) {
1625 ret
= strtoul(key
, &endp
, 0);
1626 if (*endp
== '\0' && ret
>= 0x01 && ret
<= 0xff)
1632 #define MAX_KEYCODES 16
1633 static uint8_t keycodes
[MAX_KEYCODES
];
1634 static int nb_pending_keycodes
;
1635 static QEMUTimer
*key_timer
;
1637 static void release_keys(void *opaque
)
1641 while (nb_pending_keycodes
> 0) {
1642 nb_pending_keycodes
--;
1643 keycode
= keycodes
[nb_pending_keycodes
];
1645 kbd_put_keycode(0xe0);
1646 kbd_put_keycode(keycode
| 0x80);
1650 static void do_sendkey(Monitor
*mon
, const QDict
*qdict
)
1652 char keyname_buf
[16];
1654 int keyname_len
, keycode
, i
;
1655 const char *string
= qdict_get_str(qdict
, "string");
1656 int has_hold_time
= qdict_haskey(qdict
, "hold_time");
1657 int hold_time
= qdict_get_try_int(qdict
, "hold_time", -1);
1659 if (nb_pending_keycodes
> 0) {
1660 qemu_del_timer(key_timer
);
1667 separator
= strchr(string
, '-');
1668 keyname_len
= separator
? separator
- string
: strlen(string
);
1669 if (keyname_len
> 0) {
1670 pstrcpy(keyname_buf
, sizeof(keyname_buf
), string
);
1671 if (keyname_len
> sizeof(keyname_buf
) - 1) {
1672 monitor_printf(mon
, "invalid key: '%s...'\n", keyname_buf
);
1675 if (i
== MAX_KEYCODES
) {
1676 monitor_printf(mon
, "too many keys\n");
1679 keyname_buf
[keyname_len
] = 0;
1680 keycode
= get_keycode(keyname_buf
);
1682 monitor_printf(mon
, "unknown key: '%s'\n", keyname_buf
);
1685 keycodes
[i
++] = keycode
;
1689 string
= separator
+ 1;
1691 nb_pending_keycodes
= i
;
1692 /* key down events */
1693 for (i
= 0; i
< nb_pending_keycodes
; i
++) {
1694 keycode
= keycodes
[i
];
1696 kbd_put_keycode(0xe0);
1697 kbd_put_keycode(keycode
& 0x7f);
1699 /* delayed key up events */
1700 qemu_mod_timer(key_timer
, qemu_get_clock(vm_clock
) +
1701 muldiv64(get_ticks_per_sec(), hold_time
, 1000));
1704 static int mouse_button_state
;
1706 static void do_mouse_move(Monitor
*mon
, const QDict
*qdict
)
1709 const char *dx_str
= qdict_get_str(qdict
, "dx_str");
1710 const char *dy_str
= qdict_get_str(qdict
, "dy_str");
1711 const char *dz_str
= qdict_get_try_str(qdict
, "dz_str");
1712 dx
= strtol(dx_str
, NULL
, 0);
1713 dy
= strtol(dy_str
, NULL
, 0);
1716 dz
= strtol(dz_str
, NULL
, 0);
1717 kbd_mouse_event(dx
, dy
, dz
, mouse_button_state
);
1720 static void do_mouse_button(Monitor
*mon
, const QDict
*qdict
)
1722 int button_state
= qdict_get_int(qdict
, "button_state");
1723 mouse_button_state
= button_state
;
1724 kbd_mouse_event(0, 0, 0, mouse_button_state
);
1727 static void do_ioport_read(Monitor
*mon
, const QDict
*qdict
)
1729 int size
= qdict_get_int(qdict
, "size");
1730 int addr
= qdict_get_int(qdict
, "addr");
1731 int has_index
= qdict_haskey(qdict
, "index");
1736 int index
= qdict_get_int(qdict
, "index");
1737 cpu_outb(addr
& IOPORTS_MASK
, index
& 0xff);
1745 val
= cpu_inb(addr
);
1749 val
= cpu_inw(addr
);
1753 val
= cpu_inl(addr
);
1757 monitor_printf(mon
, "port%c[0x%04x] = %#0*x\n",
1758 suffix
, addr
, size
* 2, val
);
1761 static void do_ioport_write(Monitor
*mon
, const QDict
*qdict
)
1763 int size
= qdict_get_int(qdict
, "size");
1764 int addr
= qdict_get_int(qdict
, "addr");
1765 int val
= qdict_get_int(qdict
, "val");
1767 addr
&= IOPORTS_MASK
;
1772 cpu_outb(addr
, val
);
1775 cpu_outw(addr
, val
);
1778 cpu_outl(addr
, val
);
1783 static void do_boot_set(Monitor
*mon
, const QDict
*qdict
)
1786 const char *bootdevice
= qdict_get_str(qdict
, "bootdevice");
1788 res
= qemu_boot_set(bootdevice
);
1790 monitor_printf(mon
, "boot device list now set to %s\n", bootdevice
);
1791 } else if (res
> 0) {
1792 monitor_printf(mon
, "setting boot device list failed\n");
1794 monitor_printf(mon
, "no function defined to set boot device list for "
1795 "this architecture\n");
1800 * do_system_reset(): Issue a machine reset
1802 static int do_system_reset(Monitor
*mon
, const QDict
*qdict
,
1805 qemu_system_reset_request();
1810 * do_system_powerdown(): Issue a machine powerdown
1812 static int do_system_powerdown(Monitor
*mon
, const QDict
*qdict
,
1815 qemu_system_powerdown_request();
1819 #if defined(TARGET_I386)
1820 static void print_pte(Monitor
*mon
, uint32_t addr
, uint32_t pte
, uint32_t mask
)
1822 monitor_printf(mon
, "%08x: %08x %c%c%c%c%c%c%c%c\n",
1825 pte
& PG_GLOBAL_MASK
? 'G' : '-',
1826 pte
& PG_PSE_MASK
? 'P' : '-',
1827 pte
& PG_DIRTY_MASK
? 'D' : '-',
1828 pte
& PG_ACCESSED_MASK
? 'A' : '-',
1829 pte
& PG_PCD_MASK
? 'C' : '-',
1830 pte
& PG_PWT_MASK
? 'T' : '-',
1831 pte
& PG_USER_MASK
? 'U' : '-',
1832 pte
& PG_RW_MASK
? 'W' : '-');
1835 static void tlb_info(Monitor
*mon
)
1839 uint32_t pgd
, pde
, pte
;
1841 env
= mon_get_cpu();
1843 if (!(env
->cr
[0] & CR0_PG_MASK
)) {
1844 monitor_printf(mon
, "PG disabled\n");
1847 pgd
= env
->cr
[3] & ~0xfff;
1848 for(l1
= 0; l1
< 1024; l1
++) {
1849 cpu_physical_memory_read(pgd
+ l1
* 4, (uint8_t *)&pde
, 4);
1850 pde
= le32_to_cpu(pde
);
1851 if (pde
& PG_PRESENT_MASK
) {
1852 if ((pde
& PG_PSE_MASK
) && (env
->cr
[4] & CR4_PSE_MASK
)) {
1853 print_pte(mon
, (l1
<< 22), pde
, ~((1 << 20) - 1));
1855 for(l2
= 0; l2
< 1024; l2
++) {
1856 cpu_physical_memory_read((pde
& ~0xfff) + l2
* 4,
1857 (uint8_t *)&pte
, 4);
1858 pte
= le32_to_cpu(pte
);
1859 if (pte
& PG_PRESENT_MASK
) {
1860 print_pte(mon
, (l1
<< 22) + (l2
<< 12),
1870 static void mem_print(Monitor
*mon
, uint32_t *pstart
, int *plast_prot
,
1871 uint32_t end
, int prot
)
1874 prot1
= *plast_prot
;
1875 if (prot
!= prot1
) {
1876 if (*pstart
!= -1) {
1877 monitor_printf(mon
, "%08x-%08x %08x %c%c%c\n",
1878 *pstart
, end
, end
- *pstart
,
1879 prot1
& PG_USER_MASK
? 'u' : '-',
1881 prot1
& PG_RW_MASK
? 'w' : '-');
1891 static void mem_info(Monitor
*mon
)
1894 int l1
, l2
, prot
, last_prot
;
1895 uint32_t pgd
, pde
, pte
, start
, end
;
1897 env
= mon_get_cpu();
1899 if (!(env
->cr
[0] & CR0_PG_MASK
)) {
1900 monitor_printf(mon
, "PG disabled\n");
1903 pgd
= env
->cr
[3] & ~0xfff;
1906 for(l1
= 0; l1
< 1024; l1
++) {
1907 cpu_physical_memory_read(pgd
+ l1
* 4, (uint8_t *)&pde
, 4);
1908 pde
= le32_to_cpu(pde
);
1910 if (pde
& PG_PRESENT_MASK
) {
1911 if ((pde
& PG_PSE_MASK
) && (env
->cr
[4] & CR4_PSE_MASK
)) {
1912 prot
= pde
& (PG_USER_MASK
| PG_RW_MASK
| PG_PRESENT_MASK
);
1913 mem_print(mon
, &start
, &last_prot
, end
, prot
);
1915 for(l2
= 0; l2
< 1024; l2
++) {
1916 cpu_physical_memory_read((pde
& ~0xfff) + l2
* 4,
1917 (uint8_t *)&pte
, 4);
1918 pte
= le32_to_cpu(pte
);
1919 end
= (l1
<< 22) + (l2
<< 12);
1920 if (pte
& PG_PRESENT_MASK
) {
1921 prot
= pte
& (PG_USER_MASK
| PG_RW_MASK
| PG_PRESENT_MASK
);
1925 mem_print(mon
, &start
, &last_prot
, end
, prot
);
1930 mem_print(mon
, &start
, &last_prot
, end
, prot
);
1936 #if defined(TARGET_SH4)
1938 static void print_tlb(Monitor
*mon
, int idx
, tlb_t
*tlb
)
1940 monitor_printf(mon
, " tlb%i:\t"
1941 "asid=%hhu vpn=%x\tppn=%x\tsz=%hhu size=%u\t"
1942 "v=%hhu shared=%hhu cached=%hhu prot=%hhu "
1943 "dirty=%hhu writethrough=%hhu\n",
1945 tlb
->asid
, tlb
->vpn
, tlb
->ppn
, tlb
->sz
, tlb
->size
,
1946 tlb
->v
, tlb
->sh
, tlb
->c
, tlb
->pr
,
1950 static void tlb_info(Monitor
*mon
)
1952 CPUState
*env
= mon_get_cpu();
1955 monitor_printf (mon
, "ITLB:\n");
1956 for (i
= 0 ; i
< ITLB_SIZE
; i
++)
1957 print_tlb (mon
, i
, &env
->itlb
[i
]);
1958 monitor_printf (mon
, "UTLB:\n");
1959 for (i
= 0 ; i
< UTLB_SIZE
; i
++)
1960 print_tlb (mon
, i
, &env
->utlb
[i
]);
1965 static void do_info_kvm_print(Monitor
*mon
, const QObject
*data
)
1969 qdict
= qobject_to_qdict(data
);
1971 monitor_printf(mon
, "kvm support: ");
1972 if (qdict_get_bool(qdict
, "present")) {
1973 monitor_printf(mon
, "%s\n", qdict_get_bool(qdict
, "enabled") ?
1974 "enabled" : "disabled");
1976 monitor_printf(mon
, "not compiled\n");
1980 static void do_info_kvm(Monitor
*mon
, QObject
**ret_data
)
1983 *ret_data
= qobject_from_jsonf("{ 'enabled': %i, 'present': true }",
1986 *ret_data
= qobject_from_jsonf("{ 'enabled': false, 'present': false }");
1990 static void do_info_numa(Monitor
*mon
)
1995 monitor_printf(mon
, "%d nodes\n", nb_numa_nodes
);
1996 for (i
= 0; i
< nb_numa_nodes
; i
++) {
1997 monitor_printf(mon
, "node %d cpus:", i
);
1998 for (env
= first_cpu
; env
!= NULL
; env
= env
->next_cpu
) {
1999 if (env
->numa_node
== i
) {
2000 monitor_printf(mon
, " %d", env
->cpu_index
);
2003 monitor_printf(mon
, "\n");
2004 monitor_printf(mon
, "node %d size: %" PRId64
" MB\n", i
,
2009 #ifdef CONFIG_PROFILER
2014 static void do_info_profile(Monitor
*mon
)
2020 monitor_printf(mon
, "async time %" PRId64
" (%0.3f)\n",
2021 dev_time
, dev_time
/ (double)get_ticks_per_sec());
2022 monitor_printf(mon
, "qemu time %" PRId64
" (%0.3f)\n",
2023 qemu_time
, qemu_time
/ (double)get_ticks_per_sec());
2028 static void do_info_profile(Monitor
*mon
)
2030 monitor_printf(mon
, "Internal profiler not compiled\n");
2034 /* Capture support */
2035 static QLIST_HEAD (capture_list_head
, CaptureState
) capture_head
;
2037 static void do_info_capture(Monitor
*mon
)
2042 for (s
= capture_head
.lh_first
, i
= 0; s
; s
= s
->entries
.le_next
, ++i
) {
2043 monitor_printf(mon
, "[%d]: ", i
);
2044 s
->ops
.info (s
->opaque
);
2049 static void do_stop_capture(Monitor
*mon
, const QDict
*qdict
)
2052 int n
= qdict_get_int(qdict
, "n");
2055 for (s
= capture_head
.lh_first
, i
= 0; s
; s
= s
->entries
.le_next
, ++i
) {
2057 s
->ops
.destroy (s
->opaque
);
2058 QLIST_REMOVE (s
, entries
);
2065 static void do_wav_capture(Monitor
*mon
, const QDict
*qdict
)
2067 const char *path
= qdict_get_str(qdict
, "path");
2068 int has_freq
= qdict_haskey(qdict
, "freq");
2069 int freq
= qdict_get_try_int(qdict
, "freq", -1);
2070 int has_bits
= qdict_haskey(qdict
, "bits");
2071 int bits
= qdict_get_try_int(qdict
, "bits", -1);
2072 int has_channels
= qdict_haskey(qdict
, "nchannels");
2073 int nchannels
= qdict_get_try_int(qdict
, "nchannels", -1);
2076 s
= qemu_mallocz (sizeof (*s
));
2078 freq
= has_freq
? freq
: 44100;
2079 bits
= has_bits
? bits
: 16;
2080 nchannels
= has_channels
? nchannels
: 2;
2082 if (wav_start_capture (s
, path
, freq
, bits
, nchannels
)) {
2083 monitor_printf(mon
, "Faied to add wave capture\n");
2086 QLIST_INSERT_HEAD (&capture_head
, s
, entries
);
2090 #if defined(TARGET_I386)
2091 static void do_inject_nmi(Monitor
*mon
, const QDict
*qdict
)
2094 int cpu_index
= qdict_get_int(qdict
, "cpu_index");
2096 for (env
= first_cpu
; env
!= NULL
; env
= env
->next_cpu
)
2097 if (env
->cpu_index
== cpu_index
) {
2099 kvm_inject_interrupt(env
, CPU_INTERRUPT_NMI
);
2101 cpu_interrupt(env
, CPU_INTERRUPT_NMI
);
2107 static void do_info_status_print(Monitor
*mon
, const QObject
*data
)
2111 qdict
= qobject_to_qdict(data
);
2113 monitor_printf(mon
, "VM status: ");
2114 if (qdict_get_bool(qdict
, "running")) {
2115 monitor_printf(mon
, "running");
2116 if (qdict_get_bool(qdict
, "singlestep")) {
2117 monitor_printf(mon
, " (single step mode)");
2120 monitor_printf(mon
, "paused");
2123 monitor_printf(mon
, "\n");
2126 static void do_info_status(Monitor
*mon
, QObject
**ret_data
)
2128 *ret_data
= qobject_from_jsonf("{ 'running': %i, 'singlestep': %i }",
2129 vm_running
, singlestep
);
2132 static qemu_acl
*find_acl(Monitor
*mon
, const char *name
)
2134 qemu_acl
*acl
= qemu_acl_find(name
);
2137 monitor_printf(mon
, "acl: unknown list '%s'\n", name
);
2142 static void do_acl_show(Monitor
*mon
, const QDict
*qdict
)
2144 const char *aclname
= qdict_get_str(qdict
, "aclname");
2145 qemu_acl
*acl
= find_acl(mon
, aclname
);
2146 qemu_acl_entry
*entry
;
2150 monitor_printf(mon
, "policy: %s\n",
2151 acl
->defaultDeny
? "deny" : "allow");
2152 QTAILQ_FOREACH(entry
, &acl
->entries
, next
) {
2154 monitor_printf(mon
, "%d: %s %s\n", i
,
2155 entry
->deny
? "deny" : "allow", entry
->match
);
2160 static void do_acl_reset(Monitor
*mon
, const QDict
*qdict
)
2162 const char *aclname
= qdict_get_str(qdict
, "aclname");
2163 qemu_acl
*acl
= find_acl(mon
, aclname
);
2166 qemu_acl_reset(acl
);
2167 monitor_printf(mon
, "acl: removed all rules\n");
2171 static void do_acl_policy(Monitor
*mon
, const QDict
*qdict
)
2173 const char *aclname
= qdict_get_str(qdict
, "aclname");
2174 const char *policy
= qdict_get_str(qdict
, "policy");
2175 qemu_acl
*acl
= find_acl(mon
, aclname
);
2178 if (strcmp(policy
, "allow") == 0) {
2179 acl
->defaultDeny
= 0;
2180 monitor_printf(mon
, "acl: policy set to 'allow'\n");
2181 } else if (strcmp(policy
, "deny") == 0) {
2182 acl
->defaultDeny
= 1;
2183 monitor_printf(mon
, "acl: policy set to 'deny'\n");
2185 monitor_printf(mon
, "acl: unknown policy '%s', "
2186 "expected 'deny' or 'allow'\n", policy
);
2191 static void do_acl_add(Monitor
*mon
, const QDict
*qdict
)
2193 const char *aclname
= qdict_get_str(qdict
, "aclname");
2194 const char *match
= qdict_get_str(qdict
, "match");
2195 const char *policy
= qdict_get_str(qdict
, "policy");
2196 int has_index
= qdict_haskey(qdict
, "index");
2197 int index
= qdict_get_try_int(qdict
, "index", -1);
2198 qemu_acl
*acl
= find_acl(mon
, aclname
);
2202 if (strcmp(policy
, "allow") == 0) {
2204 } else if (strcmp(policy
, "deny") == 0) {
2207 monitor_printf(mon
, "acl: unknown policy '%s', "
2208 "expected 'deny' or 'allow'\n", policy
);
2212 ret
= qemu_acl_insert(acl
, deny
, match
, index
);
2214 ret
= qemu_acl_append(acl
, deny
, match
);
2216 monitor_printf(mon
, "acl: unable to add acl entry\n");
2218 monitor_printf(mon
, "acl: added rule at position %d\n", ret
);
2222 static void do_acl_remove(Monitor
*mon
, const QDict
*qdict
)
2224 const char *aclname
= qdict_get_str(qdict
, "aclname");
2225 const char *match
= qdict_get_str(qdict
, "match");
2226 qemu_acl
*acl
= find_acl(mon
, aclname
);
2230 ret
= qemu_acl_remove(acl
, match
);
2232 monitor_printf(mon
, "acl: no matching acl entry\n");
2234 monitor_printf(mon
, "acl: removed rule at position %d\n", ret
);
2238 #if defined(TARGET_I386)
2239 static void do_inject_mce(Monitor
*mon
, const QDict
*qdict
)
2242 int cpu_index
= qdict_get_int(qdict
, "cpu_index");
2243 int bank
= qdict_get_int(qdict
, "bank");
2244 uint64_t status
= qdict_get_int(qdict
, "status");
2245 uint64_t mcg_status
= qdict_get_int(qdict
, "mcg_status");
2246 uint64_t addr
= qdict_get_int(qdict
, "addr");
2247 uint64_t misc
= qdict_get_int(qdict
, "misc");
2249 for (cenv
= first_cpu
; cenv
!= NULL
; cenv
= cenv
->next_cpu
)
2250 if (cenv
->cpu_index
== cpu_index
&& cenv
->mcg_cap
) {
2251 cpu_inject_x86_mce(cenv
, bank
, status
, mcg_status
, addr
, misc
);
2257 static int do_getfd(Monitor
*mon
, const QDict
*qdict
, QObject
**ret_data
)
2259 const char *fdname
= qdict_get_str(qdict
, "fdname");
2263 fd
= qemu_chr_get_msgfd(mon
->chr
);
2265 qerror_report(QERR_FD_NOT_SUPPLIED
);
2269 if (qemu_isdigit(fdname
[0])) {
2270 qerror_report(QERR_INVALID_PARAMETER_VALUE
, "fdname",
2271 "a name not starting with a digit");
2275 QLIST_FOREACH(monfd
, &mon
->fds
, next
) {
2276 if (strcmp(monfd
->name
, fdname
) != 0) {
2285 monfd
= qemu_mallocz(sizeof(mon_fd_t
));
2286 monfd
->name
= qemu_strdup(fdname
);
2289 QLIST_INSERT_HEAD(&mon
->fds
, monfd
, next
);
2293 static int do_closefd(Monitor
*mon
, const QDict
*qdict
, QObject
**ret_data
)
2295 const char *fdname
= qdict_get_str(qdict
, "fdname");
2298 QLIST_FOREACH(monfd
, &mon
->fds
, next
) {
2299 if (strcmp(monfd
->name
, fdname
) != 0) {
2303 QLIST_REMOVE(monfd
, next
);
2305 qemu_free(monfd
->name
);
2310 qerror_report(QERR_FD_NOT_FOUND
, fdname
);
2314 static void do_loadvm(Monitor
*mon
, const QDict
*qdict
)
2316 int saved_vm_running
= vm_running
;
2317 const char *name
= qdict_get_str(qdict
, "name");
2321 if (load_vmstate(name
) == 0 && saved_vm_running
) {
2326 int monitor_get_fd(Monitor
*mon
, const char *fdname
)
2330 QLIST_FOREACH(monfd
, &mon
->fds
, next
) {
2333 if (strcmp(monfd
->name
, fdname
) != 0) {
2339 /* caller takes ownership of fd */
2340 QLIST_REMOVE(monfd
, next
);
2341 qemu_free(monfd
->name
);
2350 static const mon_cmd_t mon_cmds
[] = {
2351 #include "qemu-monitor.h"
2355 /* Please update qemu-monitor.hx when adding or changing commands */
2356 static const mon_cmd_t info_cmds
[] = {
2361 .help
= "show the version of QEMU",
2362 .user_print
= do_info_version_print
,
2363 .mhandler
.info_new
= do_info_version
,
2369 .help
= "list QMP available commands",
2370 .user_print
= monitor_user_noop
,
2371 .mhandler
.info_new
= do_info_commands
,
2377 .help
= "show the network state",
2378 .mhandler
.info
= do_info_network
,
2384 .help
= "show the character devices",
2385 .user_print
= qemu_chr_info_print
,
2386 .mhandler
.info_new
= qemu_chr_info
,
2392 .help
= "show the block devices",
2393 .user_print
= bdrv_info_print
,
2394 .mhandler
.info_new
= bdrv_info
,
2397 .name
= "blockstats",
2400 .help
= "show block device statistics",
2401 .user_print
= bdrv_stats_print
,
2402 .mhandler
.info_new
= bdrv_info_stats
,
2405 .name
= "registers",
2408 .help
= "show the cpu registers",
2409 .mhandler
.info
= do_info_registers
,
2415 .help
= "show infos for each CPU",
2416 .user_print
= monitor_print_cpus
,
2417 .mhandler
.info_new
= do_info_cpus
,
2423 .help
= "show the command line history",
2424 .mhandler
.info
= do_info_history
,
2430 .help
= "show the interrupts statistics (if available)",
2431 .mhandler
.info
= irq_info
,
2437 .help
= "show i8259 (PIC) state",
2438 .mhandler
.info
= pic_info
,
2444 .help
= "show PCI info",
2445 .user_print
= do_pci_info_print
,
2446 .mhandler
.info_new
= do_pci_info
,
2448 #if defined(TARGET_I386) || defined(TARGET_SH4)
2453 .help
= "show virtual to physical memory mappings",
2454 .mhandler
.info
= tlb_info
,
2457 #if defined(TARGET_I386)
2462 .help
= "show the active virtual memory mappings",
2463 .mhandler
.info
= mem_info
,
2470 .help
= "show dynamic compiler info",
2471 .mhandler
.info
= do_info_jit
,
2477 .help
= "show KVM information",
2478 .user_print
= do_info_kvm_print
,
2479 .mhandler
.info_new
= do_info_kvm
,
2485 .help
= "show NUMA information",
2486 .mhandler
.info
= do_info_numa
,
2492 .help
= "show guest USB devices",
2493 .mhandler
.info
= usb_info
,
2499 .help
= "show host USB devices",
2500 .mhandler
.info
= usb_host_info
,
2506 .help
= "show profiling information",
2507 .mhandler
.info
= do_info_profile
,
2513 .help
= "show capture information",
2514 .mhandler
.info
= do_info_capture
,
2517 .name
= "snapshots",
2520 .help
= "show the currently saved VM snapshots",
2521 .mhandler
.info
= do_info_snapshots
,
2527 .help
= "show the current VM status (running|paused)",
2528 .user_print
= do_info_status_print
,
2529 .mhandler
.info_new
= do_info_status
,
2535 .help
= "show guest PCMCIA status",
2536 .mhandler
.info
= pcmcia_info
,
2542 .help
= "show which guest mouse is receiving events",
2543 .user_print
= do_info_mice_print
,
2544 .mhandler
.info_new
= do_info_mice
,
2550 .help
= "show the vnc server status",
2551 .user_print
= do_info_vnc_print
,
2552 .mhandler
.info_new
= do_info_vnc
,
2558 .help
= "show the current VM name",
2559 .user_print
= do_info_name_print
,
2560 .mhandler
.info_new
= do_info_name
,
2566 .help
= "show the current VM UUID",
2567 .user_print
= do_info_uuid_print
,
2568 .mhandler
.info_new
= do_info_uuid
,
2570 #if defined(TARGET_PPC)
2575 .help
= "show CPU statistics",
2576 .mhandler
.info
= do_info_cpu_stats
,
2579 #if defined(CONFIG_SLIRP)
2584 .help
= "show user network stack connection states",
2585 .mhandler
.info
= do_info_usernet
,
2592 .help
= "show migration status",
2593 .user_print
= do_info_migrate_print
,
2594 .mhandler
.info_new
= do_info_migrate
,
2600 .help
= "show balloon information",
2601 .user_print
= monitor_print_balloon
,
2602 .mhandler
.info_async
= do_info_balloon
,
2603 .flags
= MONITOR_CMD_ASYNC
,
2609 .help
= "show device tree",
2610 .mhandler
.info
= do_info_qtree
,
2616 .help
= "show qdev device model list",
2617 .mhandler
.info
= do_info_qdm
,
2623 .help
= "show roms",
2624 .mhandler
.info
= do_info_roms
,
2631 /*******************************************************************/
2633 static const char *pch
;
2634 static jmp_buf expr_env
;
2639 typedef struct MonitorDef
{
2642 target_long (*get_value
)(const struct MonitorDef
*md
, int val
);
2646 #if defined(TARGET_I386)
2647 static target_long
monitor_get_pc (const struct MonitorDef
*md
, int val
)
2649 CPUState
*env
= mon_get_cpu();
2650 return env
->eip
+ env
->segs
[R_CS
].base
;
2654 #if defined(TARGET_PPC)
2655 static target_long
monitor_get_ccr (const struct MonitorDef
*md
, int val
)
2657 CPUState
*env
= mon_get_cpu();
2662 for (i
= 0; i
< 8; i
++)
2663 u
|= env
->crf
[i
] << (32 - (4 * i
));
2668 static target_long
monitor_get_msr (const struct MonitorDef
*md
, int val
)
2670 CPUState
*env
= mon_get_cpu();
2674 static target_long
monitor_get_xer (const struct MonitorDef
*md
, int val
)
2676 CPUState
*env
= mon_get_cpu();
2680 static target_long
monitor_get_decr (const struct MonitorDef
*md
, int val
)
2682 CPUState
*env
= mon_get_cpu();
2683 return cpu_ppc_load_decr(env
);
2686 static target_long
monitor_get_tbu (const struct MonitorDef
*md
, int val
)
2688 CPUState
*env
= mon_get_cpu();
2689 return cpu_ppc_load_tbu(env
);
2692 static target_long
monitor_get_tbl (const struct MonitorDef
*md
, int val
)
2694 CPUState
*env
= mon_get_cpu();
2695 return cpu_ppc_load_tbl(env
);
2699 #if defined(TARGET_SPARC)
2700 #ifndef TARGET_SPARC64
2701 static target_long
monitor_get_psr (const struct MonitorDef
*md
, int val
)
2703 CPUState
*env
= mon_get_cpu();
2705 return cpu_get_psr(env
);
2709 static target_long
monitor_get_reg(const struct MonitorDef
*md
, int val
)
2711 CPUState
*env
= mon_get_cpu();
2712 return env
->regwptr
[val
];
2716 static const MonitorDef monitor_defs
[] = {
2719 #define SEG(name, seg) \
2720 { name, offsetof(CPUState, segs[seg].selector), NULL, MD_I32 },\
2721 { name ".base", offsetof(CPUState, segs[seg].base) },\
2722 { name ".limit", offsetof(CPUState, segs[seg].limit), NULL, MD_I32 },
2724 { "eax", offsetof(CPUState
, regs
[0]) },
2725 { "ecx", offsetof(CPUState
, regs
[1]) },
2726 { "edx", offsetof(CPUState
, regs
[2]) },
2727 { "ebx", offsetof(CPUState
, regs
[3]) },
2728 { "esp|sp", offsetof(CPUState
, regs
[4]) },
2729 { "ebp|fp", offsetof(CPUState
, regs
[5]) },
2730 { "esi", offsetof(CPUState
, regs
[6]) },
2731 { "edi", offsetof(CPUState
, regs
[7]) },
2732 #ifdef TARGET_X86_64
2733 { "r8", offsetof(CPUState
, regs
[8]) },
2734 { "r9", offsetof(CPUState
, regs
[9]) },
2735 { "r10", offsetof(CPUState
, regs
[10]) },
2736 { "r11", offsetof(CPUState
, regs
[11]) },
2737 { "r12", offsetof(CPUState
, regs
[12]) },
2738 { "r13", offsetof(CPUState
, regs
[13]) },
2739 { "r14", offsetof(CPUState
, regs
[14]) },
2740 { "r15", offsetof(CPUState
, regs
[15]) },
2742 { "eflags", offsetof(CPUState
, eflags
) },
2743 { "eip", offsetof(CPUState
, eip
) },
2750 { "pc", 0, monitor_get_pc
, },
2751 #elif defined(TARGET_PPC)
2752 /* General purpose registers */
2753 { "r0", offsetof(CPUState
, gpr
[0]) },
2754 { "r1", offsetof(CPUState
, gpr
[1]) },
2755 { "r2", offsetof(CPUState
, gpr
[2]) },
2756 { "r3", offsetof(CPUState
, gpr
[3]) },
2757 { "r4", offsetof(CPUState
, gpr
[4]) },
2758 { "r5", offsetof(CPUState
, gpr
[5]) },
2759 { "r6", offsetof(CPUState
, gpr
[6]) },
2760 { "r7", offsetof(CPUState
, gpr
[7]) },
2761 { "r8", offsetof(CPUState
, gpr
[8]) },
2762 { "r9", offsetof(CPUState
, gpr
[9]) },
2763 { "r10", offsetof(CPUState
, gpr
[10]) },
2764 { "r11", offsetof(CPUState
, gpr
[11]) },
2765 { "r12", offsetof(CPUState
, gpr
[12]) },
2766 { "r13", offsetof(CPUState
, gpr
[13]) },
2767 { "r14", offsetof(CPUState
, gpr
[14]) },
2768 { "r15", offsetof(CPUState
, gpr
[15]) },
2769 { "r16", offsetof(CPUState
, gpr
[16]) },
2770 { "r17", offsetof(CPUState
, gpr
[17]) },
2771 { "r18", offsetof(CPUState
, gpr
[18]) },
2772 { "r19", offsetof(CPUState
, gpr
[19]) },
2773 { "r20", offsetof(CPUState
, gpr
[20]) },
2774 { "r21", offsetof(CPUState
, gpr
[21]) },
2775 { "r22", offsetof(CPUState
, gpr
[22]) },
2776 { "r23", offsetof(CPUState
, gpr
[23]) },
2777 { "r24", offsetof(CPUState
, gpr
[24]) },
2778 { "r25", offsetof(CPUState
, gpr
[25]) },
2779 { "r26", offsetof(CPUState
, gpr
[26]) },
2780 { "r27", offsetof(CPUState
, gpr
[27]) },
2781 { "r28", offsetof(CPUState
, gpr
[28]) },
2782 { "r29", offsetof(CPUState
, gpr
[29]) },
2783 { "r30", offsetof(CPUState
, gpr
[30]) },
2784 { "r31", offsetof(CPUState
, gpr
[31]) },
2785 /* Floating point registers */
2786 { "f0", offsetof(CPUState
, fpr
[0]) },
2787 { "f1", offsetof(CPUState
, fpr
[1]) },
2788 { "f2", offsetof(CPUState
, fpr
[2]) },
2789 { "f3", offsetof(CPUState
, fpr
[3]) },
2790 { "f4", offsetof(CPUState
, fpr
[4]) },
2791 { "f5", offsetof(CPUState
, fpr
[5]) },
2792 { "f6", offsetof(CPUState
, fpr
[6]) },
2793 { "f7", offsetof(CPUState
, fpr
[7]) },
2794 { "f8", offsetof(CPUState
, fpr
[8]) },
2795 { "f9", offsetof(CPUState
, fpr
[9]) },
2796 { "f10", offsetof(CPUState
, fpr
[10]) },
2797 { "f11", offsetof(CPUState
, fpr
[11]) },
2798 { "f12", offsetof(CPUState
, fpr
[12]) },
2799 { "f13", offsetof(CPUState
, fpr
[13]) },
2800 { "f14", offsetof(CPUState
, fpr
[14]) },
2801 { "f15", offsetof(CPUState
, fpr
[15]) },
2802 { "f16", offsetof(CPUState
, fpr
[16]) },
2803 { "f17", offsetof(CPUState
, fpr
[17]) },
2804 { "f18", offsetof(CPUState
, fpr
[18]) },
2805 { "f19", offsetof(CPUState
, fpr
[19]) },
2806 { "f20", offsetof(CPUState
, fpr
[20]) },
2807 { "f21", offsetof(CPUState
, fpr
[21]) },
2808 { "f22", offsetof(CPUState
, fpr
[22]) },
2809 { "f23", offsetof(CPUState
, fpr
[23]) },
2810 { "f24", offsetof(CPUState
, fpr
[24]) },
2811 { "f25", offsetof(CPUState
, fpr
[25]) },
2812 { "f26", offsetof(CPUState
, fpr
[26]) },
2813 { "f27", offsetof(CPUState
, fpr
[27]) },
2814 { "f28", offsetof(CPUState
, fpr
[28]) },
2815 { "f29", offsetof(CPUState
, fpr
[29]) },
2816 { "f30", offsetof(CPUState
, fpr
[30]) },
2817 { "f31", offsetof(CPUState
, fpr
[31]) },
2818 { "fpscr", offsetof(CPUState
, fpscr
) },
2819 /* Next instruction pointer */
2820 { "nip|pc", offsetof(CPUState
, nip
) },
2821 { "lr", offsetof(CPUState
, lr
) },
2822 { "ctr", offsetof(CPUState
, ctr
) },
2823 { "decr", 0, &monitor_get_decr
, },
2824 { "ccr", 0, &monitor_get_ccr
, },
2825 /* Machine state register */
2826 { "msr", 0, &monitor_get_msr
, },
2827 { "xer", 0, &monitor_get_xer
, },
2828 { "tbu", 0, &monitor_get_tbu
, },
2829 { "tbl", 0, &monitor_get_tbl
, },
2830 #if defined(TARGET_PPC64)
2831 /* Address space register */
2832 { "asr", offsetof(CPUState
, asr
) },
2834 /* Segment registers */
2835 { "sdr1", offsetof(CPUState
, sdr1
) },
2836 { "sr0", offsetof(CPUState
, sr
[0]) },
2837 { "sr1", offsetof(CPUState
, sr
[1]) },
2838 { "sr2", offsetof(CPUState
, sr
[2]) },
2839 { "sr3", offsetof(CPUState
, sr
[3]) },
2840 { "sr4", offsetof(CPUState
, sr
[4]) },
2841 { "sr5", offsetof(CPUState
, sr
[5]) },
2842 { "sr6", offsetof(CPUState
, sr
[6]) },
2843 { "sr7", offsetof(CPUState
, sr
[7]) },
2844 { "sr8", offsetof(CPUState
, sr
[8]) },
2845 { "sr9", offsetof(CPUState
, sr
[9]) },
2846 { "sr10", offsetof(CPUState
, sr
[10]) },
2847 { "sr11", offsetof(CPUState
, sr
[11]) },
2848 { "sr12", offsetof(CPUState
, sr
[12]) },
2849 { "sr13", offsetof(CPUState
, sr
[13]) },
2850 { "sr14", offsetof(CPUState
, sr
[14]) },
2851 { "sr15", offsetof(CPUState
, sr
[15]) },
2852 /* Too lazy to put BATs and SPRs ... */
2853 #elif defined(TARGET_SPARC)
2854 { "g0", offsetof(CPUState
, gregs
[0]) },
2855 { "g1", offsetof(CPUState
, gregs
[1]) },
2856 { "g2", offsetof(CPUState
, gregs
[2]) },
2857 { "g3", offsetof(CPUState
, gregs
[3]) },
2858 { "g4", offsetof(CPUState
, gregs
[4]) },
2859 { "g5", offsetof(CPUState
, gregs
[5]) },
2860 { "g6", offsetof(CPUState
, gregs
[6]) },
2861 { "g7", offsetof(CPUState
, gregs
[7]) },
2862 { "o0", 0, monitor_get_reg
},
2863 { "o1", 1, monitor_get_reg
},
2864 { "o2", 2, monitor_get_reg
},
2865 { "o3", 3, monitor_get_reg
},
2866 { "o4", 4, monitor_get_reg
},
2867 { "o5", 5, monitor_get_reg
},
2868 { "o6", 6, monitor_get_reg
},
2869 { "o7", 7, monitor_get_reg
},
2870 { "l0", 8, monitor_get_reg
},
2871 { "l1", 9, monitor_get_reg
},
2872 { "l2", 10, monitor_get_reg
},
2873 { "l3", 11, monitor_get_reg
},
2874 { "l4", 12, monitor_get_reg
},
2875 { "l5", 13, monitor_get_reg
},
2876 { "l6", 14, monitor_get_reg
},
2877 { "l7", 15, monitor_get_reg
},
2878 { "i0", 16, monitor_get_reg
},
2879 { "i1", 17, monitor_get_reg
},
2880 { "i2", 18, monitor_get_reg
},
2881 { "i3", 19, monitor_get_reg
},
2882 { "i4", 20, monitor_get_reg
},
2883 { "i5", 21, monitor_get_reg
},
2884 { "i6", 22, monitor_get_reg
},
2885 { "i7", 23, monitor_get_reg
},
2886 { "pc", offsetof(CPUState
, pc
) },
2887 { "npc", offsetof(CPUState
, npc
) },
2888 { "y", offsetof(CPUState
, y
) },
2889 #ifndef TARGET_SPARC64
2890 { "psr", 0, &monitor_get_psr
, },
2891 { "wim", offsetof(CPUState
, wim
) },
2893 { "tbr", offsetof(CPUState
, tbr
) },
2894 { "fsr", offsetof(CPUState
, fsr
) },
2895 { "f0", offsetof(CPUState
, fpr
[0]) },
2896 { "f1", offsetof(CPUState
, fpr
[1]) },
2897 { "f2", offsetof(CPUState
, fpr
[2]) },
2898 { "f3", offsetof(CPUState
, fpr
[3]) },
2899 { "f4", offsetof(CPUState
, fpr
[4]) },
2900 { "f5", offsetof(CPUState
, fpr
[5]) },
2901 { "f6", offsetof(CPUState
, fpr
[6]) },
2902 { "f7", offsetof(CPUState
, fpr
[7]) },
2903 { "f8", offsetof(CPUState
, fpr
[8]) },
2904 { "f9", offsetof(CPUState
, fpr
[9]) },
2905 { "f10", offsetof(CPUState
, fpr
[10]) },
2906 { "f11", offsetof(CPUState
, fpr
[11]) },
2907 { "f12", offsetof(CPUState
, fpr
[12]) },
2908 { "f13", offsetof(CPUState
, fpr
[13]) },
2909 { "f14", offsetof(CPUState
, fpr
[14]) },
2910 { "f15", offsetof(CPUState
, fpr
[15]) },
2911 { "f16", offsetof(CPUState
, fpr
[16]) },
2912 { "f17", offsetof(CPUState
, fpr
[17]) },
2913 { "f18", offsetof(CPUState
, fpr
[18]) },
2914 { "f19", offsetof(CPUState
, fpr
[19]) },
2915 { "f20", offsetof(CPUState
, fpr
[20]) },
2916 { "f21", offsetof(CPUState
, fpr
[21]) },
2917 { "f22", offsetof(CPUState
, fpr
[22]) },
2918 { "f23", offsetof(CPUState
, fpr
[23]) },
2919 { "f24", offsetof(CPUState
, fpr
[24]) },
2920 { "f25", offsetof(CPUState
, fpr
[25]) },
2921 { "f26", offsetof(CPUState
, fpr
[26]) },
2922 { "f27", offsetof(CPUState
, fpr
[27]) },
2923 { "f28", offsetof(CPUState
, fpr
[28]) },
2924 { "f29", offsetof(CPUState
, fpr
[29]) },
2925 { "f30", offsetof(CPUState
, fpr
[30]) },
2926 { "f31", offsetof(CPUState
, fpr
[31]) },
2927 #ifdef TARGET_SPARC64
2928 { "f32", offsetof(CPUState
, fpr
[32]) },
2929 { "f34", offsetof(CPUState
, fpr
[34]) },
2930 { "f36", offsetof(CPUState
, fpr
[36]) },
2931 { "f38", offsetof(CPUState
, fpr
[38]) },
2932 { "f40", offsetof(CPUState
, fpr
[40]) },
2933 { "f42", offsetof(CPUState
, fpr
[42]) },
2934 { "f44", offsetof(CPUState
, fpr
[44]) },
2935 { "f46", offsetof(CPUState
, fpr
[46]) },
2936 { "f48", offsetof(CPUState
, fpr
[48]) },
2937 { "f50", offsetof(CPUState
, fpr
[50]) },
2938 { "f52", offsetof(CPUState
, fpr
[52]) },
2939 { "f54", offsetof(CPUState
, fpr
[54]) },
2940 { "f56", offsetof(CPUState
, fpr
[56]) },
2941 { "f58", offsetof(CPUState
, fpr
[58]) },
2942 { "f60", offsetof(CPUState
, fpr
[60]) },
2943 { "f62", offsetof(CPUState
, fpr
[62]) },
2944 { "asi", offsetof(CPUState
, asi
) },
2945 { "pstate", offsetof(CPUState
, pstate
) },
2946 { "cansave", offsetof(CPUState
, cansave
) },
2947 { "canrestore", offsetof(CPUState
, canrestore
) },
2948 { "otherwin", offsetof(CPUState
, otherwin
) },
2949 { "wstate", offsetof(CPUState
, wstate
) },
2950 { "cleanwin", offsetof(CPUState
, cleanwin
) },
2951 { "fprs", offsetof(CPUState
, fprs
) },
2957 static void expr_error(Monitor
*mon
, const char *msg
)
2959 monitor_printf(mon
, "%s\n", msg
);
2960 longjmp(expr_env
, 1);
2963 /* return 0 if OK, -1 if not found */
2964 static int get_monitor_def(target_long
*pval
, const char *name
)
2966 const MonitorDef
*md
;
2969 for(md
= monitor_defs
; md
->name
!= NULL
; md
++) {
2970 if (compare_cmd(name
, md
->name
)) {
2971 if (md
->get_value
) {
2972 *pval
= md
->get_value(md
, md
->offset
);
2974 CPUState
*env
= mon_get_cpu();
2975 ptr
= (uint8_t *)env
+ md
->offset
;
2978 *pval
= *(int32_t *)ptr
;
2981 *pval
= *(target_long
*)ptr
;
2994 static void next(void)
2998 while (qemu_isspace(*pch
))
3003 static int64_t expr_sum(Monitor
*mon
);
3005 static int64_t expr_unary(Monitor
*mon
)
3014 n
= expr_unary(mon
);
3018 n
= -expr_unary(mon
);
3022 n
= ~expr_unary(mon
);
3028 expr_error(mon
, "')' expected");
3035 expr_error(mon
, "character constant expected");
3039 expr_error(mon
, "missing terminating \' character");
3049 while ((*pch
>= 'a' && *pch
<= 'z') ||
3050 (*pch
>= 'A' && *pch
<= 'Z') ||
3051 (*pch
>= '0' && *pch
<= '9') ||
3052 *pch
== '_' || *pch
== '.') {
3053 if ((q
- buf
) < sizeof(buf
) - 1)
3057 while (qemu_isspace(*pch
))
3060 ret
= get_monitor_def(®
, buf
);
3062 expr_error(mon
, "unknown register");
3067 expr_error(mon
, "unexpected end of expression");
3071 #if TARGET_PHYS_ADDR_BITS > 32
3072 n
= strtoull(pch
, &p
, 0);
3074 n
= strtoul(pch
, &p
, 0);
3077 expr_error(mon
, "invalid char in expression");
3080 while (qemu_isspace(*pch
))
3088 static int64_t expr_prod(Monitor
*mon
)
3093 val
= expr_unary(mon
);
3096 if (op
!= '*' && op
!= '/' && op
!= '%')
3099 val2
= expr_unary(mon
);
3108 expr_error(mon
, "division by zero");
3119 static int64_t expr_logic(Monitor
*mon
)
3124 val
= expr_prod(mon
);
3127 if (op
!= '&' && op
!= '|' && op
!= '^')
3130 val2
= expr_prod(mon
);
3147 static int64_t expr_sum(Monitor
*mon
)
3152 val
= expr_logic(mon
);
3155 if (op
!= '+' && op
!= '-')
3158 val2
= expr_logic(mon
);
3167 static int get_expr(Monitor
*mon
, int64_t *pval
, const char **pp
)
3170 if (setjmp(expr_env
)) {
3174 while (qemu_isspace(*pch
))
3176 *pval
= expr_sum(mon
);
3181 static int get_double(Monitor
*mon
, double *pval
, const char **pp
)
3183 const char *p
= *pp
;
3187 d
= strtod(p
, &tailp
);
3189 monitor_printf(mon
, "Number expected\n");
3192 if (d
!= d
|| d
- d
!= 0) {
3193 /* NaN or infinity */
3194 monitor_printf(mon
, "Bad number\n");
3202 static int get_str(char *buf
, int buf_size
, const char **pp
)
3210 while (qemu_isspace(*p
))
3220 while (*p
!= '\0' && *p
!= '\"') {
3236 qemu_printf("unsupported escape code: '\\%c'\n", c
);
3239 if ((q
- buf
) < buf_size
- 1) {
3243 if ((q
- buf
) < buf_size
- 1) {
3250 qemu_printf("unterminated string\n");
3255 while (*p
!= '\0' && !qemu_isspace(*p
)) {
3256 if ((q
- buf
) < buf_size
- 1) {
3268 * Store the command-name in cmdname, and return a pointer to
3269 * the remaining of the command string.
3271 static const char *get_command_name(const char *cmdline
,
3272 char *cmdname
, size_t nlen
)
3275 const char *p
, *pstart
;
3278 while (qemu_isspace(*p
))
3283 while (*p
!= '\0' && *p
!= '/' && !qemu_isspace(*p
))
3288 memcpy(cmdname
, pstart
, len
);
3289 cmdname
[len
] = '\0';
3294 * Read key of 'type' into 'key' and return the current
3297 static char *key_get_info(const char *type
, char **key
)
3305 p
= strchr(type
, ':');
3312 str
= qemu_malloc(len
+ 1);
3313 memcpy(str
, type
, len
);
3320 static int default_fmt_format
= 'x';
3321 static int default_fmt_size
= 4;
3325 static int is_valid_option(const char *c
, const char *typestr
)
3333 typestr
= strstr(typestr
, option
);
3334 return (typestr
!= NULL
);
3337 static const mon_cmd_t
*monitor_find_command(const char *cmdname
)
3339 const mon_cmd_t
*cmd
;
3341 for (cmd
= mon_cmds
; cmd
->name
!= NULL
; cmd
++) {
3342 if (compare_cmd(cmdname
, cmd
->name
)) {
3350 static const mon_cmd_t
*monitor_parse_command(Monitor
*mon
,
3351 const char *cmdline
,
3354 const char *p
, *typestr
;
3356 const mon_cmd_t
*cmd
;
3362 monitor_printf(mon
, "command='%s'\n", cmdline
);
3365 /* extract the command name */
3366 p
= get_command_name(cmdline
, cmdname
, sizeof(cmdname
));
3370 cmd
= monitor_find_command(cmdname
);
3372 monitor_printf(mon
, "unknown command: '%s'\n", cmdname
);
3376 /* parse the parameters */
3377 typestr
= cmd
->args_type
;
3379 typestr
= key_get_info(typestr
, &key
);
3391 while (qemu_isspace(*p
))
3393 if (*typestr
== '?') {
3396 /* no optional string: NULL argument */
3400 ret
= get_str(buf
, sizeof(buf
), &p
);
3404 monitor_printf(mon
, "%s: filename expected\n",
3408 monitor_printf(mon
, "%s: block device name expected\n",
3412 monitor_printf(mon
, "%s: string expected\n", cmdname
);
3417 qdict_put(qdict
, key
, qstring_from_str(buf
));
3422 QemuOptsList
*opts_list
;
3425 opts_list
= qemu_find_opts(key
);
3426 if (!opts_list
|| opts_list
->desc
->name
) {
3429 while (qemu_isspace(*p
)) {
3434 if (get_str(buf
, sizeof(buf
), &p
) < 0) {
3437 opts
= qemu_opts_parse(opts_list
, buf
, 1);
3441 qemu_opts_to_qdict(opts
, qdict
);
3442 qemu_opts_del(opts
);
3447 int count
, format
, size
;
3449 while (qemu_isspace(*p
))
3455 if (qemu_isdigit(*p
)) {
3457 while (qemu_isdigit(*p
)) {
3458 count
= count
* 10 + (*p
- '0');
3496 if (*p
!= '\0' && !qemu_isspace(*p
)) {
3497 monitor_printf(mon
, "invalid char in format: '%c'\n",
3502 format
= default_fmt_format
;
3503 if (format
!= 'i') {
3504 /* for 'i', not specifying a size gives -1 as size */
3506 size
= default_fmt_size
;
3507 default_fmt_size
= size
;
3509 default_fmt_format
= format
;
3512 format
= default_fmt_format
;
3513 if (format
!= 'i') {
3514 size
= default_fmt_size
;
3519 qdict_put(qdict
, "count", qint_from_int(count
));
3520 qdict_put(qdict
, "format", qint_from_int(format
));
3521 qdict_put(qdict
, "size", qint_from_int(size
));
3530 while (qemu_isspace(*p
))
3532 if (*typestr
== '?' || *typestr
== '.') {
3533 if (*typestr
== '?') {
3541 while (qemu_isspace(*p
))
3550 if (get_expr(mon
, &val
, &p
))
3552 /* Check if 'i' is greater than 32-bit */
3553 if ((c
== 'i') && ((val
>> 32) & 0xffffffff)) {
3554 monitor_printf(mon
, "\'%s\' has failed: ", cmdname
);
3555 monitor_printf(mon
, "integer is for 32-bit values\n");
3557 } else if (c
== 'M') {
3560 qdict_put(qdict
, key
, qint_from_int(val
));
3568 while (qemu_isspace(*p
))
3570 if (*typestr
== '?') {
3576 if (get_double(mon
, &val
, &p
) < 0) {
3579 if (c
== 'f' && *p
) {
3582 val
*= 1 << 10; p
++; break;
3584 val
*= 1 << 20; p
++; break;
3586 val
*= 1 << 30; p
++; break;
3589 if (c
== 'T' && p
[0] && p
[1] == 's') {
3592 val
/= 1e3
; p
+= 2; break;
3594 val
/= 1e6
; p
+= 2; break;
3596 val
/= 1e9
; p
+= 2; break;
3599 if (*p
&& !qemu_isspace(*p
)) {
3600 monitor_printf(mon
, "Unknown unit suffix\n");
3603 qdict_put(qdict
, key
, qfloat_from_double(val
));
3611 while (qemu_isspace(*p
)) {
3615 while (qemu_isgraph(*p
)) {
3618 if (p
- beg
== 2 && !memcmp(beg
, "on", p
- beg
)) {
3620 } else if (p
- beg
== 3 && !memcmp(beg
, "off", p
- beg
)) {
3623 monitor_printf(mon
, "Expected 'on' or 'off'\n");
3626 qdict_put(qdict
, key
, qbool_from_int(val
));
3631 const char *tmp
= p
;
3638 while (qemu_isspace(*p
))
3643 if(!is_valid_option(p
, typestr
)) {
3645 monitor_printf(mon
, "%s: unsupported option -%c\n",
3657 qdict_put(qdict
, key
, qbool_from_int(1));
3664 monitor_printf(mon
, "%s: unknown type '%c'\n", cmdname
, c
);
3670 /* check that all arguments were parsed */
3671 while (qemu_isspace(*p
))
3674 monitor_printf(mon
, "%s: extraneous characters at the end of line\n",
3686 void monitor_set_error(Monitor
*mon
, QError
*qerror
)
3688 /* report only the first error */
3690 mon
->error
= qerror
;
3692 MON_DEBUG("Additional error report at %s:%d\n",
3693 qerror
->file
, qerror
->linenr
);
3698 static int is_async_return(const QObject
*data
)
3700 if (data
&& qobject_type(data
) == QTYPE_QDICT
) {
3701 return qdict_haskey(qobject_to_qdict(data
), "__mon_async");
3707 static void handler_audit(Monitor
*mon
, const mon_cmd_t
*cmd
, int ret
)
3709 if (monitor_ctrl_mode(mon
)) {
3710 if (ret
&& !monitor_has_error(mon
)) {
3712 * If it returns failure, it must have passed on error.
3714 * Action: Report an internal error to the client if in QMP.
3716 qerror_report(QERR_UNDEFINED_ERROR
);
3717 MON_DEBUG("command '%s' returned failure but did not pass an error\n",
3721 #ifdef CONFIG_DEBUG_MONITOR
3722 if (!ret
&& monitor_has_error(mon
)) {
3724 * If it returns success, it must not have passed an error.
3726 * Action: Report the passed error to the client.
3728 MON_DEBUG("command '%s' returned success but passed an error\n",
3732 if (mon_print_count_get(mon
) > 0 && strcmp(cmd
->name
, "info") != 0) {
3734 * Handlers should not call Monitor print functions.
3736 * Action: Ignore them in QMP.
3738 * (XXX: we don't check any 'info' or 'query' command here
3739 * because the user print function _is_ called by do_info(), hence
3740 * we will trigger this check. This problem will go away when we
3741 * make 'query' commands real and kill do_info())
3743 MON_DEBUG("command '%s' called print functions %d time(s)\n",
3744 cmd
->name
, mon_print_count_get(mon
));
3748 assert(!monitor_has_error(mon
));
3749 QDECREF(mon
->error
);
3754 static void monitor_call_handler(Monitor
*mon
, const mon_cmd_t
*cmd
,
3755 const QDict
*params
)
3758 QObject
*data
= NULL
;
3760 mon_print_count_init(mon
);
3762 ret
= cmd
->mhandler
.cmd_new(mon
, params
, &data
);
3763 handler_audit(mon
, cmd
, ret
);
3765 if (is_async_return(data
)) {
3767 * Asynchronous commands have no initial return data but they can
3768 * generate errors. Data is returned via the async completion handler.
3770 if (monitor_ctrl_mode(mon
) && monitor_has_error(mon
)) {
3771 monitor_protocol_emitter(mon
, NULL
);
3773 } else if (monitor_ctrl_mode(mon
)) {
3774 /* Monitor Protocol */
3775 monitor_protocol_emitter(mon
, data
);
3779 cmd
->user_print(mon
, data
);
3782 qobject_decref(data
);
3785 static void handle_user_command(Monitor
*mon
, const char *cmdline
)
3788 const mon_cmd_t
*cmd
;
3790 qdict
= qdict_new();
3792 cmd
= monitor_parse_command(mon
, cmdline
, qdict
);
3796 if (monitor_handler_is_async(cmd
)) {
3797 user_async_cmd_handler(mon
, cmd
, qdict
);
3798 } else if (monitor_handler_ported(cmd
)) {
3799 monitor_call_handler(mon
, cmd
, qdict
);
3801 cmd
->mhandler
.cmd(mon
, qdict
);
3808 static void cmd_completion(const char *name
, const char *list
)
3810 const char *p
, *pstart
;
3819 p
= pstart
+ strlen(pstart
);
3821 if (len
> sizeof(cmd
) - 2)
3822 len
= sizeof(cmd
) - 2;
3823 memcpy(cmd
, pstart
, len
);
3825 if (name
[0] == '\0' || !strncmp(name
, cmd
, strlen(name
))) {
3826 readline_add_completion(cur_mon
->rs
, cmd
);
3834 static void file_completion(const char *input
)
3839 char file
[1024], file_prefix
[1024];
3843 p
= strrchr(input
, '/');
3846 pstrcpy(file_prefix
, sizeof(file_prefix
), input
);
3847 pstrcpy(path
, sizeof(path
), ".");
3849 input_path_len
= p
- input
+ 1;
3850 memcpy(path
, input
, input_path_len
);
3851 if (input_path_len
> sizeof(path
) - 1)
3852 input_path_len
= sizeof(path
) - 1;
3853 path
[input_path_len
] = '\0';
3854 pstrcpy(file_prefix
, sizeof(file_prefix
), p
+ 1);
3856 #ifdef DEBUG_COMPLETION
3857 monitor_printf(cur_mon
, "input='%s' path='%s' prefix='%s'\n",
3858 input
, path
, file_prefix
);
3860 ffs
= opendir(path
);
3868 if (strstart(d
->d_name
, file_prefix
, NULL
)) {
3869 memcpy(file
, input
, input_path_len
);
3870 if (input_path_len
< sizeof(file
))
3871 pstrcpy(file
+ input_path_len
, sizeof(file
) - input_path_len
,
3873 /* stat the file to find out if it's a directory.
3874 * In that case add a slash to speed up typing long paths
3877 if(S_ISDIR(sb
.st_mode
))
3878 pstrcat(file
, sizeof(file
), "/");
3879 readline_add_completion(cur_mon
->rs
, file
);
3885 static void block_completion_it(void *opaque
, BlockDriverState
*bs
)
3887 const char *name
= bdrv_get_device_name(bs
);
3888 const char *input
= opaque
;
3890 if (input
[0] == '\0' ||
3891 !strncmp(name
, (char *)input
, strlen(input
))) {
3892 readline_add_completion(cur_mon
->rs
, name
);
3896 /* NOTE: this parser is an approximate form of the real command parser */
3897 static void parse_cmdline(const char *cmdline
,
3898 int *pnb_args
, char **args
)
3907 while (qemu_isspace(*p
))
3911 if (nb_args
>= MAX_ARGS
)
3913 ret
= get_str(buf
, sizeof(buf
), &p
);
3914 args
[nb_args
] = qemu_strdup(buf
);
3919 *pnb_args
= nb_args
;
3922 static const char *next_arg_type(const char *typestr
)
3924 const char *p
= strchr(typestr
, ':');
3925 return (p
!= NULL
? ++p
: typestr
);
3928 static void monitor_find_completion(const char *cmdline
)
3930 const char *cmdname
;
3931 char *args
[MAX_ARGS
];
3932 int nb_args
, i
, len
;
3933 const char *ptype
, *str
;
3934 const mon_cmd_t
*cmd
;
3937 parse_cmdline(cmdline
, &nb_args
, args
);
3938 #ifdef DEBUG_COMPLETION
3939 for(i
= 0; i
< nb_args
; i
++) {
3940 monitor_printf(cur_mon
, "arg%d = '%s'\n", i
, (char *)args
[i
]);
3944 /* if the line ends with a space, it means we want to complete the
3946 len
= strlen(cmdline
);
3947 if (len
> 0 && qemu_isspace(cmdline
[len
- 1])) {
3948 if (nb_args
>= MAX_ARGS
) {
3951 args
[nb_args
++] = qemu_strdup("");
3954 /* command completion */
3959 readline_set_completion_index(cur_mon
->rs
, strlen(cmdname
));
3960 for(cmd
= mon_cmds
; cmd
->name
!= NULL
; cmd
++) {
3961 cmd_completion(cmdname
, cmd
->name
);
3964 /* find the command */
3965 for (cmd
= mon_cmds
; cmd
->name
!= NULL
; cmd
++) {
3966 if (compare_cmd(args
[0], cmd
->name
)) {
3974 ptype
= next_arg_type(cmd
->args_type
);
3975 for(i
= 0; i
< nb_args
- 2; i
++) {
3976 if (*ptype
!= '\0') {
3977 ptype
= next_arg_type(ptype
);
3978 while (*ptype
== '?')
3979 ptype
= next_arg_type(ptype
);
3982 str
= args
[nb_args
- 1];
3983 if (*ptype
== '-' && ptype
[1] != '\0') {
3984 ptype
= next_arg_type(ptype
);
3988 /* file completion */
3989 readline_set_completion_index(cur_mon
->rs
, strlen(str
));
3990 file_completion(str
);
3993 /* block device name completion */
3994 readline_set_completion_index(cur_mon
->rs
, strlen(str
));
3995 bdrv_iterate(block_completion_it
, (void *)str
);
3998 /* XXX: more generic ? */
3999 if (!strcmp(cmd
->name
, "info")) {
4000 readline_set_completion_index(cur_mon
->rs
, strlen(str
));
4001 for(cmd
= info_cmds
; cmd
->name
!= NULL
; cmd
++) {
4002 cmd_completion(str
, cmd
->name
);
4004 } else if (!strcmp(cmd
->name
, "sendkey")) {
4005 char *sep
= strrchr(str
, '-');
4008 readline_set_completion_index(cur_mon
->rs
, strlen(str
));
4009 for(key
= key_defs
; key
->name
!= NULL
; key
++) {
4010 cmd_completion(str
, key
->name
);
4012 } else if (!strcmp(cmd
->name
, "help|?")) {
4013 readline_set_completion_index(cur_mon
->rs
, strlen(str
));
4014 for (cmd
= mon_cmds
; cmd
->name
!= NULL
; cmd
++) {
4015 cmd_completion(str
, cmd
->name
);
4025 for (i
= 0; i
< nb_args
; i
++) {
4030 static int monitor_can_read(void *opaque
)
4032 Monitor
*mon
= opaque
;
4034 return (mon
->suspend_cnt
== 0) ? 1 : 0;
4037 static int invalid_qmp_mode(const Monitor
*mon
, const char *cmd_name
)
4039 int is_cap
= compare_cmd(cmd_name
, "qmp_capabilities");
4040 return (qmp_cmd_mode(mon
) ? is_cap
: !is_cap
);
4044 * Argument validation rules:
4046 * 1. The argument must exist in cmd_args qdict
4047 * 2. The argument type must be the expected one
4049 * Special case: If the argument doesn't exist in cmd_args and
4050 * the QMP_ACCEPT_UNKNOWNS flag is set, then the
4051 * checking is skipped for it.
4053 static int check_client_args_type(const QDict
*client_args
,
4054 const QDict
*cmd_args
, int flags
)
4056 const QDictEntry
*ent
;
4058 for (ent
= qdict_first(client_args
); ent
;ent
= qdict_next(client_args
,ent
)){
4061 const QObject
*client_arg
= qdict_entry_value(ent
);
4062 const char *client_arg_name
= qdict_entry_key(ent
);
4064 obj
= qdict_get(cmd_args
, client_arg_name
);
4066 if (flags
& QMP_ACCEPT_UNKNOWNS
) {
4067 /* handler accepts unknowns */
4070 /* client arg doesn't exist */
4071 qerror_report(QERR_INVALID_PARAMETER
, client_arg_name
);
4075 arg_type
= qobject_to_qstring(obj
);
4076 assert(arg_type
!= NULL
);
4078 /* check if argument's type is correct */
4079 switch (qstring_get_str(arg_type
)[0]) {
4083 if (qobject_type(client_arg
) != QTYPE_QSTRING
) {
4084 qerror_report(QERR_INVALID_PARAMETER_TYPE
, client_arg_name
,
4092 if (qobject_type(client_arg
) != QTYPE_QINT
) {
4093 qerror_report(QERR_INVALID_PARAMETER_TYPE
, client_arg_name
,
4100 if (qobject_type(client_arg
) != QTYPE_QINT
&&
4101 qobject_type(client_arg
) != QTYPE_QFLOAT
) {
4102 qerror_report(QERR_INVALID_PARAMETER_TYPE
, client_arg_name
,
4109 if (qobject_type(client_arg
) != QTYPE_QBOOL
) {
4110 qerror_report(QERR_INVALID_PARAMETER_TYPE
, client_arg_name
,
4116 assert(flags
& QMP_ACCEPT_UNKNOWNS
);
4121 * These types are not supported by QMP and thus are not
4122 * handled here. Fall through.
4133 * - Check if the client has passed all mandatory args
4134 * - Set special flags for argument validation
4136 static int check_mandatory_args(const QDict
*cmd_args
,
4137 const QDict
*client_args
, int *flags
)
4139 const QDictEntry
*ent
;
4141 for (ent
= qdict_first(cmd_args
); ent
; ent
= qdict_next(cmd_args
, ent
)) {
4142 const char *cmd_arg_name
= qdict_entry_key(ent
);
4143 QString
*type
= qobject_to_qstring(qdict_entry_value(ent
));
4144 assert(type
!= NULL
);
4146 if (qstring_get_str(type
)[0] == 'O') {
4147 assert((*flags
& QMP_ACCEPT_UNKNOWNS
) == 0);
4148 *flags
|= QMP_ACCEPT_UNKNOWNS
;
4149 } else if (qstring_get_str(type
)[0] != '-' &&
4150 qstring_get_str(type
)[1] != '?' &&
4151 !qdict_haskey(client_args
, cmd_arg_name
)) {
4152 qerror_report(QERR_MISSING_PARAMETER
, cmd_arg_name
);
4160 static QDict
*qdict_from_args_type(const char *args_type
)
4164 QString
*key
, *type
, *cur_qs
;
4166 assert(args_type
!= NULL
);
4168 qdict
= qdict_new();
4170 if (args_type
== NULL
|| args_type
[0] == '\0') {
4171 /* no args, empty qdict */
4175 key
= qstring_new();
4176 type
= qstring_new();
4181 switch (args_type
[i
]) {
4184 qdict_put(qdict
, qstring_get_str(key
), type
);
4186 if (args_type
[i
] == '\0') {
4189 type
= qstring_new(); /* qdict has ref */
4190 cur_qs
= key
= qstring_new();
4196 qstring_append_chr(cur_qs
, args_type
[i
]);
4206 * Client argument checking rules:
4208 * 1. Client must provide all mandatory arguments
4209 * 2. Each argument provided by the client must be expected
4210 * 3. Each argument provided by the client must have the type expected
4213 static int qmp_check_client_args(const mon_cmd_t
*cmd
, QDict
*client_args
)
4218 cmd_args
= qdict_from_args_type(cmd
->args_type
);
4221 err
= check_mandatory_args(cmd_args
, client_args
, &flags
);
4226 err
= check_client_args_type(client_args
, cmd_args
, flags
);
4234 * Input object checking rules
4236 * 1. Input object must be a dict
4237 * 2. The "execute" key must exist
4238 * 3. The "execute" key must be a string
4239 * 4. If the "arguments" key exists, it must be a dict
4240 * 5. If the "id" key exists, it can be anything (ie. json-value)
4241 * 6. Any argument not listed above is considered invalid
4243 static QDict
*qmp_check_input_obj(QObject
*input_obj
)
4245 const QDictEntry
*ent
;
4246 int has_exec_key
= 0;
4249 if (qobject_type(input_obj
) != QTYPE_QDICT
) {
4250 qerror_report(QERR_QMP_BAD_INPUT_OBJECT
, "object");
4254 input_dict
= qobject_to_qdict(input_obj
);
4256 for (ent
= qdict_first(input_dict
); ent
; ent
= qdict_next(input_dict
, ent
)){
4257 const char *arg_name
= qdict_entry_key(ent
);
4258 const QObject
*arg_obj
= qdict_entry_value(ent
);
4260 if (!strcmp(arg_name
, "execute")) {
4261 if (qobject_type(arg_obj
) != QTYPE_QSTRING
) {
4262 qerror_report(QERR_QMP_BAD_INPUT_OBJECT_MEMBER
, "execute",
4267 } else if (!strcmp(arg_name
, "arguments")) {
4268 if (qobject_type(arg_obj
) != QTYPE_QDICT
) {
4269 qerror_report(QERR_QMP_BAD_INPUT_OBJECT_MEMBER
, "arguments",
4273 } else if (!strcmp(arg_name
, "id")) {
4274 /* FIXME: check duplicated IDs for async commands */
4276 qerror_report(QERR_QMP_EXTRA_MEMBER
, arg_name
);
4281 if (!has_exec_key
) {
4282 qerror_report(QERR_QMP_BAD_INPUT_OBJECT
, "execute");
4289 static void handle_qmp_command(JSONMessageParser
*parser
, QList
*tokens
)
4293 QDict
*input
, *args
;
4294 const mon_cmd_t
*cmd
;
4295 Monitor
*mon
= cur_mon
;
4296 const char *cmd_name
, *info_item
;
4298 args
= input
= NULL
;
4300 obj
= json_parser_parse(tokens
, NULL
);
4302 // FIXME: should be triggered in json_parser_parse()
4303 qerror_report(QERR_JSON_PARSING
);
4307 input
= qmp_check_input_obj(obj
);
4309 qobject_decref(obj
);
4313 mon
->mc
->id
= qdict_get(input
, "id");
4314 qobject_incref(mon
->mc
->id
);
4316 cmd_name
= qdict_get_str(input
, "execute");
4317 if (invalid_qmp_mode(mon
, cmd_name
)) {
4318 qerror_report(QERR_COMMAND_NOT_FOUND
, cmd_name
);
4323 * XXX: We need this special case until we get info handlers
4324 * converted into 'query-' commands
4326 if (compare_cmd(cmd_name
, "info")) {
4327 qerror_report(QERR_COMMAND_NOT_FOUND
, cmd_name
);
4329 } else if (strstart(cmd_name
, "query-", &info_item
)) {
4330 cmd
= monitor_find_command("info");
4331 qdict_put_obj(input
, "arguments",
4332 qobject_from_jsonf("{ 'item': %s }", info_item
));
4334 cmd
= monitor_find_command(cmd_name
);
4335 if (!cmd
|| !monitor_handler_ported(cmd
)
4336 || monitor_cmd_user_only(cmd
)) {
4337 qerror_report(QERR_COMMAND_NOT_FOUND
, cmd_name
);
4342 obj
= qdict_get(input
, "arguments");
4346 args
= qobject_to_qdict(obj
);
4350 err
= qmp_check_client_args(cmd
, args
);
4355 if (monitor_handler_is_async(cmd
)) {
4356 err
= qmp_async_cmd_handler(mon
, cmd
, args
);
4358 /* emit the error response */
4362 monitor_call_handler(mon
, cmd
, args
);
4368 monitor_protocol_emitter(mon
, NULL
);
4375 * monitor_control_read(): Read and handle QMP input
4377 static void monitor_control_read(void *opaque
, const uint8_t *buf
, int size
)
4379 Monitor
*old_mon
= cur_mon
;
4383 json_message_parser_feed(&cur_mon
->mc
->parser
, (const char *) buf
, size
);
4388 static void monitor_read(void *opaque
, const uint8_t *buf
, int size
)
4390 Monitor
*old_mon
= cur_mon
;
4396 for (i
= 0; i
< size
; i
++)
4397 readline_handle_byte(cur_mon
->rs
, buf
[i
]);
4399 if (size
== 0 || buf
[size
- 1] != 0)
4400 monitor_printf(cur_mon
, "corrupted command\n");
4402 handle_user_command(cur_mon
, (char *)buf
);
4408 static void monitor_command_cb(Monitor
*mon
, const char *cmdline
, void *opaque
)
4410 monitor_suspend(mon
);
4411 handle_user_command(mon
, cmdline
);
4412 monitor_resume(mon
);
4415 int monitor_suspend(Monitor
*mon
)
4423 void monitor_resume(Monitor
*mon
)
4427 if (--mon
->suspend_cnt
== 0)
4428 readline_show_prompt(mon
->rs
);
4431 static QObject
*get_qmp_greeting(void)
4435 do_info_version(NULL
, &ver
);
4436 return qobject_from_jsonf("{'QMP':{'version': %p,'capabilities': []}}",ver
);
4440 * monitor_control_event(): Print QMP gretting
4442 static void monitor_control_event(void *opaque
, int event
)
4445 Monitor
*mon
= opaque
;
4448 case CHR_EVENT_OPENED
:
4449 mon
->mc
->command_mode
= 0;
4450 json_message_parser_init(&mon
->mc
->parser
, handle_qmp_command
);
4451 data
= get_qmp_greeting();
4452 monitor_json_emitter(mon
, data
);
4453 qobject_decref(data
);
4455 case CHR_EVENT_CLOSED
:
4456 json_message_parser_destroy(&mon
->mc
->parser
);
4461 static void monitor_event(void *opaque
, int event
)
4463 Monitor
*mon
= opaque
;
4466 case CHR_EVENT_MUX_IN
:
4468 if (mon
->reset_seen
) {
4469 readline_restart(mon
->rs
);
4470 monitor_resume(mon
);
4473 mon
->suspend_cnt
= 0;
4477 case CHR_EVENT_MUX_OUT
:
4478 if (mon
->reset_seen
) {
4479 if (mon
->suspend_cnt
== 0) {
4480 monitor_printf(mon
, "\n");
4483 monitor_suspend(mon
);
4490 case CHR_EVENT_OPENED
:
4491 monitor_printf(mon
, "QEMU %s monitor - type 'help' for more "
4492 "information\n", QEMU_VERSION
);
4493 if (!mon
->mux_out
) {
4494 readline_show_prompt(mon
->rs
);
4496 mon
->reset_seen
= 1;
4510 void monitor_init(CharDriverState
*chr
, int flags
)
4512 static int is_first_init
= 1;
4515 if (is_first_init
) {
4516 key_timer
= qemu_new_timer(vm_clock
, release_keys
, NULL
);
4520 mon
= qemu_mallocz(sizeof(*mon
));
4524 if (flags
& MONITOR_USE_READLINE
) {
4525 mon
->rs
= readline_init(mon
, monitor_find_completion
);
4526 monitor_read_command(mon
, 0);
4529 if (monitor_ctrl_mode(mon
)) {
4530 mon
->mc
= qemu_mallocz(sizeof(MonitorControl
));
4531 /* Control mode requires special handlers */
4532 qemu_chr_add_handlers(chr
, monitor_can_read
, monitor_control_read
,
4533 monitor_control_event
, mon
);
4535 qemu_chr_add_handlers(chr
, monitor_can_read
, monitor_read
,
4536 monitor_event
, mon
);
4539 QLIST_INSERT_HEAD(&mon_list
, mon
, entry
);
4540 if (!default_mon
|| (flags
& MONITOR_IS_DEFAULT
))
4544 static void bdrv_password_cb(Monitor
*mon
, const char *password
, void *opaque
)
4546 BlockDriverState
*bs
= opaque
;
4549 if (bdrv_set_key(bs
, password
) != 0) {
4550 monitor_printf(mon
, "invalid password\n");
4553 if (mon
->password_completion_cb
)
4554 mon
->password_completion_cb(mon
->password_opaque
, ret
);
4556 monitor_read_command(mon
, 1);
4559 int monitor_read_bdrv_key_start(Monitor
*mon
, BlockDriverState
*bs
,
4560 BlockDriverCompletionFunc
*completion_cb
,
4565 if (!bdrv_key_required(bs
)) {
4567 completion_cb(opaque
, 0);
4571 if (monitor_ctrl_mode(mon
)) {
4572 qerror_report(QERR_DEVICE_ENCRYPTED
, bdrv_get_device_name(bs
));
4576 monitor_printf(mon
, "%s (%s) is encrypted.\n", bdrv_get_device_name(bs
),
4577 bdrv_get_encrypted_filename(bs
));
4579 mon
->password_completion_cb
= completion_cb
;
4580 mon
->password_opaque
= opaque
;
4582 err
= monitor_read_password(mon
, bdrv_password_cb
, bs
);
4584 if (err
&& completion_cb
)
4585 completion_cb(opaque
, err
);