blockdev: Use GCC_FMT_ATTR (format checking)
[qemu.git] / monitor.c
blob377ab378c297a79c5563075104515643ac392b0d
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 GCC_FMT_ATTR(2, 3) monitor_fprintf(FILE *stream,
320 const char *fmt, ...)
322 va_list ap;
323 va_start(ap, fmt);
324 monitor_vprintf((Monitor *)stream, fmt, ap);
325 va_end(ap);
326 return 0;
329 static void monitor_user_noop(Monitor *mon, const QObject *data) { }
331 static inline int monitor_handler_ported(const mon_cmd_t *cmd)
333 return cmd->user_print != NULL;
336 static inline bool monitor_handler_is_async(const mon_cmd_t *cmd)
338 return cmd->flags & MONITOR_CMD_ASYNC;
341 static inline bool monitor_cmd_user_only(const mon_cmd_t *cmd)
343 return (cmd->flags & MONITOR_CMD_USER_ONLY);
346 static inline int monitor_has_error(const Monitor *mon)
348 return mon->error != NULL;
351 static void monitor_json_emitter(Monitor *mon, const QObject *data)
353 QString *json;
355 json = qobject_to_json(data);
356 assert(json != NULL);
358 qstring_append_chr(json, '\n');
359 monitor_puts(mon, qstring_get_str(json));
361 QDECREF(json);
364 static void monitor_protocol_emitter(Monitor *mon, QObject *data)
366 QDict *qmp;
368 qmp = qdict_new();
370 if (!monitor_has_error(mon)) {
371 /* success response */
372 if (data) {
373 qobject_incref(data);
374 qdict_put_obj(qmp, "return", data);
375 } else {
376 /* return an empty QDict by default */
377 qdict_put(qmp, "return", qdict_new());
379 } else {
380 /* error response */
381 qdict_put(mon->error->error, "desc", qerror_human(mon->error));
382 qdict_put(qmp, "error", mon->error->error);
383 QINCREF(mon->error->error);
384 QDECREF(mon->error);
385 mon->error = NULL;
388 if (mon->mc->id) {
389 qdict_put_obj(qmp, "id", mon->mc->id);
390 mon->mc->id = NULL;
393 monitor_json_emitter(mon, QOBJECT(qmp));
394 QDECREF(qmp);
397 static void timestamp_put(QDict *qdict)
399 int err;
400 QObject *obj;
401 qemu_timeval tv;
403 err = qemu_gettimeofday(&tv);
404 if (err < 0)
405 return;
407 obj = qobject_from_jsonf("{ 'seconds': %" PRId64 ", "
408 "'microseconds': %" PRId64 " }",
409 (int64_t) tv.tv_sec, (int64_t) tv.tv_usec);
410 qdict_put_obj(qdict, "timestamp", obj);
414 * monitor_protocol_event(): Generate a Monitor event
416 * Event-specific data can be emitted through the (optional) 'data' parameter.
418 void monitor_protocol_event(MonitorEvent event, QObject *data)
420 QDict *qmp;
421 const char *event_name;
422 Monitor *mon;
424 assert(event < QEVENT_MAX);
426 switch (event) {
427 case QEVENT_SHUTDOWN:
428 event_name = "SHUTDOWN";
429 break;
430 case QEVENT_RESET:
431 event_name = "RESET";
432 break;
433 case QEVENT_POWERDOWN:
434 event_name = "POWERDOWN";
435 break;
436 case QEVENT_STOP:
437 event_name = "STOP";
438 break;
439 case QEVENT_RESUME:
440 event_name = "RESUME";
441 break;
442 case QEVENT_VNC_CONNECTED:
443 event_name = "VNC_CONNECTED";
444 break;
445 case QEVENT_VNC_INITIALIZED:
446 event_name = "VNC_INITIALIZED";
447 break;
448 case QEVENT_VNC_DISCONNECTED:
449 event_name = "VNC_DISCONNECTED";
450 break;
451 case QEVENT_BLOCK_IO_ERROR:
452 event_name = "BLOCK_IO_ERROR";
453 break;
454 case QEVENT_RTC_CHANGE:
455 event_name = "RTC_CHANGE";
456 break;
457 case QEVENT_WATCHDOG:
458 event_name = "WATCHDOG";
459 break;
460 default:
461 abort();
462 break;
465 qmp = qdict_new();
466 timestamp_put(qmp);
467 qdict_put(qmp, "event", qstring_from_str(event_name));
468 if (data) {
469 qobject_incref(data);
470 qdict_put_obj(qmp, "data", data);
473 QLIST_FOREACH(mon, &mon_list, entry) {
474 if (monitor_ctrl_mode(mon) && qmp_cmd_mode(mon)) {
475 monitor_json_emitter(mon, QOBJECT(qmp));
478 QDECREF(qmp);
481 static int do_qmp_capabilities(Monitor *mon, const QDict *params,
482 QObject **ret_data)
484 /* Will setup QMP capabilities in the future */
485 if (monitor_ctrl_mode(mon)) {
486 mon->mc->command_mode = 1;
489 return 0;
492 static int compare_cmd(const char *name, const char *list)
494 const char *p, *pstart;
495 int len;
496 len = strlen(name);
497 p = list;
498 for(;;) {
499 pstart = p;
500 p = strchr(p, '|');
501 if (!p)
502 p = pstart + strlen(pstart);
503 if ((p - pstart) == len && !memcmp(pstart, name, len))
504 return 1;
505 if (*p == '\0')
506 break;
507 p++;
509 return 0;
512 static void help_cmd_dump(Monitor *mon, const mon_cmd_t *cmds,
513 const char *prefix, const char *name)
515 const mon_cmd_t *cmd;
517 for(cmd = cmds; cmd->name != NULL; cmd++) {
518 if (!name || !strcmp(name, cmd->name))
519 monitor_printf(mon, "%s%s %s -- %s\n", prefix, cmd->name,
520 cmd->params, cmd->help);
524 static void help_cmd(Monitor *mon, const char *name)
526 if (name && !strcmp(name, "info")) {
527 help_cmd_dump(mon, info_cmds, "info ", NULL);
528 } else {
529 help_cmd_dump(mon, mon_cmds, "", name);
530 if (name && !strcmp(name, "log")) {
531 const CPULogItem *item;
532 monitor_printf(mon, "Log items (comma separated):\n");
533 monitor_printf(mon, "%-10s %s\n", "none", "remove all logs");
534 for(item = cpu_log_items; item->mask != 0; item++) {
535 monitor_printf(mon, "%-10s %s\n", item->name, item->help);
541 static void do_help_cmd(Monitor *mon, const QDict *qdict)
543 help_cmd(mon, qdict_get_try_str(qdict, "name"));
546 #ifdef CONFIG_SIMPLE_TRACE
547 static void do_change_trace_event_state(Monitor *mon, const QDict *qdict)
549 const char *tp_name = qdict_get_str(qdict, "name");
550 bool new_state = qdict_get_bool(qdict, "option");
551 st_change_trace_event_state(tp_name, new_state);
554 static void do_trace_file(Monitor *mon, const QDict *qdict)
556 const char *op = qdict_get_try_str(qdict, "op");
557 const char *arg = qdict_get_try_str(qdict, "arg");
559 if (!op) {
560 st_print_trace_file_status((FILE *)mon, &monitor_fprintf);
561 } else if (!strcmp(op, "on")) {
562 st_set_trace_file_enabled(true);
563 } else if (!strcmp(op, "off")) {
564 st_set_trace_file_enabled(false);
565 } else if (!strcmp(op, "flush")) {
566 st_flush_trace_buffer();
567 } else if (!strcmp(op, "set")) {
568 if (arg) {
569 st_set_trace_file(arg);
571 } else {
572 monitor_printf(mon, "unexpected argument \"%s\"\n", op);
573 help_cmd(mon, "trace-file");
576 #endif
578 static void user_monitor_complete(void *opaque, QObject *ret_data)
580 MonitorCompletionData *data = (MonitorCompletionData *)opaque;
582 if (ret_data) {
583 data->user_print(data->mon, ret_data);
585 monitor_resume(data->mon);
586 qemu_free(data);
589 static void qmp_monitor_complete(void *opaque, QObject *ret_data)
591 monitor_protocol_emitter(opaque, ret_data);
594 static int qmp_async_cmd_handler(Monitor *mon, const mon_cmd_t *cmd,
595 const QDict *params)
597 return cmd->mhandler.cmd_async(mon, params, qmp_monitor_complete, mon);
600 static void qmp_async_info_handler(Monitor *mon, const mon_cmd_t *cmd)
602 cmd->mhandler.info_async(mon, qmp_monitor_complete, mon);
605 static void user_async_cmd_handler(Monitor *mon, const mon_cmd_t *cmd,
606 const QDict *params)
608 int ret;
610 MonitorCompletionData *cb_data = qemu_malloc(sizeof(*cb_data));
611 cb_data->mon = mon;
612 cb_data->user_print = cmd->user_print;
613 monitor_suspend(mon);
614 ret = cmd->mhandler.cmd_async(mon, params,
615 user_monitor_complete, cb_data);
616 if (ret < 0) {
617 monitor_resume(mon);
618 qemu_free(cb_data);
622 static void user_async_info_handler(Monitor *mon, const mon_cmd_t *cmd)
624 int ret;
626 MonitorCompletionData *cb_data = qemu_malloc(sizeof(*cb_data));
627 cb_data->mon = mon;
628 cb_data->user_print = cmd->user_print;
629 monitor_suspend(mon);
630 ret = cmd->mhandler.info_async(mon, user_monitor_complete, cb_data);
631 if (ret < 0) {
632 monitor_resume(mon);
633 qemu_free(cb_data);
637 static int do_info(Monitor *mon, const QDict *qdict, QObject **ret_data)
639 const mon_cmd_t *cmd;
640 const char *item = qdict_get_try_str(qdict, "item");
642 if (!item) {
643 assert(monitor_ctrl_mode(mon) == 0);
644 goto help;
647 for (cmd = info_cmds; cmd->name != NULL; cmd++) {
648 if (compare_cmd(item, cmd->name))
649 break;
652 if (cmd->name == NULL) {
653 if (monitor_ctrl_mode(mon)) {
654 qerror_report(QERR_COMMAND_NOT_FOUND, item);
655 return -1;
657 goto help;
660 if (monitor_ctrl_mode(mon) && monitor_cmd_user_only(cmd)) {
661 qerror_report(QERR_COMMAND_NOT_FOUND, item);
662 return -1;
665 if (monitor_handler_is_async(cmd)) {
666 if (monitor_ctrl_mode(mon)) {
667 qmp_async_info_handler(mon, cmd);
668 } else {
669 user_async_info_handler(mon, cmd);
672 * Indicate that this command is asynchronous and will not return any
673 * data (not even empty). Instead, the data will be returned via a
674 * completion callback.
676 *ret_data = qobject_from_jsonf("{ '__mon_async': 'return' }");
677 } else if (monitor_handler_ported(cmd)) {
678 cmd->mhandler.info_new(mon, ret_data);
680 if (!monitor_ctrl_mode(mon)) {
682 * User Protocol function is called here, Monitor Protocol is
683 * handled by monitor_call_handler()
685 if (*ret_data)
686 cmd->user_print(mon, *ret_data);
688 } else {
689 if (monitor_ctrl_mode(mon)) {
690 /* handler not converted yet */
691 qerror_report(QERR_COMMAND_NOT_FOUND, item);
692 return -1;
693 } else {
694 cmd->mhandler.info(mon);
698 return 0;
700 help:
701 help_cmd(mon, "info");
702 return 0;
705 static void do_info_version_print(Monitor *mon, const QObject *data)
707 QDict *qdict;
708 QDict *qemu;
710 qdict = qobject_to_qdict(data);
711 qemu = qdict_get_qdict(qdict, "qemu");
713 monitor_printf(mon, "%" PRId64 ".%" PRId64 ".%" PRId64 "%s\n",
714 qdict_get_int(qemu, "major"),
715 qdict_get_int(qemu, "minor"),
716 qdict_get_int(qemu, "micro"),
717 qdict_get_str(qdict, "package"));
720 static void do_info_version(Monitor *mon, QObject **ret_data)
722 const char *version = QEMU_VERSION;
723 int major = 0, minor = 0, micro = 0;
724 char *tmp;
726 major = strtol(version, &tmp, 10);
727 tmp++;
728 minor = strtol(tmp, &tmp, 10);
729 tmp++;
730 micro = strtol(tmp, &tmp, 10);
732 *ret_data = qobject_from_jsonf("{ 'qemu': { 'major': %d, 'minor': %d, \
733 'micro': %d }, 'package': %s }", major, minor, micro, QEMU_PKGVERSION);
736 static void do_info_name_print(Monitor *mon, const QObject *data)
738 QDict *qdict;
740 qdict = qobject_to_qdict(data);
741 if (qdict_size(qdict) == 0) {
742 return;
745 monitor_printf(mon, "%s\n", qdict_get_str(qdict, "name"));
748 static void do_info_name(Monitor *mon, QObject **ret_data)
750 *ret_data = qemu_name ? qobject_from_jsonf("{'name': %s }", qemu_name) :
751 qobject_from_jsonf("{}");
754 static QObject *get_cmd_dict(const char *name)
756 const char *p;
758 /* Remove '|' from some commands */
759 p = strchr(name, '|');
760 if (p) {
761 p++;
762 } else {
763 p = name;
766 return qobject_from_jsonf("{ 'name': %s }", p);
769 static void do_info_commands(Monitor *mon, QObject **ret_data)
771 QList *cmd_list;
772 const mon_cmd_t *cmd;
774 cmd_list = qlist_new();
776 for (cmd = mon_cmds; cmd->name != NULL; cmd++) {
777 if (monitor_handler_ported(cmd) && !monitor_cmd_user_only(cmd) &&
778 !compare_cmd(cmd->name, "info")) {
779 qlist_append_obj(cmd_list, get_cmd_dict(cmd->name));
783 for (cmd = info_cmds; cmd->name != NULL; cmd++) {
784 if (monitor_handler_ported(cmd) && !monitor_cmd_user_only(cmd)) {
785 char buf[128];
786 snprintf(buf, sizeof(buf), "query-%s", cmd->name);
787 qlist_append_obj(cmd_list, get_cmd_dict(buf));
791 *ret_data = QOBJECT(cmd_list);
794 static void do_info_uuid_print(Monitor *mon, const QObject *data)
796 monitor_printf(mon, "%s\n", qdict_get_str(qobject_to_qdict(data), "UUID"));
799 static void do_info_uuid(Monitor *mon, QObject **ret_data)
801 char uuid[64];
803 snprintf(uuid, sizeof(uuid), UUID_FMT, qemu_uuid[0], qemu_uuid[1],
804 qemu_uuid[2], qemu_uuid[3], qemu_uuid[4], qemu_uuid[5],
805 qemu_uuid[6], qemu_uuid[7], qemu_uuid[8], qemu_uuid[9],
806 qemu_uuid[10], qemu_uuid[11], qemu_uuid[12], qemu_uuid[13],
807 qemu_uuid[14], qemu_uuid[15]);
808 *ret_data = qobject_from_jsonf("{ 'UUID': %s }", uuid);
811 /* get the current CPU defined by the user */
812 static int mon_set_cpu(int cpu_index)
814 CPUState *env;
816 for(env = first_cpu; env != NULL; env = env->next_cpu) {
817 if (env->cpu_index == cpu_index) {
818 cur_mon->mon_cpu = env;
819 return 0;
822 return -1;
825 static CPUState *mon_get_cpu(void)
827 if (!cur_mon->mon_cpu) {
828 mon_set_cpu(0);
830 cpu_synchronize_state(cur_mon->mon_cpu);
831 return cur_mon->mon_cpu;
834 static void do_info_registers(Monitor *mon)
836 CPUState *env;
837 env = mon_get_cpu();
838 #ifdef TARGET_I386
839 cpu_dump_state(env, (FILE *)mon, monitor_fprintf,
840 X86_DUMP_FPU);
841 #else
842 cpu_dump_state(env, (FILE *)mon, monitor_fprintf,
844 #endif
847 static void print_cpu_iter(QObject *obj, void *opaque)
849 QDict *cpu;
850 int active = ' ';
851 Monitor *mon = opaque;
853 assert(qobject_type(obj) == QTYPE_QDICT);
854 cpu = qobject_to_qdict(obj);
856 if (qdict_get_bool(cpu, "current")) {
857 active = '*';
860 monitor_printf(mon, "%c CPU #%d: ", active, (int)qdict_get_int(cpu, "CPU"));
862 #if defined(TARGET_I386)
863 monitor_printf(mon, "pc=0x" TARGET_FMT_lx,
864 (target_ulong) qdict_get_int(cpu, "pc"));
865 #elif defined(TARGET_PPC)
866 monitor_printf(mon, "nip=0x" TARGET_FMT_lx,
867 (target_long) qdict_get_int(cpu, "nip"));
868 #elif defined(TARGET_SPARC)
869 monitor_printf(mon, "pc=0x " TARGET_FMT_lx,
870 (target_long) qdict_get_int(cpu, "pc"));
871 monitor_printf(mon, "npc=0x" TARGET_FMT_lx,
872 (target_long) qdict_get_int(cpu, "npc"));
873 #elif defined(TARGET_MIPS)
874 monitor_printf(mon, "PC=0x" TARGET_FMT_lx,
875 (target_long) qdict_get_int(cpu, "PC"));
876 #endif
878 if (qdict_get_bool(cpu, "halted")) {
879 monitor_printf(mon, " (halted)");
882 monitor_printf(mon, "\n");
885 static void monitor_print_cpus(Monitor *mon, const QObject *data)
887 QList *cpu_list;
889 assert(qobject_type(data) == QTYPE_QLIST);
890 cpu_list = qobject_to_qlist(data);
891 qlist_iter(cpu_list, print_cpu_iter, mon);
894 static void do_info_cpus(Monitor *mon, QObject **ret_data)
896 CPUState *env;
897 QList *cpu_list;
899 cpu_list = qlist_new();
901 /* just to set the default cpu if not already done */
902 mon_get_cpu();
904 for(env = first_cpu; env != NULL; env = env->next_cpu) {
905 QDict *cpu;
906 QObject *obj;
908 cpu_synchronize_state(env);
910 obj = qobject_from_jsonf("{ 'CPU': %d, 'current': %i, 'halted': %i }",
911 env->cpu_index, env == mon->mon_cpu,
912 env->halted);
914 cpu = qobject_to_qdict(obj);
916 #if defined(TARGET_I386)
917 qdict_put(cpu, "pc", qint_from_int(env->eip + env->segs[R_CS].base));
918 #elif defined(TARGET_PPC)
919 qdict_put(cpu, "nip", qint_from_int(env->nip));
920 #elif defined(TARGET_SPARC)
921 qdict_put(cpu, "pc", qint_from_int(env->pc));
922 qdict_put(cpu, "npc", qint_from_int(env->npc));
923 #elif defined(TARGET_MIPS)
924 qdict_put(cpu, "PC", qint_from_int(env->active_tc.PC));
925 #endif
927 qlist_append(cpu_list, cpu);
930 *ret_data = QOBJECT(cpu_list);
933 static int do_cpu_set(Monitor *mon, const QDict *qdict, QObject **ret_data)
935 int index = qdict_get_int(qdict, "index");
936 if (mon_set_cpu(index) < 0) {
937 qerror_report(QERR_INVALID_PARAMETER_VALUE, "index",
938 "a CPU number");
939 return -1;
941 return 0;
944 static void do_info_jit(Monitor *mon)
946 dump_exec_info((FILE *)mon, monitor_fprintf);
949 static void do_info_history(Monitor *mon)
951 int i;
952 const char *str;
954 if (!mon->rs)
955 return;
956 i = 0;
957 for(;;) {
958 str = readline_get_history(mon->rs, i);
959 if (!str)
960 break;
961 monitor_printf(mon, "%d: '%s'\n", i, str);
962 i++;
966 #if defined(TARGET_PPC)
967 /* XXX: not implemented in other targets */
968 static void do_info_cpu_stats(Monitor *mon)
970 CPUState *env;
972 env = mon_get_cpu();
973 cpu_dump_statistics(env, (FILE *)mon, &monitor_fprintf, 0);
975 #endif
977 #if defined(CONFIG_SIMPLE_TRACE)
978 static void do_info_trace(Monitor *mon)
980 st_print_trace((FILE *)mon, &monitor_fprintf);
983 static void do_info_trace_events(Monitor *mon)
985 st_print_trace_events((FILE *)mon, &monitor_fprintf);
987 #endif
990 * do_quit(): Quit QEMU execution
992 static int do_quit(Monitor *mon, const QDict *qdict, QObject **ret_data)
994 monitor_suspend(mon);
995 no_shutdown = 0;
996 qemu_system_shutdown_request();
998 return 0;
1001 static int change_vnc_password(const char *password)
1003 if (vnc_display_password(NULL, password) < 0) {
1004 qerror_report(QERR_SET_PASSWD_FAILED);
1005 return -1;
1008 return 0;
1011 static void change_vnc_password_cb(Monitor *mon, const char *password,
1012 void *opaque)
1014 change_vnc_password(password);
1015 monitor_read_command(mon, 1);
1018 static int do_change_vnc(Monitor *mon, const char *target, const char *arg)
1020 if (strcmp(target, "passwd") == 0 ||
1021 strcmp(target, "password") == 0) {
1022 if (arg) {
1023 char password[9];
1024 strncpy(password, arg, sizeof(password));
1025 password[sizeof(password) - 1] = '\0';
1026 return change_vnc_password(password);
1027 } else {
1028 return monitor_read_password(mon, change_vnc_password_cb, NULL);
1030 } else {
1031 if (vnc_display_open(NULL, target) < 0) {
1032 qerror_report(QERR_VNC_SERVER_FAILED, target);
1033 return -1;
1037 return 0;
1041 * do_change(): Change a removable medium, or VNC configuration
1043 static int do_change(Monitor *mon, const QDict *qdict, QObject **ret_data)
1045 const char *device = qdict_get_str(qdict, "device");
1046 const char *target = qdict_get_str(qdict, "target");
1047 const char *arg = qdict_get_try_str(qdict, "arg");
1048 int ret;
1050 if (strcmp(device, "vnc") == 0) {
1051 ret = do_change_vnc(mon, target, arg);
1052 } else {
1053 ret = do_change_block(mon, device, target, arg);
1056 return ret;
1059 static int do_screen_dump(Monitor *mon, const QDict *qdict, QObject **ret_data)
1061 vga_hw_screen_dump(qdict_get_str(qdict, "filename"));
1062 return 0;
1065 static void do_logfile(Monitor *mon, const QDict *qdict)
1067 cpu_set_log_filename(qdict_get_str(qdict, "filename"));
1070 static void do_log(Monitor *mon, const QDict *qdict)
1072 int mask;
1073 const char *items = qdict_get_str(qdict, "items");
1075 if (!strcmp(items, "none")) {
1076 mask = 0;
1077 } else {
1078 mask = cpu_str_to_log_mask(items);
1079 if (!mask) {
1080 help_cmd(mon, "log");
1081 return;
1084 cpu_set_log(mask);
1087 static void do_singlestep(Monitor *mon, const QDict *qdict)
1089 const char *option = qdict_get_try_str(qdict, "option");
1090 if (!option || !strcmp(option, "on")) {
1091 singlestep = 1;
1092 } else if (!strcmp(option, "off")) {
1093 singlestep = 0;
1094 } else {
1095 monitor_printf(mon, "unexpected option %s\n", option);
1100 * do_stop(): Stop VM execution
1102 static int do_stop(Monitor *mon, const QDict *qdict, QObject **ret_data)
1104 vm_stop(EXCP_INTERRUPT);
1105 return 0;
1108 static void encrypted_bdrv_it(void *opaque, BlockDriverState *bs);
1110 struct bdrv_iterate_context {
1111 Monitor *mon;
1112 int err;
1116 * do_cont(): Resume emulation.
1118 static int do_cont(Monitor *mon, const QDict *qdict, QObject **ret_data)
1120 struct bdrv_iterate_context context = { mon, 0 };
1122 if (incoming_expected) {
1123 qerror_report(QERR_MIGRATION_EXPECTED);
1124 return -1;
1126 bdrv_iterate(encrypted_bdrv_it, &context);
1127 /* only resume the vm if all keys are set and valid */
1128 if (!context.err) {
1129 vm_start();
1130 return 0;
1131 } else {
1132 return -1;
1136 static void bdrv_key_cb(void *opaque, int err)
1138 Monitor *mon = opaque;
1140 /* another key was set successfully, retry to continue */
1141 if (!err)
1142 do_cont(mon, NULL, NULL);
1145 static void encrypted_bdrv_it(void *opaque, BlockDriverState *bs)
1147 struct bdrv_iterate_context *context = opaque;
1149 if (!context->err && bdrv_key_required(bs)) {
1150 context->err = -EBUSY;
1151 monitor_read_bdrv_key_start(context->mon, bs, bdrv_key_cb,
1152 context->mon);
1156 static void do_gdbserver(Monitor *mon, const QDict *qdict)
1158 const char *device = qdict_get_try_str(qdict, "device");
1159 if (!device)
1160 device = "tcp::" DEFAULT_GDBSTUB_PORT;
1161 if (gdbserver_start(device) < 0) {
1162 monitor_printf(mon, "Could not open gdbserver on device '%s'\n",
1163 device);
1164 } else if (strcmp(device, "none") == 0) {
1165 monitor_printf(mon, "Disabled gdbserver\n");
1166 } else {
1167 monitor_printf(mon, "Waiting for gdb connection on device '%s'\n",
1168 device);
1172 static void do_watchdog_action(Monitor *mon, const QDict *qdict)
1174 const char *action = qdict_get_str(qdict, "action");
1175 if (select_watchdog_action(action) == -1) {
1176 monitor_printf(mon, "Unknown watchdog action '%s'\n", action);
1180 static void monitor_printc(Monitor *mon, int c)
1182 monitor_printf(mon, "'");
1183 switch(c) {
1184 case '\'':
1185 monitor_printf(mon, "\\'");
1186 break;
1187 case '\\':
1188 monitor_printf(mon, "\\\\");
1189 break;
1190 case '\n':
1191 monitor_printf(mon, "\\n");
1192 break;
1193 case '\r':
1194 monitor_printf(mon, "\\r");
1195 break;
1196 default:
1197 if (c >= 32 && c <= 126) {
1198 monitor_printf(mon, "%c", c);
1199 } else {
1200 monitor_printf(mon, "\\x%02x", c);
1202 break;
1204 monitor_printf(mon, "'");
1207 static void memory_dump(Monitor *mon, int count, int format, int wsize,
1208 target_phys_addr_t addr, int is_physical)
1210 CPUState *env;
1211 int l, line_size, i, max_digits, len;
1212 uint8_t buf[16];
1213 uint64_t v;
1215 if (format == 'i') {
1216 int flags;
1217 flags = 0;
1218 env = mon_get_cpu();
1219 #ifdef TARGET_I386
1220 if (wsize == 2) {
1221 flags = 1;
1222 } else if (wsize == 4) {
1223 flags = 0;
1224 } else {
1225 /* as default we use the current CS size */
1226 flags = 0;
1227 if (env) {
1228 #ifdef TARGET_X86_64
1229 if ((env->efer & MSR_EFER_LMA) &&
1230 (env->segs[R_CS].flags & DESC_L_MASK))
1231 flags = 2;
1232 else
1233 #endif
1234 if (!(env->segs[R_CS].flags & DESC_B_MASK))
1235 flags = 1;
1238 #endif
1239 monitor_disas(mon, env, addr, count, is_physical, flags);
1240 return;
1243 len = wsize * count;
1244 if (wsize == 1)
1245 line_size = 8;
1246 else
1247 line_size = 16;
1248 max_digits = 0;
1250 switch(format) {
1251 case 'o':
1252 max_digits = (wsize * 8 + 2) / 3;
1253 break;
1254 default:
1255 case 'x':
1256 max_digits = (wsize * 8) / 4;
1257 break;
1258 case 'u':
1259 case 'd':
1260 max_digits = (wsize * 8 * 10 + 32) / 33;
1261 break;
1262 case 'c':
1263 wsize = 1;
1264 break;
1267 while (len > 0) {
1268 if (is_physical)
1269 monitor_printf(mon, TARGET_FMT_plx ":", addr);
1270 else
1271 monitor_printf(mon, TARGET_FMT_lx ":", (target_ulong)addr);
1272 l = len;
1273 if (l > line_size)
1274 l = line_size;
1275 if (is_physical) {
1276 cpu_physical_memory_rw(addr, buf, l, 0);
1277 } else {
1278 env = mon_get_cpu();
1279 if (cpu_memory_rw_debug(env, addr, buf, l, 0) < 0) {
1280 monitor_printf(mon, " Cannot access memory\n");
1281 break;
1284 i = 0;
1285 while (i < l) {
1286 switch(wsize) {
1287 default:
1288 case 1:
1289 v = ldub_raw(buf + i);
1290 break;
1291 case 2:
1292 v = lduw_raw(buf + i);
1293 break;
1294 case 4:
1295 v = (uint32_t)ldl_raw(buf + i);
1296 break;
1297 case 8:
1298 v = ldq_raw(buf + i);
1299 break;
1301 monitor_printf(mon, " ");
1302 switch(format) {
1303 case 'o':
1304 monitor_printf(mon, "%#*" PRIo64, max_digits, v);
1305 break;
1306 case 'x':
1307 monitor_printf(mon, "0x%0*" PRIx64, max_digits, v);
1308 break;
1309 case 'u':
1310 monitor_printf(mon, "%*" PRIu64, max_digits, v);
1311 break;
1312 case 'd':
1313 monitor_printf(mon, "%*" PRId64, max_digits, v);
1314 break;
1315 case 'c':
1316 monitor_printc(mon, v);
1317 break;
1319 i += wsize;
1321 monitor_printf(mon, "\n");
1322 addr += l;
1323 len -= l;
1327 static void do_memory_dump(Monitor *mon, const QDict *qdict)
1329 int count = qdict_get_int(qdict, "count");
1330 int format = qdict_get_int(qdict, "format");
1331 int size = qdict_get_int(qdict, "size");
1332 target_long addr = qdict_get_int(qdict, "addr");
1334 memory_dump(mon, count, format, size, addr, 0);
1337 static void do_physical_memory_dump(Monitor *mon, const QDict *qdict)
1339 int count = qdict_get_int(qdict, "count");
1340 int format = qdict_get_int(qdict, "format");
1341 int size = qdict_get_int(qdict, "size");
1342 target_phys_addr_t addr = qdict_get_int(qdict, "addr");
1344 memory_dump(mon, count, format, size, addr, 1);
1347 static void do_print(Monitor *mon, const QDict *qdict)
1349 int format = qdict_get_int(qdict, "format");
1350 target_phys_addr_t val = qdict_get_int(qdict, "val");
1352 #if TARGET_PHYS_ADDR_BITS == 32
1353 switch(format) {
1354 case 'o':
1355 monitor_printf(mon, "%#o", val);
1356 break;
1357 case 'x':
1358 monitor_printf(mon, "%#x", val);
1359 break;
1360 case 'u':
1361 monitor_printf(mon, "%u", val);
1362 break;
1363 default:
1364 case 'd':
1365 monitor_printf(mon, "%d", val);
1366 break;
1367 case 'c':
1368 monitor_printc(mon, val);
1369 break;
1371 #else
1372 switch(format) {
1373 case 'o':
1374 monitor_printf(mon, "%#" PRIo64, val);
1375 break;
1376 case 'x':
1377 monitor_printf(mon, "%#" PRIx64, val);
1378 break;
1379 case 'u':
1380 monitor_printf(mon, "%" PRIu64, val);
1381 break;
1382 default:
1383 case 'd':
1384 monitor_printf(mon, "%" PRId64, val);
1385 break;
1386 case 'c':
1387 monitor_printc(mon, val);
1388 break;
1390 #endif
1391 monitor_printf(mon, "\n");
1394 static int do_memory_save(Monitor *mon, const QDict *qdict, QObject **ret_data)
1396 FILE *f;
1397 uint32_t size = qdict_get_int(qdict, "size");
1398 const char *filename = qdict_get_str(qdict, "filename");
1399 target_long addr = qdict_get_int(qdict, "val");
1400 uint32_t l;
1401 CPUState *env;
1402 uint8_t buf[1024];
1403 int ret = -1;
1405 env = mon_get_cpu();
1407 f = fopen(filename, "wb");
1408 if (!f) {
1409 qerror_report(QERR_OPEN_FILE_FAILED, filename);
1410 return -1;
1412 while (size != 0) {
1413 l = sizeof(buf);
1414 if (l > size)
1415 l = size;
1416 cpu_memory_rw_debug(env, addr, buf, l, 0);
1417 if (fwrite(buf, 1, l, f) != l) {
1418 monitor_printf(mon, "fwrite() error in do_memory_save\n");
1419 goto exit;
1421 addr += l;
1422 size -= l;
1425 ret = 0;
1427 exit:
1428 fclose(f);
1429 return ret;
1432 static int do_physical_memory_save(Monitor *mon, const QDict *qdict,
1433 QObject **ret_data)
1435 FILE *f;
1436 uint32_t l;
1437 uint8_t buf[1024];
1438 uint32_t size = qdict_get_int(qdict, "size");
1439 const char *filename = qdict_get_str(qdict, "filename");
1440 target_phys_addr_t addr = qdict_get_int(qdict, "val");
1441 int ret = -1;
1443 f = fopen(filename, "wb");
1444 if (!f) {
1445 qerror_report(QERR_OPEN_FILE_FAILED, filename);
1446 return -1;
1448 while (size != 0) {
1449 l = sizeof(buf);
1450 if (l > size)
1451 l = size;
1452 cpu_physical_memory_rw(addr, buf, l, 0);
1453 if (fwrite(buf, 1, l, f) != l) {
1454 monitor_printf(mon, "fwrite() error in do_physical_memory_save\n");
1455 goto exit;
1457 fflush(f);
1458 addr += l;
1459 size -= l;
1462 ret = 0;
1464 exit:
1465 fclose(f);
1466 return ret;
1469 static void do_sum(Monitor *mon, const QDict *qdict)
1471 uint32_t addr;
1472 uint8_t buf[1];
1473 uint16_t sum;
1474 uint32_t start = qdict_get_int(qdict, "start");
1475 uint32_t size = qdict_get_int(qdict, "size");
1477 sum = 0;
1478 for(addr = start; addr < (start + size); addr++) {
1479 cpu_physical_memory_rw(addr, buf, 1, 0);
1480 /* BSD sum algorithm ('sum' Unix command) */
1481 sum = (sum >> 1) | (sum << 15);
1482 sum += buf[0];
1484 monitor_printf(mon, "%05d\n", sum);
1487 typedef struct {
1488 int keycode;
1489 const char *name;
1490 } KeyDef;
1492 static const KeyDef key_defs[] = {
1493 { 0x2a, "shift" },
1494 { 0x36, "shift_r" },
1496 { 0x38, "alt" },
1497 { 0xb8, "alt_r" },
1498 { 0x64, "altgr" },
1499 { 0xe4, "altgr_r" },
1500 { 0x1d, "ctrl" },
1501 { 0x9d, "ctrl_r" },
1503 { 0xdd, "menu" },
1505 { 0x01, "esc" },
1507 { 0x02, "1" },
1508 { 0x03, "2" },
1509 { 0x04, "3" },
1510 { 0x05, "4" },
1511 { 0x06, "5" },
1512 { 0x07, "6" },
1513 { 0x08, "7" },
1514 { 0x09, "8" },
1515 { 0x0a, "9" },
1516 { 0x0b, "0" },
1517 { 0x0c, "minus" },
1518 { 0x0d, "equal" },
1519 { 0x0e, "backspace" },
1521 { 0x0f, "tab" },
1522 { 0x10, "q" },
1523 { 0x11, "w" },
1524 { 0x12, "e" },
1525 { 0x13, "r" },
1526 { 0x14, "t" },
1527 { 0x15, "y" },
1528 { 0x16, "u" },
1529 { 0x17, "i" },
1530 { 0x18, "o" },
1531 { 0x19, "p" },
1532 { 0x1a, "bracket_left" },
1533 { 0x1b, "bracket_right" },
1534 { 0x1c, "ret" },
1536 { 0x1e, "a" },
1537 { 0x1f, "s" },
1538 { 0x20, "d" },
1539 { 0x21, "f" },
1540 { 0x22, "g" },
1541 { 0x23, "h" },
1542 { 0x24, "j" },
1543 { 0x25, "k" },
1544 { 0x26, "l" },
1545 { 0x27, "semicolon" },
1546 { 0x28, "apostrophe" },
1547 { 0x29, "grave_accent" },
1549 { 0x2b, "backslash" },
1550 { 0x2c, "z" },
1551 { 0x2d, "x" },
1552 { 0x2e, "c" },
1553 { 0x2f, "v" },
1554 { 0x30, "b" },
1555 { 0x31, "n" },
1556 { 0x32, "m" },
1557 { 0x33, "comma" },
1558 { 0x34, "dot" },
1559 { 0x35, "slash" },
1561 { 0x37, "asterisk" },
1563 { 0x39, "spc" },
1564 { 0x3a, "caps_lock" },
1565 { 0x3b, "f1" },
1566 { 0x3c, "f2" },
1567 { 0x3d, "f3" },
1568 { 0x3e, "f4" },
1569 { 0x3f, "f5" },
1570 { 0x40, "f6" },
1571 { 0x41, "f7" },
1572 { 0x42, "f8" },
1573 { 0x43, "f9" },
1574 { 0x44, "f10" },
1575 { 0x45, "num_lock" },
1576 { 0x46, "scroll_lock" },
1578 { 0xb5, "kp_divide" },
1579 { 0x37, "kp_multiply" },
1580 { 0x4a, "kp_subtract" },
1581 { 0x4e, "kp_add" },
1582 { 0x9c, "kp_enter" },
1583 { 0x53, "kp_decimal" },
1584 { 0x54, "sysrq" },
1586 { 0x52, "kp_0" },
1587 { 0x4f, "kp_1" },
1588 { 0x50, "kp_2" },
1589 { 0x51, "kp_3" },
1590 { 0x4b, "kp_4" },
1591 { 0x4c, "kp_5" },
1592 { 0x4d, "kp_6" },
1593 { 0x47, "kp_7" },
1594 { 0x48, "kp_8" },
1595 { 0x49, "kp_9" },
1597 { 0x56, "<" },
1599 { 0x57, "f11" },
1600 { 0x58, "f12" },
1602 { 0xb7, "print" },
1604 { 0xc7, "home" },
1605 { 0xc9, "pgup" },
1606 { 0xd1, "pgdn" },
1607 { 0xcf, "end" },
1609 { 0xcb, "left" },
1610 { 0xc8, "up" },
1611 { 0xd0, "down" },
1612 { 0xcd, "right" },
1614 { 0xd2, "insert" },
1615 { 0xd3, "delete" },
1616 #if defined(TARGET_SPARC) && !defined(TARGET_SPARC64)
1617 { 0xf0, "stop" },
1618 { 0xf1, "again" },
1619 { 0xf2, "props" },
1620 { 0xf3, "undo" },
1621 { 0xf4, "front" },
1622 { 0xf5, "copy" },
1623 { 0xf6, "open" },
1624 { 0xf7, "paste" },
1625 { 0xf8, "find" },
1626 { 0xf9, "cut" },
1627 { 0xfa, "lf" },
1628 { 0xfb, "help" },
1629 { 0xfc, "meta_l" },
1630 { 0xfd, "meta_r" },
1631 { 0xfe, "compose" },
1632 #endif
1633 { 0, NULL },
1636 static int get_keycode(const char *key)
1638 const KeyDef *p;
1639 char *endp;
1640 int ret;
1642 for(p = key_defs; p->name != NULL; p++) {
1643 if (!strcmp(key, p->name))
1644 return p->keycode;
1646 if (strstart(key, "0x", NULL)) {
1647 ret = strtoul(key, &endp, 0);
1648 if (*endp == '\0' && ret >= 0x01 && ret <= 0xff)
1649 return ret;
1651 return -1;
1654 #define MAX_KEYCODES 16
1655 static uint8_t keycodes[MAX_KEYCODES];
1656 static int nb_pending_keycodes;
1657 static QEMUTimer *key_timer;
1659 static void release_keys(void *opaque)
1661 int keycode;
1663 while (nb_pending_keycodes > 0) {
1664 nb_pending_keycodes--;
1665 keycode = keycodes[nb_pending_keycodes];
1666 if (keycode & 0x80)
1667 kbd_put_keycode(0xe0);
1668 kbd_put_keycode(keycode | 0x80);
1672 static void do_sendkey(Monitor *mon, const QDict *qdict)
1674 char keyname_buf[16];
1675 char *separator;
1676 int keyname_len, keycode, i;
1677 const char *string = qdict_get_str(qdict, "string");
1678 int has_hold_time = qdict_haskey(qdict, "hold_time");
1679 int hold_time = qdict_get_try_int(qdict, "hold_time", -1);
1681 if (nb_pending_keycodes > 0) {
1682 qemu_del_timer(key_timer);
1683 release_keys(NULL);
1685 if (!has_hold_time)
1686 hold_time = 100;
1687 i = 0;
1688 while (1) {
1689 separator = strchr(string, '-');
1690 keyname_len = separator ? separator - string : strlen(string);
1691 if (keyname_len > 0) {
1692 pstrcpy(keyname_buf, sizeof(keyname_buf), string);
1693 if (keyname_len > sizeof(keyname_buf) - 1) {
1694 monitor_printf(mon, "invalid key: '%s...'\n", keyname_buf);
1695 return;
1697 if (i == MAX_KEYCODES) {
1698 monitor_printf(mon, "too many keys\n");
1699 return;
1701 keyname_buf[keyname_len] = 0;
1702 keycode = get_keycode(keyname_buf);
1703 if (keycode < 0) {
1704 monitor_printf(mon, "unknown key: '%s'\n", keyname_buf);
1705 return;
1707 keycodes[i++] = keycode;
1709 if (!separator)
1710 break;
1711 string = separator + 1;
1713 nb_pending_keycodes = i;
1714 /* key down events */
1715 for (i = 0; i < nb_pending_keycodes; i++) {
1716 keycode = keycodes[i];
1717 if (keycode & 0x80)
1718 kbd_put_keycode(0xe0);
1719 kbd_put_keycode(keycode & 0x7f);
1721 /* delayed key up events */
1722 qemu_mod_timer(key_timer, qemu_get_clock(vm_clock) +
1723 muldiv64(get_ticks_per_sec(), hold_time, 1000));
1726 static int mouse_button_state;
1728 static void do_mouse_move(Monitor *mon, const QDict *qdict)
1730 int dx, dy, dz;
1731 const char *dx_str = qdict_get_str(qdict, "dx_str");
1732 const char *dy_str = qdict_get_str(qdict, "dy_str");
1733 const char *dz_str = qdict_get_try_str(qdict, "dz_str");
1734 dx = strtol(dx_str, NULL, 0);
1735 dy = strtol(dy_str, NULL, 0);
1736 dz = 0;
1737 if (dz_str)
1738 dz = strtol(dz_str, NULL, 0);
1739 kbd_mouse_event(dx, dy, dz, mouse_button_state);
1742 static void do_mouse_button(Monitor *mon, const QDict *qdict)
1744 int button_state = qdict_get_int(qdict, "button_state");
1745 mouse_button_state = button_state;
1746 kbd_mouse_event(0, 0, 0, mouse_button_state);
1749 static void do_ioport_read(Monitor *mon, const QDict *qdict)
1751 int size = qdict_get_int(qdict, "size");
1752 int addr = qdict_get_int(qdict, "addr");
1753 int has_index = qdict_haskey(qdict, "index");
1754 uint32_t val;
1755 int suffix;
1757 if (has_index) {
1758 int index = qdict_get_int(qdict, "index");
1759 cpu_outb(addr & IOPORTS_MASK, index & 0xff);
1760 addr++;
1762 addr &= 0xffff;
1764 switch(size) {
1765 default:
1766 case 1:
1767 val = cpu_inb(addr);
1768 suffix = 'b';
1769 break;
1770 case 2:
1771 val = cpu_inw(addr);
1772 suffix = 'w';
1773 break;
1774 case 4:
1775 val = cpu_inl(addr);
1776 suffix = 'l';
1777 break;
1779 monitor_printf(mon, "port%c[0x%04x] = %#0*x\n",
1780 suffix, addr, size * 2, val);
1783 static void do_ioport_write(Monitor *mon, const QDict *qdict)
1785 int size = qdict_get_int(qdict, "size");
1786 int addr = qdict_get_int(qdict, "addr");
1787 int val = qdict_get_int(qdict, "val");
1789 addr &= IOPORTS_MASK;
1791 switch (size) {
1792 default:
1793 case 1:
1794 cpu_outb(addr, val);
1795 break;
1796 case 2:
1797 cpu_outw(addr, val);
1798 break;
1799 case 4:
1800 cpu_outl(addr, val);
1801 break;
1805 static void do_boot_set(Monitor *mon, const QDict *qdict)
1807 int res;
1808 const char *bootdevice = qdict_get_str(qdict, "bootdevice");
1810 res = qemu_boot_set(bootdevice);
1811 if (res == 0) {
1812 monitor_printf(mon, "boot device list now set to %s\n", bootdevice);
1813 } else if (res > 0) {
1814 monitor_printf(mon, "setting boot device list failed\n");
1815 } else {
1816 monitor_printf(mon, "no function defined to set boot device list for "
1817 "this architecture\n");
1822 * do_system_reset(): Issue a machine reset
1824 static int do_system_reset(Monitor *mon, const QDict *qdict,
1825 QObject **ret_data)
1827 qemu_system_reset_request();
1828 return 0;
1832 * do_system_powerdown(): Issue a machine powerdown
1834 static int do_system_powerdown(Monitor *mon, const QDict *qdict,
1835 QObject **ret_data)
1837 qemu_system_powerdown_request();
1838 return 0;
1841 #if defined(TARGET_I386)
1842 static void print_pte(Monitor *mon, uint32_t addr, uint32_t pte, uint32_t mask)
1844 monitor_printf(mon, "%08x: %08x %c%c%c%c%c%c%c%c\n",
1845 addr,
1846 pte & mask,
1847 pte & PG_GLOBAL_MASK ? 'G' : '-',
1848 pte & PG_PSE_MASK ? 'P' : '-',
1849 pte & PG_DIRTY_MASK ? 'D' : '-',
1850 pte & PG_ACCESSED_MASK ? 'A' : '-',
1851 pte & PG_PCD_MASK ? 'C' : '-',
1852 pte & PG_PWT_MASK ? 'T' : '-',
1853 pte & PG_USER_MASK ? 'U' : '-',
1854 pte & PG_RW_MASK ? 'W' : '-');
1857 static void tlb_info(Monitor *mon)
1859 CPUState *env;
1860 int l1, l2;
1861 uint32_t pgd, pde, pte;
1863 env = mon_get_cpu();
1865 if (!(env->cr[0] & CR0_PG_MASK)) {
1866 monitor_printf(mon, "PG disabled\n");
1867 return;
1869 pgd = env->cr[3] & ~0xfff;
1870 for(l1 = 0; l1 < 1024; l1++) {
1871 cpu_physical_memory_read(pgd + l1 * 4, (uint8_t *)&pde, 4);
1872 pde = le32_to_cpu(pde);
1873 if (pde & PG_PRESENT_MASK) {
1874 if ((pde & PG_PSE_MASK) && (env->cr[4] & CR4_PSE_MASK)) {
1875 print_pte(mon, (l1 << 22), pde, ~((1 << 20) - 1));
1876 } else {
1877 for(l2 = 0; l2 < 1024; l2++) {
1878 cpu_physical_memory_read((pde & ~0xfff) + l2 * 4,
1879 (uint8_t *)&pte, 4);
1880 pte = le32_to_cpu(pte);
1881 if (pte & PG_PRESENT_MASK) {
1882 print_pte(mon, (l1 << 22) + (l2 << 12),
1883 pte & ~PG_PSE_MASK,
1884 ~0xfff);
1892 static void mem_print(Monitor *mon, uint32_t *pstart, int *plast_prot,
1893 uint32_t end, int prot)
1895 int prot1;
1896 prot1 = *plast_prot;
1897 if (prot != prot1) {
1898 if (*pstart != -1) {
1899 monitor_printf(mon, "%08x-%08x %08x %c%c%c\n",
1900 *pstart, end, end - *pstart,
1901 prot1 & PG_USER_MASK ? 'u' : '-',
1902 'r',
1903 prot1 & PG_RW_MASK ? 'w' : '-');
1905 if (prot != 0)
1906 *pstart = end;
1907 else
1908 *pstart = -1;
1909 *plast_prot = prot;
1913 static void mem_info(Monitor *mon)
1915 CPUState *env;
1916 int l1, l2, prot, last_prot;
1917 uint32_t pgd, pde, pte, start, end;
1919 env = mon_get_cpu();
1921 if (!(env->cr[0] & CR0_PG_MASK)) {
1922 monitor_printf(mon, "PG disabled\n");
1923 return;
1925 pgd = env->cr[3] & ~0xfff;
1926 last_prot = 0;
1927 start = -1;
1928 for(l1 = 0; l1 < 1024; l1++) {
1929 cpu_physical_memory_read(pgd + l1 * 4, (uint8_t *)&pde, 4);
1930 pde = le32_to_cpu(pde);
1931 end = l1 << 22;
1932 if (pde & PG_PRESENT_MASK) {
1933 if ((pde & PG_PSE_MASK) && (env->cr[4] & CR4_PSE_MASK)) {
1934 prot = pde & (PG_USER_MASK | PG_RW_MASK | PG_PRESENT_MASK);
1935 mem_print(mon, &start, &last_prot, end, prot);
1936 } else {
1937 for(l2 = 0; l2 < 1024; l2++) {
1938 cpu_physical_memory_read((pde & ~0xfff) + l2 * 4,
1939 (uint8_t *)&pte, 4);
1940 pte = le32_to_cpu(pte);
1941 end = (l1 << 22) + (l2 << 12);
1942 if (pte & PG_PRESENT_MASK) {
1943 prot = pte & (PG_USER_MASK | PG_RW_MASK | PG_PRESENT_MASK);
1944 } else {
1945 prot = 0;
1947 mem_print(mon, &start, &last_prot, end, prot);
1950 } else {
1951 prot = 0;
1952 mem_print(mon, &start, &last_prot, end, prot);
1956 #endif
1958 #if defined(TARGET_SH4)
1960 static void print_tlb(Monitor *mon, int idx, tlb_t *tlb)
1962 monitor_printf(mon, " tlb%i:\t"
1963 "asid=%hhu vpn=%x\tppn=%x\tsz=%hhu size=%u\t"
1964 "v=%hhu shared=%hhu cached=%hhu prot=%hhu "
1965 "dirty=%hhu writethrough=%hhu\n",
1966 idx,
1967 tlb->asid, tlb->vpn, tlb->ppn, tlb->sz, tlb->size,
1968 tlb->v, tlb->sh, tlb->c, tlb->pr,
1969 tlb->d, tlb->wt);
1972 static void tlb_info(Monitor *mon)
1974 CPUState *env = mon_get_cpu();
1975 int i;
1977 monitor_printf (mon, "ITLB:\n");
1978 for (i = 0 ; i < ITLB_SIZE ; i++)
1979 print_tlb (mon, i, &env->itlb[i]);
1980 monitor_printf (mon, "UTLB:\n");
1981 for (i = 0 ; i < UTLB_SIZE ; i++)
1982 print_tlb (mon, i, &env->utlb[i]);
1985 #endif
1987 static void do_info_kvm_print(Monitor *mon, const QObject *data)
1989 QDict *qdict;
1991 qdict = qobject_to_qdict(data);
1993 monitor_printf(mon, "kvm support: ");
1994 if (qdict_get_bool(qdict, "present")) {
1995 monitor_printf(mon, "%s\n", qdict_get_bool(qdict, "enabled") ?
1996 "enabled" : "disabled");
1997 } else {
1998 monitor_printf(mon, "not compiled\n");
2002 static void do_info_kvm(Monitor *mon, QObject **ret_data)
2004 #ifdef CONFIG_KVM
2005 *ret_data = qobject_from_jsonf("{ 'enabled': %i, 'present': true }",
2006 kvm_enabled());
2007 #else
2008 *ret_data = qobject_from_jsonf("{ 'enabled': false, 'present': false }");
2009 #endif
2012 static void do_info_numa(Monitor *mon)
2014 int i;
2015 CPUState *env;
2017 monitor_printf(mon, "%d nodes\n", nb_numa_nodes);
2018 for (i = 0; i < nb_numa_nodes; i++) {
2019 monitor_printf(mon, "node %d cpus:", i);
2020 for (env = first_cpu; env != NULL; env = env->next_cpu) {
2021 if (env->numa_node == i) {
2022 monitor_printf(mon, " %d", env->cpu_index);
2025 monitor_printf(mon, "\n");
2026 monitor_printf(mon, "node %d size: %" PRId64 " MB\n", i,
2027 node_mem[i] >> 20);
2031 #ifdef CONFIG_PROFILER
2033 int64_t qemu_time;
2034 int64_t dev_time;
2036 static void do_info_profile(Monitor *mon)
2038 int64_t total;
2039 total = qemu_time;
2040 if (total == 0)
2041 total = 1;
2042 monitor_printf(mon, "async time %" PRId64 " (%0.3f)\n",
2043 dev_time, dev_time / (double)get_ticks_per_sec());
2044 monitor_printf(mon, "qemu time %" PRId64 " (%0.3f)\n",
2045 qemu_time, qemu_time / (double)get_ticks_per_sec());
2046 qemu_time = 0;
2047 dev_time = 0;
2049 #else
2050 static void do_info_profile(Monitor *mon)
2052 monitor_printf(mon, "Internal profiler not compiled\n");
2054 #endif
2056 /* Capture support */
2057 static QLIST_HEAD (capture_list_head, CaptureState) capture_head;
2059 static void do_info_capture(Monitor *mon)
2061 int i;
2062 CaptureState *s;
2064 for (s = capture_head.lh_first, i = 0; s; s = s->entries.le_next, ++i) {
2065 monitor_printf(mon, "[%d]: ", i);
2066 s->ops.info (s->opaque);
2070 #ifdef HAS_AUDIO
2071 static void do_stop_capture(Monitor *mon, const QDict *qdict)
2073 int i;
2074 int n = qdict_get_int(qdict, "n");
2075 CaptureState *s;
2077 for (s = capture_head.lh_first, i = 0; s; s = s->entries.le_next, ++i) {
2078 if (i == n) {
2079 s->ops.destroy (s->opaque);
2080 QLIST_REMOVE (s, entries);
2081 qemu_free (s);
2082 return;
2087 static void do_wav_capture(Monitor *mon, const QDict *qdict)
2089 const char *path = qdict_get_str(qdict, "path");
2090 int has_freq = qdict_haskey(qdict, "freq");
2091 int freq = qdict_get_try_int(qdict, "freq", -1);
2092 int has_bits = qdict_haskey(qdict, "bits");
2093 int bits = qdict_get_try_int(qdict, "bits", -1);
2094 int has_channels = qdict_haskey(qdict, "nchannels");
2095 int nchannels = qdict_get_try_int(qdict, "nchannels", -1);
2096 CaptureState *s;
2098 s = qemu_mallocz (sizeof (*s));
2100 freq = has_freq ? freq : 44100;
2101 bits = has_bits ? bits : 16;
2102 nchannels = has_channels ? nchannels : 2;
2104 if (wav_start_capture (s, path, freq, bits, nchannels)) {
2105 monitor_printf(mon, "Faied to add wave capture\n");
2106 qemu_free (s);
2108 QLIST_INSERT_HEAD (&capture_head, s, entries);
2110 #endif
2112 #if defined(TARGET_I386)
2113 static void do_inject_nmi(Monitor *mon, const QDict *qdict)
2115 CPUState *env;
2116 int cpu_index = qdict_get_int(qdict, "cpu_index");
2118 for (env = first_cpu; env != NULL; env = env->next_cpu)
2119 if (env->cpu_index == cpu_index) {
2120 cpu_interrupt(env, CPU_INTERRUPT_NMI);
2121 break;
2124 #endif
2126 static void do_info_status_print(Monitor *mon, const QObject *data)
2128 QDict *qdict;
2130 qdict = qobject_to_qdict(data);
2132 monitor_printf(mon, "VM status: ");
2133 if (qdict_get_bool(qdict, "running")) {
2134 monitor_printf(mon, "running");
2135 if (qdict_get_bool(qdict, "singlestep")) {
2136 monitor_printf(mon, " (single step mode)");
2138 } else {
2139 monitor_printf(mon, "paused");
2142 monitor_printf(mon, "\n");
2145 static void do_info_status(Monitor *mon, QObject **ret_data)
2147 *ret_data = qobject_from_jsonf("{ 'running': %i, 'singlestep': %i }",
2148 vm_running, singlestep);
2151 static qemu_acl *find_acl(Monitor *mon, const char *name)
2153 qemu_acl *acl = qemu_acl_find(name);
2155 if (!acl) {
2156 monitor_printf(mon, "acl: unknown list '%s'\n", name);
2158 return acl;
2161 static void do_acl_show(Monitor *mon, const QDict *qdict)
2163 const char *aclname = qdict_get_str(qdict, "aclname");
2164 qemu_acl *acl = find_acl(mon, aclname);
2165 qemu_acl_entry *entry;
2166 int i = 0;
2168 if (acl) {
2169 monitor_printf(mon, "policy: %s\n",
2170 acl->defaultDeny ? "deny" : "allow");
2171 QTAILQ_FOREACH(entry, &acl->entries, next) {
2172 i++;
2173 monitor_printf(mon, "%d: %s %s\n", i,
2174 entry->deny ? "deny" : "allow", entry->match);
2179 static void do_acl_reset(Monitor *mon, const QDict *qdict)
2181 const char *aclname = qdict_get_str(qdict, "aclname");
2182 qemu_acl *acl = find_acl(mon, aclname);
2184 if (acl) {
2185 qemu_acl_reset(acl);
2186 monitor_printf(mon, "acl: removed all rules\n");
2190 static void do_acl_policy(Monitor *mon, const QDict *qdict)
2192 const char *aclname = qdict_get_str(qdict, "aclname");
2193 const char *policy = qdict_get_str(qdict, "policy");
2194 qemu_acl *acl = find_acl(mon, aclname);
2196 if (acl) {
2197 if (strcmp(policy, "allow") == 0) {
2198 acl->defaultDeny = 0;
2199 monitor_printf(mon, "acl: policy set to 'allow'\n");
2200 } else if (strcmp(policy, "deny") == 0) {
2201 acl->defaultDeny = 1;
2202 monitor_printf(mon, "acl: policy set to 'deny'\n");
2203 } else {
2204 monitor_printf(mon, "acl: unknown policy '%s', "
2205 "expected 'deny' or 'allow'\n", policy);
2210 static void do_acl_add(Monitor *mon, const QDict *qdict)
2212 const char *aclname = qdict_get_str(qdict, "aclname");
2213 const char *match = qdict_get_str(qdict, "match");
2214 const char *policy = qdict_get_str(qdict, "policy");
2215 int has_index = qdict_haskey(qdict, "index");
2216 int index = qdict_get_try_int(qdict, "index", -1);
2217 qemu_acl *acl = find_acl(mon, aclname);
2218 int deny, ret;
2220 if (acl) {
2221 if (strcmp(policy, "allow") == 0) {
2222 deny = 0;
2223 } else if (strcmp(policy, "deny") == 0) {
2224 deny = 1;
2225 } else {
2226 monitor_printf(mon, "acl: unknown policy '%s', "
2227 "expected 'deny' or 'allow'\n", policy);
2228 return;
2230 if (has_index)
2231 ret = qemu_acl_insert(acl, deny, match, index);
2232 else
2233 ret = qemu_acl_append(acl, deny, match);
2234 if (ret < 0)
2235 monitor_printf(mon, "acl: unable to add acl entry\n");
2236 else
2237 monitor_printf(mon, "acl: added rule at position %d\n", ret);
2241 static void do_acl_remove(Monitor *mon, const QDict *qdict)
2243 const char *aclname = qdict_get_str(qdict, "aclname");
2244 const char *match = qdict_get_str(qdict, "match");
2245 qemu_acl *acl = find_acl(mon, aclname);
2246 int ret;
2248 if (acl) {
2249 ret = qemu_acl_remove(acl, match);
2250 if (ret < 0)
2251 monitor_printf(mon, "acl: no matching acl entry\n");
2252 else
2253 monitor_printf(mon, "acl: removed rule at position %d\n", ret);
2257 #if defined(TARGET_I386)
2258 static void do_inject_mce(Monitor *mon, const QDict *qdict)
2260 CPUState *cenv;
2261 int cpu_index = qdict_get_int(qdict, "cpu_index");
2262 int bank = qdict_get_int(qdict, "bank");
2263 uint64_t status = qdict_get_int(qdict, "status");
2264 uint64_t mcg_status = qdict_get_int(qdict, "mcg_status");
2265 uint64_t addr = qdict_get_int(qdict, "addr");
2266 uint64_t misc = qdict_get_int(qdict, "misc");
2268 for (cenv = first_cpu; cenv != NULL; cenv = cenv->next_cpu)
2269 if (cenv->cpu_index == cpu_index && cenv->mcg_cap) {
2270 cpu_inject_x86_mce(cenv, bank, status, mcg_status, addr, misc);
2271 break;
2274 #endif
2276 static int do_getfd(Monitor *mon, const QDict *qdict, QObject **ret_data)
2278 const char *fdname = qdict_get_str(qdict, "fdname");
2279 mon_fd_t *monfd;
2280 int fd;
2282 fd = qemu_chr_get_msgfd(mon->chr);
2283 if (fd == -1) {
2284 qerror_report(QERR_FD_NOT_SUPPLIED);
2285 return -1;
2288 if (qemu_isdigit(fdname[0])) {
2289 qerror_report(QERR_INVALID_PARAMETER_VALUE, "fdname",
2290 "a name not starting with a digit");
2291 return -1;
2294 QLIST_FOREACH(monfd, &mon->fds, next) {
2295 if (strcmp(monfd->name, fdname) != 0) {
2296 continue;
2299 close(monfd->fd);
2300 monfd->fd = fd;
2301 return 0;
2304 monfd = qemu_mallocz(sizeof(mon_fd_t));
2305 monfd->name = qemu_strdup(fdname);
2306 monfd->fd = fd;
2308 QLIST_INSERT_HEAD(&mon->fds, monfd, next);
2309 return 0;
2312 static int do_closefd(Monitor *mon, const QDict *qdict, QObject **ret_data)
2314 const char *fdname = qdict_get_str(qdict, "fdname");
2315 mon_fd_t *monfd;
2317 QLIST_FOREACH(monfd, &mon->fds, next) {
2318 if (strcmp(monfd->name, fdname) != 0) {
2319 continue;
2322 QLIST_REMOVE(monfd, next);
2323 close(monfd->fd);
2324 qemu_free(monfd->name);
2325 qemu_free(monfd);
2326 return 0;
2329 qerror_report(QERR_FD_NOT_FOUND, fdname);
2330 return -1;
2333 static void do_loadvm(Monitor *mon, const QDict *qdict)
2335 int saved_vm_running = vm_running;
2336 const char *name = qdict_get_str(qdict, "name");
2338 vm_stop(0);
2340 if (load_vmstate(name) == 0 && saved_vm_running) {
2341 vm_start();
2345 int monitor_get_fd(Monitor *mon, const char *fdname)
2347 mon_fd_t *monfd;
2349 QLIST_FOREACH(monfd, &mon->fds, next) {
2350 int fd;
2352 if (strcmp(monfd->name, fdname) != 0) {
2353 continue;
2356 fd = monfd->fd;
2358 /* caller takes ownership of fd */
2359 QLIST_REMOVE(monfd, next);
2360 qemu_free(monfd->name);
2361 qemu_free(monfd);
2363 return fd;
2366 return -1;
2369 static const mon_cmd_t mon_cmds[] = {
2370 #include "qemu-monitor.h"
2371 { NULL, NULL, },
2374 /* Please update qemu-monitor.hx when adding or changing commands */
2375 static const mon_cmd_t info_cmds[] = {
2377 .name = "version",
2378 .args_type = "",
2379 .params = "",
2380 .help = "show the version of QEMU",
2381 .user_print = do_info_version_print,
2382 .mhandler.info_new = do_info_version,
2385 .name = "commands",
2386 .args_type = "",
2387 .params = "",
2388 .help = "list QMP available commands",
2389 .user_print = monitor_user_noop,
2390 .mhandler.info_new = do_info_commands,
2393 .name = "network",
2394 .args_type = "",
2395 .params = "",
2396 .help = "show the network state",
2397 .mhandler.info = do_info_network,
2400 .name = "chardev",
2401 .args_type = "",
2402 .params = "",
2403 .help = "show the character devices",
2404 .user_print = qemu_chr_info_print,
2405 .mhandler.info_new = qemu_chr_info,
2408 .name = "block",
2409 .args_type = "",
2410 .params = "",
2411 .help = "show the block devices",
2412 .user_print = bdrv_info_print,
2413 .mhandler.info_new = bdrv_info,
2416 .name = "blockstats",
2417 .args_type = "",
2418 .params = "",
2419 .help = "show block device statistics",
2420 .user_print = bdrv_stats_print,
2421 .mhandler.info_new = bdrv_info_stats,
2424 .name = "registers",
2425 .args_type = "",
2426 .params = "",
2427 .help = "show the cpu registers",
2428 .mhandler.info = do_info_registers,
2431 .name = "cpus",
2432 .args_type = "",
2433 .params = "",
2434 .help = "show infos for each CPU",
2435 .user_print = monitor_print_cpus,
2436 .mhandler.info_new = do_info_cpus,
2439 .name = "history",
2440 .args_type = "",
2441 .params = "",
2442 .help = "show the command line history",
2443 .mhandler.info = do_info_history,
2446 .name = "irq",
2447 .args_type = "",
2448 .params = "",
2449 .help = "show the interrupts statistics (if available)",
2450 .mhandler.info = irq_info,
2453 .name = "pic",
2454 .args_type = "",
2455 .params = "",
2456 .help = "show i8259 (PIC) state",
2457 .mhandler.info = pic_info,
2460 .name = "pci",
2461 .args_type = "",
2462 .params = "",
2463 .help = "show PCI info",
2464 .user_print = do_pci_info_print,
2465 .mhandler.info_new = do_pci_info,
2467 #if defined(TARGET_I386) || defined(TARGET_SH4)
2469 .name = "tlb",
2470 .args_type = "",
2471 .params = "",
2472 .help = "show virtual to physical memory mappings",
2473 .mhandler.info = tlb_info,
2475 #endif
2476 #if defined(TARGET_I386)
2478 .name = "mem",
2479 .args_type = "",
2480 .params = "",
2481 .help = "show the active virtual memory mappings",
2482 .mhandler.info = mem_info,
2484 #endif
2486 .name = "jit",
2487 .args_type = "",
2488 .params = "",
2489 .help = "show dynamic compiler info",
2490 .mhandler.info = do_info_jit,
2493 .name = "kvm",
2494 .args_type = "",
2495 .params = "",
2496 .help = "show KVM information",
2497 .user_print = do_info_kvm_print,
2498 .mhandler.info_new = do_info_kvm,
2501 .name = "numa",
2502 .args_type = "",
2503 .params = "",
2504 .help = "show NUMA information",
2505 .mhandler.info = do_info_numa,
2508 .name = "usb",
2509 .args_type = "",
2510 .params = "",
2511 .help = "show guest USB devices",
2512 .mhandler.info = usb_info,
2515 .name = "usbhost",
2516 .args_type = "",
2517 .params = "",
2518 .help = "show host USB devices",
2519 .mhandler.info = usb_host_info,
2522 .name = "profile",
2523 .args_type = "",
2524 .params = "",
2525 .help = "show profiling information",
2526 .mhandler.info = do_info_profile,
2529 .name = "capture",
2530 .args_type = "",
2531 .params = "",
2532 .help = "show capture information",
2533 .mhandler.info = do_info_capture,
2536 .name = "snapshots",
2537 .args_type = "",
2538 .params = "",
2539 .help = "show the currently saved VM snapshots",
2540 .mhandler.info = do_info_snapshots,
2543 .name = "status",
2544 .args_type = "",
2545 .params = "",
2546 .help = "show the current VM status (running|paused)",
2547 .user_print = do_info_status_print,
2548 .mhandler.info_new = do_info_status,
2551 .name = "pcmcia",
2552 .args_type = "",
2553 .params = "",
2554 .help = "show guest PCMCIA status",
2555 .mhandler.info = pcmcia_info,
2558 .name = "mice",
2559 .args_type = "",
2560 .params = "",
2561 .help = "show which guest mouse is receiving events",
2562 .user_print = do_info_mice_print,
2563 .mhandler.info_new = do_info_mice,
2566 .name = "vnc",
2567 .args_type = "",
2568 .params = "",
2569 .help = "show the vnc server status",
2570 .user_print = do_info_vnc_print,
2571 .mhandler.info_new = do_info_vnc,
2574 .name = "name",
2575 .args_type = "",
2576 .params = "",
2577 .help = "show the current VM name",
2578 .user_print = do_info_name_print,
2579 .mhandler.info_new = do_info_name,
2582 .name = "uuid",
2583 .args_type = "",
2584 .params = "",
2585 .help = "show the current VM UUID",
2586 .user_print = do_info_uuid_print,
2587 .mhandler.info_new = do_info_uuid,
2589 #if defined(TARGET_PPC)
2591 .name = "cpustats",
2592 .args_type = "",
2593 .params = "",
2594 .help = "show CPU statistics",
2595 .mhandler.info = do_info_cpu_stats,
2597 #endif
2598 #if defined(CONFIG_SLIRP)
2600 .name = "usernet",
2601 .args_type = "",
2602 .params = "",
2603 .help = "show user network stack connection states",
2604 .mhandler.info = do_info_usernet,
2606 #endif
2608 .name = "migrate",
2609 .args_type = "",
2610 .params = "",
2611 .help = "show migration status",
2612 .user_print = do_info_migrate_print,
2613 .mhandler.info_new = do_info_migrate,
2616 .name = "balloon",
2617 .args_type = "",
2618 .params = "",
2619 .help = "show balloon information",
2620 .user_print = monitor_print_balloon,
2621 .mhandler.info_async = do_info_balloon,
2622 .flags = MONITOR_CMD_ASYNC,
2625 .name = "qtree",
2626 .args_type = "",
2627 .params = "",
2628 .help = "show device tree",
2629 .mhandler.info = do_info_qtree,
2632 .name = "qdm",
2633 .args_type = "",
2634 .params = "",
2635 .help = "show qdev device model list",
2636 .mhandler.info = do_info_qdm,
2639 .name = "roms",
2640 .args_type = "",
2641 .params = "",
2642 .help = "show roms",
2643 .mhandler.info = do_info_roms,
2645 #if defined(CONFIG_SIMPLE_TRACE)
2647 .name = "trace",
2648 .args_type = "",
2649 .params = "",
2650 .help = "show current contents of trace buffer",
2651 .mhandler.info = do_info_trace,
2654 .name = "trace-events",
2655 .args_type = "",
2656 .params = "",
2657 .help = "show available trace-events & their state",
2658 .mhandler.info = do_info_trace_events,
2660 #endif
2662 .name = NULL,
2666 /*******************************************************************/
2668 static const char *pch;
2669 static jmp_buf expr_env;
2671 #define MD_TLONG 0
2672 #define MD_I32 1
2674 typedef struct MonitorDef {
2675 const char *name;
2676 int offset;
2677 target_long (*get_value)(const struct MonitorDef *md, int val);
2678 int type;
2679 } MonitorDef;
2681 #if defined(TARGET_I386)
2682 static target_long monitor_get_pc (const struct MonitorDef *md, int val)
2684 CPUState *env = mon_get_cpu();
2685 return env->eip + env->segs[R_CS].base;
2687 #endif
2689 #if defined(TARGET_PPC)
2690 static target_long monitor_get_ccr (const struct MonitorDef *md, int val)
2692 CPUState *env = mon_get_cpu();
2693 unsigned int u;
2694 int i;
2696 u = 0;
2697 for (i = 0; i < 8; i++)
2698 u |= env->crf[i] << (32 - (4 * i));
2700 return u;
2703 static target_long monitor_get_msr (const struct MonitorDef *md, int val)
2705 CPUState *env = mon_get_cpu();
2706 return env->msr;
2709 static target_long monitor_get_xer (const struct MonitorDef *md, int val)
2711 CPUState *env = mon_get_cpu();
2712 return env->xer;
2715 static target_long monitor_get_decr (const struct MonitorDef *md, int val)
2717 CPUState *env = mon_get_cpu();
2718 return cpu_ppc_load_decr(env);
2721 static target_long monitor_get_tbu (const struct MonitorDef *md, int val)
2723 CPUState *env = mon_get_cpu();
2724 return cpu_ppc_load_tbu(env);
2727 static target_long monitor_get_tbl (const struct MonitorDef *md, int val)
2729 CPUState *env = mon_get_cpu();
2730 return cpu_ppc_load_tbl(env);
2732 #endif
2734 #if defined(TARGET_SPARC)
2735 #ifndef TARGET_SPARC64
2736 static target_long monitor_get_psr (const struct MonitorDef *md, int val)
2738 CPUState *env = mon_get_cpu();
2740 return cpu_get_psr(env);
2742 #endif
2744 static target_long monitor_get_reg(const struct MonitorDef *md, int val)
2746 CPUState *env = mon_get_cpu();
2747 return env->regwptr[val];
2749 #endif
2751 static const MonitorDef monitor_defs[] = {
2752 #ifdef TARGET_I386
2754 #define SEG(name, seg) \
2755 { name, offsetof(CPUState, segs[seg].selector), NULL, MD_I32 },\
2756 { name ".base", offsetof(CPUState, segs[seg].base) },\
2757 { name ".limit", offsetof(CPUState, segs[seg].limit), NULL, MD_I32 },
2759 { "eax", offsetof(CPUState, regs[0]) },
2760 { "ecx", offsetof(CPUState, regs[1]) },
2761 { "edx", offsetof(CPUState, regs[2]) },
2762 { "ebx", offsetof(CPUState, regs[3]) },
2763 { "esp|sp", offsetof(CPUState, regs[4]) },
2764 { "ebp|fp", offsetof(CPUState, regs[5]) },
2765 { "esi", offsetof(CPUState, regs[6]) },
2766 { "edi", offsetof(CPUState, regs[7]) },
2767 #ifdef TARGET_X86_64
2768 { "r8", offsetof(CPUState, regs[8]) },
2769 { "r9", offsetof(CPUState, regs[9]) },
2770 { "r10", offsetof(CPUState, regs[10]) },
2771 { "r11", offsetof(CPUState, regs[11]) },
2772 { "r12", offsetof(CPUState, regs[12]) },
2773 { "r13", offsetof(CPUState, regs[13]) },
2774 { "r14", offsetof(CPUState, regs[14]) },
2775 { "r15", offsetof(CPUState, regs[15]) },
2776 #endif
2777 { "eflags", offsetof(CPUState, eflags) },
2778 { "eip", offsetof(CPUState, eip) },
2779 SEG("cs", R_CS)
2780 SEG("ds", R_DS)
2781 SEG("es", R_ES)
2782 SEG("ss", R_SS)
2783 SEG("fs", R_FS)
2784 SEG("gs", R_GS)
2785 { "pc", 0, monitor_get_pc, },
2786 #elif defined(TARGET_PPC)
2787 /* General purpose registers */
2788 { "r0", offsetof(CPUState, gpr[0]) },
2789 { "r1", offsetof(CPUState, gpr[1]) },
2790 { "r2", offsetof(CPUState, gpr[2]) },
2791 { "r3", offsetof(CPUState, gpr[3]) },
2792 { "r4", offsetof(CPUState, gpr[4]) },
2793 { "r5", offsetof(CPUState, gpr[5]) },
2794 { "r6", offsetof(CPUState, gpr[6]) },
2795 { "r7", offsetof(CPUState, gpr[7]) },
2796 { "r8", offsetof(CPUState, gpr[8]) },
2797 { "r9", offsetof(CPUState, gpr[9]) },
2798 { "r10", offsetof(CPUState, gpr[10]) },
2799 { "r11", offsetof(CPUState, gpr[11]) },
2800 { "r12", offsetof(CPUState, gpr[12]) },
2801 { "r13", offsetof(CPUState, gpr[13]) },
2802 { "r14", offsetof(CPUState, gpr[14]) },
2803 { "r15", offsetof(CPUState, gpr[15]) },
2804 { "r16", offsetof(CPUState, gpr[16]) },
2805 { "r17", offsetof(CPUState, gpr[17]) },
2806 { "r18", offsetof(CPUState, gpr[18]) },
2807 { "r19", offsetof(CPUState, gpr[19]) },
2808 { "r20", offsetof(CPUState, gpr[20]) },
2809 { "r21", offsetof(CPUState, gpr[21]) },
2810 { "r22", offsetof(CPUState, gpr[22]) },
2811 { "r23", offsetof(CPUState, gpr[23]) },
2812 { "r24", offsetof(CPUState, gpr[24]) },
2813 { "r25", offsetof(CPUState, gpr[25]) },
2814 { "r26", offsetof(CPUState, gpr[26]) },
2815 { "r27", offsetof(CPUState, gpr[27]) },
2816 { "r28", offsetof(CPUState, gpr[28]) },
2817 { "r29", offsetof(CPUState, gpr[29]) },
2818 { "r30", offsetof(CPUState, gpr[30]) },
2819 { "r31", offsetof(CPUState, gpr[31]) },
2820 /* Floating point registers */
2821 { "f0", offsetof(CPUState, fpr[0]) },
2822 { "f1", offsetof(CPUState, fpr[1]) },
2823 { "f2", offsetof(CPUState, fpr[2]) },
2824 { "f3", offsetof(CPUState, fpr[3]) },
2825 { "f4", offsetof(CPUState, fpr[4]) },
2826 { "f5", offsetof(CPUState, fpr[5]) },
2827 { "f6", offsetof(CPUState, fpr[6]) },
2828 { "f7", offsetof(CPUState, fpr[7]) },
2829 { "f8", offsetof(CPUState, fpr[8]) },
2830 { "f9", offsetof(CPUState, fpr[9]) },
2831 { "f10", offsetof(CPUState, fpr[10]) },
2832 { "f11", offsetof(CPUState, fpr[11]) },
2833 { "f12", offsetof(CPUState, fpr[12]) },
2834 { "f13", offsetof(CPUState, fpr[13]) },
2835 { "f14", offsetof(CPUState, fpr[14]) },
2836 { "f15", offsetof(CPUState, fpr[15]) },
2837 { "f16", offsetof(CPUState, fpr[16]) },
2838 { "f17", offsetof(CPUState, fpr[17]) },
2839 { "f18", offsetof(CPUState, fpr[18]) },
2840 { "f19", offsetof(CPUState, fpr[19]) },
2841 { "f20", offsetof(CPUState, fpr[20]) },
2842 { "f21", offsetof(CPUState, fpr[21]) },
2843 { "f22", offsetof(CPUState, fpr[22]) },
2844 { "f23", offsetof(CPUState, fpr[23]) },
2845 { "f24", offsetof(CPUState, fpr[24]) },
2846 { "f25", offsetof(CPUState, fpr[25]) },
2847 { "f26", offsetof(CPUState, fpr[26]) },
2848 { "f27", offsetof(CPUState, fpr[27]) },
2849 { "f28", offsetof(CPUState, fpr[28]) },
2850 { "f29", offsetof(CPUState, fpr[29]) },
2851 { "f30", offsetof(CPUState, fpr[30]) },
2852 { "f31", offsetof(CPUState, fpr[31]) },
2853 { "fpscr", offsetof(CPUState, fpscr) },
2854 /* Next instruction pointer */
2855 { "nip|pc", offsetof(CPUState, nip) },
2856 { "lr", offsetof(CPUState, lr) },
2857 { "ctr", offsetof(CPUState, ctr) },
2858 { "decr", 0, &monitor_get_decr, },
2859 { "ccr", 0, &monitor_get_ccr, },
2860 /* Machine state register */
2861 { "msr", 0, &monitor_get_msr, },
2862 { "xer", 0, &monitor_get_xer, },
2863 { "tbu", 0, &monitor_get_tbu, },
2864 { "tbl", 0, &monitor_get_tbl, },
2865 #if defined(TARGET_PPC64)
2866 /* Address space register */
2867 { "asr", offsetof(CPUState, asr) },
2868 #endif
2869 /* Segment registers */
2870 { "sdr1", offsetof(CPUState, sdr1) },
2871 { "sr0", offsetof(CPUState, sr[0]) },
2872 { "sr1", offsetof(CPUState, sr[1]) },
2873 { "sr2", offsetof(CPUState, sr[2]) },
2874 { "sr3", offsetof(CPUState, sr[3]) },
2875 { "sr4", offsetof(CPUState, sr[4]) },
2876 { "sr5", offsetof(CPUState, sr[5]) },
2877 { "sr6", offsetof(CPUState, sr[6]) },
2878 { "sr7", offsetof(CPUState, sr[7]) },
2879 { "sr8", offsetof(CPUState, sr[8]) },
2880 { "sr9", offsetof(CPUState, sr[9]) },
2881 { "sr10", offsetof(CPUState, sr[10]) },
2882 { "sr11", offsetof(CPUState, sr[11]) },
2883 { "sr12", offsetof(CPUState, sr[12]) },
2884 { "sr13", offsetof(CPUState, sr[13]) },
2885 { "sr14", offsetof(CPUState, sr[14]) },
2886 { "sr15", offsetof(CPUState, sr[15]) },
2887 /* Too lazy to put BATs and SPRs ... */
2888 #elif defined(TARGET_SPARC)
2889 { "g0", offsetof(CPUState, gregs[0]) },
2890 { "g1", offsetof(CPUState, gregs[1]) },
2891 { "g2", offsetof(CPUState, gregs[2]) },
2892 { "g3", offsetof(CPUState, gregs[3]) },
2893 { "g4", offsetof(CPUState, gregs[4]) },
2894 { "g5", offsetof(CPUState, gregs[5]) },
2895 { "g6", offsetof(CPUState, gregs[6]) },
2896 { "g7", offsetof(CPUState, gregs[7]) },
2897 { "o0", 0, monitor_get_reg },
2898 { "o1", 1, monitor_get_reg },
2899 { "o2", 2, monitor_get_reg },
2900 { "o3", 3, monitor_get_reg },
2901 { "o4", 4, monitor_get_reg },
2902 { "o5", 5, monitor_get_reg },
2903 { "o6", 6, monitor_get_reg },
2904 { "o7", 7, monitor_get_reg },
2905 { "l0", 8, monitor_get_reg },
2906 { "l1", 9, monitor_get_reg },
2907 { "l2", 10, monitor_get_reg },
2908 { "l3", 11, monitor_get_reg },
2909 { "l4", 12, monitor_get_reg },
2910 { "l5", 13, monitor_get_reg },
2911 { "l6", 14, monitor_get_reg },
2912 { "l7", 15, monitor_get_reg },
2913 { "i0", 16, monitor_get_reg },
2914 { "i1", 17, monitor_get_reg },
2915 { "i2", 18, monitor_get_reg },
2916 { "i3", 19, monitor_get_reg },
2917 { "i4", 20, monitor_get_reg },
2918 { "i5", 21, monitor_get_reg },
2919 { "i6", 22, monitor_get_reg },
2920 { "i7", 23, monitor_get_reg },
2921 { "pc", offsetof(CPUState, pc) },
2922 { "npc", offsetof(CPUState, npc) },
2923 { "y", offsetof(CPUState, y) },
2924 #ifndef TARGET_SPARC64
2925 { "psr", 0, &monitor_get_psr, },
2926 { "wim", offsetof(CPUState, wim) },
2927 #endif
2928 { "tbr", offsetof(CPUState, tbr) },
2929 { "fsr", offsetof(CPUState, fsr) },
2930 { "f0", offsetof(CPUState, fpr[0]) },
2931 { "f1", offsetof(CPUState, fpr[1]) },
2932 { "f2", offsetof(CPUState, fpr[2]) },
2933 { "f3", offsetof(CPUState, fpr[3]) },
2934 { "f4", offsetof(CPUState, fpr[4]) },
2935 { "f5", offsetof(CPUState, fpr[5]) },
2936 { "f6", offsetof(CPUState, fpr[6]) },
2937 { "f7", offsetof(CPUState, fpr[7]) },
2938 { "f8", offsetof(CPUState, fpr[8]) },
2939 { "f9", offsetof(CPUState, fpr[9]) },
2940 { "f10", offsetof(CPUState, fpr[10]) },
2941 { "f11", offsetof(CPUState, fpr[11]) },
2942 { "f12", offsetof(CPUState, fpr[12]) },
2943 { "f13", offsetof(CPUState, fpr[13]) },
2944 { "f14", offsetof(CPUState, fpr[14]) },
2945 { "f15", offsetof(CPUState, fpr[15]) },
2946 { "f16", offsetof(CPUState, fpr[16]) },
2947 { "f17", offsetof(CPUState, fpr[17]) },
2948 { "f18", offsetof(CPUState, fpr[18]) },
2949 { "f19", offsetof(CPUState, fpr[19]) },
2950 { "f20", offsetof(CPUState, fpr[20]) },
2951 { "f21", offsetof(CPUState, fpr[21]) },
2952 { "f22", offsetof(CPUState, fpr[22]) },
2953 { "f23", offsetof(CPUState, fpr[23]) },
2954 { "f24", offsetof(CPUState, fpr[24]) },
2955 { "f25", offsetof(CPUState, fpr[25]) },
2956 { "f26", offsetof(CPUState, fpr[26]) },
2957 { "f27", offsetof(CPUState, fpr[27]) },
2958 { "f28", offsetof(CPUState, fpr[28]) },
2959 { "f29", offsetof(CPUState, fpr[29]) },
2960 { "f30", offsetof(CPUState, fpr[30]) },
2961 { "f31", offsetof(CPUState, fpr[31]) },
2962 #ifdef TARGET_SPARC64
2963 { "f32", offsetof(CPUState, fpr[32]) },
2964 { "f34", offsetof(CPUState, fpr[34]) },
2965 { "f36", offsetof(CPUState, fpr[36]) },
2966 { "f38", offsetof(CPUState, fpr[38]) },
2967 { "f40", offsetof(CPUState, fpr[40]) },
2968 { "f42", offsetof(CPUState, fpr[42]) },
2969 { "f44", offsetof(CPUState, fpr[44]) },
2970 { "f46", offsetof(CPUState, fpr[46]) },
2971 { "f48", offsetof(CPUState, fpr[48]) },
2972 { "f50", offsetof(CPUState, fpr[50]) },
2973 { "f52", offsetof(CPUState, fpr[52]) },
2974 { "f54", offsetof(CPUState, fpr[54]) },
2975 { "f56", offsetof(CPUState, fpr[56]) },
2976 { "f58", offsetof(CPUState, fpr[58]) },
2977 { "f60", offsetof(CPUState, fpr[60]) },
2978 { "f62", offsetof(CPUState, fpr[62]) },
2979 { "asi", offsetof(CPUState, asi) },
2980 { "pstate", offsetof(CPUState, pstate) },
2981 { "cansave", offsetof(CPUState, cansave) },
2982 { "canrestore", offsetof(CPUState, canrestore) },
2983 { "otherwin", offsetof(CPUState, otherwin) },
2984 { "wstate", offsetof(CPUState, wstate) },
2985 { "cleanwin", offsetof(CPUState, cleanwin) },
2986 { "fprs", offsetof(CPUState, fprs) },
2987 #endif
2988 #endif
2989 { NULL },
2992 static void expr_error(Monitor *mon, const char *msg)
2994 monitor_printf(mon, "%s\n", msg);
2995 longjmp(expr_env, 1);
2998 /* return 0 if OK, -1 if not found */
2999 static int get_monitor_def(target_long *pval, const char *name)
3001 const MonitorDef *md;
3002 void *ptr;
3004 for(md = monitor_defs; md->name != NULL; md++) {
3005 if (compare_cmd(name, md->name)) {
3006 if (md->get_value) {
3007 *pval = md->get_value(md, md->offset);
3008 } else {
3009 CPUState *env = mon_get_cpu();
3010 ptr = (uint8_t *)env + md->offset;
3011 switch(md->type) {
3012 case MD_I32:
3013 *pval = *(int32_t *)ptr;
3014 break;
3015 case MD_TLONG:
3016 *pval = *(target_long *)ptr;
3017 break;
3018 default:
3019 *pval = 0;
3020 break;
3023 return 0;
3026 return -1;
3029 static void next(void)
3031 if (*pch != '\0') {
3032 pch++;
3033 while (qemu_isspace(*pch))
3034 pch++;
3038 static int64_t expr_sum(Monitor *mon);
3040 static int64_t expr_unary(Monitor *mon)
3042 int64_t n;
3043 char *p;
3044 int ret;
3046 switch(*pch) {
3047 case '+':
3048 next();
3049 n = expr_unary(mon);
3050 break;
3051 case '-':
3052 next();
3053 n = -expr_unary(mon);
3054 break;
3055 case '~':
3056 next();
3057 n = ~expr_unary(mon);
3058 break;
3059 case '(':
3060 next();
3061 n = expr_sum(mon);
3062 if (*pch != ')') {
3063 expr_error(mon, "')' expected");
3065 next();
3066 break;
3067 case '\'':
3068 pch++;
3069 if (*pch == '\0')
3070 expr_error(mon, "character constant expected");
3071 n = *pch;
3072 pch++;
3073 if (*pch != '\'')
3074 expr_error(mon, "missing terminating \' character");
3075 next();
3076 break;
3077 case '$':
3079 char buf[128], *q;
3080 target_long reg=0;
3082 pch++;
3083 q = buf;
3084 while ((*pch >= 'a' && *pch <= 'z') ||
3085 (*pch >= 'A' && *pch <= 'Z') ||
3086 (*pch >= '0' && *pch <= '9') ||
3087 *pch == '_' || *pch == '.') {
3088 if ((q - buf) < sizeof(buf) - 1)
3089 *q++ = *pch;
3090 pch++;
3092 while (qemu_isspace(*pch))
3093 pch++;
3094 *q = 0;
3095 ret = get_monitor_def(&reg, buf);
3096 if (ret < 0)
3097 expr_error(mon, "unknown register");
3098 n = reg;
3100 break;
3101 case '\0':
3102 expr_error(mon, "unexpected end of expression");
3103 n = 0;
3104 break;
3105 default:
3106 #if TARGET_PHYS_ADDR_BITS > 32
3107 n = strtoull(pch, &p, 0);
3108 #else
3109 n = strtoul(pch, &p, 0);
3110 #endif
3111 if (pch == p) {
3112 expr_error(mon, "invalid char in expression");
3114 pch = p;
3115 while (qemu_isspace(*pch))
3116 pch++;
3117 break;
3119 return n;
3123 static int64_t expr_prod(Monitor *mon)
3125 int64_t val, val2;
3126 int op;
3128 val = expr_unary(mon);
3129 for(;;) {
3130 op = *pch;
3131 if (op != '*' && op != '/' && op != '%')
3132 break;
3133 next();
3134 val2 = expr_unary(mon);
3135 switch(op) {
3136 default:
3137 case '*':
3138 val *= val2;
3139 break;
3140 case '/':
3141 case '%':
3142 if (val2 == 0)
3143 expr_error(mon, "division by zero");
3144 if (op == '/')
3145 val /= val2;
3146 else
3147 val %= val2;
3148 break;
3151 return val;
3154 static int64_t expr_logic(Monitor *mon)
3156 int64_t val, val2;
3157 int op;
3159 val = expr_prod(mon);
3160 for(;;) {
3161 op = *pch;
3162 if (op != '&' && op != '|' && op != '^')
3163 break;
3164 next();
3165 val2 = expr_prod(mon);
3166 switch(op) {
3167 default:
3168 case '&':
3169 val &= val2;
3170 break;
3171 case '|':
3172 val |= val2;
3173 break;
3174 case '^':
3175 val ^= val2;
3176 break;
3179 return val;
3182 static int64_t expr_sum(Monitor *mon)
3184 int64_t val, val2;
3185 int op;
3187 val = expr_logic(mon);
3188 for(;;) {
3189 op = *pch;
3190 if (op != '+' && op != '-')
3191 break;
3192 next();
3193 val2 = expr_logic(mon);
3194 if (op == '+')
3195 val += val2;
3196 else
3197 val -= val2;
3199 return val;
3202 static int get_expr(Monitor *mon, int64_t *pval, const char **pp)
3204 pch = *pp;
3205 if (setjmp(expr_env)) {
3206 *pp = pch;
3207 return -1;
3209 while (qemu_isspace(*pch))
3210 pch++;
3211 *pval = expr_sum(mon);
3212 *pp = pch;
3213 return 0;
3216 static int get_double(Monitor *mon, double *pval, const char **pp)
3218 const char *p = *pp;
3219 char *tailp;
3220 double d;
3222 d = strtod(p, &tailp);
3223 if (tailp == p) {
3224 monitor_printf(mon, "Number expected\n");
3225 return -1;
3227 if (d != d || d - d != 0) {
3228 /* NaN or infinity */
3229 monitor_printf(mon, "Bad number\n");
3230 return -1;
3232 *pval = d;
3233 *pp = tailp;
3234 return 0;
3237 static int get_str(char *buf, int buf_size, const char **pp)
3239 const char *p;
3240 char *q;
3241 int c;
3243 q = buf;
3244 p = *pp;
3245 while (qemu_isspace(*p))
3246 p++;
3247 if (*p == '\0') {
3248 fail:
3249 *q = '\0';
3250 *pp = p;
3251 return -1;
3253 if (*p == '\"') {
3254 p++;
3255 while (*p != '\0' && *p != '\"') {
3256 if (*p == '\\') {
3257 p++;
3258 c = *p++;
3259 switch(c) {
3260 case 'n':
3261 c = '\n';
3262 break;
3263 case 'r':
3264 c = '\r';
3265 break;
3266 case '\\':
3267 case '\'':
3268 case '\"':
3269 break;
3270 default:
3271 qemu_printf("unsupported escape code: '\\%c'\n", c);
3272 goto fail;
3274 if ((q - buf) < buf_size - 1) {
3275 *q++ = c;
3277 } else {
3278 if ((q - buf) < buf_size - 1) {
3279 *q++ = *p;
3281 p++;
3284 if (*p != '\"') {
3285 qemu_printf("unterminated string\n");
3286 goto fail;
3288 p++;
3289 } else {
3290 while (*p != '\0' && !qemu_isspace(*p)) {
3291 if ((q - buf) < buf_size - 1) {
3292 *q++ = *p;
3294 p++;
3297 *q = '\0';
3298 *pp = p;
3299 return 0;
3303 * Store the command-name in cmdname, and return a pointer to
3304 * the remaining of the command string.
3306 static const char *get_command_name(const char *cmdline,
3307 char *cmdname, size_t nlen)
3309 size_t len;
3310 const char *p, *pstart;
3312 p = cmdline;
3313 while (qemu_isspace(*p))
3314 p++;
3315 if (*p == '\0')
3316 return NULL;
3317 pstart = p;
3318 while (*p != '\0' && *p != '/' && !qemu_isspace(*p))
3319 p++;
3320 len = p - pstart;
3321 if (len > nlen - 1)
3322 len = nlen - 1;
3323 memcpy(cmdname, pstart, len);
3324 cmdname[len] = '\0';
3325 return p;
3329 * Read key of 'type' into 'key' and return the current
3330 * 'type' pointer.
3332 static char *key_get_info(const char *type, char **key)
3334 size_t len;
3335 char *p, *str;
3337 if (*type == ',')
3338 type++;
3340 p = strchr(type, ':');
3341 if (!p) {
3342 *key = NULL;
3343 return NULL;
3345 len = p - type;
3347 str = qemu_malloc(len + 1);
3348 memcpy(str, type, len);
3349 str[len] = '\0';
3351 *key = str;
3352 return ++p;
3355 static int default_fmt_format = 'x';
3356 static int default_fmt_size = 4;
3358 #define MAX_ARGS 16
3360 static int is_valid_option(const char *c, const char *typestr)
3362 char option[3];
3364 option[0] = '-';
3365 option[1] = *c;
3366 option[2] = '\0';
3368 typestr = strstr(typestr, option);
3369 return (typestr != NULL);
3372 static const mon_cmd_t *monitor_find_command(const char *cmdname)
3374 const mon_cmd_t *cmd;
3376 for (cmd = mon_cmds; cmd->name != NULL; cmd++) {
3377 if (compare_cmd(cmdname, cmd->name)) {
3378 return cmd;
3382 return NULL;
3385 static const mon_cmd_t *monitor_parse_command(Monitor *mon,
3386 const char *cmdline,
3387 QDict *qdict)
3389 const char *p, *typestr;
3390 int c;
3391 const mon_cmd_t *cmd;
3392 char cmdname[256];
3393 char buf[1024];
3394 char *key;
3396 #ifdef DEBUG
3397 monitor_printf(mon, "command='%s'\n", cmdline);
3398 #endif
3400 /* extract the command name */
3401 p = get_command_name(cmdline, cmdname, sizeof(cmdname));
3402 if (!p)
3403 return NULL;
3405 cmd = monitor_find_command(cmdname);
3406 if (!cmd) {
3407 monitor_printf(mon, "unknown command: '%s'\n", cmdname);
3408 return NULL;
3411 /* parse the parameters */
3412 typestr = cmd->args_type;
3413 for(;;) {
3414 typestr = key_get_info(typestr, &key);
3415 if (!typestr)
3416 break;
3417 c = *typestr;
3418 typestr++;
3419 switch(c) {
3420 case 'F':
3421 case 'B':
3422 case 's':
3424 int ret;
3426 while (qemu_isspace(*p))
3427 p++;
3428 if (*typestr == '?') {
3429 typestr++;
3430 if (*p == '\0') {
3431 /* no optional string: NULL argument */
3432 break;
3435 ret = get_str(buf, sizeof(buf), &p);
3436 if (ret < 0) {
3437 switch(c) {
3438 case 'F':
3439 monitor_printf(mon, "%s: filename expected\n",
3440 cmdname);
3441 break;
3442 case 'B':
3443 monitor_printf(mon, "%s: block device name expected\n",
3444 cmdname);
3445 break;
3446 default:
3447 monitor_printf(mon, "%s: string expected\n", cmdname);
3448 break;
3450 goto fail;
3452 qdict_put(qdict, key, qstring_from_str(buf));
3454 break;
3455 case 'O':
3457 QemuOptsList *opts_list;
3458 QemuOpts *opts;
3460 opts_list = qemu_find_opts(key);
3461 if (!opts_list || opts_list->desc->name) {
3462 goto bad_type;
3464 while (qemu_isspace(*p)) {
3465 p++;
3467 if (!*p)
3468 break;
3469 if (get_str(buf, sizeof(buf), &p) < 0) {
3470 goto fail;
3472 opts = qemu_opts_parse(opts_list, buf, 1);
3473 if (!opts) {
3474 goto fail;
3476 qemu_opts_to_qdict(opts, qdict);
3477 qemu_opts_del(opts);
3479 break;
3480 case '/':
3482 int count, format, size;
3484 while (qemu_isspace(*p))
3485 p++;
3486 if (*p == '/') {
3487 /* format found */
3488 p++;
3489 count = 1;
3490 if (qemu_isdigit(*p)) {
3491 count = 0;
3492 while (qemu_isdigit(*p)) {
3493 count = count * 10 + (*p - '0');
3494 p++;
3497 size = -1;
3498 format = -1;
3499 for(;;) {
3500 switch(*p) {
3501 case 'o':
3502 case 'd':
3503 case 'u':
3504 case 'x':
3505 case 'i':
3506 case 'c':
3507 format = *p++;
3508 break;
3509 case 'b':
3510 size = 1;
3511 p++;
3512 break;
3513 case 'h':
3514 size = 2;
3515 p++;
3516 break;
3517 case 'w':
3518 size = 4;
3519 p++;
3520 break;
3521 case 'g':
3522 case 'L':
3523 size = 8;
3524 p++;
3525 break;
3526 default:
3527 goto next;
3530 next:
3531 if (*p != '\0' && !qemu_isspace(*p)) {
3532 monitor_printf(mon, "invalid char in format: '%c'\n",
3533 *p);
3534 goto fail;
3536 if (format < 0)
3537 format = default_fmt_format;
3538 if (format != 'i') {
3539 /* for 'i', not specifying a size gives -1 as size */
3540 if (size < 0)
3541 size = default_fmt_size;
3542 default_fmt_size = size;
3544 default_fmt_format = format;
3545 } else {
3546 count = 1;
3547 format = default_fmt_format;
3548 if (format != 'i') {
3549 size = default_fmt_size;
3550 } else {
3551 size = -1;
3554 qdict_put(qdict, "count", qint_from_int(count));
3555 qdict_put(qdict, "format", qint_from_int(format));
3556 qdict_put(qdict, "size", qint_from_int(size));
3558 break;
3559 case 'i':
3560 case 'l':
3561 case 'M':
3563 int64_t val;
3565 while (qemu_isspace(*p))
3566 p++;
3567 if (*typestr == '?' || *typestr == '.') {
3568 if (*typestr == '?') {
3569 if (*p == '\0') {
3570 typestr++;
3571 break;
3573 } else {
3574 if (*p == '.') {
3575 p++;
3576 while (qemu_isspace(*p))
3577 p++;
3578 } else {
3579 typestr++;
3580 break;
3583 typestr++;
3585 if (get_expr(mon, &val, &p))
3586 goto fail;
3587 /* Check if 'i' is greater than 32-bit */
3588 if ((c == 'i') && ((val >> 32) & 0xffffffff)) {
3589 monitor_printf(mon, "\'%s\' has failed: ", cmdname);
3590 monitor_printf(mon, "integer is for 32-bit values\n");
3591 goto fail;
3592 } else if (c == 'M') {
3593 val <<= 20;
3595 qdict_put(qdict, key, qint_from_int(val));
3597 break;
3598 case 'f':
3599 case 'T':
3601 double val;
3603 while (qemu_isspace(*p))
3604 p++;
3605 if (*typestr == '?') {
3606 typestr++;
3607 if (*p == '\0') {
3608 break;
3611 if (get_double(mon, &val, &p) < 0) {
3612 goto fail;
3614 if (c == 'f' && *p) {
3615 switch (*p) {
3616 case 'K': case 'k':
3617 val *= 1 << 10; p++; break;
3618 case 'M': case 'm':
3619 val *= 1 << 20; p++; break;
3620 case 'G': case 'g':
3621 val *= 1 << 30; p++; break;
3624 if (c == 'T' && p[0] && p[1] == 's') {
3625 switch (*p) {
3626 case 'm':
3627 val /= 1e3; p += 2; break;
3628 case 'u':
3629 val /= 1e6; p += 2; break;
3630 case 'n':
3631 val /= 1e9; p += 2; break;
3634 if (*p && !qemu_isspace(*p)) {
3635 monitor_printf(mon, "Unknown unit suffix\n");
3636 goto fail;
3638 qdict_put(qdict, key, qfloat_from_double(val));
3640 break;
3641 case 'b':
3643 const char *beg;
3644 int val;
3646 while (qemu_isspace(*p)) {
3647 p++;
3649 beg = p;
3650 while (qemu_isgraph(*p)) {
3651 p++;
3653 if (p - beg == 2 && !memcmp(beg, "on", p - beg)) {
3654 val = 1;
3655 } else if (p - beg == 3 && !memcmp(beg, "off", p - beg)) {
3656 val = 0;
3657 } else {
3658 monitor_printf(mon, "Expected 'on' or 'off'\n");
3659 goto fail;
3661 qdict_put(qdict, key, qbool_from_int(val));
3663 break;
3664 case '-':
3666 const char *tmp = p;
3667 int skip_key = 0;
3668 /* option */
3670 c = *typestr++;
3671 if (c == '\0')
3672 goto bad_type;
3673 while (qemu_isspace(*p))
3674 p++;
3675 if (*p == '-') {
3676 p++;
3677 if(c != *p) {
3678 if(!is_valid_option(p, typestr)) {
3680 monitor_printf(mon, "%s: unsupported option -%c\n",
3681 cmdname, *p);
3682 goto fail;
3683 } else {
3684 skip_key = 1;
3687 if(skip_key) {
3688 p = tmp;
3689 } else {
3690 /* has option */
3691 p++;
3692 qdict_put(qdict, key, qbool_from_int(1));
3696 break;
3697 default:
3698 bad_type:
3699 monitor_printf(mon, "%s: unknown type '%c'\n", cmdname, c);
3700 goto fail;
3702 qemu_free(key);
3703 key = NULL;
3705 /* check that all arguments were parsed */
3706 while (qemu_isspace(*p))
3707 p++;
3708 if (*p != '\0') {
3709 monitor_printf(mon, "%s: extraneous characters at the end of line\n",
3710 cmdname);
3711 goto fail;
3714 return cmd;
3716 fail:
3717 qemu_free(key);
3718 return NULL;
3721 void monitor_set_error(Monitor *mon, QError *qerror)
3723 /* report only the first error */
3724 if (!mon->error) {
3725 mon->error = qerror;
3726 } else {
3727 MON_DEBUG("Additional error report at %s:%d\n",
3728 qerror->file, qerror->linenr);
3729 QDECREF(qerror);
3733 static int is_async_return(const QObject *data)
3735 if (data && qobject_type(data) == QTYPE_QDICT) {
3736 return qdict_haskey(qobject_to_qdict(data), "__mon_async");
3739 return 0;
3742 static void handler_audit(Monitor *mon, const mon_cmd_t *cmd, int ret)
3744 if (monitor_ctrl_mode(mon)) {
3745 if (ret && !monitor_has_error(mon)) {
3747 * If it returns failure, it must have passed on error.
3749 * Action: Report an internal error to the client if in QMP.
3751 qerror_report(QERR_UNDEFINED_ERROR);
3752 MON_DEBUG("command '%s' returned failure but did not pass an error\n",
3753 cmd->name);
3756 #ifdef CONFIG_DEBUG_MONITOR
3757 if (!ret && monitor_has_error(mon)) {
3759 * If it returns success, it must not have passed an error.
3761 * Action: Report the passed error to the client.
3763 MON_DEBUG("command '%s' returned success but passed an error\n",
3764 cmd->name);
3767 if (mon_print_count_get(mon) > 0 && strcmp(cmd->name, "info") != 0) {
3769 * Handlers should not call Monitor print functions.
3771 * Action: Ignore them in QMP.
3773 * (XXX: we don't check any 'info' or 'query' command here
3774 * because the user print function _is_ called by do_info(), hence
3775 * we will trigger this check. This problem will go away when we
3776 * make 'query' commands real and kill do_info())
3778 MON_DEBUG("command '%s' called print functions %d time(s)\n",
3779 cmd->name, mon_print_count_get(mon));
3781 #endif
3782 } else {
3783 assert(!monitor_has_error(mon));
3784 QDECREF(mon->error);
3785 mon->error = NULL;
3789 static void monitor_call_handler(Monitor *mon, const mon_cmd_t *cmd,
3790 const QDict *params)
3792 int ret;
3793 QObject *data = NULL;
3795 mon_print_count_init(mon);
3797 ret = cmd->mhandler.cmd_new(mon, params, &data);
3798 handler_audit(mon, cmd, ret);
3800 if (is_async_return(data)) {
3802 * Asynchronous commands have no initial return data but they can
3803 * generate errors. Data is returned via the async completion handler.
3805 if (monitor_ctrl_mode(mon) && monitor_has_error(mon)) {
3806 monitor_protocol_emitter(mon, NULL);
3808 } else if (monitor_ctrl_mode(mon)) {
3809 /* Monitor Protocol */
3810 monitor_protocol_emitter(mon, data);
3811 } else {
3812 /* User Protocol */
3813 if (data)
3814 cmd->user_print(mon, data);
3817 qobject_decref(data);
3820 static void handle_user_command(Monitor *mon, const char *cmdline)
3822 QDict *qdict;
3823 const mon_cmd_t *cmd;
3825 qdict = qdict_new();
3827 cmd = monitor_parse_command(mon, cmdline, qdict);
3828 if (!cmd)
3829 goto out;
3831 if (monitor_handler_is_async(cmd)) {
3832 user_async_cmd_handler(mon, cmd, qdict);
3833 } else if (monitor_handler_ported(cmd)) {
3834 monitor_call_handler(mon, cmd, qdict);
3835 } else {
3836 cmd->mhandler.cmd(mon, qdict);
3839 out:
3840 QDECREF(qdict);
3843 static void cmd_completion(const char *name, const char *list)
3845 const char *p, *pstart;
3846 char cmd[128];
3847 int len;
3849 p = list;
3850 for(;;) {
3851 pstart = p;
3852 p = strchr(p, '|');
3853 if (!p)
3854 p = pstart + strlen(pstart);
3855 len = p - pstart;
3856 if (len > sizeof(cmd) - 2)
3857 len = sizeof(cmd) - 2;
3858 memcpy(cmd, pstart, len);
3859 cmd[len] = '\0';
3860 if (name[0] == '\0' || !strncmp(name, cmd, strlen(name))) {
3861 readline_add_completion(cur_mon->rs, cmd);
3863 if (*p == '\0')
3864 break;
3865 p++;
3869 static void file_completion(const char *input)
3871 DIR *ffs;
3872 struct dirent *d;
3873 char path[1024];
3874 char file[1024], file_prefix[1024];
3875 int input_path_len;
3876 const char *p;
3878 p = strrchr(input, '/');
3879 if (!p) {
3880 input_path_len = 0;
3881 pstrcpy(file_prefix, sizeof(file_prefix), input);
3882 pstrcpy(path, sizeof(path), ".");
3883 } else {
3884 input_path_len = p - input + 1;
3885 memcpy(path, input, input_path_len);
3886 if (input_path_len > sizeof(path) - 1)
3887 input_path_len = sizeof(path) - 1;
3888 path[input_path_len] = '\0';
3889 pstrcpy(file_prefix, sizeof(file_prefix), p + 1);
3891 #ifdef DEBUG_COMPLETION
3892 monitor_printf(cur_mon, "input='%s' path='%s' prefix='%s'\n",
3893 input, path, file_prefix);
3894 #endif
3895 ffs = opendir(path);
3896 if (!ffs)
3897 return;
3898 for(;;) {
3899 struct stat sb;
3900 d = readdir(ffs);
3901 if (!d)
3902 break;
3903 if (strstart(d->d_name, file_prefix, NULL)) {
3904 memcpy(file, input, input_path_len);
3905 if (input_path_len < sizeof(file))
3906 pstrcpy(file + input_path_len, sizeof(file) - input_path_len,
3907 d->d_name);
3908 /* stat the file to find out if it's a directory.
3909 * In that case add a slash to speed up typing long paths
3911 stat(file, &sb);
3912 if(S_ISDIR(sb.st_mode))
3913 pstrcat(file, sizeof(file), "/");
3914 readline_add_completion(cur_mon->rs, file);
3917 closedir(ffs);
3920 static void block_completion_it(void *opaque, BlockDriverState *bs)
3922 const char *name = bdrv_get_device_name(bs);
3923 const char *input = opaque;
3925 if (input[0] == '\0' ||
3926 !strncmp(name, (char *)input, strlen(input))) {
3927 readline_add_completion(cur_mon->rs, name);
3931 /* NOTE: this parser is an approximate form of the real command parser */
3932 static void parse_cmdline(const char *cmdline,
3933 int *pnb_args, char **args)
3935 const char *p;
3936 int nb_args, ret;
3937 char buf[1024];
3939 p = cmdline;
3940 nb_args = 0;
3941 for(;;) {
3942 while (qemu_isspace(*p))
3943 p++;
3944 if (*p == '\0')
3945 break;
3946 if (nb_args >= MAX_ARGS)
3947 break;
3948 ret = get_str(buf, sizeof(buf), &p);
3949 args[nb_args] = qemu_strdup(buf);
3950 nb_args++;
3951 if (ret < 0)
3952 break;
3954 *pnb_args = nb_args;
3957 static const char *next_arg_type(const char *typestr)
3959 const char *p = strchr(typestr, ':');
3960 return (p != NULL ? ++p : typestr);
3963 static void monitor_find_completion(const char *cmdline)
3965 const char *cmdname;
3966 char *args[MAX_ARGS];
3967 int nb_args, i, len;
3968 const char *ptype, *str;
3969 const mon_cmd_t *cmd;
3970 const KeyDef *key;
3972 parse_cmdline(cmdline, &nb_args, args);
3973 #ifdef DEBUG_COMPLETION
3974 for(i = 0; i < nb_args; i++) {
3975 monitor_printf(cur_mon, "arg%d = '%s'\n", i, (char *)args[i]);
3977 #endif
3979 /* if the line ends with a space, it means we want to complete the
3980 next arg */
3981 len = strlen(cmdline);
3982 if (len > 0 && qemu_isspace(cmdline[len - 1])) {
3983 if (nb_args >= MAX_ARGS) {
3984 goto cleanup;
3986 args[nb_args++] = qemu_strdup("");
3988 if (nb_args <= 1) {
3989 /* command completion */
3990 if (nb_args == 0)
3991 cmdname = "";
3992 else
3993 cmdname = args[0];
3994 readline_set_completion_index(cur_mon->rs, strlen(cmdname));
3995 for(cmd = mon_cmds; cmd->name != NULL; cmd++) {
3996 cmd_completion(cmdname, cmd->name);
3998 } else {
3999 /* find the command */
4000 for (cmd = mon_cmds; cmd->name != NULL; cmd++) {
4001 if (compare_cmd(args[0], cmd->name)) {
4002 break;
4005 if (!cmd->name) {
4006 goto cleanup;
4009 ptype = next_arg_type(cmd->args_type);
4010 for(i = 0; i < nb_args - 2; i++) {
4011 if (*ptype != '\0') {
4012 ptype = next_arg_type(ptype);
4013 while (*ptype == '?')
4014 ptype = next_arg_type(ptype);
4017 str = args[nb_args - 1];
4018 if (*ptype == '-' && ptype[1] != '\0') {
4019 ptype = next_arg_type(ptype);
4021 switch(*ptype) {
4022 case 'F':
4023 /* file completion */
4024 readline_set_completion_index(cur_mon->rs, strlen(str));
4025 file_completion(str);
4026 break;
4027 case 'B':
4028 /* block device name completion */
4029 readline_set_completion_index(cur_mon->rs, strlen(str));
4030 bdrv_iterate(block_completion_it, (void *)str);
4031 break;
4032 case 's':
4033 /* XXX: more generic ? */
4034 if (!strcmp(cmd->name, "info")) {
4035 readline_set_completion_index(cur_mon->rs, strlen(str));
4036 for(cmd = info_cmds; cmd->name != NULL; cmd++) {
4037 cmd_completion(str, cmd->name);
4039 } else if (!strcmp(cmd->name, "sendkey")) {
4040 char *sep = strrchr(str, '-');
4041 if (sep)
4042 str = sep + 1;
4043 readline_set_completion_index(cur_mon->rs, strlen(str));
4044 for(key = key_defs; key->name != NULL; key++) {
4045 cmd_completion(str, key->name);
4047 } else if (!strcmp(cmd->name, "help|?")) {
4048 readline_set_completion_index(cur_mon->rs, strlen(str));
4049 for (cmd = mon_cmds; cmd->name != NULL; cmd++) {
4050 cmd_completion(str, cmd->name);
4053 break;
4054 default:
4055 break;
4059 cleanup:
4060 for (i = 0; i < nb_args; i++) {
4061 qemu_free(args[i]);
4065 static int monitor_can_read(void *opaque)
4067 Monitor *mon = opaque;
4069 return (mon->suspend_cnt == 0) ? 1 : 0;
4072 static int invalid_qmp_mode(const Monitor *mon, const char *cmd_name)
4074 int is_cap = compare_cmd(cmd_name, "qmp_capabilities");
4075 return (qmp_cmd_mode(mon) ? is_cap : !is_cap);
4079 * Argument validation rules:
4081 * 1. The argument must exist in cmd_args qdict
4082 * 2. The argument type must be the expected one
4084 * Special case: If the argument doesn't exist in cmd_args and
4085 * the QMP_ACCEPT_UNKNOWNS flag is set, then the
4086 * checking is skipped for it.
4088 static int check_client_args_type(const QDict *client_args,
4089 const QDict *cmd_args, int flags)
4091 const QDictEntry *ent;
4093 for (ent = qdict_first(client_args); ent;ent = qdict_next(client_args,ent)){
4094 QObject *obj;
4095 QString *arg_type;
4096 const QObject *client_arg = qdict_entry_value(ent);
4097 const char *client_arg_name = qdict_entry_key(ent);
4099 obj = qdict_get(cmd_args, client_arg_name);
4100 if (!obj) {
4101 if (flags & QMP_ACCEPT_UNKNOWNS) {
4102 /* handler accepts unknowns */
4103 continue;
4105 /* client arg doesn't exist */
4106 qerror_report(QERR_INVALID_PARAMETER, client_arg_name);
4107 return -1;
4110 arg_type = qobject_to_qstring(obj);
4111 assert(arg_type != NULL);
4113 /* check if argument's type is correct */
4114 switch (qstring_get_str(arg_type)[0]) {
4115 case 'F':
4116 case 'B':
4117 case 's':
4118 if (qobject_type(client_arg) != QTYPE_QSTRING) {
4119 qerror_report(QERR_INVALID_PARAMETER_TYPE, client_arg_name,
4120 "string");
4121 return -1;
4123 break;
4124 case 'i':
4125 case 'l':
4126 case 'M':
4127 if (qobject_type(client_arg) != QTYPE_QINT) {
4128 qerror_report(QERR_INVALID_PARAMETER_TYPE, client_arg_name,
4129 "int");
4130 return -1;
4132 break;
4133 case 'f':
4134 case 'T':
4135 if (qobject_type(client_arg) != QTYPE_QINT &&
4136 qobject_type(client_arg) != QTYPE_QFLOAT) {
4137 qerror_report(QERR_INVALID_PARAMETER_TYPE, client_arg_name,
4138 "number");
4139 return -1;
4141 break;
4142 case 'b':
4143 case '-':
4144 if (qobject_type(client_arg) != QTYPE_QBOOL) {
4145 qerror_report(QERR_INVALID_PARAMETER_TYPE, client_arg_name,
4146 "bool");
4147 return -1;
4149 break;
4150 case 'O':
4151 assert(flags & QMP_ACCEPT_UNKNOWNS);
4152 break;
4153 case '/':
4154 case '.':
4156 * These types are not supported by QMP and thus are not
4157 * handled here. Fall through.
4159 default:
4160 abort();
4164 return 0;
4168 * - Check if the client has passed all mandatory args
4169 * - Set special flags for argument validation
4171 static int check_mandatory_args(const QDict *cmd_args,
4172 const QDict *client_args, int *flags)
4174 const QDictEntry *ent;
4176 for (ent = qdict_first(cmd_args); ent; ent = qdict_next(cmd_args, ent)) {
4177 const char *cmd_arg_name = qdict_entry_key(ent);
4178 QString *type = qobject_to_qstring(qdict_entry_value(ent));
4179 assert(type != NULL);
4181 if (qstring_get_str(type)[0] == 'O') {
4182 assert((*flags & QMP_ACCEPT_UNKNOWNS) == 0);
4183 *flags |= QMP_ACCEPT_UNKNOWNS;
4184 } else if (qstring_get_str(type)[0] != '-' &&
4185 qstring_get_str(type)[1] != '?' &&
4186 !qdict_haskey(client_args, cmd_arg_name)) {
4187 qerror_report(QERR_MISSING_PARAMETER, cmd_arg_name);
4188 return -1;
4192 return 0;
4195 static QDict *qdict_from_args_type(const char *args_type)
4197 int i;
4198 QDict *qdict;
4199 QString *key, *type, *cur_qs;
4201 assert(args_type != NULL);
4203 qdict = qdict_new();
4205 if (args_type == NULL || args_type[0] == '\0') {
4206 /* no args, empty qdict */
4207 goto out;
4210 key = qstring_new();
4211 type = qstring_new();
4213 cur_qs = key;
4215 for (i = 0;; i++) {
4216 switch (args_type[i]) {
4217 case ',':
4218 case '\0':
4219 qdict_put(qdict, qstring_get_str(key), type);
4220 QDECREF(key);
4221 if (args_type[i] == '\0') {
4222 goto out;
4224 type = qstring_new(); /* qdict has ref */
4225 cur_qs = key = qstring_new();
4226 break;
4227 case ':':
4228 cur_qs = type;
4229 break;
4230 default:
4231 qstring_append_chr(cur_qs, args_type[i]);
4232 break;
4236 out:
4237 return qdict;
4241 * Client argument checking rules:
4243 * 1. Client must provide all mandatory arguments
4244 * 2. Each argument provided by the client must be expected
4245 * 3. Each argument provided by the client must have the type expected
4246 * by the command
4248 static int qmp_check_client_args(const mon_cmd_t *cmd, QDict *client_args)
4250 int flags, err;
4251 QDict *cmd_args;
4253 cmd_args = qdict_from_args_type(cmd->args_type);
4255 flags = 0;
4256 err = check_mandatory_args(cmd_args, client_args, &flags);
4257 if (err) {
4258 goto out;
4261 err = check_client_args_type(client_args, cmd_args, flags);
4263 out:
4264 QDECREF(cmd_args);
4265 return err;
4269 * Input object checking rules
4271 * 1. Input object must be a dict
4272 * 2. The "execute" key must exist
4273 * 3. The "execute" key must be a string
4274 * 4. If the "arguments" key exists, it must be a dict
4275 * 5. If the "id" key exists, it can be anything (ie. json-value)
4276 * 6. Any argument not listed above is considered invalid
4278 static QDict *qmp_check_input_obj(QObject *input_obj)
4280 const QDictEntry *ent;
4281 int has_exec_key = 0;
4282 QDict *input_dict;
4284 if (qobject_type(input_obj) != QTYPE_QDICT) {
4285 qerror_report(QERR_QMP_BAD_INPUT_OBJECT, "object");
4286 return NULL;
4289 input_dict = qobject_to_qdict(input_obj);
4291 for (ent = qdict_first(input_dict); ent; ent = qdict_next(input_dict, ent)){
4292 const char *arg_name = qdict_entry_key(ent);
4293 const QObject *arg_obj = qdict_entry_value(ent);
4295 if (!strcmp(arg_name, "execute")) {
4296 if (qobject_type(arg_obj) != QTYPE_QSTRING) {
4297 qerror_report(QERR_QMP_BAD_INPUT_OBJECT_MEMBER, "execute",
4298 "string");
4299 return NULL;
4301 has_exec_key = 1;
4302 } else if (!strcmp(arg_name, "arguments")) {
4303 if (qobject_type(arg_obj) != QTYPE_QDICT) {
4304 qerror_report(QERR_QMP_BAD_INPUT_OBJECT_MEMBER, "arguments",
4305 "object");
4306 return NULL;
4308 } else if (!strcmp(arg_name, "id")) {
4309 /* FIXME: check duplicated IDs for async commands */
4310 } else {
4311 qerror_report(QERR_QMP_EXTRA_MEMBER, arg_name);
4312 return NULL;
4316 if (!has_exec_key) {
4317 qerror_report(QERR_QMP_BAD_INPUT_OBJECT, "execute");
4318 return NULL;
4321 return input_dict;
4324 static void handle_qmp_command(JSONMessageParser *parser, QList *tokens)
4326 int err;
4327 QObject *obj;
4328 QDict *input, *args;
4329 const mon_cmd_t *cmd;
4330 Monitor *mon = cur_mon;
4331 const char *cmd_name, *info_item;
4333 args = input = NULL;
4335 obj = json_parser_parse(tokens, NULL);
4336 if (!obj) {
4337 // FIXME: should be triggered in json_parser_parse()
4338 qerror_report(QERR_JSON_PARSING);
4339 goto err_out;
4342 input = qmp_check_input_obj(obj);
4343 if (!input) {
4344 qobject_decref(obj);
4345 goto err_out;
4348 mon->mc->id = qdict_get(input, "id");
4349 qobject_incref(mon->mc->id);
4351 cmd_name = qdict_get_str(input, "execute");
4352 if (invalid_qmp_mode(mon, cmd_name)) {
4353 qerror_report(QERR_COMMAND_NOT_FOUND, cmd_name);
4354 goto err_out;
4358 * XXX: We need this special case until we get info handlers
4359 * converted into 'query-' commands
4361 if (compare_cmd(cmd_name, "info")) {
4362 qerror_report(QERR_COMMAND_NOT_FOUND, cmd_name);
4363 goto err_out;
4364 } else if (strstart(cmd_name, "query-", &info_item)) {
4365 cmd = monitor_find_command("info");
4366 qdict_put_obj(input, "arguments",
4367 qobject_from_jsonf("{ 'item': %s }", info_item));
4368 } else {
4369 cmd = monitor_find_command(cmd_name);
4370 if (!cmd || !monitor_handler_ported(cmd)
4371 || monitor_cmd_user_only(cmd)) {
4372 qerror_report(QERR_COMMAND_NOT_FOUND, cmd_name);
4373 goto err_out;
4377 obj = qdict_get(input, "arguments");
4378 if (!obj) {
4379 args = qdict_new();
4380 } else {
4381 args = qobject_to_qdict(obj);
4382 QINCREF(args);
4385 err = qmp_check_client_args(cmd, args);
4386 if (err < 0) {
4387 goto err_out;
4390 if (monitor_handler_is_async(cmd)) {
4391 err = qmp_async_cmd_handler(mon, cmd, args);
4392 if (err) {
4393 /* emit the error response */
4394 goto err_out;
4396 } else {
4397 monitor_call_handler(mon, cmd, args);
4400 goto out;
4402 err_out:
4403 monitor_protocol_emitter(mon, NULL);
4404 out:
4405 QDECREF(input);
4406 QDECREF(args);
4410 * monitor_control_read(): Read and handle QMP input
4412 static void monitor_control_read(void *opaque, const uint8_t *buf, int size)
4414 Monitor *old_mon = cur_mon;
4416 cur_mon = opaque;
4418 json_message_parser_feed(&cur_mon->mc->parser, (const char *) buf, size);
4420 cur_mon = old_mon;
4423 static void monitor_read(void *opaque, const uint8_t *buf, int size)
4425 Monitor *old_mon = cur_mon;
4426 int i;
4428 cur_mon = opaque;
4430 if (cur_mon->rs) {
4431 for (i = 0; i < size; i++)
4432 readline_handle_byte(cur_mon->rs, buf[i]);
4433 } else {
4434 if (size == 0 || buf[size - 1] != 0)
4435 monitor_printf(cur_mon, "corrupted command\n");
4436 else
4437 handle_user_command(cur_mon, (char *)buf);
4440 cur_mon = old_mon;
4443 static void monitor_command_cb(Monitor *mon, const char *cmdline, void *opaque)
4445 monitor_suspend(mon);
4446 handle_user_command(mon, cmdline);
4447 monitor_resume(mon);
4450 int monitor_suspend(Monitor *mon)
4452 if (!mon->rs)
4453 return -ENOTTY;
4454 mon->suspend_cnt++;
4455 return 0;
4458 void monitor_resume(Monitor *mon)
4460 if (!mon->rs)
4461 return;
4462 if (--mon->suspend_cnt == 0)
4463 readline_show_prompt(mon->rs);
4466 static QObject *get_qmp_greeting(void)
4468 QObject *ver;
4470 do_info_version(NULL, &ver);
4471 return qobject_from_jsonf("{'QMP':{'version': %p,'capabilities': []}}",ver);
4475 * monitor_control_event(): Print QMP gretting
4477 static void monitor_control_event(void *opaque, int event)
4479 QObject *data;
4480 Monitor *mon = opaque;
4482 switch (event) {
4483 case CHR_EVENT_OPENED:
4484 mon->mc->command_mode = 0;
4485 json_message_parser_init(&mon->mc->parser, handle_qmp_command);
4486 data = get_qmp_greeting();
4487 monitor_json_emitter(mon, data);
4488 qobject_decref(data);
4489 break;
4490 case CHR_EVENT_CLOSED:
4491 json_message_parser_destroy(&mon->mc->parser);
4492 break;
4496 static void monitor_event(void *opaque, int event)
4498 Monitor *mon = opaque;
4500 switch (event) {
4501 case CHR_EVENT_MUX_IN:
4502 mon->mux_out = 0;
4503 if (mon->reset_seen) {
4504 readline_restart(mon->rs);
4505 monitor_resume(mon);
4506 monitor_flush(mon);
4507 } else {
4508 mon->suspend_cnt = 0;
4510 break;
4512 case CHR_EVENT_MUX_OUT:
4513 if (mon->reset_seen) {
4514 if (mon->suspend_cnt == 0) {
4515 monitor_printf(mon, "\n");
4517 monitor_flush(mon);
4518 monitor_suspend(mon);
4519 } else {
4520 mon->suspend_cnt++;
4522 mon->mux_out = 1;
4523 break;
4525 case CHR_EVENT_OPENED:
4526 monitor_printf(mon, "QEMU %s monitor - type 'help' for more "
4527 "information\n", QEMU_VERSION);
4528 if (!mon->mux_out) {
4529 readline_show_prompt(mon->rs);
4531 mon->reset_seen = 1;
4532 break;
4538 * Local variables:
4539 * c-indent-level: 4
4540 * c-basic-offset: 4
4541 * tab-width: 8
4542 * End:
4545 void monitor_init(CharDriverState *chr, int flags)
4547 static int is_first_init = 1;
4548 Monitor *mon;
4550 if (is_first_init) {
4551 key_timer = qemu_new_timer(vm_clock, release_keys, NULL);
4552 is_first_init = 0;
4555 mon = qemu_mallocz(sizeof(*mon));
4557 mon->chr = chr;
4558 mon->flags = flags;
4559 if (flags & MONITOR_USE_READLINE) {
4560 mon->rs = readline_init(mon, monitor_find_completion);
4561 monitor_read_command(mon, 0);
4564 if (monitor_ctrl_mode(mon)) {
4565 mon->mc = qemu_mallocz(sizeof(MonitorControl));
4566 /* Control mode requires special handlers */
4567 qemu_chr_add_handlers(chr, monitor_can_read, monitor_control_read,
4568 monitor_control_event, mon);
4569 } else {
4570 qemu_chr_add_handlers(chr, monitor_can_read, monitor_read,
4571 monitor_event, mon);
4574 QLIST_INSERT_HEAD(&mon_list, mon, entry);
4575 if (!default_mon || (flags & MONITOR_IS_DEFAULT))
4576 default_mon = mon;
4579 static void bdrv_password_cb(Monitor *mon, const char *password, void *opaque)
4581 BlockDriverState *bs = opaque;
4582 int ret = 0;
4584 if (bdrv_set_key(bs, password) != 0) {
4585 monitor_printf(mon, "invalid password\n");
4586 ret = -EPERM;
4588 if (mon->password_completion_cb)
4589 mon->password_completion_cb(mon->password_opaque, ret);
4591 monitor_read_command(mon, 1);
4594 int monitor_read_bdrv_key_start(Monitor *mon, BlockDriverState *bs,
4595 BlockDriverCompletionFunc *completion_cb,
4596 void *opaque)
4598 int err;
4600 if (!bdrv_key_required(bs)) {
4601 if (completion_cb)
4602 completion_cb(opaque, 0);
4603 return 0;
4606 if (monitor_ctrl_mode(mon)) {
4607 qerror_report(QERR_DEVICE_ENCRYPTED, bdrv_get_device_name(bs));
4608 return -1;
4611 monitor_printf(mon, "%s (%s) is encrypted.\n", bdrv_get_device_name(bs),
4612 bdrv_get_encrypted_filename(bs));
4614 mon->password_completion_cb = completion_cb;
4615 mon->password_opaque = opaque;
4617 err = monitor_read_password(mon, bdrv_password_cb, bs);
4619 if (err && completion_cb)
4620 completion_cb(opaque, err);
4622 return err;