configure: add logging
[qemu/wangdongxu.git] / monitor.c
blobe602480ebb39bb15aae749d09fd5d9089074ef79
1 /*
2 * QEMU monitor
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
22 * THE SOFTWARE.
24 #include <dirent.h>
25 #include "hw/hw.h"
26 #include "hw/qdev.h"
27 #include "hw/usb.h"
28 #include "hw/pcmcia.h"
29 #include "hw/pc.h"
30 #include "hw/pci.h"
31 #include "hw/watchdog.h"
32 #include "hw/loader.h"
33 #include "gdbstub.h"
34 #include "net.h"
35 #include "net/slirp.h"
36 #include "qemu-char.h"
37 #include "sysemu.h"
38 #include "monitor.h"
39 #include "readline.h"
40 #include "console.h"
41 #include "blockdev.h"
42 #include "audio/audio.h"
43 #include "disas.h"
44 #include "balloon.h"
45 #include "qemu-timer.h"
46 #include "migration.h"
47 #include "kvm.h"
48 #include "acl.h"
49 #include "qint.h"
50 #include "qfloat.h"
51 #include "qlist.h"
52 #include "qbool.h"
53 #include "qstring.h"
54 #include "qjson.h"
55 #include "json-streamer.h"
56 #include "json-parser.h"
57 #include "osdep.h"
58 #include "exec-all.h"
59 #ifdef CONFIG_SIMPLE_TRACE
60 #include "trace.h"
61 #endif
63 //#define DEBUG
64 //#define DEBUG_COMPLETION
67 * Supported types:
69 * 'F' filename
70 * 'B' block device name
71 * 's' string (accept optional quote)
72 * 'O' option string of the form NAME=VALUE,...
73 * parsed according to QemuOptsList given by its name
74 * Example: 'device:O' uses qemu_device_opts.
75 * Restriction: only lists with empty desc are supported
76 * TODO lift the restriction
77 * 'i' 32 bit integer
78 * 'l' target long (32 or 64 bit)
79 * 'M' just like 'l', except in user mode the value is
80 * multiplied by 2^20 (think Mebibyte)
81 * 'f' double
82 * user mode accepts an optional G, g, M, m, K, k suffix,
83 * which multiplies the value by 2^30 for suffixes G and
84 * g, 2^20 for M and m, 2^10 for K and k
85 * 'T' double
86 * user mode accepts an optional ms, us, ns suffix,
87 * which divides the value by 1e3, 1e6, 1e9, respectively
88 * '/' optional gdb-like print format (like "/10x")
90 * '?' optional type (for all types, except '/')
91 * '.' other form of optional type (for 'i' and 'l')
92 * 'b' boolean
93 * user mode accepts "on" or "off"
94 * '-' optional parameter (eg. '-f')
98 typedef struct MonitorCompletionData MonitorCompletionData;
99 struct MonitorCompletionData {
100 Monitor *mon;
101 void (*user_print)(Monitor *mon, const QObject *data);
104 typedef struct mon_cmd_t {
105 const char *name;
106 const char *args_type;
107 const char *params;
108 const char *help;
109 void (*user_print)(Monitor *mon, const QObject *data);
110 union {
111 void (*info)(Monitor *mon);
112 void (*info_new)(Monitor *mon, QObject **ret_data);
113 int (*info_async)(Monitor *mon, MonitorCompletion *cb, void *opaque);
114 void (*cmd)(Monitor *mon, const QDict *qdict);
115 int (*cmd_new)(Monitor *mon, const QDict *params, QObject **ret_data);
116 int (*cmd_async)(Monitor *mon, const QDict *params,
117 MonitorCompletion *cb, void *opaque);
118 } mhandler;
119 int flags;
120 } mon_cmd_t;
122 /* file descriptors passed via SCM_RIGHTS */
123 typedef struct mon_fd_t mon_fd_t;
124 struct mon_fd_t {
125 char *name;
126 int fd;
127 QLIST_ENTRY(mon_fd_t) next;
130 typedef struct MonitorControl {
131 QObject *id;
132 JSONMessageParser parser;
133 int command_mode;
134 } MonitorControl;
136 struct Monitor {
137 CharDriverState *chr;
138 int mux_out;
139 int reset_seen;
140 int flags;
141 int suspend_cnt;
142 uint8_t outbuf[1024];
143 int outbuf_index;
144 ReadLineState *rs;
145 MonitorControl *mc;
146 CPUState *mon_cpu;
147 BlockDriverCompletionFunc *password_completion_cb;
148 void *password_opaque;
149 #ifdef CONFIG_DEBUG_MONITOR
150 int print_calls_nr;
151 #endif
152 QError *error;
153 QLIST_HEAD(,mon_fd_t) fds;
154 QLIST_ENTRY(Monitor) entry;
157 #ifdef CONFIG_DEBUG_MONITOR
158 #define MON_DEBUG(fmt, ...) do { \
159 fprintf(stderr, "Monitor: "); \
160 fprintf(stderr, fmt, ## __VA_ARGS__); } while (0)
162 static inline void mon_print_count_inc(Monitor *mon)
164 mon->print_calls_nr++;
167 static inline void mon_print_count_init(Monitor *mon)
169 mon->print_calls_nr = 0;
172 static inline int mon_print_count_get(const Monitor *mon)
174 return mon->print_calls_nr;
177 #else /* !CONFIG_DEBUG_MONITOR */
178 #define MON_DEBUG(fmt, ...) do { } while (0)
179 static inline void mon_print_count_inc(Monitor *mon) { }
180 static inline void mon_print_count_init(Monitor *mon) { }
181 static inline int mon_print_count_get(const Monitor *mon) { return 0; }
182 #endif /* CONFIG_DEBUG_MONITOR */
184 /* QMP checker flags */
185 #define QMP_ACCEPT_UNKNOWNS 1
187 static QLIST_HEAD(mon_list, Monitor) mon_list;
189 static const mon_cmd_t mon_cmds[];
190 static const mon_cmd_t info_cmds[];
192 Monitor *cur_mon;
193 Monitor *default_mon;
195 static void monitor_command_cb(Monitor *mon, const char *cmdline,
196 void *opaque);
198 static inline int qmp_cmd_mode(const Monitor *mon)
200 return (mon->mc ? mon->mc->command_mode : 0);
203 /* Return true if in control mode, false otherwise */
204 static inline int monitor_ctrl_mode(const Monitor *mon)
206 return (mon->flags & MONITOR_USE_CONTROL);
209 /* Return non-zero iff we have a current monitor, and it is in QMP mode. */
210 int monitor_cur_is_qmp(void)
212 return cur_mon && monitor_ctrl_mode(cur_mon);
215 static void monitor_read_command(Monitor *mon, int show_prompt)
217 if (!mon->rs)
218 return;
220 readline_start(mon->rs, "(qemu) ", 0, monitor_command_cb, NULL);
221 if (show_prompt)
222 readline_show_prompt(mon->rs);
225 static int monitor_read_password(Monitor *mon, ReadLineFunc *readline_func,
226 void *opaque)
228 if (monitor_ctrl_mode(mon)) {
229 qerror_report(QERR_MISSING_PARAMETER, "password");
230 return -EINVAL;
231 } else if (mon->rs) {
232 readline_start(mon->rs, "Password: ", 1, readline_func, opaque);
233 /* prompt is printed on return from the command handler */
234 return 0;
235 } else {
236 monitor_printf(mon, "terminal does not support password prompting\n");
237 return -ENOTTY;
241 void monitor_flush(Monitor *mon)
243 if (mon && mon->outbuf_index != 0 && !mon->mux_out) {
244 qemu_chr_write(mon->chr, mon->outbuf, mon->outbuf_index);
245 mon->outbuf_index = 0;
249 /* flush at every end of line or if the buffer is full */
250 static void monitor_puts(Monitor *mon, const char *str)
252 char c;
254 for(;;) {
255 c = *str++;
256 if (c == '\0')
257 break;
258 if (c == '\n')
259 mon->outbuf[mon->outbuf_index++] = '\r';
260 mon->outbuf[mon->outbuf_index++] = c;
261 if (mon->outbuf_index >= (sizeof(mon->outbuf) - 1)
262 || c == '\n')
263 monitor_flush(mon);
267 void monitor_vprintf(Monitor *mon, const char *fmt, va_list ap)
269 char buf[4096];
271 if (!mon)
272 return;
274 mon_print_count_inc(mon);
276 if (monitor_ctrl_mode(mon)) {
277 return;
280 vsnprintf(buf, sizeof(buf), fmt, ap);
281 monitor_puts(mon, buf);
284 void monitor_printf(Monitor *mon, const char *fmt, ...)
286 va_list ap;
287 va_start(ap, fmt);
288 monitor_vprintf(mon, fmt, ap);
289 va_end(ap);
292 void monitor_print_filename(Monitor *mon, const char *filename)
294 int i;
296 for (i = 0; filename[i]; i++) {
297 switch (filename[i]) {
298 case ' ':
299 case '"':
300 case '\\':
301 monitor_printf(mon, "\\%c", filename[i]);
302 break;
303 case '\t':
304 monitor_printf(mon, "\\t");
305 break;
306 case '\r':
307 monitor_printf(mon, "\\r");
308 break;
309 case '\n':
310 monitor_printf(mon, "\\n");
311 break;
312 default:
313 monitor_printf(mon, "%c", filename[i]);
314 break;
319 static int monitor_fprintf(FILE *stream, const char *fmt, ...)
321 va_list ap;
322 va_start(ap, fmt);
323 monitor_vprintf((Monitor *)stream, fmt, ap);
324 va_end(ap);
325 return 0;
328 static void monitor_user_noop(Monitor *mon, const QObject *data) { }
330 static inline int monitor_handler_ported(const mon_cmd_t *cmd)
332 return cmd->user_print != NULL;
335 static inline bool monitor_handler_is_async(const mon_cmd_t *cmd)
337 return cmd->flags & MONITOR_CMD_ASYNC;
340 static inline bool monitor_cmd_user_only(const mon_cmd_t *cmd)
342 return (cmd->flags & MONITOR_CMD_USER_ONLY);
345 static inline int monitor_has_error(const Monitor *mon)
347 return mon->error != NULL;
350 static void monitor_json_emitter(Monitor *mon, const QObject *data)
352 QString *json;
354 json = qobject_to_json(data);
355 assert(json != NULL);
357 qstring_append_chr(json, '\n');
358 monitor_puts(mon, qstring_get_str(json));
360 QDECREF(json);
363 static void monitor_protocol_emitter(Monitor *mon, QObject *data)
365 QDict *qmp;
367 qmp = qdict_new();
369 if (!monitor_has_error(mon)) {
370 /* success response */
371 if (data) {
372 qobject_incref(data);
373 qdict_put_obj(qmp, "return", data);
374 } else {
375 /* return an empty QDict by default */
376 qdict_put(qmp, "return", qdict_new());
378 } else {
379 /* error response */
380 qdict_put(mon->error->error, "desc", qerror_human(mon->error));
381 qdict_put(qmp, "error", mon->error->error);
382 QINCREF(mon->error->error);
383 QDECREF(mon->error);
384 mon->error = NULL;
387 if (mon->mc->id) {
388 qdict_put_obj(qmp, "id", mon->mc->id);
389 mon->mc->id = NULL;
392 monitor_json_emitter(mon, QOBJECT(qmp));
393 QDECREF(qmp);
396 static void timestamp_put(QDict *qdict)
398 int err;
399 QObject *obj;
400 qemu_timeval tv;
402 err = qemu_gettimeofday(&tv);
403 if (err < 0)
404 return;
406 obj = qobject_from_jsonf("{ 'seconds': %" PRId64 ", "
407 "'microseconds': %" PRId64 " }",
408 (int64_t) tv.tv_sec, (int64_t) tv.tv_usec);
409 qdict_put_obj(qdict, "timestamp", obj);
413 * monitor_protocol_event(): Generate a Monitor event
415 * Event-specific data can be emitted through the (optional) 'data' parameter.
417 void monitor_protocol_event(MonitorEvent event, QObject *data)
419 QDict *qmp;
420 const char *event_name;
421 Monitor *mon;
423 assert(event < QEVENT_MAX);
425 switch (event) {
426 case QEVENT_SHUTDOWN:
427 event_name = "SHUTDOWN";
428 break;
429 case QEVENT_RESET:
430 event_name = "RESET";
431 break;
432 case QEVENT_POWERDOWN:
433 event_name = "POWERDOWN";
434 break;
435 case QEVENT_STOP:
436 event_name = "STOP";
437 break;
438 case QEVENT_RESUME:
439 event_name = "RESUME";
440 break;
441 case QEVENT_VNC_CONNECTED:
442 event_name = "VNC_CONNECTED";
443 break;
444 case QEVENT_VNC_INITIALIZED:
445 event_name = "VNC_INITIALIZED";
446 break;
447 case QEVENT_VNC_DISCONNECTED:
448 event_name = "VNC_DISCONNECTED";
449 break;
450 case QEVENT_BLOCK_IO_ERROR:
451 event_name = "BLOCK_IO_ERROR";
452 break;
453 case QEVENT_RTC_CHANGE:
454 event_name = "RTC_CHANGE";
455 break;
456 case QEVENT_WATCHDOG:
457 event_name = "WATCHDOG";
458 break;
459 default:
460 abort();
461 break;
464 qmp = qdict_new();
465 timestamp_put(qmp);
466 qdict_put(qmp, "event", qstring_from_str(event_name));
467 if (data) {
468 qobject_incref(data);
469 qdict_put_obj(qmp, "data", data);
472 QLIST_FOREACH(mon, &mon_list, entry) {
473 if (monitor_ctrl_mode(mon) && qmp_cmd_mode(mon)) {
474 monitor_json_emitter(mon, QOBJECT(qmp));
477 QDECREF(qmp);
480 static int do_qmp_capabilities(Monitor *mon, const QDict *params,
481 QObject **ret_data)
483 /* Will setup QMP capabilities in the future */
484 if (monitor_ctrl_mode(mon)) {
485 mon->mc->command_mode = 1;
488 return 0;
491 static int compare_cmd(const char *name, const char *list)
493 const char *p, *pstart;
494 int len;
495 len = strlen(name);
496 p = list;
497 for(;;) {
498 pstart = p;
499 p = strchr(p, '|');
500 if (!p)
501 p = pstart + strlen(pstart);
502 if ((p - pstart) == len && !memcmp(pstart, name, len))
503 return 1;
504 if (*p == '\0')
505 break;
506 p++;
508 return 0;
511 static void help_cmd_dump(Monitor *mon, const mon_cmd_t *cmds,
512 const char *prefix, const char *name)
514 const mon_cmd_t *cmd;
516 for(cmd = cmds; cmd->name != NULL; cmd++) {
517 if (!name || !strcmp(name, cmd->name))
518 monitor_printf(mon, "%s%s %s -- %s\n", prefix, cmd->name,
519 cmd->params, cmd->help);
523 static void help_cmd(Monitor *mon, const char *name)
525 if (name && !strcmp(name, "info")) {
526 help_cmd_dump(mon, info_cmds, "info ", NULL);
527 } else {
528 help_cmd_dump(mon, mon_cmds, "", name);
529 if (name && !strcmp(name, "log")) {
530 const CPULogItem *item;
531 monitor_printf(mon, "Log items (comma separated):\n");
532 monitor_printf(mon, "%-10s %s\n", "none", "remove all logs");
533 for(item = cpu_log_items; item->mask != 0; item++) {
534 monitor_printf(mon, "%-10s %s\n", item->name, item->help);
540 static void do_help_cmd(Monitor *mon, const QDict *qdict)
542 help_cmd(mon, qdict_get_try_str(qdict, "name"));
545 #ifdef CONFIG_SIMPLE_TRACE
546 static void do_change_trace_event_state(Monitor *mon, const QDict *qdict)
548 const char *tp_name = qdict_get_str(qdict, "name");
549 bool new_state = qdict_get_bool(qdict, "option");
550 st_change_trace_event_state(tp_name, new_state);
553 static void do_trace_file(Monitor *mon, const QDict *qdict)
555 const char *op = qdict_get_try_str(qdict, "op");
556 const char *arg = qdict_get_try_str(qdict, "arg");
558 if (!op) {
559 st_print_trace_file_status((FILE *)mon, &monitor_fprintf);
560 } else if (!strcmp(op, "on")) {
561 st_set_trace_file_enabled(true);
562 } else if (!strcmp(op, "off")) {
563 st_set_trace_file_enabled(false);
564 } else if (!strcmp(op, "flush")) {
565 st_flush_trace_buffer();
566 } else if (!strcmp(op, "set")) {
567 if (arg) {
568 st_set_trace_file(arg);
570 } else {
571 monitor_printf(mon, "unexpected argument \"%s\"\n", op);
572 help_cmd(mon, "trace-file");
575 #endif
577 static void user_monitor_complete(void *opaque, QObject *ret_data)
579 MonitorCompletionData *data = (MonitorCompletionData *)opaque;
581 if (ret_data) {
582 data->user_print(data->mon, ret_data);
584 monitor_resume(data->mon);
585 qemu_free(data);
588 static void qmp_monitor_complete(void *opaque, QObject *ret_data)
590 monitor_protocol_emitter(opaque, ret_data);
593 static int qmp_async_cmd_handler(Monitor *mon, const mon_cmd_t *cmd,
594 const QDict *params)
596 return cmd->mhandler.cmd_async(mon, params, qmp_monitor_complete, mon);
599 static void qmp_async_info_handler(Monitor *mon, const mon_cmd_t *cmd)
601 cmd->mhandler.info_async(mon, qmp_monitor_complete, mon);
604 static void user_async_cmd_handler(Monitor *mon, const mon_cmd_t *cmd,
605 const QDict *params)
607 int ret;
609 MonitorCompletionData *cb_data = qemu_malloc(sizeof(*cb_data));
610 cb_data->mon = mon;
611 cb_data->user_print = cmd->user_print;
612 monitor_suspend(mon);
613 ret = cmd->mhandler.cmd_async(mon, params,
614 user_monitor_complete, cb_data);
615 if (ret < 0) {
616 monitor_resume(mon);
617 qemu_free(cb_data);
621 static void user_async_info_handler(Monitor *mon, const mon_cmd_t *cmd)
623 int ret;
625 MonitorCompletionData *cb_data = qemu_malloc(sizeof(*cb_data));
626 cb_data->mon = mon;
627 cb_data->user_print = cmd->user_print;
628 monitor_suspend(mon);
629 ret = cmd->mhandler.info_async(mon, user_monitor_complete, cb_data);
630 if (ret < 0) {
631 monitor_resume(mon);
632 qemu_free(cb_data);
636 static int do_info(Monitor *mon, const QDict *qdict, QObject **ret_data)
638 const mon_cmd_t *cmd;
639 const char *item = qdict_get_try_str(qdict, "item");
641 if (!item) {
642 assert(monitor_ctrl_mode(mon) == 0);
643 goto help;
646 for (cmd = info_cmds; cmd->name != NULL; cmd++) {
647 if (compare_cmd(item, cmd->name))
648 break;
651 if (cmd->name == NULL) {
652 if (monitor_ctrl_mode(mon)) {
653 qerror_report(QERR_COMMAND_NOT_FOUND, item);
654 return -1;
656 goto help;
659 if (monitor_ctrl_mode(mon) && monitor_cmd_user_only(cmd)) {
660 qerror_report(QERR_COMMAND_NOT_FOUND, item);
661 return -1;
664 if (monitor_handler_is_async(cmd)) {
665 if (monitor_ctrl_mode(mon)) {
666 qmp_async_info_handler(mon, cmd);
667 } else {
668 user_async_info_handler(mon, cmd);
671 * Indicate that this command is asynchronous and will not return any
672 * data (not even empty). Instead, the data will be returned via a
673 * completion callback.
675 *ret_data = qobject_from_jsonf("{ '__mon_async': 'return' }");
676 } else if (monitor_handler_ported(cmd)) {
677 cmd->mhandler.info_new(mon, ret_data);
679 if (!monitor_ctrl_mode(mon)) {
681 * User Protocol function is called here, Monitor Protocol is
682 * handled by monitor_call_handler()
684 if (*ret_data)
685 cmd->user_print(mon, *ret_data);
687 } else {
688 if (monitor_ctrl_mode(mon)) {
689 /* handler not converted yet */
690 qerror_report(QERR_COMMAND_NOT_FOUND, item);
691 return -1;
692 } else {
693 cmd->mhandler.info(mon);
697 return 0;
699 help:
700 help_cmd(mon, "info");
701 return 0;
704 static void do_info_version_print(Monitor *mon, const QObject *data)
706 QDict *qdict;
707 QDict *qemu;
709 qdict = qobject_to_qdict(data);
710 qemu = qdict_get_qdict(qdict, "qemu");
712 monitor_printf(mon, "%" PRId64 ".%" PRId64 ".%" PRId64 "%s\n",
713 qdict_get_int(qemu, "major"),
714 qdict_get_int(qemu, "minor"),
715 qdict_get_int(qemu, "micro"),
716 qdict_get_str(qdict, "package"));
719 static void do_info_version(Monitor *mon, QObject **ret_data)
721 const char *version = QEMU_VERSION;
722 int major = 0, minor = 0, micro = 0;
723 char *tmp;
725 major = strtol(version, &tmp, 10);
726 tmp++;
727 minor = strtol(tmp, &tmp, 10);
728 tmp++;
729 micro = strtol(tmp, &tmp, 10);
731 *ret_data = qobject_from_jsonf("{ 'qemu': { 'major': %d, 'minor': %d, \
732 'micro': %d }, 'package': %s }", major, minor, micro, QEMU_PKGVERSION);
735 static void do_info_name_print(Monitor *mon, const QObject *data)
737 QDict *qdict;
739 qdict = qobject_to_qdict(data);
740 if (qdict_size(qdict) == 0) {
741 return;
744 monitor_printf(mon, "%s\n", qdict_get_str(qdict, "name"));
747 static void do_info_name(Monitor *mon, QObject **ret_data)
749 *ret_data = qemu_name ? qobject_from_jsonf("{'name': %s }", qemu_name) :
750 qobject_from_jsonf("{}");
753 static QObject *get_cmd_dict(const char *name)
755 const char *p;
757 /* Remove '|' from some commands */
758 p = strchr(name, '|');
759 if (p) {
760 p++;
761 } else {
762 p = name;
765 return qobject_from_jsonf("{ 'name': %s }", p);
768 static void do_info_commands(Monitor *mon, QObject **ret_data)
770 QList *cmd_list;
771 const mon_cmd_t *cmd;
773 cmd_list = qlist_new();
775 for (cmd = mon_cmds; cmd->name != NULL; cmd++) {
776 if (monitor_handler_ported(cmd) && !monitor_cmd_user_only(cmd) &&
777 !compare_cmd(cmd->name, "info")) {
778 qlist_append_obj(cmd_list, get_cmd_dict(cmd->name));
782 for (cmd = info_cmds; cmd->name != NULL; cmd++) {
783 if (monitor_handler_ported(cmd) && !monitor_cmd_user_only(cmd)) {
784 char buf[128];
785 snprintf(buf, sizeof(buf), "query-%s", cmd->name);
786 qlist_append_obj(cmd_list, get_cmd_dict(buf));
790 *ret_data = QOBJECT(cmd_list);
793 static void do_info_uuid_print(Monitor *mon, const QObject *data)
795 monitor_printf(mon, "%s\n", qdict_get_str(qobject_to_qdict(data), "UUID"));
798 static void do_info_uuid(Monitor *mon, QObject **ret_data)
800 char uuid[64];
802 snprintf(uuid, sizeof(uuid), UUID_FMT, qemu_uuid[0], qemu_uuid[1],
803 qemu_uuid[2], qemu_uuid[3], qemu_uuid[4], qemu_uuid[5],
804 qemu_uuid[6], qemu_uuid[7], qemu_uuid[8], qemu_uuid[9],
805 qemu_uuid[10], qemu_uuid[11], qemu_uuid[12], qemu_uuid[13],
806 qemu_uuid[14], qemu_uuid[15]);
807 *ret_data = qobject_from_jsonf("{ 'UUID': %s }", uuid);
810 /* get the current CPU defined by the user */
811 static int mon_set_cpu(int cpu_index)
813 CPUState *env;
815 for(env = first_cpu; env != NULL; env = env->next_cpu) {
816 if (env->cpu_index == cpu_index) {
817 cur_mon->mon_cpu = env;
818 return 0;
821 return -1;
824 static CPUState *mon_get_cpu(void)
826 if (!cur_mon->mon_cpu) {
827 mon_set_cpu(0);
829 cpu_synchronize_state(cur_mon->mon_cpu);
830 return cur_mon->mon_cpu;
833 static void do_info_registers(Monitor *mon)
835 CPUState *env;
836 env = mon_get_cpu();
837 #ifdef TARGET_I386
838 cpu_dump_state(env, (FILE *)mon, monitor_fprintf,
839 X86_DUMP_FPU);
840 #else
841 cpu_dump_state(env, (FILE *)mon, monitor_fprintf,
843 #endif
846 static void print_cpu_iter(QObject *obj, void *opaque)
848 QDict *cpu;
849 int active = ' ';
850 Monitor *mon = opaque;
852 assert(qobject_type(obj) == QTYPE_QDICT);
853 cpu = qobject_to_qdict(obj);
855 if (qdict_get_bool(cpu, "current")) {
856 active = '*';
859 monitor_printf(mon, "%c CPU #%d: ", active, (int)qdict_get_int(cpu, "CPU"));
861 #if defined(TARGET_I386)
862 monitor_printf(mon, "pc=0x" TARGET_FMT_lx,
863 (target_ulong) qdict_get_int(cpu, "pc"));
864 #elif defined(TARGET_PPC)
865 monitor_printf(mon, "nip=0x" TARGET_FMT_lx,
866 (target_long) qdict_get_int(cpu, "nip"));
867 #elif defined(TARGET_SPARC)
868 monitor_printf(mon, "pc=0x " TARGET_FMT_lx,
869 (target_long) qdict_get_int(cpu, "pc"));
870 monitor_printf(mon, "npc=0x" TARGET_FMT_lx,
871 (target_long) qdict_get_int(cpu, "npc"));
872 #elif defined(TARGET_MIPS)
873 monitor_printf(mon, "PC=0x" TARGET_FMT_lx,
874 (target_long) qdict_get_int(cpu, "PC"));
875 #endif
877 if (qdict_get_bool(cpu, "halted")) {
878 monitor_printf(mon, " (halted)");
881 monitor_printf(mon, "\n");
884 static void monitor_print_cpus(Monitor *mon, const QObject *data)
886 QList *cpu_list;
888 assert(qobject_type(data) == QTYPE_QLIST);
889 cpu_list = qobject_to_qlist(data);
890 qlist_iter(cpu_list, print_cpu_iter, mon);
893 static void do_info_cpus(Monitor *mon, QObject **ret_data)
895 CPUState *env;
896 QList *cpu_list;
898 cpu_list = qlist_new();
900 /* just to set the default cpu if not already done */
901 mon_get_cpu();
903 for(env = first_cpu; env != NULL; env = env->next_cpu) {
904 QDict *cpu;
905 QObject *obj;
907 cpu_synchronize_state(env);
909 obj = qobject_from_jsonf("{ 'CPU': %d, 'current': %i, 'halted': %i }",
910 env->cpu_index, env == mon->mon_cpu,
911 env->halted);
913 cpu = qobject_to_qdict(obj);
915 #if defined(TARGET_I386)
916 qdict_put(cpu, "pc", qint_from_int(env->eip + env->segs[R_CS].base));
917 #elif defined(TARGET_PPC)
918 qdict_put(cpu, "nip", qint_from_int(env->nip));
919 #elif defined(TARGET_SPARC)
920 qdict_put(cpu, "pc", qint_from_int(env->pc));
921 qdict_put(cpu, "npc", qint_from_int(env->npc));
922 #elif defined(TARGET_MIPS)
923 qdict_put(cpu, "PC", qint_from_int(env->active_tc.PC));
924 #endif
926 qlist_append(cpu_list, cpu);
929 *ret_data = QOBJECT(cpu_list);
932 static int do_cpu_set(Monitor *mon, const QDict *qdict, QObject **ret_data)
934 int index = qdict_get_int(qdict, "index");
935 if (mon_set_cpu(index) < 0) {
936 qerror_report(QERR_INVALID_PARAMETER_VALUE, "index",
937 "a CPU number");
938 return -1;
940 return 0;
943 static void do_info_jit(Monitor *mon)
945 dump_exec_info((FILE *)mon, monitor_fprintf);
948 static void do_info_history(Monitor *mon)
950 int i;
951 const char *str;
953 if (!mon->rs)
954 return;
955 i = 0;
956 for(;;) {
957 str = readline_get_history(mon->rs, i);
958 if (!str)
959 break;
960 monitor_printf(mon, "%d: '%s'\n", i, str);
961 i++;
965 #if defined(TARGET_PPC)
966 /* XXX: not implemented in other targets */
967 static void do_info_cpu_stats(Monitor *mon)
969 CPUState *env;
971 env = mon_get_cpu();
972 cpu_dump_statistics(env, (FILE *)mon, &monitor_fprintf, 0);
974 #endif
976 #if defined(CONFIG_SIMPLE_TRACE)
977 static void do_info_trace(Monitor *mon)
979 st_print_trace((FILE *)mon, &monitor_fprintf);
982 static void do_info_trace_events(Monitor *mon)
984 st_print_trace_events((FILE *)mon, &monitor_fprintf);
986 #endif
989 * do_quit(): Quit QEMU execution
991 static int do_quit(Monitor *mon, const QDict *qdict, QObject **ret_data)
993 monitor_suspend(mon);
994 no_shutdown = 0;
995 qemu_system_shutdown_request();
997 return 0;
1000 static int change_vnc_password(const char *password)
1002 if (vnc_display_password(NULL, password) < 0) {
1003 qerror_report(QERR_SET_PASSWD_FAILED);
1004 return -1;
1007 return 0;
1010 static void change_vnc_password_cb(Monitor *mon, const char *password,
1011 void *opaque)
1013 change_vnc_password(password);
1014 monitor_read_command(mon, 1);
1017 static int do_change_vnc(Monitor *mon, const char *target, const char *arg)
1019 if (strcmp(target, "passwd") == 0 ||
1020 strcmp(target, "password") == 0) {
1021 if (arg) {
1022 char password[9];
1023 strncpy(password, arg, sizeof(password));
1024 password[sizeof(password) - 1] = '\0';
1025 return change_vnc_password(password);
1026 } else {
1027 return monitor_read_password(mon, change_vnc_password_cb, NULL);
1029 } else {
1030 if (vnc_display_open(NULL, target) < 0) {
1031 qerror_report(QERR_VNC_SERVER_FAILED, target);
1032 return -1;
1036 return 0;
1040 * do_change(): Change a removable medium, or VNC configuration
1042 static int do_change(Monitor *mon, const QDict *qdict, QObject **ret_data)
1044 const char *device = qdict_get_str(qdict, "device");
1045 const char *target = qdict_get_str(qdict, "target");
1046 const char *arg = qdict_get_try_str(qdict, "arg");
1047 int ret;
1049 if (strcmp(device, "vnc") == 0) {
1050 ret = do_change_vnc(mon, target, arg);
1051 } else {
1052 ret = do_change_block(mon, device, target, arg);
1055 return ret;
1058 static int do_screen_dump(Monitor *mon, const QDict *qdict, QObject **ret_data)
1060 vga_hw_screen_dump(qdict_get_str(qdict, "filename"));
1061 return 0;
1064 static void do_logfile(Monitor *mon, const QDict *qdict)
1066 cpu_set_log_filename(qdict_get_str(qdict, "filename"));
1069 static void do_log(Monitor *mon, const QDict *qdict)
1071 int mask;
1072 const char *items = qdict_get_str(qdict, "items");
1074 if (!strcmp(items, "none")) {
1075 mask = 0;
1076 } else {
1077 mask = cpu_str_to_log_mask(items);
1078 if (!mask) {
1079 help_cmd(mon, "log");
1080 return;
1083 cpu_set_log(mask);
1086 static void do_singlestep(Monitor *mon, const QDict *qdict)
1088 const char *option = qdict_get_try_str(qdict, "option");
1089 if (!option || !strcmp(option, "on")) {
1090 singlestep = 1;
1091 } else if (!strcmp(option, "off")) {
1092 singlestep = 0;
1093 } else {
1094 monitor_printf(mon, "unexpected option %s\n", option);
1099 * do_stop(): Stop VM execution
1101 static int do_stop(Monitor *mon, const QDict *qdict, QObject **ret_data)
1103 vm_stop(EXCP_INTERRUPT);
1104 return 0;
1107 static void encrypted_bdrv_it(void *opaque, BlockDriverState *bs);
1109 struct bdrv_iterate_context {
1110 Monitor *mon;
1111 int err;
1115 * do_cont(): Resume emulation.
1117 static int do_cont(Monitor *mon, const QDict *qdict, QObject **ret_data)
1119 struct bdrv_iterate_context context = { mon, 0 };
1121 if (incoming_expected) {
1122 qerror_report(QERR_MIGRATION_EXPECTED);
1123 return -1;
1125 bdrv_iterate(encrypted_bdrv_it, &context);
1126 /* only resume the vm if all keys are set and valid */
1127 if (!context.err) {
1128 vm_start();
1129 return 0;
1130 } else {
1131 return -1;
1135 static void bdrv_key_cb(void *opaque, int err)
1137 Monitor *mon = opaque;
1139 /* another key was set successfully, retry to continue */
1140 if (!err)
1141 do_cont(mon, NULL, NULL);
1144 static void encrypted_bdrv_it(void *opaque, BlockDriverState *bs)
1146 struct bdrv_iterate_context *context = opaque;
1148 if (!context->err && bdrv_key_required(bs)) {
1149 context->err = -EBUSY;
1150 monitor_read_bdrv_key_start(context->mon, bs, bdrv_key_cb,
1151 context->mon);
1155 static void do_gdbserver(Monitor *mon, const QDict *qdict)
1157 const char *device = qdict_get_try_str(qdict, "device");
1158 if (!device)
1159 device = "tcp::" DEFAULT_GDBSTUB_PORT;
1160 if (gdbserver_start(device) < 0) {
1161 monitor_printf(mon, "Could not open gdbserver on device '%s'\n",
1162 device);
1163 } else if (strcmp(device, "none") == 0) {
1164 monitor_printf(mon, "Disabled gdbserver\n");
1165 } else {
1166 monitor_printf(mon, "Waiting for gdb connection on device '%s'\n",
1167 device);
1171 static void do_watchdog_action(Monitor *mon, const QDict *qdict)
1173 const char *action = qdict_get_str(qdict, "action");
1174 if (select_watchdog_action(action) == -1) {
1175 monitor_printf(mon, "Unknown watchdog action '%s'\n", action);
1179 static void monitor_printc(Monitor *mon, int c)
1181 monitor_printf(mon, "'");
1182 switch(c) {
1183 case '\'':
1184 monitor_printf(mon, "\\'");
1185 break;
1186 case '\\':
1187 monitor_printf(mon, "\\\\");
1188 break;
1189 case '\n':
1190 monitor_printf(mon, "\\n");
1191 break;
1192 case '\r':
1193 monitor_printf(mon, "\\r");
1194 break;
1195 default:
1196 if (c >= 32 && c <= 126) {
1197 monitor_printf(mon, "%c", c);
1198 } else {
1199 monitor_printf(mon, "\\x%02x", c);
1201 break;
1203 monitor_printf(mon, "'");
1206 static void memory_dump(Monitor *mon, int count, int format, int wsize,
1207 target_phys_addr_t addr, int is_physical)
1209 CPUState *env;
1210 int l, line_size, i, max_digits, len;
1211 uint8_t buf[16];
1212 uint64_t v;
1214 if (format == 'i') {
1215 int flags;
1216 flags = 0;
1217 env = mon_get_cpu();
1218 #ifdef TARGET_I386
1219 if (wsize == 2) {
1220 flags = 1;
1221 } else if (wsize == 4) {
1222 flags = 0;
1223 } else {
1224 /* as default we use the current CS size */
1225 flags = 0;
1226 if (env) {
1227 #ifdef TARGET_X86_64
1228 if ((env->efer & MSR_EFER_LMA) &&
1229 (env->segs[R_CS].flags & DESC_L_MASK))
1230 flags = 2;
1231 else
1232 #endif
1233 if (!(env->segs[R_CS].flags & DESC_B_MASK))
1234 flags = 1;
1237 #endif
1238 monitor_disas(mon, env, addr, count, is_physical, flags);
1239 return;
1242 len = wsize * count;
1243 if (wsize == 1)
1244 line_size = 8;
1245 else
1246 line_size = 16;
1247 max_digits = 0;
1249 switch(format) {
1250 case 'o':
1251 max_digits = (wsize * 8 + 2) / 3;
1252 break;
1253 default:
1254 case 'x':
1255 max_digits = (wsize * 8) / 4;
1256 break;
1257 case 'u':
1258 case 'd':
1259 max_digits = (wsize * 8 * 10 + 32) / 33;
1260 break;
1261 case 'c':
1262 wsize = 1;
1263 break;
1266 while (len > 0) {
1267 if (is_physical)
1268 monitor_printf(mon, TARGET_FMT_plx ":", addr);
1269 else
1270 monitor_printf(mon, TARGET_FMT_lx ":", (target_ulong)addr);
1271 l = len;
1272 if (l > line_size)
1273 l = line_size;
1274 if (is_physical) {
1275 cpu_physical_memory_rw(addr, buf, l, 0);
1276 } else {
1277 env = mon_get_cpu();
1278 if (cpu_memory_rw_debug(env, addr, buf, l, 0) < 0) {
1279 monitor_printf(mon, " Cannot access memory\n");
1280 break;
1283 i = 0;
1284 while (i < l) {
1285 switch(wsize) {
1286 default:
1287 case 1:
1288 v = ldub_raw(buf + i);
1289 break;
1290 case 2:
1291 v = lduw_raw(buf + i);
1292 break;
1293 case 4:
1294 v = (uint32_t)ldl_raw(buf + i);
1295 break;
1296 case 8:
1297 v = ldq_raw(buf + i);
1298 break;
1300 monitor_printf(mon, " ");
1301 switch(format) {
1302 case 'o':
1303 monitor_printf(mon, "%#*" PRIo64, max_digits, v);
1304 break;
1305 case 'x':
1306 monitor_printf(mon, "0x%0*" PRIx64, max_digits, v);
1307 break;
1308 case 'u':
1309 monitor_printf(mon, "%*" PRIu64, max_digits, v);
1310 break;
1311 case 'd':
1312 monitor_printf(mon, "%*" PRId64, max_digits, v);
1313 break;
1314 case 'c':
1315 monitor_printc(mon, v);
1316 break;
1318 i += wsize;
1320 monitor_printf(mon, "\n");
1321 addr += l;
1322 len -= l;
1326 static void do_memory_dump(Monitor *mon, const QDict *qdict)
1328 int count = qdict_get_int(qdict, "count");
1329 int format = qdict_get_int(qdict, "format");
1330 int size = qdict_get_int(qdict, "size");
1331 target_long addr = qdict_get_int(qdict, "addr");
1333 memory_dump(mon, count, format, size, addr, 0);
1336 static void do_physical_memory_dump(Monitor *mon, const QDict *qdict)
1338 int count = qdict_get_int(qdict, "count");
1339 int format = qdict_get_int(qdict, "format");
1340 int size = qdict_get_int(qdict, "size");
1341 target_phys_addr_t addr = qdict_get_int(qdict, "addr");
1343 memory_dump(mon, count, format, size, addr, 1);
1346 static void do_print(Monitor *mon, const QDict *qdict)
1348 int format = qdict_get_int(qdict, "format");
1349 target_phys_addr_t val = qdict_get_int(qdict, "val");
1351 #if TARGET_PHYS_ADDR_BITS == 32
1352 switch(format) {
1353 case 'o':
1354 monitor_printf(mon, "%#o", val);
1355 break;
1356 case 'x':
1357 monitor_printf(mon, "%#x", val);
1358 break;
1359 case 'u':
1360 monitor_printf(mon, "%u", val);
1361 break;
1362 default:
1363 case 'd':
1364 monitor_printf(mon, "%d", val);
1365 break;
1366 case 'c':
1367 monitor_printc(mon, val);
1368 break;
1370 #else
1371 switch(format) {
1372 case 'o':
1373 monitor_printf(mon, "%#" PRIo64, val);
1374 break;
1375 case 'x':
1376 monitor_printf(mon, "%#" PRIx64, val);
1377 break;
1378 case 'u':
1379 monitor_printf(mon, "%" PRIu64, val);
1380 break;
1381 default:
1382 case 'd':
1383 monitor_printf(mon, "%" PRId64, val);
1384 break;
1385 case 'c':
1386 monitor_printc(mon, val);
1387 break;
1389 #endif
1390 monitor_printf(mon, "\n");
1393 static int do_memory_save(Monitor *mon, const QDict *qdict, QObject **ret_data)
1395 FILE *f;
1396 uint32_t size = qdict_get_int(qdict, "size");
1397 const char *filename = qdict_get_str(qdict, "filename");
1398 target_long addr = qdict_get_int(qdict, "val");
1399 uint32_t l;
1400 CPUState *env;
1401 uint8_t buf[1024];
1402 int ret = -1;
1404 env = mon_get_cpu();
1406 f = fopen(filename, "wb");
1407 if (!f) {
1408 qerror_report(QERR_OPEN_FILE_FAILED, filename);
1409 return -1;
1411 while (size != 0) {
1412 l = sizeof(buf);
1413 if (l > size)
1414 l = size;
1415 cpu_memory_rw_debug(env, addr, buf, l, 0);
1416 if (fwrite(buf, 1, l, f) != l) {
1417 monitor_printf(mon, "fwrite() error in do_memory_save\n");
1418 goto exit;
1420 addr += l;
1421 size -= l;
1424 ret = 0;
1426 exit:
1427 fclose(f);
1428 return ret;
1431 static int do_physical_memory_save(Monitor *mon, const QDict *qdict,
1432 QObject **ret_data)
1434 FILE *f;
1435 uint32_t l;
1436 uint8_t buf[1024];
1437 uint32_t size = qdict_get_int(qdict, "size");
1438 const char *filename = qdict_get_str(qdict, "filename");
1439 target_phys_addr_t addr = qdict_get_int(qdict, "val");
1440 int ret = -1;
1442 f = fopen(filename, "wb");
1443 if (!f) {
1444 qerror_report(QERR_OPEN_FILE_FAILED, filename);
1445 return -1;
1447 while (size != 0) {
1448 l = sizeof(buf);
1449 if (l > size)
1450 l = size;
1451 cpu_physical_memory_rw(addr, buf, l, 0);
1452 if (fwrite(buf, 1, l, f) != l) {
1453 monitor_printf(mon, "fwrite() error in do_physical_memory_save\n");
1454 goto exit;
1456 fflush(f);
1457 addr += l;
1458 size -= l;
1461 ret = 0;
1463 exit:
1464 fclose(f);
1465 return ret;
1468 static void do_sum(Monitor *mon, const QDict *qdict)
1470 uint32_t addr;
1471 uint8_t buf[1];
1472 uint16_t sum;
1473 uint32_t start = qdict_get_int(qdict, "start");
1474 uint32_t size = qdict_get_int(qdict, "size");
1476 sum = 0;
1477 for(addr = start; addr < (start + size); addr++) {
1478 cpu_physical_memory_rw(addr, buf, 1, 0);
1479 /* BSD sum algorithm ('sum' Unix command) */
1480 sum = (sum >> 1) | (sum << 15);
1481 sum += buf[0];
1483 monitor_printf(mon, "%05d\n", sum);
1486 typedef struct {
1487 int keycode;
1488 const char *name;
1489 } KeyDef;
1491 static const KeyDef key_defs[] = {
1492 { 0x2a, "shift" },
1493 { 0x36, "shift_r" },
1495 { 0x38, "alt" },
1496 { 0xb8, "alt_r" },
1497 { 0x64, "altgr" },
1498 { 0xe4, "altgr_r" },
1499 { 0x1d, "ctrl" },
1500 { 0x9d, "ctrl_r" },
1502 { 0xdd, "menu" },
1504 { 0x01, "esc" },
1506 { 0x02, "1" },
1507 { 0x03, "2" },
1508 { 0x04, "3" },
1509 { 0x05, "4" },
1510 { 0x06, "5" },
1511 { 0x07, "6" },
1512 { 0x08, "7" },
1513 { 0x09, "8" },
1514 { 0x0a, "9" },
1515 { 0x0b, "0" },
1516 { 0x0c, "minus" },
1517 { 0x0d, "equal" },
1518 { 0x0e, "backspace" },
1520 { 0x0f, "tab" },
1521 { 0x10, "q" },
1522 { 0x11, "w" },
1523 { 0x12, "e" },
1524 { 0x13, "r" },
1525 { 0x14, "t" },
1526 { 0x15, "y" },
1527 { 0x16, "u" },
1528 { 0x17, "i" },
1529 { 0x18, "o" },
1530 { 0x19, "p" },
1531 { 0x1a, "bracket_left" },
1532 { 0x1b, "bracket_right" },
1533 { 0x1c, "ret" },
1535 { 0x1e, "a" },
1536 { 0x1f, "s" },
1537 { 0x20, "d" },
1538 { 0x21, "f" },
1539 { 0x22, "g" },
1540 { 0x23, "h" },
1541 { 0x24, "j" },
1542 { 0x25, "k" },
1543 { 0x26, "l" },
1544 { 0x27, "semicolon" },
1545 { 0x28, "apostrophe" },
1546 { 0x29, "grave_accent" },
1548 { 0x2b, "backslash" },
1549 { 0x2c, "z" },
1550 { 0x2d, "x" },
1551 { 0x2e, "c" },
1552 { 0x2f, "v" },
1553 { 0x30, "b" },
1554 { 0x31, "n" },
1555 { 0x32, "m" },
1556 { 0x33, "comma" },
1557 { 0x34, "dot" },
1558 { 0x35, "slash" },
1560 { 0x37, "asterisk" },
1562 { 0x39, "spc" },
1563 { 0x3a, "caps_lock" },
1564 { 0x3b, "f1" },
1565 { 0x3c, "f2" },
1566 { 0x3d, "f3" },
1567 { 0x3e, "f4" },
1568 { 0x3f, "f5" },
1569 { 0x40, "f6" },
1570 { 0x41, "f7" },
1571 { 0x42, "f8" },
1572 { 0x43, "f9" },
1573 { 0x44, "f10" },
1574 { 0x45, "num_lock" },
1575 { 0x46, "scroll_lock" },
1577 { 0xb5, "kp_divide" },
1578 { 0x37, "kp_multiply" },
1579 { 0x4a, "kp_subtract" },
1580 { 0x4e, "kp_add" },
1581 { 0x9c, "kp_enter" },
1582 { 0x53, "kp_decimal" },
1583 { 0x54, "sysrq" },
1585 { 0x52, "kp_0" },
1586 { 0x4f, "kp_1" },
1587 { 0x50, "kp_2" },
1588 { 0x51, "kp_3" },
1589 { 0x4b, "kp_4" },
1590 { 0x4c, "kp_5" },
1591 { 0x4d, "kp_6" },
1592 { 0x47, "kp_7" },
1593 { 0x48, "kp_8" },
1594 { 0x49, "kp_9" },
1596 { 0x56, "<" },
1598 { 0x57, "f11" },
1599 { 0x58, "f12" },
1601 { 0xb7, "print" },
1603 { 0xc7, "home" },
1604 { 0xc9, "pgup" },
1605 { 0xd1, "pgdn" },
1606 { 0xcf, "end" },
1608 { 0xcb, "left" },
1609 { 0xc8, "up" },
1610 { 0xd0, "down" },
1611 { 0xcd, "right" },
1613 { 0xd2, "insert" },
1614 { 0xd3, "delete" },
1615 #if defined(TARGET_SPARC) && !defined(TARGET_SPARC64)
1616 { 0xf0, "stop" },
1617 { 0xf1, "again" },
1618 { 0xf2, "props" },
1619 { 0xf3, "undo" },
1620 { 0xf4, "front" },
1621 { 0xf5, "copy" },
1622 { 0xf6, "open" },
1623 { 0xf7, "paste" },
1624 { 0xf8, "find" },
1625 { 0xf9, "cut" },
1626 { 0xfa, "lf" },
1627 { 0xfb, "help" },
1628 { 0xfc, "meta_l" },
1629 { 0xfd, "meta_r" },
1630 { 0xfe, "compose" },
1631 #endif
1632 { 0, NULL },
1635 static int get_keycode(const char *key)
1637 const KeyDef *p;
1638 char *endp;
1639 int ret;
1641 for(p = key_defs; p->name != NULL; p++) {
1642 if (!strcmp(key, p->name))
1643 return p->keycode;
1645 if (strstart(key, "0x", NULL)) {
1646 ret = strtoul(key, &endp, 0);
1647 if (*endp == '\0' && ret >= 0x01 && ret <= 0xff)
1648 return ret;
1650 return -1;
1653 #define MAX_KEYCODES 16
1654 static uint8_t keycodes[MAX_KEYCODES];
1655 static int nb_pending_keycodes;
1656 static QEMUTimer *key_timer;
1658 static void release_keys(void *opaque)
1660 int keycode;
1662 while (nb_pending_keycodes > 0) {
1663 nb_pending_keycodes--;
1664 keycode = keycodes[nb_pending_keycodes];
1665 if (keycode & 0x80)
1666 kbd_put_keycode(0xe0);
1667 kbd_put_keycode(keycode | 0x80);
1671 static void do_sendkey(Monitor *mon, const QDict *qdict)
1673 char keyname_buf[16];
1674 char *separator;
1675 int keyname_len, keycode, i;
1676 const char *string = qdict_get_str(qdict, "string");
1677 int has_hold_time = qdict_haskey(qdict, "hold_time");
1678 int hold_time = qdict_get_try_int(qdict, "hold_time", -1);
1680 if (nb_pending_keycodes > 0) {
1681 qemu_del_timer(key_timer);
1682 release_keys(NULL);
1684 if (!has_hold_time)
1685 hold_time = 100;
1686 i = 0;
1687 while (1) {
1688 separator = strchr(string, '-');
1689 keyname_len = separator ? separator - string : strlen(string);
1690 if (keyname_len > 0) {
1691 pstrcpy(keyname_buf, sizeof(keyname_buf), string);
1692 if (keyname_len > sizeof(keyname_buf) - 1) {
1693 monitor_printf(mon, "invalid key: '%s...'\n", keyname_buf);
1694 return;
1696 if (i == MAX_KEYCODES) {
1697 monitor_printf(mon, "too many keys\n");
1698 return;
1700 keyname_buf[keyname_len] = 0;
1701 keycode = get_keycode(keyname_buf);
1702 if (keycode < 0) {
1703 monitor_printf(mon, "unknown key: '%s'\n", keyname_buf);
1704 return;
1706 keycodes[i++] = keycode;
1708 if (!separator)
1709 break;
1710 string = separator + 1;
1712 nb_pending_keycodes = i;
1713 /* key down events */
1714 for (i = 0; i < nb_pending_keycodes; i++) {
1715 keycode = keycodes[i];
1716 if (keycode & 0x80)
1717 kbd_put_keycode(0xe0);
1718 kbd_put_keycode(keycode & 0x7f);
1720 /* delayed key up events */
1721 qemu_mod_timer(key_timer, qemu_get_clock(vm_clock) +
1722 muldiv64(get_ticks_per_sec(), hold_time, 1000));
1725 static int mouse_button_state;
1727 static void do_mouse_move(Monitor *mon, const QDict *qdict)
1729 int dx, dy, dz;
1730 const char *dx_str = qdict_get_str(qdict, "dx_str");
1731 const char *dy_str = qdict_get_str(qdict, "dy_str");
1732 const char *dz_str = qdict_get_try_str(qdict, "dz_str");
1733 dx = strtol(dx_str, NULL, 0);
1734 dy = strtol(dy_str, NULL, 0);
1735 dz = 0;
1736 if (dz_str)
1737 dz = strtol(dz_str, NULL, 0);
1738 kbd_mouse_event(dx, dy, dz, mouse_button_state);
1741 static void do_mouse_button(Monitor *mon, const QDict *qdict)
1743 int button_state = qdict_get_int(qdict, "button_state");
1744 mouse_button_state = button_state;
1745 kbd_mouse_event(0, 0, 0, mouse_button_state);
1748 static void do_ioport_read(Monitor *mon, const QDict *qdict)
1750 int size = qdict_get_int(qdict, "size");
1751 int addr = qdict_get_int(qdict, "addr");
1752 int has_index = qdict_haskey(qdict, "index");
1753 uint32_t val;
1754 int suffix;
1756 if (has_index) {
1757 int index = qdict_get_int(qdict, "index");
1758 cpu_outb(addr & IOPORTS_MASK, index & 0xff);
1759 addr++;
1761 addr &= 0xffff;
1763 switch(size) {
1764 default:
1765 case 1:
1766 val = cpu_inb(addr);
1767 suffix = 'b';
1768 break;
1769 case 2:
1770 val = cpu_inw(addr);
1771 suffix = 'w';
1772 break;
1773 case 4:
1774 val = cpu_inl(addr);
1775 suffix = 'l';
1776 break;
1778 monitor_printf(mon, "port%c[0x%04x] = %#0*x\n",
1779 suffix, addr, size * 2, val);
1782 static void do_ioport_write(Monitor *mon, const QDict *qdict)
1784 int size = qdict_get_int(qdict, "size");
1785 int addr = qdict_get_int(qdict, "addr");
1786 int val = qdict_get_int(qdict, "val");
1788 addr &= IOPORTS_MASK;
1790 switch (size) {
1791 default:
1792 case 1:
1793 cpu_outb(addr, val);
1794 break;
1795 case 2:
1796 cpu_outw(addr, val);
1797 break;
1798 case 4:
1799 cpu_outl(addr, val);
1800 break;
1804 static void do_boot_set(Monitor *mon, const QDict *qdict)
1806 int res;
1807 const char *bootdevice = qdict_get_str(qdict, "bootdevice");
1809 res = qemu_boot_set(bootdevice);
1810 if (res == 0) {
1811 monitor_printf(mon, "boot device list now set to %s\n", bootdevice);
1812 } else if (res > 0) {
1813 monitor_printf(mon, "setting boot device list failed\n");
1814 } else {
1815 monitor_printf(mon, "no function defined to set boot device list for "
1816 "this architecture\n");
1821 * do_system_reset(): Issue a machine reset
1823 static int do_system_reset(Monitor *mon, const QDict *qdict,
1824 QObject **ret_data)
1826 qemu_system_reset_request();
1827 return 0;
1831 * do_system_powerdown(): Issue a machine powerdown
1833 static int do_system_powerdown(Monitor *mon, const QDict *qdict,
1834 QObject **ret_data)
1836 qemu_system_powerdown_request();
1837 return 0;
1840 #if defined(TARGET_I386)
1841 static void print_pte(Monitor *mon, uint32_t addr, uint32_t pte, uint32_t mask)
1843 monitor_printf(mon, "%08x: %08x %c%c%c%c%c%c%c%c\n",
1844 addr,
1845 pte & mask,
1846 pte & PG_GLOBAL_MASK ? 'G' : '-',
1847 pte & PG_PSE_MASK ? 'P' : '-',
1848 pte & PG_DIRTY_MASK ? 'D' : '-',
1849 pte & PG_ACCESSED_MASK ? 'A' : '-',
1850 pte & PG_PCD_MASK ? 'C' : '-',
1851 pte & PG_PWT_MASK ? 'T' : '-',
1852 pte & PG_USER_MASK ? 'U' : '-',
1853 pte & PG_RW_MASK ? 'W' : '-');
1856 static void tlb_info(Monitor *mon)
1858 CPUState *env;
1859 int l1, l2;
1860 uint32_t pgd, pde, pte;
1862 env = mon_get_cpu();
1864 if (!(env->cr[0] & CR0_PG_MASK)) {
1865 monitor_printf(mon, "PG disabled\n");
1866 return;
1868 pgd = env->cr[3] & ~0xfff;
1869 for(l1 = 0; l1 < 1024; l1++) {
1870 cpu_physical_memory_read(pgd + l1 * 4, (uint8_t *)&pde, 4);
1871 pde = le32_to_cpu(pde);
1872 if (pde & PG_PRESENT_MASK) {
1873 if ((pde & PG_PSE_MASK) && (env->cr[4] & CR4_PSE_MASK)) {
1874 print_pte(mon, (l1 << 22), pde, ~((1 << 20) - 1));
1875 } else {
1876 for(l2 = 0; l2 < 1024; l2++) {
1877 cpu_physical_memory_read((pde & ~0xfff) + l2 * 4,
1878 (uint8_t *)&pte, 4);
1879 pte = le32_to_cpu(pte);
1880 if (pte & PG_PRESENT_MASK) {
1881 print_pte(mon, (l1 << 22) + (l2 << 12),
1882 pte & ~PG_PSE_MASK,
1883 ~0xfff);
1891 static void mem_print(Monitor *mon, uint32_t *pstart, int *plast_prot,
1892 uint32_t end, int prot)
1894 int prot1;
1895 prot1 = *plast_prot;
1896 if (prot != prot1) {
1897 if (*pstart != -1) {
1898 monitor_printf(mon, "%08x-%08x %08x %c%c%c\n",
1899 *pstart, end, end - *pstart,
1900 prot1 & PG_USER_MASK ? 'u' : '-',
1901 'r',
1902 prot1 & PG_RW_MASK ? 'w' : '-');
1904 if (prot != 0)
1905 *pstart = end;
1906 else
1907 *pstart = -1;
1908 *plast_prot = prot;
1912 static void mem_info(Monitor *mon)
1914 CPUState *env;
1915 int l1, l2, prot, last_prot;
1916 uint32_t pgd, pde, pte, start, end;
1918 env = mon_get_cpu();
1920 if (!(env->cr[0] & CR0_PG_MASK)) {
1921 monitor_printf(mon, "PG disabled\n");
1922 return;
1924 pgd = env->cr[3] & ~0xfff;
1925 last_prot = 0;
1926 start = -1;
1927 for(l1 = 0; l1 < 1024; l1++) {
1928 cpu_physical_memory_read(pgd + l1 * 4, (uint8_t *)&pde, 4);
1929 pde = le32_to_cpu(pde);
1930 end = l1 << 22;
1931 if (pde & PG_PRESENT_MASK) {
1932 if ((pde & PG_PSE_MASK) && (env->cr[4] & CR4_PSE_MASK)) {
1933 prot = pde & (PG_USER_MASK | PG_RW_MASK | PG_PRESENT_MASK);
1934 mem_print(mon, &start, &last_prot, end, prot);
1935 } else {
1936 for(l2 = 0; l2 < 1024; l2++) {
1937 cpu_physical_memory_read((pde & ~0xfff) + l2 * 4,
1938 (uint8_t *)&pte, 4);
1939 pte = le32_to_cpu(pte);
1940 end = (l1 << 22) + (l2 << 12);
1941 if (pte & PG_PRESENT_MASK) {
1942 prot = pte & (PG_USER_MASK | PG_RW_MASK | PG_PRESENT_MASK);
1943 } else {
1944 prot = 0;
1946 mem_print(mon, &start, &last_prot, end, prot);
1949 } else {
1950 prot = 0;
1951 mem_print(mon, &start, &last_prot, end, prot);
1955 #endif
1957 #if defined(TARGET_SH4)
1959 static void print_tlb(Monitor *mon, int idx, tlb_t *tlb)
1961 monitor_printf(mon, " tlb%i:\t"
1962 "asid=%hhu vpn=%x\tppn=%x\tsz=%hhu size=%u\t"
1963 "v=%hhu shared=%hhu cached=%hhu prot=%hhu "
1964 "dirty=%hhu writethrough=%hhu\n",
1965 idx,
1966 tlb->asid, tlb->vpn, tlb->ppn, tlb->sz, tlb->size,
1967 tlb->v, tlb->sh, tlb->c, tlb->pr,
1968 tlb->d, tlb->wt);
1971 static void tlb_info(Monitor *mon)
1973 CPUState *env = mon_get_cpu();
1974 int i;
1976 monitor_printf (mon, "ITLB:\n");
1977 for (i = 0 ; i < ITLB_SIZE ; i++)
1978 print_tlb (mon, i, &env->itlb[i]);
1979 monitor_printf (mon, "UTLB:\n");
1980 for (i = 0 ; i < UTLB_SIZE ; i++)
1981 print_tlb (mon, i, &env->utlb[i]);
1984 #endif
1986 static void do_info_kvm_print(Monitor *mon, const QObject *data)
1988 QDict *qdict;
1990 qdict = qobject_to_qdict(data);
1992 monitor_printf(mon, "kvm support: ");
1993 if (qdict_get_bool(qdict, "present")) {
1994 monitor_printf(mon, "%s\n", qdict_get_bool(qdict, "enabled") ?
1995 "enabled" : "disabled");
1996 } else {
1997 monitor_printf(mon, "not compiled\n");
2001 static void do_info_kvm(Monitor *mon, QObject **ret_data)
2003 #ifdef CONFIG_KVM
2004 *ret_data = qobject_from_jsonf("{ 'enabled': %i, 'present': true }",
2005 kvm_enabled());
2006 #else
2007 *ret_data = qobject_from_jsonf("{ 'enabled': false, 'present': false }");
2008 #endif
2011 static void do_info_numa(Monitor *mon)
2013 int i;
2014 CPUState *env;
2016 monitor_printf(mon, "%d nodes\n", nb_numa_nodes);
2017 for (i = 0; i < nb_numa_nodes; i++) {
2018 monitor_printf(mon, "node %d cpus:", i);
2019 for (env = first_cpu; env != NULL; env = env->next_cpu) {
2020 if (env->numa_node == i) {
2021 monitor_printf(mon, " %d", env->cpu_index);
2024 monitor_printf(mon, "\n");
2025 monitor_printf(mon, "node %d size: %" PRId64 " MB\n", i,
2026 node_mem[i] >> 20);
2030 #ifdef CONFIG_PROFILER
2032 int64_t qemu_time;
2033 int64_t dev_time;
2035 static void do_info_profile(Monitor *mon)
2037 int64_t total;
2038 total = qemu_time;
2039 if (total == 0)
2040 total = 1;
2041 monitor_printf(mon, "async time %" PRId64 " (%0.3f)\n",
2042 dev_time, dev_time / (double)get_ticks_per_sec());
2043 monitor_printf(mon, "qemu time %" PRId64 " (%0.3f)\n",
2044 qemu_time, qemu_time / (double)get_ticks_per_sec());
2045 qemu_time = 0;
2046 dev_time = 0;
2048 #else
2049 static void do_info_profile(Monitor *mon)
2051 monitor_printf(mon, "Internal profiler not compiled\n");
2053 #endif
2055 /* Capture support */
2056 static QLIST_HEAD (capture_list_head, CaptureState) capture_head;
2058 static void do_info_capture(Monitor *mon)
2060 int i;
2061 CaptureState *s;
2063 for (s = capture_head.lh_first, i = 0; s; s = s->entries.le_next, ++i) {
2064 monitor_printf(mon, "[%d]: ", i);
2065 s->ops.info (s->opaque);
2069 #ifdef HAS_AUDIO
2070 static void do_stop_capture(Monitor *mon, const QDict *qdict)
2072 int i;
2073 int n = qdict_get_int(qdict, "n");
2074 CaptureState *s;
2076 for (s = capture_head.lh_first, i = 0; s; s = s->entries.le_next, ++i) {
2077 if (i == n) {
2078 s->ops.destroy (s->opaque);
2079 QLIST_REMOVE (s, entries);
2080 qemu_free (s);
2081 return;
2086 static void do_wav_capture(Monitor *mon, const QDict *qdict)
2088 const char *path = qdict_get_str(qdict, "path");
2089 int has_freq = qdict_haskey(qdict, "freq");
2090 int freq = qdict_get_try_int(qdict, "freq", -1);
2091 int has_bits = qdict_haskey(qdict, "bits");
2092 int bits = qdict_get_try_int(qdict, "bits", -1);
2093 int has_channels = qdict_haskey(qdict, "nchannels");
2094 int nchannels = qdict_get_try_int(qdict, "nchannels", -1);
2095 CaptureState *s;
2097 s = qemu_mallocz (sizeof (*s));
2099 freq = has_freq ? freq : 44100;
2100 bits = has_bits ? bits : 16;
2101 nchannels = has_channels ? nchannels : 2;
2103 if (wav_start_capture (s, path, freq, bits, nchannels)) {
2104 monitor_printf(mon, "Faied to add wave capture\n");
2105 qemu_free (s);
2107 QLIST_INSERT_HEAD (&capture_head, s, entries);
2109 #endif
2111 #if defined(TARGET_I386)
2112 static void do_inject_nmi(Monitor *mon, const QDict *qdict)
2114 CPUState *env;
2115 int cpu_index = qdict_get_int(qdict, "cpu_index");
2117 for (env = first_cpu; env != NULL; env = env->next_cpu)
2118 if (env->cpu_index == cpu_index) {
2119 cpu_interrupt(env, CPU_INTERRUPT_NMI);
2120 break;
2123 #endif
2125 static void do_info_status_print(Monitor *mon, const QObject *data)
2127 QDict *qdict;
2129 qdict = qobject_to_qdict(data);
2131 monitor_printf(mon, "VM status: ");
2132 if (qdict_get_bool(qdict, "running")) {
2133 monitor_printf(mon, "running");
2134 if (qdict_get_bool(qdict, "singlestep")) {
2135 monitor_printf(mon, " (single step mode)");
2137 } else {
2138 monitor_printf(mon, "paused");
2141 monitor_printf(mon, "\n");
2144 static void do_info_status(Monitor *mon, QObject **ret_data)
2146 *ret_data = qobject_from_jsonf("{ 'running': %i, 'singlestep': %i }",
2147 vm_running, singlestep);
2150 static qemu_acl *find_acl(Monitor *mon, const char *name)
2152 qemu_acl *acl = qemu_acl_find(name);
2154 if (!acl) {
2155 monitor_printf(mon, "acl: unknown list '%s'\n", name);
2157 return acl;
2160 static void do_acl_show(Monitor *mon, const QDict *qdict)
2162 const char *aclname = qdict_get_str(qdict, "aclname");
2163 qemu_acl *acl = find_acl(mon, aclname);
2164 qemu_acl_entry *entry;
2165 int i = 0;
2167 if (acl) {
2168 monitor_printf(mon, "policy: %s\n",
2169 acl->defaultDeny ? "deny" : "allow");
2170 QTAILQ_FOREACH(entry, &acl->entries, next) {
2171 i++;
2172 monitor_printf(mon, "%d: %s %s\n", i,
2173 entry->deny ? "deny" : "allow", entry->match);
2178 static void do_acl_reset(Monitor *mon, const QDict *qdict)
2180 const char *aclname = qdict_get_str(qdict, "aclname");
2181 qemu_acl *acl = find_acl(mon, aclname);
2183 if (acl) {
2184 qemu_acl_reset(acl);
2185 monitor_printf(mon, "acl: removed all rules\n");
2189 static void do_acl_policy(Monitor *mon, const QDict *qdict)
2191 const char *aclname = qdict_get_str(qdict, "aclname");
2192 const char *policy = qdict_get_str(qdict, "policy");
2193 qemu_acl *acl = find_acl(mon, aclname);
2195 if (acl) {
2196 if (strcmp(policy, "allow") == 0) {
2197 acl->defaultDeny = 0;
2198 monitor_printf(mon, "acl: policy set to 'allow'\n");
2199 } else if (strcmp(policy, "deny") == 0) {
2200 acl->defaultDeny = 1;
2201 monitor_printf(mon, "acl: policy set to 'deny'\n");
2202 } else {
2203 monitor_printf(mon, "acl: unknown policy '%s', "
2204 "expected 'deny' or 'allow'\n", policy);
2209 static void do_acl_add(Monitor *mon, const QDict *qdict)
2211 const char *aclname = qdict_get_str(qdict, "aclname");
2212 const char *match = qdict_get_str(qdict, "match");
2213 const char *policy = qdict_get_str(qdict, "policy");
2214 int has_index = qdict_haskey(qdict, "index");
2215 int index = qdict_get_try_int(qdict, "index", -1);
2216 qemu_acl *acl = find_acl(mon, aclname);
2217 int deny, ret;
2219 if (acl) {
2220 if (strcmp(policy, "allow") == 0) {
2221 deny = 0;
2222 } else if (strcmp(policy, "deny") == 0) {
2223 deny = 1;
2224 } else {
2225 monitor_printf(mon, "acl: unknown policy '%s', "
2226 "expected 'deny' or 'allow'\n", policy);
2227 return;
2229 if (has_index)
2230 ret = qemu_acl_insert(acl, deny, match, index);
2231 else
2232 ret = qemu_acl_append(acl, deny, match);
2233 if (ret < 0)
2234 monitor_printf(mon, "acl: unable to add acl entry\n");
2235 else
2236 monitor_printf(mon, "acl: added rule at position %d\n", ret);
2240 static void do_acl_remove(Monitor *mon, const QDict *qdict)
2242 const char *aclname = qdict_get_str(qdict, "aclname");
2243 const char *match = qdict_get_str(qdict, "match");
2244 qemu_acl *acl = find_acl(mon, aclname);
2245 int ret;
2247 if (acl) {
2248 ret = qemu_acl_remove(acl, match);
2249 if (ret < 0)
2250 monitor_printf(mon, "acl: no matching acl entry\n");
2251 else
2252 monitor_printf(mon, "acl: removed rule at position %d\n", ret);
2256 #if defined(TARGET_I386)
2257 static void do_inject_mce(Monitor *mon, const QDict *qdict)
2259 CPUState *cenv;
2260 int cpu_index = qdict_get_int(qdict, "cpu_index");
2261 int bank = qdict_get_int(qdict, "bank");
2262 uint64_t status = qdict_get_int(qdict, "status");
2263 uint64_t mcg_status = qdict_get_int(qdict, "mcg_status");
2264 uint64_t addr = qdict_get_int(qdict, "addr");
2265 uint64_t misc = qdict_get_int(qdict, "misc");
2267 for (cenv = first_cpu; cenv != NULL; cenv = cenv->next_cpu)
2268 if (cenv->cpu_index == cpu_index && cenv->mcg_cap) {
2269 cpu_inject_x86_mce(cenv, bank, status, mcg_status, addr, misc);
2270 break;
2273 #endif
2275 static int do_getfd(Monitor *mon, const QDict *qdict, QObject **ret_data)
2277 const char *fdname = qdict_get_str(qdict, "fdname");
2278 mon_fd_t *monfd;
2279 int fd;
2281 fd = qemu_chr_get_msgfd(mon->chr);
2282 if (fd == -1) {
2283 qerror_report(QERR_FD_NOT_SUPPLIED);
2284 return -1;
2287 if (qemu_isdigit(fdname[0])) {
2288 qerror_report(QERR_INVALID_PARAMETER_VALUE, "fdname",
2289 "a name not starting with a digit");
2290 return -1;
2293 QLIST_FOREACH(monfd, &mon->fds, next) {
2294 if (strcmp(monfd->name, fdname) != 0) {
2295 continue;
2298 close(monfd->fd);
2299 monfd->fd = fd;
2300 return 0;
2303 monfd = qemu_mallocz(sizeof(mon_fd_t));
2304 monfd->name = qemu_strdup(fdname);
2305 monfd->fd = fd;
2307 QLIST_INSERT_HEAD(&mon->fds, monfd, next);
2308 return 0;
2311 static int do_closefd(Monitor *mon, const QDict *qdict, QObject **ret_data)
2313 const char *fdname = qdict_get_str(qdict, "fdname");
2314 mon_fd_t *monfd;
2316 QLIST_FOREACH(monfd, &mon->fds, next) {
2317 if (strcmp(monfd->name, fdname) != 0) {
2318 continue;
2321 QLIST_REMOVE(monfd, next);
2322 close(monfd->fd);
2323 qemu_free(monfd->name);
2324 qemu_free(monfd);
2325 return 0;
2328 qerror_report(QERR_FD_NOT_FOUND, fdname);
2329 return -1;
2332 static void do_loadvm(Monitor *mon, const QDict *qdict)
2334 int saved_vm_running = vm_running;
2335 const char *name = qdict_get_str(qdict, "name");
2337 vm_stop(0);
2339 if (load_vmstate(name) == 0 && saved_vm_running) {
2340 vm_start();
2344 int monitor_get_fd(Monitor *mon, const char *fdname)
2346 mon_fd_t *monfd;
2348 QLIST_FOREACH(monfd, &mon->fds, next) {
2349 int fd;
2351 if (strcmp(monfd->name, fdname) != 0) {
2352 continue;
2355 fd = monfd->fd;
2357 /* caller takes ownership of fd */
2358 QLIST_REMOVE(monfd, next);
2359 qemu_free(monfd->name);
2360 qemu_free(monfd);
2362 return fd;
2365 return -1;
2368 static const mon_cmd_t mon_cmds[] = {
2369 #include "qemu-monitor.h"
2370 { NULL, NULL, },
2373 /* Please update qemu-monitor.hx when adding or changing commands */
2374 static const mon_cmd_t info_cmds[] = {
2376 .name = "version",
2377 .args_type = "",
2378 .params = "",
2379 .help = "show the version of QEMU",
2380 .user_print = do_info_version_print,
2381 .mhandler.info_new = do_info_version,
2384 .name = "commands",
2385 .args_type = "",
2386 .params = "",
2387 .help = "list QMP available commands",
2388 .user_print = monitor_user_noop,
2389 .mhandler.info_new = do_info_commands,
2392 .name = "network",
2393 .args_type = "",
2394 .params = "",
2395 .help = "show the network state",
2396 .mhandler.info = do_info_network,
2399 .name = "chardev",
2400 .args_type = "",
2401 .params = "",
2402 .help = "show the character devices",
2403 .user_print = qemu_chr_info_print,
2404 .mhandler.info_new = qemu_chr_info,
2407 .name = "block",
2408 .args_type = "",
2409 .params = "",
2410 .help = "show the block devices",
2411 .user_print = bdrv_info_print,
2412 .mhandler.info_new = bdrv_info,
2415 .name = "blockstats",
2416 .args_type = "",
2417 .params = "",
2418 .help = "show block device statistics",
2419 .user_print = bdrv_stats_print,
2420 .mhandler.info_new = bdrv_info_stats,
2423 .name = "registers",
2424 .args_type = "",
2425 .params = "",
2426 .help = "show the cpu registers",
2427 .mhandler.info = do_info_registers,
2430 .name = "cpus",
2431 .args_type = "",
2432 .params = "",
2433 .help = "show infos for each CPU",
2434 .user_print = monitor_print_cpus,
2435 .mhandler.info_new = do_info_cpus,
2438 .name = "history",
2439 .args_type = "",
2440 .params = "",
2441 .help = "show the command line history",
2442 .mhandler.info = do_info_history,
2445 .name = "irq",
2446 .args_type = "",
2447 .params = "",
2448 .help = "show the interrupts statistics (if available)",
2449 .mhandler.info = irq_info,
2452 .name = "pic",
2453 .args_type = "",
2454 .params = "",
2455 .help = "show i8259 (PIC) state",
2456 .mhandler.info = pic_info,
2459 .name = "pci",
2460 .args_type = "",
2461 .params = "",
2462 .help = "show PCI info",
2463 .user_print = do_pci_info_print,
2464 .mhandler.info_new = do_pci_info,
2466 #if defined(TARGET_I386) || defined(TARGET_SH4)
2468 .name = "tlb",
2469 .args_type = "",
2470 .params = "",
2471 .help = "show virtual to physical memory mappings",
2472 .mhandler.info = tlb_info,
2474 #endif
2475 #if defined(TARGET_I386)
2477 .name = "mem",
2478 .args_type = "",
2479 .params = "",
2480 .help = "show the active virtual memory mappings",
2481 .mhandler.info = mem_info,
2483 #endif
2485 .name = "jit",
2486 .args_type = "",
2487 .params = "",
2488 .help = "show dynamic compiler info",
2489 .mhandler.info = do_info_jit,
2492 .name = "kvm",
2493 .args_type = "",
2494 .params = "",
2495 .help = "show KVM information",
2496 .user_print = do_info_kvm_print,
2497 .mhandler.info_new = do_info_kvm,
2500 .name = "numa",
2501 .args_type = "",
2502 .params = "",
2503 .help = "show NUMA information",
2504 .mhandler.info = do_info_numa,
2507 .name = "usb",
2508 .args_type = "",
2509 .params = "",
2510 .help = "show guest USB devices",
2511 .mhandler.info = usb_info,
2514 .name = "usbhost",
2515 .args_type = "",
2516 .params = "",
2517 .help = "show host USB devices",
2518 .mhandler.info = usb_host_info,
2521 .name = "profile",
2522 .args_type = "",
2523 .params = "",
2524 .help = "show profiling information",
2525 .mhandler.info = do_info_profile,
2528 .name = "capture",
2529 .args_type = "",
2530 .params = "",
2531 .help = "show capture information",
2532 .mhandler.info = do_info_capture,
2535 .name = "snapshots",
2536 .args_type = "",
2537 .params = "",
2538 .help = "show the currently saved VM snapshots",
2539 .mhandler.info = do_info_snapshots,
2542 .name = "status",
2543 .args_type = "",
2544 .params = "",
2545 .help = "show the current VM status (running|paused)",
2546 .user_print = do_info_status_print,
2547 .mhandler.info_new = do_info_status,
2550 .name = "pcmcia",
2551 .args_type = "",
2552 .params = "",
2553 .help = "show guest PCMCIA status",
2554 .mhandler.info = pcmcia_info,
2557 .name = "mice",
2558 .args_type = "",
2559 .params = "",
2560 .help = "show which guest mouse is receiving events",
2561 .user_print = do_info_mice_print,
2562 .mhandler.info_new = do_info_mice,
2565 .name = "vnc",
2566 .args_type = "",
2567 .params = "",
2568 .help = "show the vnc server status",
2569 .user_print = do_info_vnc_print,
2570 .mhandler.info_new = do_info_vnc,
2573 .name = "name",
2574 .args_type = "",
2575 .params = "",
2576 .help = "show the current VM name",
2577 .user_print = do_info_name_print,
2578 .mhandler.info_new = do_info_name,
2581 .name = "uuid",
2582 .args_type = "",
2583 .params = "",
2584 .help = "show the current VM UUID",
2585 .user_print = do_info_uuid_print,
2586 .mhandler.info_new = do_info_uuid,
2588 #if defined(TARGET_PPC)
2590 .name = "cpustats",
2591 .args_type = "",
2592 .params = "",
2593 .help = "show CPU statistics",
2594 .mhandler.info = do_info_cpu_stats,
2596 #endif
2597 #if defined(CONFIG_SLIRP)
2599 .name = "usernet",
2600 .args_type = "",
2601 .params = "",
2602 .help = "show user network stack connection states",
2603 .mhandler.info = do_info_usernet,
2605 #endif
2607 .name = "migrate",
2608 .args_type = "",
2609 .params = "",
2610 .help = "show migration status",
2611 .user_print = do_info_migrate_print,
2612 .mhandler.info_new = do_info_migrate,
2615 .name = "balloon",
2616 .args_type = "",
2617 .params = "",
2618 .help = "show balloon information",
2619 .user_print = monitor_print_balloon,
2620 .mhandler.info_async = do_info_balloon,
2621 .flags = MONITOR_CMD_ASYNC,
2624 .name = "qtree",
2625 .args_type = "",
2626 .params = "",
2627 .help = "show device tree",
2628 .mhandler.info = do_info_qtree,
2631 .name = "qdm",
2632 .args_type = "",
2633 .params = "",
2634 .help = "show qdev device model list",
2635 .mhandler.info = do_info_qdm,
2638 .name = "roms",
2639 .args_type = "",
2640 .params = "",
2641 .help = "show roms",
2642 .mhandler.info = do_info_roms,
2644 #if defined(CONFIG_SIMPLE_TRACE)
2646 .name = "trace",
2647 .args_type = "",
2648 .params = "",
2649 .help = "show current contents of trace buffer",
2650 .mhandler.info = do_info_trace,
2653 .name = "trace-events",
2654 .args_type = "",
2655 .params = "",
2656 .help = "show available trace-events & their state",
2657 .mhandler.info = do_info_trace_events,
2659 #endif
2661 .name = NULL,
2665 /*******************************************************************/
2667 static const char *pch;
2668 static jmp_buf expr_env;
2670 #define MD_TLONG 0
2671 #define MD_I32 1
2673 typedef struct MonitorDef {
2674 const char *name;
2675 int offset;
2676 target_long (*get_value)(const struct MonitorDef *md, int val);
2677 int type;
2678 } MonitorDef;
2680 #if defined(TARGET_I386)
2681 static target_long monitor_get_pc (const struct MonitorDef *md, int val)
2683 CPUState *env = mon_get_cpu();
2684 return env->eip + env->segs[R_CS].base;
2686 #endif
2688 #if defined(TARGET_PPC)
2689 static target_long monitor_get_ccr (const struct MonitorDef *md, int val)
2691 CPUState *env = mon_get_cpu();
2692 unsigned int u;
2693 int i;
2695 u = 0;
2696 for (i = 0; i < 8; i++)
2697 u |= env->crf[i] << (32 - (4 * i));
2699 return u;
2702 static target_long monitor_get_msr (const struct MonitorDef *md, int val)
2704 CPUState *env = mon_get_cpu();
2705 return env->msr;
2708 static target_long monitor_get_xer (const struct MonitorDef *md, int val)
2710 CPUState *env = mon_get_cpu();
2711 return env->xer;
2714 static target_long monitor_get_decr (const struct MonitorDef *md, int val)
2716 CPUState *env = mon_get_cpu();
2717 return cpu_ppc_load_decr(env);
2720 static target_long monitor_get_tbu (const struct MonitorDef *md, int val)
2722 CPUState *env = mon_get_cpu();
2723 return cpu_ppc_load_tbu(env);
2726 static target_long monitor_get_tbl (const struct MonitorDef *md, int val)
2728 CPUState *env = mon_get_cpu();
2729 return cpu_ppc_load_tbl(env);
2731 #endif
2733 #if defined(TARGET_SPARC)
2734 #ifndef TARGET_SPARC64
2735 static target_long monitor_get_psr (const struct MonitorDef *md, int val)
2737 CPUState *env = mon_get_cpu();
2739 return cpu_get_psr(env);
2741 #endif
2743 static target_long monitor_get_reg(const struct MonitorDef *md, int val)
2745 CPUState *env = mon_get_cpu();
2746 return env->regwptr[val];
2748 #endif
2750 static const MonitorDef monitor_defs[] = {
2751 #ifdef TARGET_I386
2753 #define SEG(name, seg) \
2754 { name, offsetof(CPUState, segs[seg].selector), NULL, MD_I32 },\
2755 { name ".base", offsetof(CPUState, segs[seg].base) },\
2756 { name ".limit", offsetof(CPUState, segs[seg].limit), NULL, MD_I32 },
2758 { "eax", offsetof(CPUState, regs[0]) },
2759 { "ecx", offsetof(CPUState, regs[1]) },
2760 { "edx", offsetof(CPUState, regs[2]) },
2761 { "ebx", offsetof(CPUState, regs[3]) },
2762 { "esp|sp", offsetof(CPUState, regs[4]) },
2763 { "ebp|fp", offsetof(CPUState, regs[5]) },
2764 { "esi", offsetof(CPUState, regs[6]) },
2765 { "edi", offsetof(CPUState, regs[7]) },
2766 #ifdef TARGET_X86_64
2767 { "r8", offsetof(CPUState, regs[8]) },
2768 { "r9", offsetof(CPUState, regs[9]) },
2769 { "r10", offsetof(CPUState, regs[10]) },
2770 { "r11", offsetof(CPUState, regs[11]) },
2771 { "r12", offsetof(CPUState, regs[12]) },
2772 { "r13", offsetof(CPUState, regs[13]) },
2773 { "r14", offsetof(CPUState, regs[14]) },
2774 { "r15", offsetof(CPUState, regs[15]) },
2775 #endif
2776 { "eflags", offsetof(CPUState, eflags) },
2777 { "eip", offsetof(CPUState, eip) },
2778 SEG("cs", R_CS)
2779 SEG("ds", R_DS)
2780 SEG("es", R_ES)
2781 SEG("ss", R_SS)
2782 SEG("fs", R_FS)
2783 SEG("gs", R_GS)
2784 { "pc", 0, monitor_get_pc, },
2785 #elif defined(TARGET_PPC)
2786 /* General purpose registers */
2787 { "r0", offsetof(CPUState, gpr[0]) },
2788 { "r1", offsetof(CPUState, gpr[1]) },
2789 { "r2", offsetof(CPUState, gpr[2]) },
2790 { "r3", offsetof(CPUState, gpr[3]) },
2791 { "r4", offsetof(CPUState, gpr[4]) },
2792 { "r5", offsetof(CPUState, gpr[5]) },
2793 { "r6", offsetof(CPUState, gpr[6]) },
2794 { "r7", offsetof(CPUState, gpr[7]) },
2795 { "r8", offsetof(CPUState, gpr[8]) },
2796 { "r9", offsetof(CPUState, gpr[9]) },
2797 { "r10", offsetof(CPUState, gpr[10]) },
2798 { "r11", offsetof(CPUState, gpr[11]) },
2799 { "r12", offsetof(CPUState, gpr[12]) },
2800 { "r13", offsetof(CPUState, gpr[13]) },
2801 { "r14", offsetof(CPUState, gpr[14]) },
2802 { "r15", offsetof(CPUState, gpr[15]) },
2803 { "r16", offsetof(CPUState, gpr[16]) },
2804 { "r17", offsetof(CPUState, gpr[17]) },
2805 { "r18", offsetof(CPUState, gpr[18]) },
2806 { "r19", offsetof(CPUState, gpr[19]) },
2807 { "r20", offsetof(CPUState, gpr[20]) },
2808 { "r21", offsetof(CPUState, gpr[21]) },
2809 { "r22", offsetof(CPUState, gpr[22]) },
2810 { "r23", offsetof(CPUState, gpr[23]) },
2811 { "r24", offsetof(CPUState, gpr[24]) },
2812 { "r25", offsetof(CPUState, gpr[25]) },
2813 { "r26", offsetof(CPUState, gpr[26]) },
2814 { "r27", offsetof(CPUState, gpr[27]) },
2815 { "r28", offsetof(CPUState, gpr[28]) },
2816 { "r29", offsetof(CPUState, gpr[29]) },
2817 { "r30", offsetof(CPUState, gpr[30]) },
2818 { "r31", offsetof(CPUState, gpr[31]) },
2819 /* Floating point registers */
2820 { "f0", offsetof(CPUState, fpr[0]) },
2821 { "f1", offsetof(CPUState, fpr[1]) },
2822 { "f2", offsetof(CPUState, fpr[2]) },
2823 { "f3", offsetof(CPUState, fpr[3]) },
2824 { "f4", offsetof(CPUState, fpr[4]) },
2825 { "f5", offsetof(CPUState, fpr[5]) },
2826 { "f6", offsetof(CPUState, fpr[6]) },
2827 { "f7", offsetof(CPUState, fpr[7]) },
2828 { "f8", offsetof(CPUState, fpr[8]) },
2829 { "f9", offsetof(CPUState, fpr[9]) },
2830 { "f10", offsetof(CPUState, fpr[10]) },
2831 { "f11", offsetof(CPUState, fpr[11]) },
2832 { "f12", offsetof(CPUState, fpr[12]) },
2833 { "f13", offsetof(CPUState, fpr[13]) },
2834 { "f14", offsetof(CPUState, fpr[14]) },
2835 { "f15", offsetof(CPUState, fpr[15]) },
2836 { "f16", offsetof(CPUState, fpr[16]) },
2837 { "f17", offsetof(CPUState, fpr[17]) },
2838 { "f18", offsetof(CPUState, fpr[18]) },
2839 { "f19", offsetof(CPUState, fpr[19]) },
2840 { "f20", offsetof(CPUState, fpr[20]) },
2841 { "f21", offsetof(CPUState, fpr[21]) },
2842 { "f22", offsetof(CPUState, fpr[22]) },
2843 { "f23", offsetof(CPUState, fpr[23]) },
2844 { "f24", offsetof(CPUState, fpr[24]) },
2845 { "f25", offsetof(CPUState, fpr[25]) },
2846 { "f26", offsetof(CPUState, fpr[26]) },
2847 { "f27", offsetof(CPUState, fpr[27]) },
2848 { "f28", offsetof(CPUState, fpr[28]) },
2849 { "f29", offsetof(CPUState, fpr[29]) },
2850 { "f30", offsetof(CPUState, fpr[30]) },
2851 { "f31", offsetof(CPUState, fpr[31]) },
2852 { "fpscr", offsetof(CPUState, fpscr) },
2853 /* Next instruction pointer */
2854 { "nip|pc", offsetof(CPUState, nip) },
2855 { "lr", offsetof(CPUState, lr) },
2856 { "ctr", offsetof(CPUState, ctr) },
2857 { "decr", 0, &monitor_get_decr, },
2858 { "ccr", 0, &monitor_get_ccr, },
2859 /* Machine state register */
2860 { "msr", 0, &monitor_get_msr, },
2861 { "xer", 0, &monitor_get_xer, },
2862 { "tbu", 0, &monitor_get_tbu, },
2863 { "tbl", 0, &monitor_get_tbl, },
2864 #if defined(TARGET_PPC64)
2865 /* Address space register */
2866 { "asr", offsetof(CPUState, asr) },
2867 #endif
2868 /* Segment registers */
2869 { "sdr1", offsetof(CPUState, sdr1) },
2870 { "sr0", offsetof(CPUState, sr[0]) },
2871 { "sr1", offsetof(CPUState, sr[1]) },
2872 { "sr2", offsetof(CPUState, sr[2]) },
2873 { "sr3", offsetof(CPUState, sr[3]) },
2874 { "sr4", offsetof(CPUState, sr[4]) },
2875 { "sr5", offsetof(CPUState, sr[5]) },
2876 { "sr6", offsetof(CPUState, sr[6]) },
2877 { "sr7", offsetof(CPUState, sr[7]) },
2878 { "sr8", offsetof(CPUState, sr[8]) },
2879 { "sr9", offsetof(CPUState, sr[9]) },
2880 { "sr10", offsetof(CPUState, sr[10]) },
2881 { "sr11", offsetof(CPUState, sr[11]) },
2882 { "sr12", offsetof(CPUState, sr[12]) },
2883 { "sr13", offsetof(CPUState, sr[13]) },
2884 { "sr14", offsetof(CPUState, sr[14]) },
2885 { "sr15", offsetof(CPUState, sr[15]) },
2886 /* Too lazy to put BATs and SPRs ... */
2887 #elif defined(TARGET_SPARC)
2888 { "g0", offsetof(CPUState, gregs[0]) },
2889 { "g1", offsetof(CPUState, gregs[1]) },
2890 { "g2", offsetof(CPUState, gregs[2]) },
2891 { "g3", offsetof(CPUState, gregs[3]) },
2892 { "g4", offsetof(CPUState, gregs[4]) },
2893 { "g5", offsetof(CPUState, gregs[5]) },
2894 { "g6", offsetof(CPUState, gregs[6]) },
2895 { "g7", offsetof(CPUState, gregs[7]) },
2896 { "o0", 0, monitor_get_reg },
2897 { "o1", 1, monitor_get_reg },
2898 { "o2", 2, monitor_get_reg },
2899 { "o3", 3, monitor_get_reg },
2900 { "o4", 4, monitor_get_reg },
2901 { "o5", 5, monitor_get_reg },
2902 { "o6", 6, monitor_get_reg },
2903 { "o7", 7, monitor_get_reg },
2904 { "l0", 8, monitor_get_reg },
2905 { "l1", 9, monitor_get_reg },
2906 { "l2", 10, monitor_get_reg },
2907 { "l3", 11, monitor_get_reg },
2908 { "l4", 12, monitor_get_reg },
2909 { "l5", 13, monitor_get_reg },
2910 { "l6", 14, monitor_get_reg },
2911 { "l7", 15, monitor_get_reg },
2912 { "i0", 16, monitor_get_reg },
2913 { "i1", 17, monitor_get_reg },
2914 { "i2", 18, monitor_get_reg },
2915 { "i3", 19, monitor_get_reg },
2916 { "i4", 20, monitor_get_reg },
2917 { "i5", 21, monitor_get_reg },
2918 { "i6", 22, monitor_get_reg },
2919 { "i7", 23, monitor_get_reg },
2920 { "pc", offsetof(CPUState, pc) },
2921 { "npc", offsetof(CPUState, npc) },
2922 { "y", offsetof(CPUState, y) },
2923 #ifndef TARGET_SPARC64
2924 { "psr", 0, &monitor_get_psr, },
2925 { "wim", offsetof(CPUState, wim) },
2926 #endif
2927 { "tbr", offsetof(CPUState, tbr) },
2928 { "fsr", offsetof(CPUState, fsr) },
2929 { "f0", offsetof(CPUState, fpr[0]) },
2930 { "f1", offsetof(CPUState, fpr[1]) },
2931 { "f2", offsetof(CPUState, fpr[2]) },
2932 { "f3", offsetof(CPUState, fpr[3]) },
2933 { "f4", offsetof(CPUState, fpr[4]) },
2934 { "f5", offsetof(CPUState, fpr[5]) },
2935 { "f6", offsetof(CPUState, fpr[6]) },
2936 { "f7", offsetof(CPUState, fpr[7]) },
2937 { "f8", offsetof(CPUState, fpr[8]) },
2938 { "f9", offsetof(CPUState, fpr[9]) },
2939 { "f10", offsetof(CPUState, fpr[10]) },
2940 { "f11", offsetof(CPUState, fpr[11]) },
2941 { "f12", offsetof(CPUState, fpr[12]) },
2942 { "f13", offsetof(CPUState, fpr[13]) },
2943 { "f14", offsetof(CPUState, fpr[14]) },
2944 { "f15", offsetof(CPUState, fpr[15]) },
2945 { "f16", offsetof(CPUState, fpr[16]) },
2946 { "f17", offsetof(CPUState, fpr[17]) },
2947 { "f18", offsetof(CPUState, fpr[18]) },
2948 { "f19", offsetof(CPUState, fpr[19]) },
2949 { "f20", offsetof(CPUState, fpr[20]) },
2950 { "f21", offsetof(CPUState, fpr[21]) },
2951 { "f22", offsetof(CPUState, fpr[22]) },
2952 { "f23", offsetof(CPUState, fpr[23]) },
2953 { "f24", offsetof(CPUState, fpr[24]) },
2954 { "f25", offsetof(CPUState, fpr[25]) },
2955 { "f26", offsetof(CPUState, fpr[26]) },
2956 { "f27", offsetof(CPUState, fpr[27]) },
2957 { "f28", offsetof(CPUState, fpr[28]) },
2958 { "f29", offsetof(CPUState, fpr[29]) },
2959 { "f30", offsetof(CPUState, fpr[30]) },
2960 { "f31", offsetof(CPUState, fpr[31]) },
2961 #ifdef TARGET_SPARC64
2962 { "f32", offsetof(CPUState, fpr[32]) },
2963 { "f34", offsetof(CPUState, fpr[34]) },
2964 { "f36", offsetof(CPUState, fpr[36]) },
2965 { "f38", offsetof(CPUState, fpr[38]) },
2966 { "f40", offsetof(CPUState, fpr[40]) },
2967 { "f42", offsetof(CPUState, fpr[42]) },
2968 { "f44", offsetof(CPUState, fpr[44]) },
2969 { "f46", offsetof(CPUState, fpr[46]) },
2970 { "f48", offsetof(CPUState, fpr[48]) },
2971 { "f50", offsetof(CPUState, fpr[50]) },
2972 { "f52", offsetof(CPUState, fpr[52]) },
2973 { "f54", offsetof(CPUState, fpr[54]) },
2974 { "f56", offsetof(CPUState, fpr[56]) },
2975 { "f58", offsetof(CPUState, fpr[58]) },
2976 { "f60", offsetof(CPUState, fpr[60]) },
2977 { "f62", offsetof(CPUState, fpr[62]) },
2978 { "asi", offsetof(CPUState, asi) },
2979 { "pstate", offsetof(CPUState, pstate) },
2980 { "cansave", offsetof(CPUState, cansave) },
2981 { "canrestore", offsetof(CPUState, canrestore) },
2982 { "otherwin", offsetof(CPUState, otherwin) },
2983 { "wstate", offsetof(CPUState, wstate) },
2984 { "cleanwin", offsetof(CPUState, cleanwin) },
2985 { "fprs", offsetof(CPUState, fprs) },
2986 #endif
2987 #endif
2988 { NULL },
2991 static void expr_error(Monitor *mon, const char *msg)
2993 monitor_printf(mon, "%s\n", msg);
2994 longjmp(expr_env, 1);
2997 /* return 0 if OK, -1 if not found */
2998 static int get_monitor_def(target_long *pval, const char *name)
3000 const MonitorDef *md;
3001 void *ptr;
3003 for(md = monitor_defs; md->name != NULL; md++) {
3004 if (compare_cmd(name, md->name)) {
3005 if (md->get_value) {
3006 *pval = md->get_value(md, md->offset);
3007 } else {
3008 CPUState *env = mon_get_cpu();
3009 ptr = (uint8_t *)env + md->offset;
3010 switch(md->type) {
3011 case MD_I32:
3012 *pval = *(int32_t *)ptr;
3013 break;
3014 case MD_TLONG:
3015 *pval = *(target_long *)ptr;
3016 break;
3017 default:
3018 *pval = 0;
3019 break;
3022 return 0;
3025 return -1;
3028 static void next(void)
3030 if (*pch != '\0') {
3031 pch++;
3032 while (qemu_isspace(*pch))
3033 pch++;
3037 static int64_t expr_sum(Monitor *mon);
3039 static int64_t expr_unary(Monitor *mon)
3041 int64_t n;
3042 char *p;
3043 int ret;
3045 switch(*pch) {
3046 case '+':
3047 next();
3048 n = expr_unary(mon);
3049 break;
3050 case '-':
3051 next();
3052 n = -expr_unary(mon);
3053 break;
3054 case '~':
3055 next();
3056 n = ~expr_unary(mon);
3057 break;
3058 case '(':
3059 next();
3060 n = expr_sum(mon);
3061 if (*pch != ')') {
3062 expr_error(mon, "')' expected");
3064 next();
3065 break;
3066 case '\'':
3067 pch++;
3068 if (*pch == '\0')
3069 expr_error(mon, "character constant expected");
3070 n = *pch;
3071 pch++;
3072 if (*pch != '\'')
3073 expr_error(mon, "missing terminating \' character");
3074 next();
3075 break;
3076 case '$':
3078 char buf[128], *q;
3079 target_long reg=0;
3081 pch++;
3082 q = buf;
3083 while ((*pch >= 'a' && *pch <= 'z') ||
3084 (*pch >= 'A' && *pch <= 'Z') ||
3085 (*pch >= '0' && *pch <= '9') ||
3086 *pch == '_' || *pch == '.') {
3087 if ((q - buf) < sizeof(buf) - 1)
3088 *q++ = *pch;
3089 pch++;
3091 while (qemu_isspace(*pch))
3092 pch++;
3093 *q = 0;
3094 ret = get_monitor_def(&reg, buf);
3095 if (ret < 0)
3096 expr_error(mon, "unknown register");
3097 n = reg;
3099 break;
3100 case '\0':
3101 expr_error(mon, "unexpected end of expression");
3102 n = 0;
3103 break;
3104 default:
3105 #if TARGET_PHYS_ADDR_BITS > 32
3106 n = strtoull(pch, &p, 0);
3107 #else
3108 n = strtoul(pch, &p, 0);
3109 #endif
3110 if (pch == p) {
3111 expr_error(mon, "invalid char in expression");
3113 pch = p;
3114 while (qemu_isspace(*pch))
3115 pch++;
3116 break;
3118 return n;
3122 static int64_t expr_prod(Monitor *mon)
3124 int64_t val, val2;
3125 int op;
3127 val = expr_unary(mon);
3128 for(;;) {
3129 op = *pch;
3130 if (op != '*' && op != '/' && op != '%')
3131 break;
3132 next();
3133 val2 = expr_unary(mon);
3134 switch(op) {
3135 default:
3136 case '*':
3137 val *= val2;
3138 break;
3139 case '/':
3140 case '%':
3141 if (val2 == 0)
3142 expr_error(mon, "division by zero");
3143 if (op == '/')
3144 val /= val2;
3145 else
3146 val %= val2;
3147 break;
3150 return val;
3153 static int64_t expr_logic(Monitor *mon)
3155 int64_t val, val2;
3156 int op;
3158 val = expr_prod(mon);
3159 for(;;) {
3160 op = *pch;
3161 if (op != '&' && op != '|' && op != '^')
3162 break;
3163 next();
3164 val2 = expr_prod(mon);
3165 switch(op) {
3166 default:
3167 case '&':
3168 val &= val2;
3169 break;
3170 case '|':
3171 val |= val2;
3172 break;
3173 case '^':
3174 val ^= val2;
3175 break;
3178 return val;
3181 static int64_t expr_sum(Monitor *mon)
3183 int64_t val, val2;
3184 int op;
3186 val = expr_logic(mon);
3187 for(;;) {
3188 op = *pch;
3189 if (op != '+' && op != '-')
3190 break;
3191 next();
3192 val2 = expr_logic(mon);
3193 if (op == '+')
3194 val += val2;
3195 else
3196 val -= val2;
3198 return val;
3201 static int get_expr(Monitor *mon, int64_t *pval, const char **pp)
3203 pch = *pp;
3204 if (setjmp(expr_env)) {
3205 *pp = pch;
3206 return -1;
3208 while (qemu_isspace(*pch))
3209 pch++;
3210 *pval = expr_sum(mon);
3211 *pp = pch;
3212 return 0;
3215 static int get_double(Monitor *mon, double *pval, const char **pp)
3217 const char *p = *pp;
3218 char *tailp;
3219 double d;
3221 d = strtod(p, &tailp);
3222 if (tailp == p) {
3223 monitor_printf(mon, "Number expected\n");
3224 return -1;
3226 if (d != d || d - d != 0) {
3227 /* NaN or infinity */
3228 monitor_printf(mon, "Bad number\n");
3229 return -1;
3231 *pval = d;
3232 *pp = tailp;
3233 return 0;
3236 static int get_str(char *buf, int buf_size, const char **pp)
3238 const char *p;
3239 char *q;
3240 int c;
3242 q = buf;
3243 p = *pp;
3244 while (qemu_isspace(*p))
3245 p++;
3246 if (*p == '\0') {
3247 fail:
3248 *q = '\0';
3249 *pp = p;
3250 return -1;
3252 if (*p == '\"') {
3253 p++;
3254 while (*p != '\0' && *p != '\"') {
3255 if (*p == '\\') {
3256 p++;
3257 c = *p++;
3258 switch(c) {
3259 case 'n':
3260 c = '\n';
3261 break;
3262 case 'r':
3263 c = '\r';
3264 break;
3265 case '\\':
3266 case '\'':
3267 case '\"':
3268 break;
3269 default:
3270 qemu_printf("unsupported escape code: '\\%c'\n", c);
3271 goto fail;
3273 if ((q - buf) < buf_size - 1) {
3274 *q++ = c;
3276 } else {
3277 if ((q - buf) < buf_size - 1) {
3278 *q++ = *p;
3280 p++;
3283 if (*p != '\"') {
3284 qemu_printf("unterminated string\n");
3285 goto fail;
3287 p++;
3288 } else {
3289 while (*p != '\0' && !qemu_isspace(*p)) {
3290 if ((q - buf) < buf_size - 1) {
3291 *q++ = *p;
3293 p++;
3296 *q = '\0';
3297 *pp = p;
3298 return 0;
3302 * Store the command-name in cmdname, and return a pointer to
3303 * the remaining of the command string.
3305 static const char *get_command_name(const char *cmdline,
3306 char *cmdname, size_t nlen)
3308 size_t len;
3309 const char *p, *pstart;
3311 p = cmdline;
3312 while (qemu_isspace(*p))
3313 p++;
3314 if (*p == '\0')
3315 return NULL;
3316 pstart = p;
3317 while (*p != '\0' && *p != '/' && !qemu_isspace(*p))
3318 p++;
3319 len = p - pstart;
3320 if (len > nlen - 1)
3321 len = nlen - 1;
3322 memcpy(cmdname, pstart, len);
3323 cmdname[len] = '\0';
3324 return p;
3328 * Read key of 'type' into 'key' and return the current
3329 * 'type' pointer.
3331 static char *key_get_info(const char *type, char **key)
3333 size_t len;
3334 char *p, *str;
3336 if (*type == ',')
3337 type++;
3339 p = strchr(type, ':');
3340 if (!p) {
3341 *key = NULL;
3342 return NULL;
3344 len = p - type;
3346 str = qemu_malloc(len + 1);
3347 memcpy(str, type, len);
3348 str[len] = '\0';
3350 *key = str;
3351 return ++p;
3354 static int default_fmt_format = 'x';
3355 static int default_fmt_size = 4;
3357 #define MAX_ARGS 16
3359 static int is_valid_option(const char *c, const char *typestr)
3361 char option[3];
3363 option[0] = '-';
3364 option[1] = *c;
3365 option[2] = '\0';
3367 typestr = strstr(typestr, option);
3368 return (typestr != NULL);
3371 static const mon_cmd_t *monitor_find_command(const char *cmdname)
3373 const mon_cmd_t *cmd;
3375 for (cmd = mon_cmds; cmd->name != NULL; cmd++) {
3376 if (compare_cmd(cmdname, cmd->name)) {
3377 return cmd;
3381 return NULL;
3384 static const mon_cmd_t *monitor_parse_command(Monitor *mon,
3385 const char *cmdline,
3386 QDict *qdict)
3388 const char *p, *typestr;
3389 int c;
3390 const mon_cmd_t *cmd;
3391 char cmdname[256];
3392 char buf[1024];
3393 char *key;
3395 #ifdef DEBUG
3396 monitor_printf(mon, "command='%s'\n", cmdline);
3397 #endif
3399 /* extract the command name */
3400 p = get_command_name(cmdline, cmdname, sizeof(cmdname));
3401 if (!p)
3402 return NULL;
3404 cmd = monitor_find_command(cmdname);
3405 if (!cmd) {
3406 monitor_printf(mon, "unknown command: '%s'\n", cmdname);
3407 return NULL;
3410 /* parse the parameters */
3411 typestr = cmd->args_type;
3412 for(;;) {
3413 typestr = key_get_info(typestr, &key);
3414 if (!typestr)
3415 break;
3416 c = *typestr;
3417 typestr++;
3418 switch(c) {
3419 case 'F':
3420 case 'B':
3421 case 's':
3423 int ret;
3425 while (qemu_isspace(*p))
3426 p++;
3427 if (*typestr == '?') {
3428 typestr++;
3429 if (*p == '\0') {
3430 /* no optional string: NULL argument */
3431 break;
3434 ret = get_str(buf, sizeof(buf), &p);
3435 if (ret < 0) {
3436 switch(c) {
3437 case 'F':
3438 monitor_printf(mon, "%s: filename expected\n",
3439 cmdname);
3440 break;
3441 case 'B':
3442 monitor_printf(mon, "%s: block device name expected\n",
3443 cmdname);
3444 break;
3445 default:
3446 monitor_printf(mon, "%s: string expected\n", cmdname);
3447 break;
3449 goto fail;
3451 qdict_put(qdict, key, qstring_from_str(buf));
3453 break;
3454 case 'O':
3456 QemuOptsList *opts_list;
3457 QemuOpts *opts;
3459 opts_list = qemu_find_opts(key);
3460 if (!opts_list || opts_list->desc->name) {
3461 goto bad_type;
3463 while (qemu_isspace(*p)) {
3464 p++;
3466 if (!*p)
3467 break;
3468 if (get_str(buf, sizeof(buf), &p) < 0) {
3469 goto fail;
3471 opts = qemu_opts_parse(opts_list, buf, 1);
3472 if (!opts) {
3473 goto fail;
3475 qemu_opts_to_qdict(opts, qdict);
3476 qemu_opts_del(opts);
3478 break;
3479 case '/':
3481 int count, format, size;
3483 while (qemu_isspace(*p))
3484 p++;
3485 if (*p == '/') {
3486 /* format found */
3487 p++;
3488 count = 1;
3489 if (qemu_isdigit(*p)) {
3490 count = 0;
3491 while (qemu_isdigit(*p)) {
3492 count = count * 10 + (*p - '0');
3493 p++;
3496 size = -1;
3497 format = -1;
3498 for(;;) {
3499 switch(*p) {
3500 case 'o':
3501 case 'd':
3502 case 'u':
3503 case 'x':
3504 case 'i':
3505 case 'c':
3506 format = *p++;
3507 break;
3508 case 'b':
3509 size = 1;
3510 p++;
3511 break;
3512 case 'h':
3513 size = 2;
3514 p++;
3515 break;
3516 case 'w':
3517 size = 4;
3518 p++;
3519 break;
3520 case 'g':
3521 case 'L':
3522 size = 8;
3523 p++;
3524 break;
3525 default:
3526 goto next;
3529 next:
3530 if (*p != '\0' && !qemu_isspace(*p)) {
3531 monitor_printf(mon, "invalid char in format: '%c'\n",
3532 *p);
3533 goto fail;
3535 if (format < 0)
3536 format = default_fmt_format;
3537 if (format != 'i') {
3538 /* for 'i', not specifying a size gives -1 as size */
3539 if (size < 0)
3540 size = default_fmt_size;
3541 default_fmt_size = size;
3543 default_fmt_format = format;
3544 } else {
3545 count = 1;
3546 format = default_fmt_format;
3547 if (format != 'i') {
3548 size = default_fmt_size;
3549 } else {
3550 size = -1;
3553 qdict_put(qdict, "count", qint_from_int(count));
3554 qdict_put(qdict, "format", qint_from_int(format));
3555 qdict_put(qdict, "size", qint_from_int(size));
3557 break;
3558 case 'i':
3559 case 'l':
3560 case 'M':
3562 int64_t val;
3564 while (qemu_isspace(*p))
3565 p++;
3566 if (*typestr == '?' || *typestr == '.') {
3567 if (*typestr == '?') {
3568 if (*p == '\0') {
3569 typestr++;
3570 break;
3572 } else {
3573 if (*p == '.') {
3574 p++;
3575 while (qemu_isspace(*p))
3576 p++;
3577 } else {
3578 typestr++;
3579 break;
3582 typestr++;
3584 if (get_expr(mon, &val, &p))
3585 goto fail;
3586 /* Check if 'i' is greater than 32-bit */
3587 if ((c == 'i') && ((val >> 32) & 0xffffffff)) {
3588 monitor_printf(mon, "\'%s\' has failed: ", cmdname);
3589 monitor_printf(mon, "integer is for 32-bit values\n");
3590 goto fail;
3591 } else if (c == 'M') {
3592 val <<= 20;
3594 qdict_put(qdict, key, qint_from_int(val));
3596 break;
3597 case 'f':
3598 case 'T':
3600 double val;
3602 while (qemu_isspace(*p))
3603 p++;
3604 if (*typestr == '?') {
3605 typestr++;
3606 if (*p == '\0') {
3607 break;
3610 if (get_double(mon, &val, &p) < 0) {
3611 goto fail;
3613 if (c == 'f' && *p) {
3614 switch (*p) {
3615 case 'K': case 'k':
3616 val *= 1 << 10; p++; break;
3617 case 'M': case 'm':
3618 val *= 1 << 20; p++; break;
3619 case 'G': case 'g':
3620 val *= 1 << 30; p++; break;
3623 if (c == 'T' && p[0] && p[1] == 's') {
3624 switch (*p) {
3625 case 'm':
3626 val /= 1e3; p += 2; break;
3627 case 'u':
3628 val /= 1e6; p += 2; break;
3629 case 'n':
3630 val /= 1e9; p += 2; break;
3633 if (*p && !qemu_isspace(*p)) {
3634 monitor_printf(mon, "Unknown unit suffix\n");
3635 goto fail;
3637 qdict_put(qdict, key, qfloat_from_double(val));
3639 break;
3640 case 'b':
3642 const char *beg;
3643 int val;
3645 while (qemu_isspace(*p)) {
3646 p++;
3648 beg = p;
3649 while (qemu_isgraph(*p)) {
3650 p++;
3652 if (p - beg == 2 && !memcmp(beg, "on", p - beg)) {
3653 val = 1;
3654 } else if (p - beg == 3 && !memcmp(beg, "off", p - beg)) {
3655 val = 0;
3656 } else {
3657 monitor_printf(mon, "Expected 'on' or 'off'\n");
3658 goto fail;
3660 qdict_put(qdict, key, qbool_from_int(val));
3662 break;
3663 case '-':
3665 const char *tmp = p;
3666 int skip_key = 0;
3667 /* option */
3669 c = *typestr++;
3670 if (c == '\0')
3671 goto bad_type;
3672 while (qemu_isspace(*p))
3673 p++;
3674 if (*p == '-') {
3675 p++;
3676 if(c != *p) {
3677 if(!is_valid_option(p, typestr)) {
3679 monitor_printf(mon, "%s: unsupported option -%c\n",
3680 cmdname, *p);
3681 goto fail;
3682 } else {
3683 skip_key = 1;
3686 if(skip_key) {
3687 p = tmp;
3688 } else {
3689 /* has option */
3690 p++;
3691 qdict_put(qdict, key, qbool_from_int(1));
3695 break;
3696 default:
3697 bad_type:
3698 monitor_printf(mon, "%s: unknown type '%c'\n", cmdname, c);
3699 goto fail;
3701 qemu_free(key);
3702 key = NULL;
3704 /* check that all arguments were parsed */
3705 while (qemu_isspace(*p))
3706 p++;
3707 if (*p != '\0') {
3708 monitor_printf(mon, "%s: extraneous characters at the end of line\n",
3709 cmdname);
3710 goto fail;
3713 return cmd;
3715 fail:
3716 qemu_free(key);
3717 return NULL;
3720 void monitor_set_error(Monitor *mon, QError *qerror)
3722 /* report only the first error */
3723 if (!mon->error) {
3724 mon->error = qerror;
3725 } else {
3726 MON_DEBUG("Additional error report at %s:%d\n",
3727 qerror->file, qerror->linenr);
3728 QDECREF(qerror);
3732 static int is_async_return(const QObject *data)
3734 if (data && qobject_type(data) == QTYPE_QDICT) {
3735 return qdict_haskey(qobject_to_qdict(data), "__mon_async");
3738 return 0;
3741 static void handler_audit(Monitor *mon, const mon_cmd_t *cmd, int ret)
3743 if (monitor_ctrl_mode(mon)) {
3744 if (ret && !monitor_has_error(mon)) {
3746 * If it returns failure, it must have passed on error.
3748 * Action: Report an internal error to the client if in QMP.
3750 qerror_report(QERR_UNDEFINED_ERROR);
3751 MON_DEBUG("command '%s' returned failure but did not pass an error\n",
3752 cmd->name);
3755 #ifdef CONFIG_DEBUG_MONITOR
3756 if (!ret && monitor_has_error(mon)) {
3758 * If it returns success, it must not have passed an error.
3760 * Action: Report the passed error to the client.
3762 MON_DEBUG("command '%s' returned success but passed an error\n",
3763 cmd->name);
3766 if (mon_print_count_get(mon) > 0 && strcmp(cmd->name, "info") != 0) {
3768 * Handlers should not call Monitor print functions.
3770 * Action: Ignore them in QMP.
3772 * (XXX: we don't check any 'info' or 'query' command here
3773 * because the user print function _is_ called by do_info(), hence
3774 * we will trigger this check. This problem will go away when we
3775 * make 'query' commands real and kill do_info())
3777 MON_DEBUG("command '%s' called print functions %d time(s)\n",
3778 cmd->name, mon_print_count_get(mon));
3780 #endif
3781 } else {
3782 assert(!monitor_has_error(mon));
3783 QDECREF(mon->error);
3784 mon->error = NULL;
3788 static void monitor_call_handler(Monitor *mon, const mon_cmd_t *cmd,
3789 const QDict *params)
3791 int ret;
3792 QObject *data = NULL;
3794 mon_print_count_init(mon);
3796 ret = cmd->mhandler.cmd_new(mon, params, &data);
3797 handler_audit(mon, cmd, ret);
3799 if (is_async_return(data)) {
3801 * Asynchronous commands have no initial return data but they can
3802 * generate errors. Data is returned via the async completion handler.
3804 if (monitor_ctrl_mode(mon) && monitor_has_error(mon)) {
3805 monitor_protocol_emitter(mon, NULL);
3807 } else if (monitor_ctrl_mode(mon)) {
3808 /* Monitor Protocol */
3809 monitor_protocol_emitter(mon, data);
3810 } else {
3811 /* User Protocol */
3812 if (data)
3813 cmd->user_print(mon, data);
3816 qobject_decref(data);
3819 static void handle_user_command(Monitor *mon, const char *cmdline)
3821 QDict *qdict;
3822 const mon_cmd_t *cmd;
3824 qdict = qdict_new();
3826 cmd = monitor_parse_command(mon, cmdline, qdict);
3827 if (!cmd)
3828 goto out;
3830 if (monitor_handler_is_async(cmd)) {
3831 user_async_cmd_handler(mon, cmd, qdict);
3832 } else if (monitor_handler_ported(cmd)) {
3833 monitor_call_handler(mon, cmd, qdict);
3834 } else {
3835 cmd->mhandler.cmd(mon, qdict);
3838 out:
3839 QDECREF(qdict);
3842 static void cmd_completion(const char *name, const char *list)
3844 const char *p, *pstart;
3845 char cmd[128];
3846 int len;
3848 p = list;
3849 for(;;) {
3850 pstart = p;
3851 p = strchr(p, '|');
3852 if (!p)
3853 p = pstart + strlen(pstart);
3854 len = p - pstart;
3855 if (len > sizeof(cmd) - 2)
3856 len = sizeof(cmd) - 2;
3857 memcpy(cmd, pstart, len);
3858 cmd[len] = '\0';
3859 if (name[0] == '\0' || !strncmp(name, cmd, strlen(name))) {
3860 readline_add_completion(cur_mon->rs, cmd);
3862 if (*p == '\0')
3863 break;
3864 p++;
3868 static void file_completion(const char *input)
3870 DIR *ffs;
3871 struct dirent *d;
3872 char path[1024];
3873 char file[1024], file_prefix[1024];
3874 int input_path_len;
3875 const char *p;
3877 p = strrchr(input, '/');
3878 if (!p) {
3879 input_path_len = 0;
3880 pstrcpy(file_prefix, sizeof(file_prefix), input);
3881 pstrcpy(path, sizeof(path), ".");
3882 } else {
3883 input_path_len = p - input + 1;
3884 memcpy(path, input, input_path_len);
3885 if (input_path_len > sizeof(path) - 1)
3886 input_path_len = sizeof(path) - 1;
3887 path[input_path_len] = '\0';
3888 pstrcpy(file_prefix, sizeof(file_prefix), p + 1);
3890 #ifdef DEBUG_COMPLETION
3891 monitor_printf(cur_mon, "input='%s' path='%s' prefix='%s'\n",
3892 input, path, file_prefix);
3893 #endif
3894 ffs = opendir(path);
3895 if (!ffs)
3896 return;
3897 for(;;) {
3898 struct stat sb;
3899 d = readdir(ffs);
3900 if (!d)
3901 break;
3902 if (strstart(d->d_name, file_prefix, NULL)) {
3903 memcpy(file, input, input_path_len);
3904 if (input_path_len < sizeof(file))
3905 pstrcpy(file + input_path_len, sizeof(file) - input_path_len,
3906 d->d_name);
3907 /* stat the file to find out if it's a directory.
3908 * In that case add a slash to speed up typing long paths
3910 stat(file, &sb);
3911 if(S_ISDIR(sb.st_mode))
3912 pstrcat(file, sizeof(file), "/");
3913 readline_add_completion(cur_mon->rs, file);
3916 closedir(ffs);
3919 static void block_completion_it(void *opaque, BlockDriverState *bs)
3921 const char *name = bdrv_get_device_name(bs);
3922 const char *input = opaque;
3924 if (input[0] == '\0' ||
3925 !strncmp(name, (char *)input, strlen(input))) {
3926 readline_add_completion(cur_mon->rs, name);
3930 /* NOTE: this parser is an approximate form of the real command parser */
3931 static void parse_cmdline(const char *cmdline,
3932 int *pnb_args, char **args)
3934 const char *p;
3935 int nb_args, ret;
3936 char buf[1024];
3938 p = cmdline;
3939 nb_args = 0;
3940 for(;;) {
3941 while (qemu_isspace(*p))
3942 p++;
3943 if (*p == '\0')
3944 break;
3945 if (nb_args >= MAX_ARGS)
3946 break;
3947 ret = get_str(buf, sizeof(buf), &p);
3948 args[nb_args] = qemu_strdup(buf);
3949 nb_args++;
3950 if (ret < 0)
3951 break;
3953 *pnb_args = nb_args;
3956 static const char *next_arg_type(const char *typestr)
3958 const char *p = strchr(typestr, ':');
3959 return (p != NULL ? ++p : typestr);
3962 static void monitor_find_completion(const char *cmdline)
3964 const char *cmdname;
3965 char *args[MAX_ARGS];
3966 int nb_args, i, len;
3967 const char *ptype, *str;
3968 const mon_cmd_t *cmd;
3969 const KeyDef *key;
3971 parse_cmdline(cmdline, &nb_args, args);
3972 #ifdef DEBUG_COMPLETION
3973 for(i = 0; i < nb_args; i++) {
3974 monitor_printf(cur_mon, "arg%d = '%s'\n", i, (char *)args[i]);
3976 #endif
3978 /* if the line ends with a space, it means we want to complete the
3979 next arg */
3980 len = strlen(cmdline);
3981 if (len > 0 && qemu_isspace(cmdline[len - 1])) {
3982 if (nb_args >= MAX_ARGS) {
3983 goto cleanup;
3985 args[nb_args++] = qemu_strdup("");
3987 if (nb_args <= 1) {
3988 /* command completion */
3989 if (nb_args == 0)
3990 cmdname = "";
3991 else
3992 cmdname = args[0];
3993 readline_set_completion_index(cur_mon->rs, strlen(cmdname));
3994 for(cmd = mon_cmds; cmd->name != NULL; cmd++) {
3995 cmd_completion(cmdname, cmd->name);
3997 } else {
3998 /* find the command */
3999 for (cmd = mon_cmds; cmd->name != NULL; cmd++) {
4000 if (compare_cmd(args[0], cmd->name)) {
4001 break;
4004 if (!cmd->name) {
4005 goto cleanup;
4008 ptype = next_arg_type(cmd->args_type);
4009 for(i = 0; i < nb_args - 2; i++) {
4010 if (*ptype != '\0') {
4011 ptype = next_arg_type(ptype);
4012 while (*ptype == '?')
4013 ptype = next_arg_type(ptype);
4016 str = args[nb_args - 1];
4017 if (*ptype == '-' && ptype[1] != '\0') {
4018 ptype = next_arg_type(ptype);
4020 switch(*ptype) {
4021 case 'F':
4022 /* file completion */
4023 readline_set_completion_index(cur_mon->rs, strlen(str));
4024 file_completion(str);
4025 break;
4026 case 'B':
4027 /* block device name completion */
4028 readline_set_completion_index(cur_mon->rs, strlen(str));
4029 bdrv_iterate(block_completion_it, (void *)str);
4030 break;
4031 case 's':
4032 /* XXX: more generic ? */
4033 if (!strcmp(cmd->name, "info")) {
4034 readline_set_completion_index(cur_mon->rs, strlen(str));
4035 for(cmd = info_cmds; cmd->name != NULL; cmd++) {
4036 cmd_completion(str, cmd->name);
4038 } else if (!strcmp(cmd->name, "sendkey")) {
4039 char *sep = strrchr(str, '-');
4040 if (sep)
4041 str = sep + 1;
4042 readline_set_completion_index(cur_mon->rs, strlen(str));
4043 for(key = key_defs; key->name != NULL; key++) {
4044 cmd_completion(str, key->name);
4046 } else if (!strcmp(cmd->name, "help|?")) {
4047 readline_set_completion_index(cur_mon->rs, strlen(str));
4048 for (cmd = mon_cmds; cmd->name != NULL; cmd++) {
4049 cmd_completion(str, cmd->name);
4052 break;
4053 default:
4054 break;
4058 cleanup:
4059 for (i = 0; i < nb_args; i++) {
4060 qemu_free(args[i]);
4064 static int monitor_can_read(void *opaque)
4066 Monitor *mon = opaque;
4068 return (mon->suspend_cnt == 0) ? 1 : 0;
4071 static int invalid_qmp_mode(const Monitor *mon, const char *cmd_name)
4073 int is_cap = compare_cmd(cmd_name, "qmp_capabilities");
4074 return (qmp_cmd_mode(mon) ? is_cap : !is_cap);
4078 * Argument validation rules:
4080 * 1. The argument must exist in cmd_args qdict
4081 * 2. The argument type must be the expected one
4083 * Special case: If the argument doesn't exist in cmd_args and
4084 * the QMP_ACCEPT_UNKNOWNS flag is set, then the
4085 * checking is skipped for it.
4087 static int check_client_args_type(const QDict *client_args,
4088 const QDict *cmd_args, int flags)
4090 const QDictEntry *ent;
4092 for (ent = qdict_first(client_args); ent;ent = qdict_next(client_args,ent)){
4093 QObject *obj;
4094 QString *arg_type;
4095 const QObject *client_arg = qdict_entry_value(ent);
4096 const char *client_arg_name = qdict_entry_key(ent);
4098 obj = qdict_get(cmd_args, client_arg_name);
4099 if (!obj) {
4100 if (flags & QMP_ACCEPT_UNKNOWNS) {
4101 /* handler accepts unknowns */
4102 continue;
4104 /* client arg doesn't exist */
4105 qerror_report(QERR_INVALID_PARAMETER, client_arg_name);
4106 return -1;
4109 arg_type = qobject_to_qstring(obj);
4110 assert(arg_type != NULL);
4112 /* check if argument's type is correct */
4113 switch (qstring_get_str(arg_type)[0]) {
4114 case 'F':
4115 case 'B':
4116 case 's':
4117 if (qobject_type(client_arg) != QTYPE_QSTRING) {
4118 qerror_report(QERR_INVALID_PARAMETER_TYPE, client_arg_name,
4119 "string");
4120 return -1;
4122 break;
4123 case 'i':
4124 case 'l':
4125 case 'M':
4126 if (qobject_type(client_arg) != QTYPE_QINT) {
4127 qerror_report(QERR_INVALID_PARAMETER_TYPE, client_arg_name,
4128 "int");
4129 return -1;
4131 break;
4132 case 'f':
4133 case 'T':
4134 if (qobject_type(client_arg) != QTYPE_QINT &&
4135 qobject_type(client_arg) != QTYPE_QFLOAT) {
4136 qerror_report(QERR_INVALID_PARAMETER_TYPE, client_arg_name,
4137 "number");
4138 return -1;
4140 break;
4141 case 'b':
4142 case '-':
4143 if (qobject_type(client_arg) != QTYPE_QBOOL) {
4144 qerror_report(QERR_INVALID_PARAMETER_TYPE, client_arg_name,
4145 "bool");
4146 return -1;
4148 break;
4149 case 'O':
4150 assert(flags & QMP_ACCEPT_UNKNOWNS);
4151 break;
4152 case '/':
4153 case '.':
4155 * These types are not supported by QMP and thus are not
4156 * handled here. Fall through.
4158 default:
4159 abort();
4163 return 0;
4167 * - Check if the client has passed all mandatory args
4168 * - Set special flags for argument validation
4170 static int check_mandatory_args(const QDict *cmd_args,
4171 const QDict *client_args, int *flags)
4173 const QDictEntry *ent;
4175 for (ent = qdict_first(cmd_args); ent; ent = qdict_next(cmd_args, ent)) {
4176 const char *cmd_arg_name = qdict_entry_key(ent);
4177 QString *type = qobject_to_qstring(qdict_entry_value(ent));
4178 assert(type != NULL);
4180 if (qstring_get_str(type)[0] == 'O') {
4181 assert((*flags & QMP_ACCEPT_UNKNOWNS) == 0);
4182 *flags |= QMP_ACCEPT_UNKNOWNS;
4183 } else if (qstring_get_str(type)[0] != '-' &&
4184 qstring_get_str(type)[1] != '?' &&
4185 !qdict_haskey(client_args, cmd_arg_name)) {
4186 qerror_report(QERR_MISSING_PARAMETER, cmd_arg_name);
4187 return -1;
4191 return 0;
4194 static QDict *qdict_from_args_type(const char *args_type)
4196 int i;
4197 QDict *qdict;
4198 QString *key, *type, *cur_qs;
4200 assert(args_type != NULL);
4202 qdict = qdict_new();
4204 if (args_type == NULL || args_type[0] == '\0') {
4205 /* no args, empty qdict */
4206 goto out;
4209 key = qstring_new();
4210 type = qstring_new();
4212 cur_qs = key;
4214 for (i = 0;; i++) {
4215 switch (args_type[i]) {
4216 case ',':
4217 case '\0':
4218 qdict_put(qdict, qstring_get_str(key), type);
4219 QDECREF(key);
4220 if (args_type[i] == '\0') {
4221 goto out;
4223 type = qstring_new(); /* qdict has ref */
4224 cur_qs = key = qstring_new();
4225 break;
4226 case ':':
4227 cur_qs = type;
4228 break;
4229 default:
4230 qstring_append_chr(cur_qs, args_type[i]);
4231 break;
4235 out:
4236 return qdict;
4240 * Client argument checking rules:
4242 * 1. Client must provide all mandatory arguments
4243 * 2. Each argument provided by the client must be expected
4244 * 3. Each argument provided by the client must have the type expected
4245 * by the command
4247 static int qmp_check_client_args(const mon_cmd_t *cmd, QDict *client_args)
4249 int flags, err;
4250 QDict *cmd_args;
4252 cmd_args = qdict_from_args_type(cmd->args_type);
4254 flags = 0;
4255 err = check_mandatory_args(cmd_args, client_args, &flags);
4256 if (err) {
4257 goto out;
4260 err = check_client_args_type(client_args, cmd_args, flags);
4262 out:
4263 QDECREF(cmd_args);
4264 return err;
4268 * Input object checking rules
4270 * 1. Input object must be a dict
4271 * 2. The "execute" key must exist
4272 * 3. The "execute" key must be a string
4273 * 4. If the "arguments" key exists, it must be a dict
4274 * 5. If the "id" key exists, it can be anything (ie. json-value)
4275 * 6. Any argument not listed above is considered invalid
4277 static QDict *qmp_check_input_obj(QObject *input_obj)
4279 const QDictEntry *ent;
4280 int has_exec_key = 0;
4281 QDict *input_dict;
4283 if (qobject_type(input_obj) != QTYPE_QDICT) {
4284 qerror_report(QERR_QMP_BAD_INPUT_OBJECT, "object");
4285 return NULL;
4288 input_dict = qobject_to_qdict(input_obj);
4290 for (ent = qdict_first(input_dict); ent; ent = qdict_next(input_dict, ent)){
4291 const char *arg_name = qdict_entry_key(ent);
4292 const QObject *arg_obj = qdict_entry_value(ent);
4294 if (!strcmp(arg_name, "execute")) {
4295 if (qobject_type(arg_obj) != QTYPE_QSTRING) {
4296 qerror_report(QERR_QMP_BAD_INPUT_OBJECT_MEMBER, "execute",
4297 "string");
4298 return NULL;
4300 has_exec_key = 1;
4301 } else if (!strcmp(arg_name, "arguments")) {
4302 if (qobject_type(arg_obj) != QTYPE_QDICT) {
4303 qerror_report(QERR_QMP_BAD_INPUT_OBJECT_MEMBER, "arguments",
4304 "object");
4305 return NULL;
4307 } else if (!strcmp(arg_name, "id")) {
4308 /* FIXME: check duplicated IDs for async commands */
4309 } else {
4310 qerror_report(QERR_QMP_EXTRA_MEMBER, arg_name);
4311 return NULL;
4315 if (!has_exec_key) {
4316 qerror_report(QERR_QMP_BAD_INPUT_OBJECT, "execute");
4317 return NULL;
4320 return input_dict;
4323 static void handle_qmp_command(JSONMessageParser *parser, QList *tokens)
4325 int err;
4326 QObject *obj;
4327 QDict *input, *args;
4328 const mon_cmd_t *cmd;
4329 Monitor *mon = cur_mon;
4330 const char *cmd_name, *info_item;
4332 args = input = NULL;
4334 obj = json_parser_parse(tokens, NULL);
4335 if (!obj) {
4336 // FIXME: should be triggered in json_parser_parse()
4337 qerror_report(QERR_JSON_PARSING);
4338 goto err_out;
4341 input = qmp_check_input_obj(obj);
4342 if (!input) {
4343 qobject_decref(obj);
4344 goto err_out;
4347 mon->mc->id = qdict_get(input, "id");
4348 qobject_incref(mon->mc->id);
4350 cmd_name = qdict_get_str(input, "execute");
4351 if (invalid_qmp_mode(mon, cmd_name)) {
4352 qerror_report(QERR_COMMAND_NOT_FOUND, cmd_name);
4353 goto err_out;
4357 * XXX: We need this special case until we get info handlers
4358 * converted into 'query-' commands
4360 if (compare_cmd(cmd_name, "info")) {
4361 qerror_report(QERR_COMMAND_NOT_FOUND, cmd_name);
4362 goto err_out;
4363 } else if (strstart(cmd_name, "query-", &info_item)) {
4364 cmd = monitor_find_command("info");
4365 qdict_put_obj(input, "arguments",
4366 qobject_from_jsonf("{ 'item': %s }", info_item));
4367 } else {
4368 cmd = monitor_find_command(cmd_name);
4369 if (!cmd || !monitor_handler_ported(cmd)
4370 || monitor_cmd_user_only(cmd)) {
4371 qerror_report(QERR_COMMAND_NOT_FOUND, cmd_name);
4372 goto err_out;
4376 obj = qdict_get(input, "arguments");
4377 if (!obj) {
4378 args = qdict_new();
4379 } else {
4380 args = qobject_to_qdict(obj);
4381 QINCREF(args);
4384 err = qmp_check_client_args(cmd, args);
4385 if (err < 0) {
4386 goto err_out;
4389 if (monitor_handler_is_async(cmd)) {
4390 err = qmp_async_cmd_handler(mon, cmd, args);
4391 if (err) {
4392 /* emit the error response */
4393 goto err_out;
4395 } else {
4396 monitor_call_handler(mon, cmd, args);
4399 goto out;
4401 err_out:
4402 monitor_protocol_emitter(mon, NULL);
4403 out:
4404 QDECREF(input);
4405 QDECREF(args);
4409 * monitor_control_read(): Read and handle QMP input
4411 static void monitor_control_read(void *opaque, const uint8_t *buf, int size)
4413 Monitor *old_mon = cur_mon;
4415 cur_mon = opaque;
4417 json_message_parser_feed(&cur_mon->mc->parser, (const char *) buf, size);
4419 cur_mon = old_mon;
4422 static void monitor_read(void *opaque, const uint8_t *buf, int size)
4424 Monitor *old_mon = cur_mon;
4425 int i;
4427 cur_mon = opaque;
4429 if (cur_mon->rs) {
4430 for (i = 0; i < size; i++)
4431 readline_handle_byte(cur_mon->rs, buf[i]);
4432 } else {
4433 if (size == 0 || buf[size - 1] != 0)
4434 monitor_printf(cur_mon, "corrupted command\n");
4435 else
4436 handle_user_command(cur_mon, (char *)buf);
4439 cur_mon = old_mon;
4442 static void monitor_command_cb(Monitor *mon, const char *cmdline, void *opaque)
4444 monitor_suspend(mon);
4445 handle_user_command(mon, cmdline);
4446 monitor_resume(mon);
4449 int monitor_suspend(Monitor *mon)
4451 if (!mon->rs)
4452 return -ENOTTY;
4453 mon->suspend_cnt++;
4454 return 0;
4457 void monitor_resume(Monitor *mon)
4459 if (!mon->rs)
4460 return;
4461 if (--mon->suspend_cnt == 0)
4462 readline_show_prompt(mon->rs);
4465 static QObject *get_qmp_greeting(void)
4467 QObject *ver;
4469 do_info_version(NULL, &ver);
4470 return qobject_from_jsonf("{'QMP':{'version': %p,'capabilities': []}}",ver);
4474 * monitor_control_event(): Print QMP gretting
4476 static void monitor_control_event(void *opaque, int event)
4478 QObject *data;
4479 Monitor *mon = opaque;
4481 switch (event) {
4482 case CHR_EVENT_OPENED:
4483 mon->mc->command_mode = 0;
4484 json_message_parser_init(&mon->mc->parser, handle_qmp_command);
4485 data = get_qmp_greeting();
4486 monitor_json_emitter(mon, data);
4487 qobject_decref(data);
4488 break;
4489 case CHR_EVENT_CLOSED:
4490 json_message_parser_destroy(&mon->mc->parser);
4491 break;
4495 static void monitor_event(void *opaque, int event)
4497 Monitor *mon = opaque;
4499 switch (event) {
4500 case CHR_EVENT_MUX_IN:
4501 mon->mux_out = 0;
4502 if (mon->reset_seen) {
4503 readline_restart(mon->rs);
4504 monitor_resume(mon);
4505 monitor_flush(mon);
4506 } else {
4507 mon->suspend_cnt = 0;
4509 break;
4511 case CHR_EVENT_MUX_OUT:
4512 if (mon->reset_seen) {
4513 if (mon->suspend_cnt == 0) {
4514 monitor_printf(mon, "\n");
4516 monitor_flush(mon);
4517 monitor_suspend(mon);
4518 } else {
4519 mon->suspend_cnt++;
4521 mon->mux_out = 1;
4522 break;
4524 case CHR_EVENT_OPENED:
4525 monitor_printf(mon, "QEMU %s monitor - type 'help' for more "
4526 "information\n", QEMU_VERSION);
4527 if (!mon->mux_out) {
4528 readline_show_prompt(mon->rs);
4530 mon->reset_seen = 1;
4531 break;
4537 * Local variables:
4538 * c-indent-level: 4
4539 * c-basic-offset: 4
4540 * tab-width: 8
4541 * End:
4544 void monitor_init(CharDriverState *chr, int flags)
4546 static int is_first_init = 1;
4547 Monitor *mon;
4549 if (is_first_init) {
4550 key_timer = qemu_new_timer(vm_clock, release_keys, NULL);
4551 is_first_init = 0;
4554 mon = qemu_mallocz(sizeof(*mon));
4556 mon->chr = chr;
4557 mon->flags = flags;
4558 if (flags & MONITOR_USE_READLINE) {
4559 mon->rs = readline_init(mon, monitor_find_completion);
4560 monitor_read_command(mon, 0);
4563 if (monitor_ctrl_mode(mon)) {
4564 mon->mc = qemu_mallocz(sizeof(MonitorControl));
4565 /* Control mode requires special handlers */
4566 qemu_chr_add_handlers(chr, monitor_can_read, monitor_control_read,
4567 monitor_control_event, mon);
4568 } else {
4569 qemu_chr_add_handlers(chr, monitor_can_read, monitor_read,
4570 monitor_event, mon);
4573 QLIST_INSERT_HEAD(&mon_list, mon, entry);
4574 if (!default_mon || (flags & MONITOR_IS_DEFAULT))
4575 default_mon = mon;
4578 static void bdrv_password_cb(Monitor *mon, const char *password, void *opaque)
4580 BlockDriverState *bs = opaque;
4581 int ret = 0;
4583 if (bdrv_set_key(bs, password) != 0) {
4584 monitor_printf(mon, "invalid password\n");
4585 ret = -EPERM;
4587 if (mon->password_completion_cb)
4588 mon->password_completion_cb(mon->password_opaque, ret);
4590 monitor_read_command(mon, 1);
4593 int monitor_read_bdrv_key_start(Monitor *mon, BlockDriverState *bs,
4594 BlockDriverCompletionFunc *completion_cb,
4595 void *opaque)
4597 int err;
4599 if (!bdrv_key_required(bs)) {
4600 if (completion_cb)
4601 completion_cb(opaque, 0);
4602 return 0;
4605 if (monitor_ctrl_mode(mon)) {
4606 qerror_report(QERR_DEVICE_ENCRYPTED, bdrv_get_device_name(bs));
4607 return -1;
4610 monitor_printf(mon, "%s (%s) is encrypted.\n", bdrv_get_device_name(bs),
4611 bdrv_get_encrypted_filename(bs));
4613 mon->password_completion_cb = completion_cb;
4614 mon->password_opaque = opaque;
4616 err = monitor_read_password(mon, bdrv_password_cb, bs);
4618 if (err && completion_cb)
4619 completion_cb(opaque, err);
4621 return err;