4 * Copyright (c) 2003-2004 Fabrice Bellard
6 * Permission is hereby granted, free of charge, to any person obtaining a copy
7 * of this software and associated documentation files (the "Software"), to deal
8 * in the Software without restriction, including without limitation the rights
9 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 * copies of the Software, and to permit persons to whom the Software is
11 * furnished to do so, subject to the following conditions:
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
28 #include "hw/pcmcia.h"
31 #include "hw/watchdog.h"
32 #include "hw/loader.h"
35 #include "qemu-char.h"
41 #include "audio/audio.h"
44 #include "qemu-timer.h"
45 #include "migration.h"
55 #include "json-streamer.h"
56 #include "json-parser.h"
59 //#define DEBUG_COMPLETION
65 * 'B' block device name
66 * 's' string (accept optional quote)
68 * 'l' target long (32 or 64 bit)
69 * '/' optional gdb-like print format (like "/10x")
71 * '?' optional type (for all types, except '/')
72 * '.' other form of optional type (for 'i' and 'l')
73 * '-' optional parameter (eg. '-f')
77 typedef struct mon_cmd_t {
79 const char *args_type;
82 void (*user_print)(Monitor *mon, const QObject *data);
84 void (*info)(Monitor *mon);
85 void (*info_new)(Monitor *mon, QObject **ret_data);
86 void (*cmd)(Monitor *mon, const QDict *qdict);
87 void (*cmd_new)(Monitor *mon, const QDict *params, QObject **ret_data);
91 /* file descriptors passed via SCM_RIGHTS */
92 typedef struct mon_fd_t mon_fd_t;
96 QLIST_ENTRY(mon_fd_t) next;
99 typedef struct MonitorControl {
102 JSONMessageParser parser;
106 CharDriverState *chr;
111 uint8_t outbuf[1024];
116 BlockDriverCompletionFunc *password_completion_cb;
117 void *password_opaque;
119 QLIST_HEAD(,mon_fd_t) fds;
120 QLIST_ENTRY(Monitor) entry;
123 static QLIST_HEAD(mon_list, Monitor) mon_list;
125 static const mon_cmd_t mon_cmds[];
126 static const mon_cmd_t info_cmds[];
128 Monitor *cur_mon = NULL;
130 static void monitor_command_cb(Monitor *mon, const char *cmdline,
133 /* Return true if in control mode, false otherwise */
134 static inline int monitor_ctrl_mode(const Monitor *mon)
136 return (mon->flags & MONITOR_USE_CONTROL);
139 static void monitor_read_command(Monitor *mon, int show_prompt)
141 readline_start(mon->rs, "(qemu) ", 0, monitor_command_cb, NULL);
143 readline_show_prompt(mon->rs);
146 static int monitor_read_password(Monitor *mon, ReadLineFunc *readline_func,
150 readline_start(mon->rs, "Password: ", 1, readline_func, opaque);
151 /* prompt is printed on return from the command handler */
154 monitor_printf(mon, "terminal does not support password prompting\n");
159 void monitor_flush(Monitor *mon)
161 if (mon && mon->outbuf_index != 0 && !mon->mux_out) {
162 qemu_chr_write(mon->chr, mon->outbuf, mon->outbuf_index);
163 mon->outbuf_index = 0;
167 /* flush at every end of line or if the buffer is full */
168 static void monitor_puts(Monitor *mon, const char *str)
180 mon->outbuf[mon->outbuf_index++] = '\r';
181 mon->outbuf[mon->outbuf_index++] = c;
182 if (mon->outbuf_index >= (sizeof(mon->outbuf) - 1)
188 void monitor_vprintf(Monitor *mon, const char *fmt, va_list ap)
190 if (mon->mc && !mon->mc->print_enabled) {
191 qemu_error_new(QERR_UNDEFINED_ERROR);
194 vsnprintf(buf, sizeof(buf), fmt, ap);
195 monitor_puts(mon, buf);
199 void monitor_printf(Monitor *mon, const char *fmt, ...)
203 monitor_vprintf(mon, fmt, ap);
207 void monitor_print_filename(Monitor *mon, const char *filename)
211 for (i = 0; filename[i]; i++) {
212 switch (filename[i]) {
216 monitor_printf(mon, "\\%c", filename[i]);
219 monitor_printf(mon, "\\t");
222 monitor_printf(mon, "\\r");
225 monitor_printf(mon, "\\n");
228 monitor_printf(mon, "%c", filename[i]);
234 static int monitor_fprintf(FILE *stream, const char *fmt, ...)
238 monitor_vprintf((Monitor *)stream, fmt, ap);
243 static void monitor_user_noop(Monitor *mon, const QObject *data) { }
245 static inline int monitor_handler_ported(const mon_cmd_t *cmd)
247 return cmd->user_print != NULL;
250 static inline int monitor_has_error(const Monitor *mon)
252 return mon->error != NULL;
255 static void monitor_print_qobject(Monitor *mon, const QObject *data)
257 switch (qobject_type(data)) {
259 monitor_printf(mon, "%s",qstring_get_str(qobject_to_qstring(data)));
262 monitor_printf(mon, "%" PRId64,qint_get_int(qobject_to_qint(data)));
265 monitor_printf(mon, "ERROR: unsupported type: %d",
270 monitor_puts(mon, "\n");
273 static void monitor_json_emitter(Monitor *mon, const QObject *data)
277 json = qobject_to_json(data);
278 assert(json != NULL);
280 mon->mc->print_enabled = 1;
281 monitor_printf(mon, "%s\n", qstring_get_str(json));
282 mon->mc->print_enabled = 0;
287 static void monitor_protocol_emitter(Monitor *mon, QObject *data)
293 if (!monitor_has_error(mon)) {
294 /* success response */
296 qobject_incref(data);
297 qdict_put_obj(qmp, "return", data);
299 qdict_put(qmp, "return", qstring_from_str("OK"));
303 qdict_put(qmp, "error", mon->error->error);
304 QINCREF(mon->error->error);
310 qdict_put_obj(qmp, "id", mon->mc->id);
314 monitor_json_emitter(mon, QOBJECT(qmp));
318 static void timestamp_put(QDict *qdict)
324 err = gettimeofday(&tv, NULL);
328 obj = qobject_from_jsonf("{ 'seconds': %" PRId64 ", "
329 "'microseconds': %" PRId64 " }",
330 (int64_t) tv.tv_sec, (int64_t) tv.tv_usec);
333 qdict_put_obj(qdict, "timestamp", obj);
337 * monitor_protocol_event(): Generate a Monitor event
339 * Event-specific data can be emitted through the (optional) 'data' parameter.
341 void monitor_protocol_event(MonitorEvent event, QObject *data)
344 const char *event_name;
345 Monitor *mon = cur_mon;
347 assert(event < EVENT_MAX);
349 if (!monitor_ctrl_mode(mon))
354 event_name = "DEBUG";
357 event_name = "SHUTDOWN";
360 event_name = "RESET";
362 case EVENT_POWERDOWN:
363 event_name = "POWERDOWN";
375 qdict_put(qmp, "event", qstring_from_str(event_name));
377 qdict_put_obj(qmp, "data", data);
379 monitor_json_emitter(mon, QOBJECT(qmp));
383 static int compare_cmd(const char *name, const char *list)
385 const char *p, *pstart;
393 p = pstart + strlen(pstart);
394 if ((p - pstart) == len && !memcmp(pstart, name, len))
403 static void help_cmd_dump(Monitor *mon, const mon_cmd_t *cmds,
404 const char *prefix, const char *name)
406 const mon_cmd_t *cmd;
408 for(cmd = cmds; cmd->name != NULL; cmd++) {
409 if (!name || !strcmp(name, cmd->name))
410 monitor_printf(mon, "%s%s %s -- %s\n", prefix, cmd->name,
411 cmd->params, cmd->help);
415 static void help_cmd(Monitor *mon, const char *name)
417 if (name && !strcmp(name, "info")) {
418 help_cmd_dump(mon, info_cmds, "info ", NULL);
420 help_cmd_dump(mon, mon_cmds, "", name);
421 if (name && !strcmp(name, "log")) {
422 const CPULogItem *item;
423 monitor_printf(mon, "Log items (comma separated):\n");
424 monitor_printf(mon, "%-10s %s\n", "none", "remove all logs");
425 for(item = cpu_log_items; item->mask != 0; item++) {
426 monitor_printf(mon, "%-10s %s\n", item->name, item->help);
432 static void do_help_cmd(Monitor *mon, const QDict *qdict)
434 help_cmd(mon, qdict_get_try_str(qdict, "name"));
437 static void do_commit(Monitor *mon, const QDict *qdict)
441 const char *device = qdict_get_str(qdict, "device");
443 all_devices = !strcmp(device, "all");
444 QTAILQ_FOREACH(dinfo, &drives, next) {
446 if (strcmp(bdrv_get_device_name(dinfo->bdrv), device))
448 bdrv_commit(dinfo->bdrv);
452 static void do_info(Monitor *mon, const QDict *qdict, QObject **ret_data)
454 const mon_cmd_t *cmd;
455 const char *item = qdict_get_try_str(qdict, "item");
458 assert(monitor_ctrl_mode(mon) == 0);
462 for (cmd = info_cmds; cmd->name != NULL; cmd++) {
463 if (compare_cmd(item, cmd->name))
467 if (cmd->name == NULL) {
468 if (monitor_ctrl_mode(mon)) {
469 qemu_error_new(QERR_COMMAND_NOT_FOUND, item);
475 if (monitor_handler_ported(cmd)) {
476 cmd->mhandler.info_new(mon, ret_data);
478 if (!monitor_ctrl_mode(mon)) {
480 * User Protocol function is called here, Monitor Protocol is
481 * handled by monitor_call_handler()
484 cmd->user_print(mon, *ret_data);
487 if (monitor_ctrl_mode(mon)) {
488 /* handler not converted yet */
489 qemu_error_new(QERR_COMMAND_NOT_FOUND, item);
491 cmd->mhandler.info(mon);
498 help_cmd(mon, "info");
502 * do_info_version(): Show QEMU version
504 static void do_info_version(Monitor *mon, QObject **ret_data)
506 *ret_data = QOBJECT(qstring_from_str(QEMU_VERSION QEMU_PKGVERSION));
509 static void do_info_name(Monitor *mon)
512 monitor_printf(mon, "%s\n", qemu_name);
516 * do_info_commands(): List QMP available commands
518 * Return a QList of QStrings.
520 static void do_info_commands(Monitor *mon, QObject **ret_data)
523 const mon_cmd_t *cmd;
525 cmd_list = qlist_new();
527 for (cmd = mon_cmds; cmd->name != NULL; cmd++) {
528 if (monitor_handler_ported(cmd) && !compare_cmd(cmd->name, "info")) {
529 qlist_append(cmd_list, qstring_from_str(cmd->name));
533 for (cmd = info_cmds; cmd->name != NULL; cmd++) {
534 if (monitor_handler_ported(cmd)) {
536 snprintf(buf, sizeof(buf), "query-%s", cmd->name);
537 qlist_append(cmd_list, qstring_from_str(buf));
541 *ret_data = QOBJECT(cmd_list);
544 #if defined(TARGET_I386)
545 static void do_info_hpet(Monitor *mon)
547 monitor_printf(mon, "HPET is %s by QEMU\n",
548 (no_hpet) ? "disabled" : "enabled");
552 static void do_info_uuid(Monitor *mon)
554 monitor_printf(mon, UUID_FMT "\n", qemu_uuid[0], qemu_uuid[1],
555 qemu_uuid[2], qemu_uuid[3], qemu_uuid[4], qemu_uuid[5],
556 qemu_uuid[6], qemu_uuid[7], qemu_uuid[8], qemu_uuid[9],
557 qemu_uuid[10], qemu_uuid[11], qemu_uuid[12], qemu_uuid[13],
558 qemu_uuid[14], qemu_uuid[15]);
561 /* get the current CPU defined by the user */
562 static int mon_set_cpu(int cpu_index)
566 for(env = first_cpu; env != NULL; env = env->next_cpu) {
567 if (env->cpu_index == cpu_index) {
568 cur_mon->mon_cpu = env;
575 static CPUState *mon_get_cpu(void)
577 if (!cur_mon->mon_cpu) {
580 cpu_synchronize_state(cur_mon->mon_cpu);
581 return cur_mon->mon_cpu;
584 static void do_info_registers(Monitor *mon)
591 cpu_dump_state(env, (FILE *)mon, monitor_fprintf,
594 cpu_dump_state(env, (FILE *)mon, monitor_fprintf,
599 static void print_cpu_iter(QObject *obj, void *opaque)
603 Monitor *mon = opaque;
605 assert(qobject_type(obj) == QTYPE_QDICT);
606 cpu = qobject_to_qdict(obj);
608 if (strcmp(qdict_get_str(cpu, "current"), "yes") == 0)
611 monitor_printf(mon, "%c CPU #%d: ", active, (int)qdict_get_int(cpu, "CPU"));
613 #if defined(TARGET_I386)
614 monitor_printf(mon, "pc=0x" TARGET_FMT_lx,
615 (target_ulong) qdict_get_int(cpu, "pc"));
616 #elif defined(TARGET_PPC)
617 monitor_printf(mon, "nip=0x" TARGET_FMT_lx,
618 (target_long) qdict_get_int(cpu, "nip"));
619 #elif defined(TARGET_SPARC)
620 monitor_printf(mon, "pc=0x " TARGET_FMT_lx,
621 (target_long) qdict_get_int(cpu, "pc"));
622 monitor_printf(mon, "npc=0x" TARGET_FMT_lx,
623 (target_long) qdict_get_int(cpu, "npc"));
624 #elif defined(TARGET_MIPS)
625 monitor_printf(mon, "PC=0x" TARGET_FMT_lx,
626 (target_long) qdict_get_int(cpu, "PC"));
629 if (strcmp(qdict_get_str(cpu, "halted"), "yes") == 0)
630 monitor_printf(mon, " (halted)");
632 monitor_printf(mon, "\n");
635 static void monitor_print_cpus(Monitor *mon, const QObject *data)
639 assert(qobject_type(data) == QTYPE_QLIST);
640 cpu_list = qobject_to_qlist(data);
641 qlist_iter(cpu_list, print_cpu_iter, mon);
645 * do_info_cpus(): Show CPU information
647 * Return a QList with a QDict for each CPU.
651 * [ { "CPU": 0, "current": "yes", "pc": 0x..., "halted": "no" },
652 * { "CPU": 1, "current": "no", "pc": 0x..., "halted": "yes" } ]
654 static void do_info_cpus(Monitor *mon, QObject **ret_data)
659 cpu_list = qlist_new();
661 /* just to set the default cpu if not already done */
664 for(env = first_cpu; env != NULL; env = env->next_cpu) {
666 QDict *cpu = qdict_new();
668 cpu_synchronize_state(env);
670 qdict_put(cpu, "CPU", qint_from_int(env->cpu_index));
671 answer = (env == mon->mon_cpu) ? "yes" : "no";
672 qdict_put(cpu, "current", qstring_from_str(answer));
674 #if defined(TARGET_I386)
675 qdict_put(cpu, "pc", qint_from_int(env->eip + env->segs[R_CS].base));
676 #elif defined(TARGET_PPC)
677 qdict_put(cpu, "nip", qint_from_int(env->nip));
678 #elif defined(TARGET_SPARC)
679 qdict_put(cpu, "pc", qint_from_int(env->pc));
680 qdict_put(cpu, "npc", qint_from_int(env->npc));
681 #elif defined(TARGET_MIPS)
682 qdict_put(cpu, "PC", qint_from_int(env->active_tc.PC));
684 answer = env->halted ? "yes" : "no";
685 qdict_put(cpu, "halted", qstring_from_str(answer));
687 qlist_append(cpu_list, cpu);
690 *ret_data = QOBJECT(cpu_list);
693 static void do_cpu_set(Monitor *mon, const QDict *qdict)
695 int index = qdict_get_int(qdict, "index");
696 if (mon_set_cpu(index) < 0)
697 monitor_printf(mon, "Invalid CPU index\n");
700 static void do_info_jit(Monitor *mon)
702 dump_exec_info((FILE *)mon, monitor_fprintf);
705 static void do_info_history(Monitor *mon)
714 str = readline_get_history(mon->rs, i);
717 monitor_printf(mon, "%d: '%s'\n", i, str);
722 #if defined(TARGET_PPC)
723 /* XXX: not implemented in other targets */
724 static void do_info_cpu_stats(Monitor *mon)
729 cpu_dump_statistics(env, (FILE *)mon, &monitor_fprintf, 0);
734 * do_quit(): Quit QEMU execution
736 static void do_quit(Monitor *mon, const QDict *qdict, QObject **ret_data)
741 static int eject_device(Monitor *mon, BlockDriverState *bs, int force)
743 if (bdrv_is_inserted(bs)) {
745 if (!bdrv_is_removable(bs)) {
746 monitor_printf(mon, "device is not removable\n");
749 if (bdrv_is_locked(bs)) {
750 monitor_printf(mon, "device is locked\n");
759 static void do_eject(Monitor *mon, const QDict *qdict, QObject **ret_data)
761 BlockDriverState *bs;
762 int force = qdict_get_int(qdict, "force");
763 const char *filename = qdict_get_str(qdict, "filename");
765 bs = bdrv_find(filename);
767 monitor_printf(mon, "device not found\n");
770 eject_device(mon, bs, force);
773 static void do_change_block(Monitor *mon, const char *device,
774 const char *filename, const char *fmt)
776 BlockDriverState *bs;
777 BlockDriver *drv = NULL;
779 bs = bdrv_find(device);
781 monitor_printf(mon, "device not found\n");
785 drv = bdrv_find_whitelisted_format(fmt);
787 monitor_printf(mon, "invalid format %s\n", fmt);
791 if (eject_device(mon, bs, 0) < 0)
793 bdrv_open2(bs, filename, 0, drv);
794 monitor_read_bdrv_key_start(mon, bs, NULL, NULL);
797 static void change_vnc_password_cb(Monitor *mon, const char *password,
800 if (vnc_display_password(NULL, password) < 0)
801 monitor_printf(mon, "could not set VNC server password\n");
803 monitor_read_command(mon, 1);
806 static void do_change_vnc(Monitor *mon, const char *target, const char *arg)
808 if (strcmp(target, "passwd") == 0 ||
809 strcmp(target, "password") == 0) {
812 strncpy(password, arg, sizeof(password));
813 password[sizeof(password) - 1] = '\0';
814 change_vnc_password_cb(mon, password, NULL);
816 monitor_read_password(mon, change_vnc_password_cb, NULL);
819 if (vnc_display_open(NULL, target) < 0)
820 monitor_printf(mon, "could not start VNC server on %s\n", target);
824 static void do_change(Monitor *mon, const QDict *qdict)
826 const char *device = qdict_get_str(qdict, "device");
827 const char *target = qdict_get_str(qdict, "target");
828 const char *arg = qdict_get_try_str(qdict, "arg");
829 if (strcmp(device, "vnc") == 0) {
830 do_change_vnc(mon, target, arg);
832 do_change_block(mon, device, target, arg);
836 static void do_screen_dump(Monitor *mon, const QDict *qdict)
838 vga_hw_screen_dump(qdict_get_str(qdict, "filename"));
841 static void do_logfile(Monitor *mon, const QDict *qdict)
843 cpu_set_log_filename(qdict_get_str(qdict, "filename"));
846 static void do_log(Monitor *mon, const QDict *qdict)
849 const char *items = qdict_get_str(qdict, "items");
851 if (!strcmp(items, "none")) {
854 mask = cpu_str_to_log_mask(items);
856 help_cmd(mon, "log");
863 static void do_singlestep(Monitor *mon, const QDict *qdict)
865 const char *option = qdict_get_try_str(qdict, "option");
866 if (!option || !strcmp(option, "on")) {
868 } else if (!strcmp(option, "off")) {
871 monitor_printf(mon, "unexpected option %s\n", option);
876 * do_stop(): Stop VM execution
878 static void do_stop(Monitor *mon, const QDict *qdict, QObject **ret_data)
880 vm_stop(EXCP_INTERRUPT);
883 static void encrypted_bdrv_it(void *opaque, BlockDriverState *bs);
885 struct bdrv_iterate_context {
891 * do_cont(): Resume emulation.
893 static void do_cont(Monitor *mon, const QDict *qdict, QObject **ret_data)
895 struct bdrv_iterate_context context = { mon, 0 };
897 bdrv_iterate(encrypted_bdrv_it, &context);
898 /* only resume the vm if all keys are set and valid */
903 static void bdrv_key_cb(void *opaque, int err)
905 Monitor *mon = opaque;
907 /* another key was set successfully, retry to continue */
909 do_cont(mon, NULL, NULL);
912 static void encrypted_bdrv_it(void *opaque, BlockDriverState *bs)
914 struct bdrv_iterate_context *context = opaque;
916 if (!context->err && bdrv_key_required(bs)) {
917 context->err = -EBUSY;
918 monitor_read_bdrv_key_start(context->mon, bs, bdrv_key_cb,
923 static void do_gdbserver(Monitor *mon, const QDict *qdict)
925 const char *device = qdict_get_try_str(qdict, "device");
927 device = "tcp::" DEFAULT_GDBSTUB_PORT;
928 if (gdbserver_start(device) < 0) {
929 monitor_printf(mon, "Could not open gdbserver on device '%s'\n",
931 } else if (strcmp(device, "none") == 0) {
932 monitor_printf(mon, "Disabled gdbserver\n");
934 monitor_printf(mon, "Waiting for gdb connection on device '%s'\n",
939 static void do_watchdog_action(Monitor *mon, const QDict *qdict)
941 const char *action = qdict_get_str(qdict, "action");
942 if (select_watchdog_action(action) == -1) {
943 monitor_printf(mon, "Unknown watchdog action '%s'\n", action);
947 static void monitor_printc(Monitor *mon, int c)
949 monitor_printf(mon, "'");
952 monitor_printf(mon, "\\'");
955 monitor_printf(mon, "\\\\");
958 monitor_printf(mon, "\\n");
961 monitor_printf(mon, "\\r");
964 if (c >= 32 && c <= 126) {
965 monitor_printf(mon, "%c", c);
967 monitor_printf(mon, "\\x%02x", c);
971 monitor_printf(mon, "'");
974 static void memory_dump(Monitor *mon, int count, int format, int wsize,
975 target_phys_addr_t addr, int is_physical)
978 int nb_per_line, l, line_size, i, max_digits, len;
986 if (!env && !is_physical)
991 } else if (wsize == 4) {
994 /* as default we use the current CS size */
998 if ((env->efer & MSR_EFER_LMA) &&
999 (env->segs[R_CS].flags & DESC_L_MASK))
1003 if (!(env->segs[R_CS].flags & DESC_B_MASK))
1008 monitor_disas(mon, env, addr, count, is_physical, flags);
1012 len = wsize * count;
1017 nb_per_line = line_size / wsize;
1022 max_digits = (wsize * 8 + 2) / 3;
1026 max_digits = (wsize * 8) / 4;
1030 max_digits = (wsize * 8 * 10 + 32) / 33;
1039 monitor_printf(mon, TARGET_FMT_plx ":", addr);
1041 monitor_printf(mon, TARGET_FMT_lx ":", (target_ulong)addr);
1046 cpu_physical_memory_rw(addr, buf, l, 0);
1048 env = mon_get_cpu();
1051 if (cpu_memory_rw_debug(env, addr, buf, l, 0) < 0) {
1052 monitor_printf(mon, " Cannot access memory\n");
1061 v = ldub_raw(buf + i);
1064 v = lduw_raw(buf + i);
1067 v = (uint32_t)ldl_raw(buf + i);
1070 v = ldq_raw(buf + i);
1073 monitor_printf(mon, " ");
1076 monitor_printf(mon, "%#*" PRIo64, max_digits, v);
1079 monitor_printf(mon, "0x%0*" PRIx64, max_digits, v);
1082 monitor_printf(mon, "%*" PRIu64, max_digits, v);
1085 monitor_printf(mon, "%*" PRId64, max_digits, v);
1088 monitor_printc(mon, v);
1093 monitor_printf(mon, "\n");
1099 static void do_memory_dump(Monitor *mon, const QDict *qdict)
1101 int count = qdict_get_int(qdict, "count");
1102 int format = qdict_get_int(qdict, "format");
1103 int size = qdict_get_int(qdict, "size");
1104 target_long addr = qdict_get_int(qdict, "addr");
1106 memory_dump(mon, count, format, size, addr, 0);
1109 static void do_physical_memory_dump(Monitor *mon, const QDict *qdict)
1111 int count = qdict_get_int(qdict, "count");
1112 int format = qdict_get_int(qdict, "format");
1113 int size = qdict_get_int(qdict, "size");
1114 target_phys_addr_t addr = qdict_get_int(qdict, "addr");
1116 memory_dump(mon, count, format, size, addr, 1);
1119 static void do_print(Monitor *mon, const QDict *qdict)
1121 int format = qdict_get_int(qdict, "format");
1122 target_phys_addr_t val = qdict_get_int(qdict, "val");
1124 #if TARGET_PHYS_ADDR_BITS == 32
1127 monitor_printf(mon, "%#o", val);
1130 monitor_printf(mon, "%#x", val);
1133 monitor_printf(mon, "%u", val);
1137 monitor_printf(mon, "%d", val);
1140 monitor_printc(mon, val);
1146 monitor_printf(mon, "%#" PRIo64, val);
1149 monitor_printf(mon, "%#" PRIx64, val);
1152 monitor_printf(mon, "%" PRIu64, val);
1156 monitor_printf(mon, "%" PRId64, val);
1159 monitor_printc(mon, val);
1163 monitor_printf(mon, "\n");
1166 static void do_memory_save(Monitor *mon, const QDict *qdict, QObject **ret_data)
1169 uint32_t size = qdict_get_int(qdict, "size");
1170 const char *filename = qdict_get_str(qdict, "filename");
1171 target_long addr = qdict_get_int(qdict, "val");
1176 env = mon_get_cpu();
1180 f = fopen(filename, "wb");
1182 monitor_printf(mon, "could not open '%s'\n", filename);
1189 cpu_memory_rw_debug(env, addr, buf, l, 0);
1190 fwrite(buf, 1, l, f);
1197 static void do_physical_memory_save(Monitor *mon, const QDict *qdict,
1203 uint32_t size = qdict_get_int(qdict, "size");
1204 const char *filename = qdict_get_str(qdict, "filename");
1205 target_phys_addr_t addr = qdict_get_int(qdict, "val");
1207 f = fopen(filename, "wb");
1209 monitor_printf(mon, "could not open '%s'\n", filename);
1216 cpu_physical_memory_rw(addr, buf, l, 0);
1217 fwrite(buf, 1, l, f);
1225 static void do_sum(Monitor *mon, const QDict *qdict)
1230 uint32_t start = qdict_get_int(qdict, "start");
1231 uint32_t size = qdict_get_int(qdict, "size");
1234 for(addr = start; addr < (start + size); addr++) {
1235 cpu_physical_memory_rw(addr, buf, 1, 0);
1236 /* BSD sum algorithm ('sum' Unix command) */
1237 sum = (sum >> 1) | (sum << 15);
1240 monitor_printf(mon, "%05d\n", sum);
1248 static const KeyDef key_defs[] = {
1250 { 0x36, "shift_r" },
1255 { 0xe4, "altgr_r" },
1275 { 0x0e, "backspace" },
1312 { 0x37, "asterisk" },
1315 { 0x3a, "caps_lock" },
1326 { 0x45, "num_lock" },
1327 { 0x46, "scroll_lock" },
1329 { 0xb5, "kp_divide" },
1330 { 0x37, "kp_multiply" },
1331 { 0x4a, "kp_subtract" },
1333 { 0x9c, "kp_enter" },
1334 { 0x53, "kp_decimal" },
1367 #if defined(TARGET_SPARC) && !defined(TARGET_SPARC64)
1382 { 0xfe, "compose" },
1387 static int get_keycode(const char *key)
1393 for(p = key_defs; p->name != NULL; p++) {
1394 if (!strcmp(key, p->name))
1397 if (strstart(key, "0x", NULL)) {
1398 ret = strtoul(key, &endp, 0);
1399 if (*endp == '\0' && ret >= 0x01 && ret <= 0xff)
1405 #define MAX_KEYCODES 16
1406 static uint8_t keycodes[MAX_KEYCODES];
1407 static int nb_pending_keycodes;
1408 static QEMUTimer *key_timer;
1410 static void release_keys(void *opaque)
1414 while (nb_pending_keycodes > 0) {
1415 nb_pending_keycodes--;
1416 keycode = keycodes[nb_pending_keycodes];
1418 kbd_put_keycode(0xe0);
1419 kbd_put_keycode(keycode | 0x80);
1423 static void do_sendkey(Monitor *mon, const QDict *qdict)
1425 char keyname_buf[16];
1427 int keyname_len, keycode, i;
1428 const char *string = qdict_get_str(qdict, "string");
1429 int has_hold_time = qdict_haskey(qdict, "hold_time");
1430 int hold_time = qdict_get_try_int(qdict, "hold_time", -1);
1432 if (nb_pending_keycodes > 0) {
1433 qemu_del_timer(key_timer);
1440 separator = strchr(string, '-');
1441 keyname_len = separator ? separator - string : strlen(string);
1442 if (keyname_len > 0) {
1443 pstrcpy(keyname_buf, sizeof(keyname_buf), string);
1444 if (keyname_len > sizeof(keyname_buf) - 1) {
1445 monitor_printf(mon, "invalid key: '%s...'\n", keyname_buf);
1448 if (i == MAX_KEYCODES) {
1449 monitor_printf(mon, "too many keys\n");
1452 keyname_buf[keyname_len] = 0;
1453 keycode = get_keycode(keyname_buf);
1455 monitor_printf(mon, "unknown key: '%s'\n", keyname_buf);
1458 keycodes[i++] = keycode;
1462 string = separator + 1;
1464 nb_pending_keycodes = i;
1465 /* key down events */
1466 for (i = 0; i < nb_pending_keycodes; i++) {
1467 keycode = keycodes[i];
1469 kbd_put_keycode(0xe0);
1470 kbd_put_keycode(keycode & 0x7f);
1472 /* delayed key up events */
1473 qemu_mod_timer(key_timer, qemu_get_clock(vm_clock) +
1474 muldiv64(get_ticks_per_sec(), hold_time, 1000));
1477 static int mouse_button_state;
1479 static void do_mouse_move(Monitor *mon, const QDict *qdict)
1482 const char *dx_str = qdict_get_str(qdict, "dx_str");
1483 const char *dy_str = qdict_get_str(qdict, "dy_str");
1484 const char *dz_str = qdict_get_try_str(qdict, "dz_str");
1485 dx = strtol(dx_str, NULL, 0);
1486 dy = strtol(dy_str, NULL, 0);
1489 dz = strtol(dz_str, NULL, 0);
1490 kbd_mouse_event(dx, dy, dz, mouse_button_state);
1493 static void do_mouse_button(Monitor *mon, const QDict *qdict)
1495 int button_state = qdict_get_int(qdict, "button_state");
1496 mouse_button_state = button_state;
1497 kbd_mouse_event(0, 0, 0, mouse_button_state);
1500 static void do_ioport_read(Monitor *mon, const QDict *qdict)
1502 int size = qdict_get_int(qdict, "size");
1503 int addr = qdict_get_int(qdict, "addr");
1504 int has_index = qdict_haskey(qdict, "index");
1509 int index = qdict_get_int(qdict, "index");
1510 cpu_outb(addr & IOPORTS_MASK, index & 0xff);
1518 val = cpu_inb(addr);
1522 val = cpu_inw(addr);
1526 val = cpu_inl(addr);
1530 monitor_printf(mon, "port%c[0x%04x] = %#0*x\n",
1531 suffix, addr, size * 2, val);
1534 static void do_ioport_write(Monitor *mon, const QDict *qdict)
1536 int size = qdict_get_int(qdict, "size");
1537 int addr = qdict_get_int(qdict, "addr");
1538 int val = qdict_get_int(qdict, "val");
1540 addr &= IOPORTS_MASK;
1545 cpu_outb(addr, val);
1548 cpu_outw(addr, val);
1551 cpu_outl(addr, val);
1556 static void do_boot_set(Monitor *mon, const QDict *qdict)
1559 const char *bootdevice = qdict_get_str(qdict, "bootdevice");
1561 res = qemu_boot_set(bootdevice);
1563 monitor_printf(mon, "boot device list now set to %s\n", bootdevice);
1564 } else if (res > 0) {
1565 monitor_printf(mon, "setting boot device list failed\n");
1567 monitor_printf(mon, "no function defined to set boot device list for "
1568 "this architecture\n");
1573 * do_system_reset(): Issue a machine reset
1575 static void do_system_reset(Monitor *mon, const QDict *qdict,
1578 qemu_system_reset_request();
1582 * do_system_powerdown(): Issue a machine powerdown
1584 static void do_system_powerdown(Monitor *mon, const QDict *qdict,
1587 qemu_system_powerdown_request();
1590 #if defined(TARGET_I386)
1591 static void print_pte(Monitor *mon, uint32_t addr, uint32_t pte, uint32_t mask)
1593 monitor_printf(mon, "%08x: %08x %c%c%c%c%c%c%c%c\n",
1596 pte & PG_GLOBAL_MASK ? 'G' : '-',
1597 pte & PG_PSE_MASK ? 'P' : '-',
1598 pte & PG_DIRTY_MASK ? 'D' : '-',
1599 pte & PG_ACCESSED_MASK ? 'A' : '-',
1600 pte & PG_PCD_MASK ? 'C' : '-',
1601 pte & PG_PWT_MASK ? 'T' : '-',
1602 pte & PG_USER_MASK ? 'U' : '-',
1603 pte & PG_RW_MASK ? 'W' : '-');
1606 static void tlb_info(Monitor *mon)
1610 uint32_t pgd, pde, pte;
1612 env = mon_get_cpu();
1616 if (!(env->cr[0] & CR0_PG_MASK)) {
1617 monitor_printf(mon, "PG disabled\n");
1620 pgd = env->cr[3] & ~0xfff;
1621 for(l1 = 0; l1 < 1024; l1++) {
1622 cpu_physical_memory_read(pgd + l1 * 4, (uint8_t *)&pde, 4);
1623 pde = le32_to_cpu(pde);
1624 if (pde & PG_PRESENT_MASK) {
1625 if ((pde & PG_PSE_MASK) && (env->cr[4] & CR4_PSE_MASK)) {
1626 print_pte(mon, (l1 << 22), pde, ~((1 << 20) - 1));
1628 for(l2 = 0; l2 < 1024; l2++) {
1629 cpu_physical_memory_read((pde & ~0xfff) + l2 * 4,
1630 (uint8_t *)&pte, 4);
1631 pte = le32_to_cpu(pte);
1632 if (pte & PG_PRESENT_MASK) {
1633 print_pte(mon, (l1 << 22) + (l2 << 12),
1643 static void mem_print(Monitor *mon, uint32_t *pstart, int *plast_prot,
1644 uint32_t end, int prot)
1647 prot1 = *plast_prot;
1648 if (prot != prot1) {
1649 if (*pstart != -1) {
1650 monitor_printf(mon, "%08x-%08x %08x %c%c%c\n",
1651 *pstart, end, end - *pstart,
1652 prot1 & PG_USER_MASK ? 'u' : '-',
1654 prot1 & PG_RW_MASK ? 'w' : '-');
1664 static void mem_info(Monitor *mon)
1667 int l1, l2, prot, last_prot;
1668 uint32_t pgd, pde, pte, start, end;
1670 env = mon_get_cpu();
1674 if (!(env->cr[0] & CR0_PG_MASK)) {
1675 monitor_printf(mon, "PG disabled\n");
1678 pgd = env->cr[3] & ~0xfff;
1681 for(l1 = 0; l1 < 1024; l1++) {
1682 cpu_physical_memory_read(pgd + l1 * 4, (uint8_t *)&pde, 4);
1683 pde = le32_to_cpu(pde);
1685 if (pde & PG_PRESENT_MASK) {
1686 if ((pde & PG_PSE_MASK) && (env->cr[4] & CR4_PSE_MASK)) {
1687 prot = pde & (PG_USER_MASK | PG_RW_MASK | PG_PRESENT_MASK);
1688 mem_print(mon, &start, &last_prot, end, prot);
1690 for(l2 = 0; l2 < 1024; l2++) {
1691 cpu_physical_memory_read((pde & ~0xfff) + l2 * 4,
1692 (uint8_t *)&pte, 4);
1693 pte = le32_to_cpu(pte);
1694 end = (l1 << 22) + (l2 << 12);
1695 if (pte & PG_PRESENT_MASK) {
1696 prot = pte & (PG_USER_MASK | PG_RW_MASK | PG_PRESENT_MASK);
1700 mem_print(mon, &start, &last_prot, end, prot);
1705 mem_print(mon, &start, &last_prot, end, prot);
1711 #if defined(TARGET_SH4)
1713 static void print_tlb(Monitor *mon, int idx, tlb_t *tlb)
1715 monitor_printf(mon, " tlb%i:\t"
1716 "asid=%hhu vpn=%x\tppn=%x\tsz=%hhu size=%u\t"
1717 "v=%hhu shared=%hhu cached=%hhu prot=%hhu "
1718 "dirty=%hhu writethrough=%hhu\n",
1720 tlb->asid, tlb->vpn, tlb->ppn, tlb->sz, tlb->size,
1721 tlb->v, tlb->sh, tlb->c, tlb->pr,
1725 static void tlb_info(Monitor *mon)
1727 CPUState *env = mon_get_cpu();
1730 monitor_printf (mon, "ITLB:\n");
1731 for (i = 0 ; i < ITLB_SIZE ; i++)
1732 print_tlb (mon, i, &env->itlb[i]);
1733 monitor_printf (mon, "UTLB:\n");
1734 for (i = 0 ; i < UTLB_SIZE ; i++)
1735 print_tlb (mon, i, &env->utlb[i]);
1740 static void do_info_kvm(Monitor *mon)
1743 monitor_printf(mon, "kvm support: ");
1745 monitor_printf(mon, "enabled\n");
1747 monitor_printf(mon, "disabled\n");
1749 monitor_printf(mon, "kvm support: not compiled\n");
1753 static void do_info_numa(Monitor *mon)
1758 monitor_printf(mon, "%d nodes\n", nb_numa_nodes);
1759 for (i = 0; i < nb_numa_nodes; i++) {
1760 monitor_printf(mon, "node %d cpus:", i);
1761 for (env = first_cpu; env != NULL; env = env->next_cpu) {
1762 if (env->numa_node == i) {
1763 monitor_printf(mon, " %d", env->cpu_index);
1766 monitor_printf(mon, "\n");
1767 monitor_printf(mon, "node %d size: %" PRId64 " MB\n", i,
1772 #ifdef CONFIG_PROFILER
1777 static void do_info_profile(Monitor *mon)
1783 monitor_printf(mon, "async time %" PRId64 " (%0.3f)\n",
1784 dev_time, dev_time / (double)get_ticks_per_sec());
1785 monitor_printf(mon, "qemu time %" PRId64 " (%0.3f)\n",
1786 qemu_time, qemu_time / (double)get_ticks_per_sec());
1791 static void do_info_profile(Monitor *mon)
1793 monitor_printf(mon, "Internal profiler not compiled\n");
1797 /* Capture support */
1798 static QLIST_HEAD (capture_list_head, CaptureState) capture_head;
1800 static void do_info_capture(Monitor *mon)
1805 for (s = capture_head.lh_first, i = 0; s; s = s->entries.le_next, ++i) {
1806 monitor_printf(mon, "[%d]: ", i);
1807 s->ops.info (s->opaque);
1812 static void do_stop_capture(Monitor *mon, const QDict *qdict)
1815 int n = qdict_get_int(qdict, "n");
1818 for (s = capture_head.lh_first, i = 0; s; s = s->entries.le_next, ++i) {
1820 s->ops.destroy (s->opaque);
1821 QLIST_REMOVE (s, entries);
1828 static void do_wav_capture(Monitor *mon, const QDict *qdict)
1830 const char *path = qdict_get_str(qdict, "path");
1831 int has_freq = qdict_haskey(qdict, "freq");
1832 int freq = qdict_get_try_int(qdict, "freq", -1);
1833 int has_bits = qdict_haskey(qdict, "bits");
1834 int bits = qdict_get_try_int(qdict, "bits", -1);
1835 int has_channels = qdict_haskey(qdict, "nchannels");
1836 int nchannels = qdict_get_try_int(qdict, "nchannels", -1);
1839 s = qemu_mallocz (sizeof (*s));
1841 freq = has_freq ? freq : 44100;
1842 bits = has_bits ? bits : 16;
1843 nchannels = has_channels ? nchannels : 2;
1845 if (wav_start_capture (s, path, freq, bits, nchannels)) {
1846 monitor_printf(mon, "Faied to add wave capture\n");
1849 QLIST_INSERT_HEAD (&capture_head, s, entries);
1853 #if defined(TARGET_I386)
1854 static void do_inject_nmi(Monitor *mon, const QDict *qdict)
1857 int cpu_index = qdict_get_int(qdict, "cpu_index");
1859 for (env = first_cpu; env != NULL; env = env->next_cpu)
1860 if (env->cpu_index == cpu_index) {
1861 cpu_interrupt(env, CPU_INTERRUPT_NMI);
1867 static void do_info_status(Monitor *mon)
1871 monitor_printf(mon, "VM status: running (single step mode)\n");
1873 monitor_printf(mon, "VM status: running\n");
1876 monitor_printf(mon, "VM status: paused\n");
1880 * do_balloon(): Request VM to change its memory allocation
1882 static void do_balloon(Monitor *mon, const QDict *qdict, QObject **ret_data)
1884 int value = qdict_get_int(qdict, "value");
1885 ram_addr_t target = value;
1886 qemu_balloon(target << 20);
1889 static void monitor_print_balloon(Monitor *mon, const QObject *data)
1891 monitor_printf(mon, "balloon: actual=%d\n",
1892 (int)qint_get_int(qobject_to_qint(data)));
1896 * do_info_balloon(): Balloon information
1898 static void do_info_balloon(Monitor *mon, QObject **ret_data)
1902 actual = qemu_balloon_status();
1903 if (kvm_enabled() && !kvm_has_sync_mmu())
1904 qemu_error_new(QERR_KVM_MISSING_CAP, "synchronous MMU", "balloon");
1905 else if (actual == 0)
1906 qemu_error_new(QERR_DEVICE_NOT_ACTIVE, "balloon");
1908 *ret_data = QOBJECT(qint_from_int((int)(actual >> 20)));
1911 static qemu_acl *find_acl(Monitor *mon, const char *name)
1913 qemu_acl *acl = qemu_acl_find(name);
1916 monitor_printf(mon, "acl: unknown list '%s'\n", name);
1921 static void do_acl_show(Monitor *mon, const QDict *qdict)
1923 const char *aclname = qdict_get_str(qdict, "aclname");
1924 qemu_acl *acl = find_acl(mon, aclname);
1925 qemu_acl_entry *entry;
1929 monitor_printf(mon, "policy: %s\n",
1930 acl->defaultDeny ? "deny" : "allow");
1931 QTAILQ_FOREACH(entry, &acl->entries, next) {
1933 monitor_printf(mon, "%d: %s %s\n", i,
1934 entry->deny ? "deny" : "allow", entry->match);
1939 static void do_acl_reset(Monitor *mon, const QDict *qdict)
1941 const char *aclname = qdict_get_str(qdict, "aclname");
1942 qemu_acl *acl = find_acl(mon, aclname);
1945 qemu_acl_reset(acl);
1946 monitor_printf(mon, "acl: removed all rules\n");
1950 static void do_acl_policy(Monitor *mon, const QDict *qdict)
1952 const char *aclname = qdict_get_str(qdict, "aclname");
1953 const char *policy = qdict_get_str(qdict, "policy");
1954 qemu_acl *acl = find_acl(mon, aclname);
1957 if (strcmp(policy, "allow") == 0) {
1958 acl->defaultDeny = 0;
1959 monitor_printf(mon, "acl: policy set to 'allow'\n");
1960 } else if (strcmp(policy, "deny") == 0) {
1961 acl->defaultDeny = 1;
1962 monitor_printf(mon, "acl: policy set to 'deny'\n");
1964 monitor_printf(mon, "acl: unknown policy '%s', "
1965 "expected 'deny' or 'allow'\n", policy);
1970 static void do_acl_add(Monitor *mon, const QDict *qdict)
1972 const char *aclname = qdict_get_str(qdict, "aclname");
1973 const char *match = qdict_get_str(qdict, "match");
1974 const char *policy = qdict_get_str(qdict, "policy");
1975 int has_index = qdict_haskey(qdict, "index");
1976 int index = qdict_get_try_int(qdict, "index", -1);
1977 qemu_acl *acl = find_acl(mon, aclname);
1981 if (strcmp(policy, "allow") == 0) {
1983 } else if (strcmp(policy, "deny") == 0) {
1986 monitor_printf(mon, "acl: unknown policy '%s', "
1987 "expected 'deny' or 'allow'\n", policy);
1991 ret = qemu_acl_insert(acl, deny, match, index);
1993 ret = qemu_acl_append(acl, deny, match);
1995 monitor_printf(mon, "acl: unable to add acl entry\n");
1997 monitor_printf(mon, "acl: added rule at position %d\n", ret);
2001 static void do_acl_remove(Monitor *mon, const QDict *qdict)
2003 const char *aclname = qdict_get_str(qdict, "aclname");
2004 const char *match = qdict_get_str(qdict, "match");
2005 qemu_acl *acl = find_acl(mon, aclname);
2009 ret = qemu_acl_remove(acl, match);
2011 monitor_printf(mon, "acl: no matching acl entry\n");
2013 monitor_printf(mon, "acl: removed rule at position %d\n", ret);
2017 #if defined(TARGET_I386)
2018 static void do_inject_mce(Monitor *mon, const QDict *qdict)
2021 int cpu_index = qdict_get_int(qdict, "cpu_index");
2022 int bank = qdict_get_int(qdict, "bank");
2023 uint64_t status = qdict_get_int(qdict, "status");
2024 uint64_t mcg_status = qdict_get_int(qdict, "mcg_status");
2025 uint64_t addr = qdict_get_int(qdict, "addr");
2026 uint64_t misc = qdict_get_int(qdict, "misc");
2028 for (cenv = first_cpu; cenv != NULL; cenv = cenv->next_cpu)
2029 if (cenv->cpu_index == cpu_index && cenv->mcg_cap) {
2030 cpu_inject_x86_mce(cenv, bank, status, mcg_status, addr, misc);
2036 static void do_getfd(Monitor *mon, const QDict *qdict, QObject **ret_data)
2038 const char *fdname = qdict_get_str(qdict, "fdname");
2042 fd = qemu_chr_get_msgfd(mon->chr);
2044 monitor_printf(mon, "getfd: no file descriptor supplied via SCM_RIGHTS\n");
2048 if (qemu_isdigit(fdname[0])) {
2049 monitor_printf(mon, "getfd: monitor names may not begin with a number\n");
2055 monitor_printf(mon, "Failed to dup() file descriptor: %s\n",
2060 QLIST_FOREACH(monfd, &mon->fds, next) {
2061 if (strcmp(monfd->name, fdname) != 0) {
2070 monfd = qemu_mallocz(sizeof(mon_fd_t));
2071 monfd->name = qemu_strdup(fdname);
2074 QLIST_INSERT_HEAD(&mon->fds, monfd, next);
2077 static void do_closefd(Monitor *mon, const QDict *qdict, QObject **ret_data)
2079 const char *fdname = qdict_get_str(qdict, "fdname");
2082 QLIST_FOREACH(monfd, &mon->fds, next) {
2083 if (strcmp(monfd->name, fdname) != 0) {
2087 QLIST_REMOVE(monfd, next);
2089 qemu_free(monfd->name);
2094 monitor_printf(mon, "Failed to find file descriptor named %s\n",
2098 static void do_loadvm(Monitor *mon, const QDict *qdict)
2100 int saved_vm_running = vm_running;
2101 const char *name = qdict_get_str(qdict, "name");
2105 if (load_vmstate(mon, name) >= 0 && saved_vm_running)
2109 int monitor_get_fd(Monitor *mon, const char *fdname)
2113 QLIST_FOREACH(monfd, &mon->fds, next) {
2116 if (strcmp(monfd->name, fdname) != 0) {
2122 /* caller takes ownership of fd */
2123 QLIST_REMOVE(monfd, next);
2124 qemu_free(monfd->name);
2133 static const mon_cmd_t mon_cmds[] = {
2134 #include "qemu-monitor.h"
2138 /* Please update qemu-monitor.hx when adding or changing commands */
2139 static const mon_cmd_t info_cmds[] = {
2144 .help = "show the version of QEMU",
2145 .user_print = monitor_print_qobject,
2146 .mhandler.info_new = do_info_version,
2152 .help = "list QMP available commands",
2153 .user_print = monitor_user_noop,
2154 .mhandler.info_new = do_info_commands,
2160 .help = "show the network state",
2161 .mhandler.info = do_info_network,
2167 .help = "show the character devices",
2168 .mhandler.info = qemu_chr_info,
2174 .help = "show the block devices",
2175 .mhandler.info = bdrv_info,
2178 .name = "blockstats",
2181 .help = "show block device statistics",
2182 .mhandler.info = bdrv_info_stats,
2185 .name = "registers",
2188 .help = "show the cpu registers",
2189 .mhandler.info = do_info_registers,
2195 .help = "show infos for each CPU",
2196 .user_print = monitor_print_cpus,
2197 .mhandler.info_new = do_info_cpus,
2203 .help = "show the command line history",
2204 .mhandler.info = do_info_history,
2210 .help = "show the interrupts statistics (if available)",
2211 .mhandler.info = irq_info,
2217 .help = "show i8259 (PIC) state",
2218 .mhandler.info = pic_info,
2224 .help = "show PCI info",
2225 .mhandler.info = pci_info,
2227 #if defined(TARGET_I386) || defined(TARGET_SH4)
2232 .help = "show virtual to physical memory mappings",
2233 .mhandler.info = tlb_info,
2236 #if defined(TARGET_I386)
2241 .help = "show the active virtual memory mappings",
2242 .mhandler.info = mem_info,
2248 .help = "show state of HPET",
2249 .mhandler.info = do_info_hpet,
2256 .help = "show dynamic compiler info",
2257 .mhandler.info = do_info_jit,
2263 .help = "show KVM information",
2264 .mhandler.info = do_info_kvm,
2270 .help = "show NUMA information",
2271 .mhandler.info = do_info_numa,
2277 .help = "show guest USB devices",
2278 .mhandler.info = usb_info,
2284 .help = "show host USB devices",
2285 .mhandler.info = usb_host_info,
2291 .help = "show profiling information",
2292 .mhandler.info = do_info_profile,
2298 .help = "show capture information",
2299 .mhandler.info = do_info_capture,
2302 .name = "snapshots",
2305 .help = "show the currently saved VM snapshots",
2306 .mhandler.info = do_info_snapshots,
2312 .help = "show the current VM status (running|paused)",
2313 .mhandler.info = do_info_status,
2319 .help = "show guest PCMCIA status",
2320 .mhandler.info = pcmcia_info,
2326 .help = "show which guest mouse is receiving events",
2327 .mhandler.info = do_info_mice,
2333 .help = "show the vnc server status",
2334 .mhandler.info = do_info_vnc,
2340 .help = "show the current VM name",
2341 .mhandler.info = do_info_name,
2347 .help = "show the current VM UUID",
2348 .mhandler.info = do_info_uuid,
2350 #if defined(TARGET_PPC)
2355 .help = "show CPU statistics",
2356 .mhandler.info = do_info_cpu_stats,
2359 #if defined(CONFIG_SLIRP)
2364 .help = "show user network stack connection states",
2365 .mhandler.info = do_info_usernet,
2372 .help = "show migration status",
2373 .mhandler.info = do_info_migrate,
2379 .help = "show balloon information",
2380 .user_print = monitor_print_balloon,
2381 .mhandler.info_new = do_info_balloon,
2387 .help = "show device tree",
2388 .mhandler.info = do_info_qtree,
2394 .help = "show qdev device model list",
2395 .mhandler.info = do_info_qdm,
2401 .help = "show roms",
2402 .mhandler.info = do_info_roms,
2409 /*******************************************************************/
2411 static const char *pch;
2412 static jmp_buf expr_env;
2417 typedef struct MonitorDef {
2420 target_long (*get_value)(const struct MonitorDef *md, int val);
2424 #if defined(TARGET_I386)
2425 static target_long monitor_get_pc (const struct MonitorDef *md, int val)
2427 CPUState *env = mon_get_cpu();
2430 return env->eip + env->segs[R_CS].base;
2434 #if defined(TARGET_PPC)
2435 static target_long monitor_get_ccr (const struct MonitorDef *md, int val)
2437 CPUState *env = mon_get_cpu();
2445 for (i = 0; i < 8; i++)
2446 u |= env->crf[i] << (32 - (4 * i));
2451 static target_long monitor_get_msr (const struct MonitorDef *md, int val)
2453 CPUState *env = mon_get_cpu();
2459 static target_long monitor_get_xer (const struct MonitorDef *md, int val)
2461 CPUState *env = mon_get_cpu();
2467 static target_long monitor_get_decr (const struct MonitorDef *md, int val)
2469 CPUState *env = mon_get_cpu();
2472 return cpu_ppc_load_decr(env);
2475 static target_long monitor_get_tbu (const struct MonitorDef *md, int val)
2477 CPUState *env = mon_get_cpu();
2480 return cpu_ppc_load_tbu(env);
2483 static target_long monitor_get_tbl (const struct MonitorDef *md, int val)
2485 CPUState *env = mon_get_cpu();
2488 return cpu_ppc_load_tbl(env);
2492 #if defined(TARGET_SPARC)
2493 #ifndef TARGET_SPARC64
2494 static target_long monitor_get_psr (const struct MonitorDef *md, int val)
2496 CPUState *env = mon_get_cpu();
2499 return GET_PSR(env);
2503 static target_long monitor_get_reg(const struct MonitorDef *md, int val)
2505 CPUState *env = mon_get_cpu();
2508 return env->regwptr[val];
2512 static const MonitorDef monitor_defs[] = {
2515 #define SEG(name, seg) \
2516 { name, offsetof(CPUState, segs[seg].selector), NULL, MD_I32 },\
2517 { name ".base", offsetof(CPUState, segs[seg].base) },\
2518 { name ".limit", offsetof(CPUState, segs[seg].limit), NULL, MD_I32 },
2520 { "eax", offsetof(CPUState, regs[0]) },
2521 { "ecx", offsetof(CPUState, regs[1]) },
2522 { "edx", offsetof(CPUState, regs[2]) },
2523 { "ebx", offsetof(CPUState, regs[3]) },
2524 { "esp|sp", offsetof(CPUState, regs[4]) },
2525 { "ebp|fp", offsetof(CPUState, regs[5]) },
2526 { "esi", offsetof(CPUState, regs[6]) },
2527 { "edi", offsetof(CPUState, regs[7]) },
2528 #ifdef TARGET_X86_64
2529 { "r8", offsetof(CPUState, regs[8]) },
2530 { "r9", offsetof(CPUState, regs[9]) },
2531 { "r10", offsetof(CPUState, regs[10]) },
2532 { "r11", offsetof(CPUState, regs[11]) },
2533 { "r12", offsetof(CPUState, regs[12]) },
2534 { "r13", offsetof(CPUState, regs[13]) },
2535 { "r14", offsetof(CPUState, regs[14]) },
2536 { "r15", offsetof(CPUState, regs[15]) },
2538 { "eflags", offsetof(CPUState, eflags) },
2539 { "eip", offsetof(CPUState, eip) },
2546 { "pc", 0, monitor_get_pc, },
2547 #elif defined(TARGET_PPC)
2548 /* General purpose registers */
2549 { "r0", offsetof(CPUState, gpr[0]) },
2550 { "r1", offsetof(CPUState, gpr[1]) },
2551 { "r2", offsetof(CPUState, gpr[2]) },
2552 { "r3", offsetof(CPUState, gpr[3]) },
2553 { "r4", offsetof(CPUState, gpr[4]) },
2554 { "r5", offsetof(CPUState, gpr[5]) },
2555 { "r6", offsetof(CPUState, gpr[6]) },
2556 { "r7", offsetof(CPUState, gpr[7]) },
2557 { "r8", offsetof(CPUState, gpr[8]) },
2558 { "r9", offsetof(CPUState, gpr[9]) },
2559 { "r10", offsetof(CPUState, gpr[10]) },
2560 { "r11", offsetof(CPUState, gpr[11]) },
2561 { "r12", offsetof(CPUState, gpr[12]) },
2562 { "r13", offsetof(CPUState, gpr[13]) },
2563 { "r14", offsetof(CPUState, gpr[14]) },
2564 { "r15", offsetof(CPUState, gpr[15]) },
2565 { "r16", offsetof(CPUState, gpr[16]) },
2566 { "r17", offsetof(CPUState, gpr[17]) },
2567 { "r18", offsetof(CPUState, gpr[18]) },
2568 { "r19", offsetof(CPUState, gpr[19]) },
2569 { "r20", offsetof(CPUState, gpr[20]) },
2570 { "r21", offsetof(CPUState, gpr[21]) },
2571 { "r22", offsetof(CPUState, gpr[22]) },
2572 { "r23", offsetof(CPUState, gpr[23]) },
2573 { "r24", offsetof(CPUState, gpr[24]) },
2574 { "r25", offsetof(CPUState, gpr[25]) },
2575 { "r26", offsetof(CPUState, gpr[26]) },
2576 { "r27", offsetof(CPUState, gpr[27]) },
2577 { "r28", offsetof(CPUState, gpr[28]) },
2578 { "r29", offsetof(CPUState, gpr[29]) },
2579 { "r30", offsetof(CPUState, gpr[30]) },
2580 { "r31", offsetof(CPUState, gpr[31]) },
2581 /* Floating point registers */
2582 { "f0", offsetof(CPUState, fpr[0]) },
2583 { "f1", offsetof(CPUState, fpr[1]) },
2584 { "f2", offsetof(CPUState, fpr[2]) },
2585 { "f3", offsetof(CPUState, fpr[3]) },
2586 { "f4", offsetof(CPUState, fpr[4]) },
2587 { "f5", offsetof(CPUState, fpr[5]) },
2588 { "f6", offsetof(CPUState, fpr[6]) },
2589 { "f7", offsetof(CPUState, fpr[7]) },
2590 { "f8", offsetof(CPUState, fpr[8]) },
2591 { "f9", offsetof(CPUState, fpr[9]) },
2592 { "f10", offsetof(CPUState, fpr[10]) },
2593 { "f11", offsetof(CPUState, fpr[11]) },
2594 { "f12", offsetof(CPUState, fpr[12]) },
2595 { "f13", offsetof(CPUState, fpr[13]) },
2596 { "f14", offsetof(CPUState, fpr[14]) },
2597 { "f15", offsetof(CPUState, fpr[15]) },
2598 { "f16", offsetof(CPUState, fpr[16]) },
2599 { "f17", offsetof(CPUState, fpr[17]) },
2600 { "f18", offsetof(CPUState, fpr[18]) },
2601 { "f19", offsetof(CPUState, fpr[19]) },
2602 { "f20", offsetof(CPUState, fpr[20]) },
2603 { "f21", offsetof(CPUState, fpr[21]) },
2604 { "f22", offsetof(CPUState, fpr[22]) },
2605 { "f23", offsetof(CPUState, fpr[23]) },
2606 { "f24", offsetof(CPUState, fpr[24]) },
2607 { "f25", offsetof(CPUState, fpr[25]) },
2608 { "f26", offsetof(CPUState, fpr[26]) },
2609 { "f27", offsetof(CPUState, fpr[27]) },
2610 { "f28", offsetof(CPUState, fpr[28]) },
2611 { "f29", offsetof(CPUState, fpr[29]) },
2612 { "f30", offsetof(CPUState, fpr[30]) },
2613 { "f31", offsetof(CPUState, fpr[31]) },
2614 { "fpscr", offsetof(CPUState, fpscr) },
2615 /* Next instruction pointer */
2616 { "nip|pc", offsetof(CPUState, nip) },
2617 { "lr", offsetof(CPUState, lr) },
2618 { "ctr", offsetof(CPUState, ctr) },
2619 { "decr", 0, &monitor_get_decr, },
2620 { "ccr", 0, &monitor_get_ccr, },
2621 /* Machine state register */
2622 { "msr", 0, &monitor_get_msr, },
2623 { "xer", 0, &monitor_get_xer, },
2624 { "tbu", 0, &monitor_get_tbu, },
2625 { "tbl", 0, &monitor_get_tbl, },
2626 #if defined(TARGET_PPC64)
2627 /* Address space register */
2628 { "asr", offsetof(CPUState, asr) },
2630 /* Segment registers */
2631 { "sdr1", offsetof(CPUState, sdr1) },
2632 { "sr0", offsetof(CPUState, sr[0]) },
2633 { "sr1", offsetof(CPUState, sr[1]) },
2634 { "sr2", offsetof(CPUState, sr[2]) },
2635 { "sr3", offsetof(CPUState, sr[3]) },
2636 { "sr4", offsetof(CPUState, sr[4]) },
2637 { "sr5", offsetof(CPUState, sr[5]) },
2638 { "sr6", offsetof(CPUState, sr[6]) },
2639 { "sr7", offsetof(CPUState, sr[7]) },
2640 { "sr8", offsetof(CPUState, sr[8]) },
2641 { "sr9", offsetof(CPUState, sr[9]) },
2642 { "sr10", offsetof(CPUState, sr[10]) },
2643 { "sr11", offsetof(CPUState, sr[11]) },
2644 { "sr12", offsetof(CPUState, sr[12]) },
2645 { "sr13", offsetof(CPUState, sr[13]) },
2646 { "sr14", offsetof(CPUState, sr[14]) },
2647 { "sr15", offsetof(CPUState, sr[15]) },
2648 /* Too lazy to put BATs and SPRs ... */
2649 #elif defined(TARGET_SPARC)
2650 { "g0", offsetof(CPUState, gregs[0]) },
2651 { "g1", offsetof(CPUState, gregs[1]) },
2652 { "g2", offsetof(CPUState, gregs[2]) },
2653 { "g3", offsetof(CPUState, gregs[3]) },
2654 { "g4", offsetof(CPUState, gregs[4]) },
2655 { "g5", offsetof(CPUState, gregs[5]) },
2656 { "g6", offsetof(CPUState, gregs[6]) },
2657 { "g7", offsetof(CPUState, gregs[7]) },
2658 { "o0", 0, monitor_get_reg },
2659 { "o1", 1, monitor_get_reg },
2660 { "o2", 2, monitor_get_reg },
2661 { "o3", 3, monitor_get_reg },
2662 { "o4", 4, monitor_get_reg },
2663 { "o5", 5, monitor_get_reg },
2664 { "o6", 6, monitor_get_reg },
2665 { "o7", 7, monitor_get_reg },
2666 { "l0", 8, monitor_get_reg },
2667 { "l1", 9, monitor_get_reg },
2668 { "l2", 10, monitor_get_reg },
2669 { "l3", 11, monitor_get_reg },
2670 { "l4", 12, monitor_get_reg },
2671 { "l5", 13, monitor_get_reg },
2672 { "l6", 14, monitor_get_reg },
2673 { "l7", 15, monitor_get_reg },
2674 { "i0", 16, monitor_get_reg },
2675 { "i1", 17, monitor_get_reg },
2676 { "i2", 18, monitor_get_reg },
2677 { "i3", 19, monitor_get_reg },
2678 { "i4", 20, monitor_get_reg },
2679 { "i5", 21, monitor_get_reg },
2680 { "i6", 22, monitor_get_reg },
2681 { "i7", 23, monitor_get_reg },
2682 { "pc", offsetof(CPUState, pc) },
2683 { "npc", offsetof(CPUState, npc) },
2684 { "y", offsetof(CPUState, y) },
2685 #ifndef TARGET_SPARC64
2686 { "psr", 0, &monitor_get_psr, },
2687 { "wim", offsetof(CPUState, wim) },
2689 { "tbr", offsetof(CPUState, tbr) },
2690 { "fsr", offsetof(CPUState, fsr) },
2691 { "f0", offsetof(CPUState, fpr[0]) },
2692 { "f1", offsetof(CPUState, fpr[1]) },
2693 { "f2", offsetof(CPUState, fpr[2]) },
2694 { "f3", offsetof(CPUState, fpr[3]) },
2695 { "f4", offsetof(CPUState, fpr[4]) },
2696 { "f5", offsetof(CPUState, fpr[5]) },
2697 { "f6", offsetof(CPUState, fpr[6]) },
2698 { "f7", offsetof(CPUState, fpr[7]) },
2699 { "f8", offsetof(CPUState, fpr[8]) },
2700 { "f9", offsetof(CPUState, fpr[9]) },
2701 { "f10", offsetof(CPUState, fpr[10]) },
2702 { "f11", offsetof(CPUState, fpr[11]) },
2703 { "f12", offsetof(CPUState, fpr[12]) },
2704 { "f13", offsetof(CPUState, fpr[13]) },
2705 { "f14", offsetof(CPUState, fpr[14]) },
2706 { "f15", offsetof(CPUState, fpr[15]) },
2707 { "f16", offsetof(CPUState, fpr[16]) },
2708 { "f17", offsetof(CPUState, fpr[17]) },
2709 { "f18", offsetof(CPUState, fpr[18]) },
2710 { "f19", offsetof(CPUState, fpr[19]) },
2711 { "f20", offsetof(CPUState, fpr[20]) },
2712 { "f21", offsetof(CPUState, fpr[21]) },
2713 { "f22", offsetof(CPUState, fpr[22]) },
2714 { "f23", offsetof(CPUState, fpr[23]) },
2715 { "f24", offsetof(CPUState, fpr[24]) },
2716 { "f25", offsetof(CPUState, fpr[25]) },
2717 { "f26", offsetof(CPUState, fpr[26]) },
2718 { "f27", offsetof(CPUState, fpr[27]) },
2719 { "f28", offsetof(CPUState, fpr[28]) },
2720 { "f29", offsetof(CPUState, fpr[29]) },
2721 { "f30", offsetof(CPUState, fpr[30]) },
2722 { "f31", offsetof(CPUState, fpr[31]) },
2723 #ifdef TARGET_SPARC64
2724 { "f32", offsetof(CPUState, fpr[32]) },
2725 { "f34", offsetof(CPUState, fpr[34]) },
2726 { "f36", offsetof(CPUState, fpr[36]) },
2727 { "f38", offsetof(CPUState, fpr[38]) },
2728 { "f40", offsetof(CPUState, fpr[40]) },
2729 { "f42", offsetof(CPUState, fpr[42]) },
2730 { "f44", offsetof(CPUState, fpr[44]) },
2731 { "f46", offsetof(CPUState, fpr[46]) },
2732 { "f48", offsetof(CPUState, fpr[48]) },
2733 { "f50", offsetof(CPUState, fpr[50]) },
2734 { "f52", offsetof(CPUState, fpr[52]) },
2735 { "f54", offsetof(CPUState, fpr[54]) },
2736 { "f56", offsetof(CPUState, fpr[56]) },
2737 { "f58", offsetof(CPUState, fpr[58]) },
2738 { "f60", offsetof(CPUState, fpr[60]) },
2739 { "f62", offsetof(CPUState, fpr[62]) },
2740 { "asi", offsetof(CPUState, asi) },
2741 { "pstate", offsetof(CPUState, pstate) },
2742 { "cansave", offsetof(CPUState, cansave) },
2743 { "canrestore", offsetof(CPUState, canrestore) },
2744 { "otherwin", offsetof(CPUState, otherwin) },
2745 { "wstate", offsetof(CPUState, wstate) },
2746 { "cleanwin", offsetof(CPUState, cleanwin) },
2747 { "fprs", offsetof(CPUState, fprs) },
2753 static void expr_error(Monitor *mon, const char *msg)
2755 monitor_printf(mon, "%s\n", msg);
2756 longjmp(expr_env, 1);
2759 /* return 0 if OK, -1 if not found, -2 if no CPU defined */
2760 static int get_monitor_def(target_long *pval, const char *name)
2762 const MonitorDef *md;
2765 for(md = monitor_defs; md->name != NULL; md++) {
2766 if (compare_cmd(name, md->name)) {
2767 if (md->get_value) {
2768 *pval = md->get_value(md, md->offset);
2770 CPUState *env = mon_get_cpu();
2773 ptr = (uint8_t *)env + md->offset;
2776 *pval = *(int32_t *)ptr;
2779 *pval = *(target_long *)ptr;
2792 static void next(void)
2796 while (qemu_isspace(*pch))
2801 static int64_t expr_sum(Monitor *mon);
2803 static int64_t expr_unary(Monitor *mon)
2812 n = expr_unary(mon);
2816 n = -expr_unary(mon);
2820 n = ~expr_unary(mon);
2826 expr_error(mon, "')' expected");
2833 expr_error(mon, "character constant expected");
2837 expr_error(mon, "missing terminating \' character");
2847 while ((*pch >= 'a' && *pch <= 'z') ||
2848 (*pch >= 'A' && *pch <= 'Z') ||
2849 (*pch >= '0' && *pch <= '9') ||
2850 *pch == '_' || *pch == '.') {
2851 if ((q - buf) < sizeof(buf) - 1)
2855 while (qemu_isspace(*pch))
2858 ret = get_monitor_def(®, buf);
2860 expr_error(mon, "unknown register");
2862 expr_error(mon, "no cpu defined");
2867 expr_error(mon, "unexpected end of expression");
2871 #if TARGET_PHYS_ADDR_BITS > 32
2872 n = strtoull(pch, &p, 0);
2874 n = strtoul(pch, &p, 0);
2877 expr_error(mon, "invalid char in expression");
2880 while (qemu_isspace(*pch))
2888 static int64_t expr_prod(Monitor *mon)
2893 val = expr_unary(mon);
2896 if (op != '*' && op != '/' && op != '%')
2899 val2 = expr_unary(mon);
2908 expr_error(mon, "division by zero");
2919 static int64_t expr_logic(Monitor *mon)
2924 val = expr_prod(mon);
2927 if (op != '&' && op != '|' && op != '^')
2930 val2 = expr_prod(mon);
2947 static int64_t expr_sum(Monitor *mon)
2952 val = expr_logic(mon);
2955 if (op != '+' && op != '-')
2958 val2 = expr_logic(mon);
2967 static int get_expr(Monitor *mon, int64_t *pval, const char **pp)
2970 if (setjmp(expr_env)) {
2974 while (qemu_isspace(*pch))
2976 *pval = expr_sum(mon);
2981 static int get_str(char *buf, int buf_size, const char **pp)
2989 while (qemu_isspace(*p))
2999 while (*p != '\0' && *p != '\"') {
3015 qemu_printf("unsupported escape code: '\\%c'\n", c);
3018 if ((q - buf) < buf_size - 1) {
3022 if ((q - buf) < buf_size - 1) {
3029 qemu_printf("unterminated string\n");
3034 while (*p != '\0' && !qemu_isspace(*p)) {
3035 if ((q - buf) < buf_size - 1) {
3047 * Store the command-name in cmdname, and return a pointer to
3048 * the remaining of the command string.
3050 static const char *get_command_name(const char *cmdline,
3051 char *cmdname, size_t nlen)
3054 const char *p, *pstart;
3057 while (qemu_isspace(*p))
3062 while (*p != '\0' && *p != '/' && !qemu_isspace(*p))
3067 memcpy(cmdname, pstart, len);
3068 cmdname[len] = '\0';
3073 * Read key of 'type' into 'key' and return the current
3076 static char *key_get_info(const char *type, char **key)
3084 p = strchr(type, ':');
3091 str = qemu_malloc(len + 1);
3092 memcpy(str, type, len);
3099 static int default_fmt_format = 'x';
3100 static int default_fmt_size = 4;
3104 static int is_valid_option(const char *c, const char *typestr)
3112 typestr = strstr(typestr, option);
3113 return (typestr != NULL);
3116 static const mon_cmd_t *monitor_find_command(const char *cmdname)
3118 const mon_cmd_t *cmd;
3120 for (cmd = mon_cmds; cmd->name != NULL; cmd++) {
3121 if (compare_cmd(cmdname, cmd->name)) {
3129 static const mon_cmd_t *monitor_parse_command(Monitor *mon,
3130 const char *cmdline,
3133 const char *p, *typestr;
3135 const mon_cmd_t *cmd;
3141 monitor_printf(mon, "command='%s'\n", cmdline);
3144 /* extract the command name */
3145 p = get_command_name(cmdline, cmdname, sizeof(cmdname));
3149 cmd = monitor_find_command(cmdname);
3151 monitor_printf(mon, "unknown command: '%s'\n", cmdname);
3155 /* parse the parameters */
3156 typestr = cmd->args_type;
3158 typestr = key_get_info(typestr, &key);
3170 while (qemu_isspace(*p))
3172 if (*typestr == '?') {
3175 /* no optional string: NULL argument */
3179 ret = get_str(buf, sizeof(buf), &p);
3183 monitor_printf(mon, "%s: filename expected\n",
3187 monitor_printf(mon, "%s: block device name expected\n",
3191 monitor_printf(mon, "%s: string expected\n", cmdname);
3196 qdict_put(qdict, key, qstring_from_str(buf));
3201 int count, format, size;
3203 while (qemu_isspace(*p))
3209 if (qemu_isdigit(*p)) {
3211 while (qemu_isdigit(*p)) {
3212 count = count * 10 + (*p - '0');
3250 if (*p != '\0' && !qemu_isspace(*p)) {
3251 monitor_printf(mon, "invalid char in format: '%c'\n",
3256 format = default_fmt_format;
3257 if (format != 'i') {
3258 /* for 'i', not specifying a size gives -1 as size */
3260 size = default_fmt_size;
3261 default_fmt_size = size;
3263 default_fmt_format = format;
3266 format = default_fmt_format;
3267 if (format != 'i') {
3268 size = default_fmt_size;
3273 qdict_put(qdict, "count", qint_from_int(count));
3274 qdict_put(qdict, "format", qint_from_int(format));
3275 qdict_put(qdict, "size", qint_from_int(size));
3283 while (qemu_isspace(*p))
3285 if (*typestr == '?' || *typestr == '.') {
3286 if (*typestr == '?') {
3294 while (qemu_isspace(*p))
3303 if (get_expr(mon, &val, &p))
3305 /* Check if 'i' is greater than 32-bit */
3306 if ((c == 'i') && ((val >> 32) & 0xffffffff)) {
3307 monitor_printf(mon, "\'%s\' has failed: ", cmdname);
3308 monitor_printf(mon, "integer is for 32-bit values\n");
3311 qdict_put(qdict, key, qint_from_int(val));
3316 const char *tmp = p;
3317 int has_option, skip_key = 0;
3323 while (qemu_isspace(*p))
3329 if(!is_valid_option(p, typestr)) {
3331 monitor_printf(mon, "%s: unsupported option -%c\n",
3345 qdict_put(qdict, key, qint_from_int(has_option));
3350 monitor_printf(mon, "%s: unknown type '%c'\n", cmdname, c);
3356 /* check that all arguments were parsed */
3357 while (qemu_isspace(*p))
3360 monitor_printf(mon, "%s: extraneous characters at the end of line\n",
3372 static void monitor_print_error(Monitor *mon)
3374 qerror_print(mon->error);
3375 QDECREF(mon->error);
3379 static void monitor_call_handler(Monitor *mon, const mon_cmd_t *cmd,
3380 const QDict *params)
3382 QObject *data = NULL;
3384 cmd->mhandler.cmd_new(mon, params, &data);
3386 if (monitor_ctrl_mode(mon)) {
3387 /* Monitor Protocol */
3388 monitor_protocol_emitter(mon, data);
3392 cmd->user_print(mon, data);
3395 qobject_decref(data);
3398 static void handle_user_command(Monitor *mon, const char *cmdline)
3401 const mon_cmd_t *cmd;
3403 qdict = qdict_new();
3405 cmd = monitor_parse_command(mon, cmdline, qdict);
3409 qemu_errors_to_mon(mon);
3411 if (monitor_handler_ported(cmd)) {
3412 monitor_call_handler(mon, cmd, qdict);
3414 cmd->mhandler.cmd(mon, qdict);
3417 if (monitor_has_error(mon))
3418 monitor_print_error(mon);
3420 qemu_errors_to_previous();
3426 static void cmd_completion(const char *name, const char *list)
3428 const char *p, *pstart;
3437 p = pstart + strlen(pstart);
3439 if (len > sizeof(cmd) - 2)
3440 len = sizeof(cmd) - 2;
3441 memcpy(cmd, pstart, len);
3443 if (name[0] == '\0' || !strncmp(name, cmd, strlen(name))) {
3444 readline_add_completion(cur_mon->rs, cmd);
3452 static void file_completion(const char *input)
3457 char file[1024], file_prefix[1024];
3461 p = strrchr(input, '/');
3464 pstrcpy(file_prefix, sizeof(file_prefix), input);
3465 pstrcpy(path, sizeof(path), ".");
3467 input_path_len = p - input + 1;
3468 memcpy(path, input, input_path_len);
3469 if (input_path_len > sizeof(path) - 1)
3470 input_path_len = sizeof(path) - 1;
3471 path[input_path_len] = '\0';
3472 pstrcpy(file_prefix, sizeof(file_prefix), p + 1);
3474 #ifdef DEBUG_COMPLETION
3475 monitor_printf(cur_mon, "input='%s' path='%s' prefix='%s'\n",
3476 input, path, file_prefix);
3478 ffs = opendir(path);
3486 if (strstart(d->d_name, file_prefix, NULL)) {
3487 memcpy(file, input, input_path_len);
3488 if (input_path_len < sizeof(file))
3489 pstrcpy(file + input_path_len, sizeof(file) - input_path_len,
3491 /* stat the file to find out if it's a directory.
3492 * In that case add a slash to speed up typing long paths
3495 if(S_ISDIR(sb.st_mode))
3496 pstrcat(file, sizeof(file), "/");
3497 readline_add_completion(cur_mon->rs, file);
3503 static void block_completion_it(void *opaque, BlockDriverState *bs)
3505 const char *name = bdrv_get_device_name(bs);
3506 const char *input = opaque;
3508 if (input[0] == '\0' ||
3509 !strncmp(name, (char *)input, strlen(input))) {
3510 readline_add_completion(cur_mon->rs, name);
3514 /* NOTE: this parser is an approximate form of the real command parser */
3515 static void parse_cmdline(const char *cmdline,
3516 int *pnb_args, char **args)
3525 while (qemu_isspace(*p))
3529 if (nb_args >= MAX_ARGS)
3531 ret = get_str(buf, sizeof(buf), &p);
3532 args[nb_args] = qemu_strdup(buf);
3537 *pnb_args = nb_args;
3540 static const char *next_arg_type(const char *typestr)
3542 const char *p = strchr(typestr, ':');
3543 return (p != NULL ? ++p : typestr);
3546 static void monitor_find_completion(const char *cmdline)
3548 const char *cmdname;
3549 char *args[MAX_ARGS];
3550 int nb_args, i, len;
3551 const char *ptype, *str;
3552 const mon_cmd_t *cmd;
3555 parse_cmdline(cmdline, &nb_args, args);
3556 #ifdef DEBUG_COMPLETION
3557 for(i = 0; i < nb_args; i++) {
3558 monitor_printf(cur_mon, "arg%d = '%s'\n", i, (char *)args[i]);
3562 /* if the line ends with a space, it means we want to complete the
3564 len = strlen(cmdline);
3565 if (len > 0 && qemu_isspace(cmdline[len - 1])) {
3566 if (nb_args >= MAX_ARGS)
3568 args[nb_args++] = qemu_strdup("");
3571 /* command completion */
3576 readline_set_completion_index(cur_mon->rs, strlen(cmdname));
3577 for(cmd = mon_cmds; cmd->name != NULL; cmd++) {
3578 cmd_completion(cmdname, cmd->name);
3581 /* find the command */
3582 for(cmd = mon_cmds; cmd->name != NULL; cmd++) {
3583 if (compare_cmd(args[0], cmd->name))
3588 ptype = next_arg_type(cmd->args_type);
3589 for(i = 0; i < nb_args - 2; i++) {
3590 if (*ptype != '\0') {
3591 ptype = next_arg_type(ptype);
3592 while (*ptype == '?')
3593 ptype = next_arg_type(ptype);
3596 str = args[nb_args - 1];
3597 if (*ptype == '-' && ptype[1] != '\0') {
3602 /* file completion */
3603 readline_set_completion_index(cur_mon->rs, strlen(str));
3604 file_completion(str);
3607 /* block device name completion */
3608 readline_set_completion_index(cur_mon->rs, strlen(str));
3609 bdrv_iterate(block_completion_it, (void *)str);
3612 /* XXX: more generic ? */
3613 if (!strcmp(cmd->name, "info")) {
3614 readline_set_completion_index(cur_mon->rs, strlen(str));
3615 for(cmd = info_cmds; cmd->name != NULL; cmd++) {
3616 cmd_completion(str, cmd->name);
3618 } else if (!strcmp(cmd->name, "sendkey")) {
3619 char *sep = strrchr(str, '-');
3622 readline_set_completion_index(cur_mon->rs, strlen(str));
3623 for(key = key_defs; key->name != NULL; key++) {
3624 cmd_completion(str, key->name);
3626 } else if (!strcmp(cmd->name, "help|?")) {
3627 readline_set_completion_index(cur_mon->rs, strlen(str));
3628 for (cmd = mon_cmds; cmd->name != NULL; cmd++) {
3629 cmd_completion(str, cmd->name);
3637 for(i = 0; i < nb_args; i++)
3641 static int monitor_can_read(void *opaque)
3643 Monitor *mon = opaque;
3645 return (mon->suspend_cnt == 0) ? 128 : 0;
3648 typedef struct CmdArgs {
3655 static int check_opt(const CmdArgs *cmd_args, const char *name, QDict *args)
3657 if (!cmd_args->optional) {
3658 qemu_error_new(QERR_MISSING_PARAMETER, name);
3662 if (cmd_args->type == '-') {
3663 /* handlers expect a value, they need to be changed */
3664 qdict_put(args, name, qint_from_int(0));
3670 static int check_arg(const CmdArgs *cmd_args, QDict *args)
3675 name = qstring_get_str(cmd_args->name);
3678 return check_opt(cmd_args, name, args);
3681 value = qdict_get(args, name);
3683 return check_opt(cmd_args, name, args);
3686 switch (cmd_args->type) {
3690 if (qobject_type(value) != QTYPE_QSTRING) {
3691 qemu_error_new(QERR_INVALID_PARAMETER_TYPE, name, "string");
3697 const char *keys[] = { "count", "format", "size", NULL };
3699 for (i = 0; keys[i]; i++) {
3700 QObject *obj = qdict_get(args, keys[i]);
3702 qemu_error_new(QERR_MISSING_PARAMETER, name);
3705 if (qobject_type(obj) != QTYPE_QINT) {
3706 qemu_error_new(QERR_INVALID_PARAMETER_TYPE, name, "int");
3714 if (qobject_type(value) != QTYPE_QINT) {
3715 qemu_error_new(QERR_INVALID_PARAMETER_TYPE, name, "int");
3720 if (qobject_type(value) != QTYPE_QINT &&
3721 qobject_type(value) != QTYPE_QBOOL) {
3722 qemu_error_new(QERR_INVALID_PARAMETER_TYPE, name, "bool");
3725 if (qobject_type(value) == QTYPE_QBOOL) {
3726 /* handlers expect a QInt, they need to be changed */
3727 qdict_put(args, name,
3728 qint_from_int(qbool_get_int(qobject_to_qbool(value))));
3739 static void cmd_args_init(CmdArgs *cmd_args)
3741 cmd_args->name = qstring_new();
3742 cmd_args->type = cmd_args->flag = cmd_args->optional = 0;
3746 * This is not trivial, we have to parse Monitor command's argument
3747 * type syntax to be able to check the arguments provided by clients.
3749 * In the near future we will be using an array for that and will be
3750 * able to drop all this parsing...
3752 static int monitor_check_qmp_args(const mon_cmd_t *cmd, QDict *args)
3758 if (cmd->args_type == '\0') {
3759 return (qdict_size(args) == 0 ? 0 : -1);
3763 cmd_args_init(&cmd_args);
3765 for (p = cmd->args_type;; p++) {
3767 cmd_args.type = *++p;
3769 if (cmd_args.type == '-') {
3770 cmd_args.flag = *p++;
3771 cmd_args.optional = 1;
3772 } else if (*p == '?') {
3773 cmd_args.optional = 1;
3777 assert(*p == ',' || *p == '\0');
3778 err = check_arg(&cmd_args, args);
3780 QDECREF(cmd_args.name);
3781 cmd_args_init(&cmd_args);
3787 qstring_append_chr(cmd_args.name, *p);
3795 QDECREF(cmd_args.name);
3799 static void handle_qmp_command(JSONMessageParser *parser, QList *tokens)
3803 QDict *input, *args;
3804 const mon_cmd_t *cmd;
3805 Monitor *mon = cur_mon;
3806 const char *cmd_name, *info_item;
3809 qemu_errors_to_mon(mon);
3811 obj = json_parser_parse(tokens, NULL);
3813 // FIXME: should be triggered in json_parser_parse()
3814 qemu_error_new(QERR_JSON_PARSING);
3816 } else if (qobject_type(obj) != QTYPE_QDICT) {
3817 qemu_error_new(QERR_QMP_BAD_INPUT_OBJECT, "object");
3818 qobject_decref(obj);
3822 input = qobject_to_qdict(obj);
3824 mon->mc->id = qdict_get(input, "id");
3825 qobject_incref(mon->mc->id);
3827 obj = qdict_get(input, "execute");
3829 qemu_error_new(QERR_QMP_BAD_INPUT_OBJECT, "execute");
3831 } else if (qobject_type(obj) != QTYPE_QSTRING) {
3832 qemu_error_new(QERR_QMP_BAD_INPUT_OBJECT, "string");
3836 cmd_name = qstring_get_str(qobject_to_qstring(obj));
3839 * XXX: We need this special case until we get info handlers
3840 * converted into 'query-' commands
3842 if (compare_cmd(cmd_name, "info")) {
3843 qemu_error_new(QERR_COMMAND_NOT_FOUND, cmd_name);
3845 } else if (strstart(cmd_name, "query-", &info_item)) {
3846 cmd = monitor_find_command("info");
3847 qdict_put_obj(input, "arguments",
3848 qobject_from_jsonf("{ 'item': %s }", info_item));
3850 cmd = monitor_find_command(cmd_name);
3852 qemu_error_new(QERR_COMMAND_NOT_FOUND, cmd_name);
3857 obj = qdict_get(input, "arguments");
3861 args = qobject_to_qdict(obj);
3867 err = monitor_check_qmp_args(cmd, args);
3872 monitor_call_handler(mon, cmd, args);
3878 monitor_protocol_emitter(mon, NULL);
3881 qemu_errors_to_previous();
3885 * monitor_control_read(): Read and handle QMP input
3887 static void monitor_control_read(void *opaque, const uint8_t *buf, int size)
3889 Monitor *old_mon = cur_mon;
3893 json_message_parser_feed(&cur_mon->mc->parser, (const char *) buf, size);
3898 static void monitor_read(void *opaque, const uint8_t *buf, int size)
3900 Monitor *old_mon = cur_mon;
3906 for (i = 0; i < size; i++)
3907 readline_handle_byte(cur_mon->rs, buf[i]);
3909 if (size == 0 || buf[size - 1] != 0)
3910 monitor_printf(cur_mon, "corrupted command\n");
3912 handle_user_command(cur_mon, (char *)buf);
3918 static void monitor_command_cb(Monitor *mon, const char *cmdline, void *opaque)
3920 monitor_suspend(mon);
3921 handle_user_command(mon, cmdline);
3922 monitor_resume(mon);
3925 int monitor_suspend(Monitor *mon)
3933 void monitor_resume(Monitor *mon)
3937 if (--mon->suspend_cnt == 0)
3938 readline_show_prompt(mon->rs);
3942 * monitor_control_event(): Print QMP gretting
3944 static void monitor_control_event(void *opaque, int event)
3946 if (event == CHR_EVENT_OPENED) {
3948 Monitor *mon = opaque;
3950 json_message_parser_init(&mon->mc->parser, handle_qmp_command);
3952 data = qobject_from_jsonf("{ 'QMP': { 'capabilities': [] } }");
3953 assert(data != NULL);
3955 monitor_json_emitter(mon, data);
3956 qobject_decref(data);
3960 static void monitor_event(void *opaque, int event)
3962 Monitor *mon = opaque;
3965 case CHR_EVENT_MUX_IN:
3967 if (mon->reset_seen) {
3968 readline_restart(mon->rs);
3969 monitor_resume(mon);
3972 mon->suspend_cnt = 0;
3976 case CHR_EVENT_MUX_OUT:
3977 if (mon->reset_seen) {
3978 if (mon->suspend_cnt == 0) {
3979 monitor_printf(mon, "\n");
3982 monitor_suspend(mon);
3989 case CHR_EVENT_OPENED:
3990 monitor_printf(mon, "QEMU %s monitor - type 'help' for more "
3991 "information\n", QEMU_VERSION);
3992 if (!mon->mux_out) {
3993 readline_show_prompt(mon->rs);
3995 mon->reset_seen = 1;
4009 const char *monitor_cmdline_parse(const char *cmdline, int *flags)
4013 if (strstart(cmdline, "control,", &dev)) {
4014 if (strstart(dev, "vc", NULL)) {
4015 fprintf(stderr, "qemu: control mode is for low-level interaction ");
4016 fprintf(stderr, "cannot be used with device 'vc'\n");
4019 *flags &= ~MONITOR_USE_READLINE;
4020 *flags |= MONITOR_USE_CONTROL;
4027 void monitor_init(CharDriverState *chr, int flags)
4029 static int is_first_init = 1;
4032 if (is_first_init) {
4033 key_timer = qemu_new_timer(vm_clock, release_keys, NULL);
4037 mon = qemu_mallocz(sizeof(*mon));
4041 if (flags & MONITOR_USE_READLINE) {
4042 mon->rs = readline_init(mon, monitor_find_completion);
4043 monitor_read_command(mon, 0);
4046 if (monitor_ctrl_mode(mon)) {
4047 mon->mc = qemu_mallocz(sizeof(MonitorControl));
4048 /* Control mode requires special handlers */
4049 qemu_chr_add_handlers(chr, monitor_can_read, monitor_control_read,
4050 monitor_control_event, mon);
4052 qemu_chr_add_handlers(chr, monitor_can_read, monitor_read,
4053 monitor_event, mon);
4056 QLIST_INSERT_HEAD(&mon_list, mon, entry);
4057 if (!cur_mon || (flags & MONITOR_IS_DEFAULT))
4061 static void bdrv_password_cb(Monitor *mon, const char *password, void *opaque)
4063 BlockDriverState *bs = opaque;
4066 if (bdrv_set_key(bs, password) != 0) {
4067 monitor_printf(mon, "invalid password\n");
4070 if (mon->password_completion_cb)
4071 mon->password_completion_cb(mon->password_opaque, ret);
4073 monitor_read_command(mon, 1);
4076 void monitor_read_bdrv_key_start(Monitor *mon, BlockDriverState *bs,
4077 BlockDriverCompletionFunc *completion_cb,
4082 if (!bdrv_key_required(bs)) {
4084 completion_cb(opaque, 0);
4088 monitor_printf(mon, "%s (%s) is encrypted.\n", bdrv_get_device_name(bs),
4089 bdrv_get_encrypted_filename(bs));
4091 mon->password_completion_cb = completion_cb;
4092 mon->password_opaque = opaque;
4094 err = monitor_read_password(mon, bdrv_password_cb, bs);
4096 if (err && completion_cb)
4097 completion_cb(opaque, err);
4100 typedef struct QemuErrorSink QemuErrorSink;
4101 struct QemuErrorSink {
4110 QemuErrorSink *previous;
4113 static QemuErrorSink *qemu_error_sink;
4115 void qemu_errors_to_file(FILE *fp)
4117 QemuErrorSink *sink;
4119 sink = qemu_mallocz(sizeof(*sink));
4120 sink->dest = ERR_SINK_FILE;
4122 sink->previous = qemu_error_sink;
4123 qemu_error_sink = sink;
4126 void qemu_errors_to_mon(Monitor *mon)
4128 QemuErrorSink *sink;
4130 sink = qemu_mallocz(sizeof(*sink));
4131 sink->dest = ERR_SINK_MONITOR;
4133 sink->previous = qemu_error_sink;
4134 qemu_error_sink = sink;
4137 void qemu_errors_to_previous(void)
4139 QemuErrorSink *sink;
4141 assert(qemu_error_sink != NULL);
4142 sink = qemu_error_sink;
4143 qemu_error_sink = sink->previous;
4147 void qemu_error(const char *fmt, ...)
4151 assert(qemu_error_sink != NULL);
4152 switch (qemu_error_sink->dest) {
4154 va_start(args, fmt);
4155 vfprintf(qemu_error_sink->fp, fmt, args);
4158 case ERR_SINK_MONITOR:
4159 va_start(args, fmt);
4160 monitor_vprintf(qemu_error_sink->mon, fmt, args);
4166 void qemu_error_internal(const char *file, int linenr, const char *func,
4167 const char *fmt, ...)
4172 assert(qemu_error_sink != NULL);
4175 qerror = qerror_from_info(file, linenr, func, fmt, &va);
4178 switch (qemu_error_sink->dest) {
4180 qerror_print(qerror);
4183 case ERR_SINK_MONITOR:
4184 assert(qemu_error_sink->mon->error == NULL);
4185 qemu_error_sink->mon->error = qerror;