4 * Copyright (c) 2003-2004 Fabrice Bellard
6 * Permission is hereby granted, free of charge, to any person obtaining a copy
7 * of this software and associated documentation files (the "Software"), to deal
8 * in the Software without restriction, including without limitation the rights
9 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 * copies of the Software, and to permit persons to whom the Software is
11 * furnished to do so, subject to the following conditions:
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
28 #include "hw/pcmcia.h"
31 #include "hw/watchdog.h"
32 #include "hw/loader.h"
35 #include "net/slirp.h"
36 #include "qemu-char.h"
42 #include "audio/audio.h"
45 #include "qemu-timer.h"
46 #include "migration.h"
56 #include "json-streamer.h"
57 #include "json-parser.h"
60 //#define DEBUG_COMPLETION
66 * 'B' block device name
67 * 's' string (accept optional quote)
69 * 'l' target long (32 or 64 bit)
70 * '/' optional gdb-like print format (like "/10x")
72 * '?' optional type (for all types, except '/')
73 * '.' other form of optional type (for 'i' and 'l')
74 * '-' optional parameter (eg. '-f')
78 typedef struct mon_cmd_t {
80 const char *args_type;
83 void (*user_print)(Monitor *mon, const QObject *data);
85 void (*info)(Monitor *mon);
86 void (*info_new)(Monitor *mon, QObject **ret_data);
87 void (*cmd)(Monitor *mon, const QDict *qdict);
88 void (*cmd_new)(Monitor *mon, const QDict *params, QObject **ret_data);
92 /* file descriptors passed via SCM_RIGHTS */
93 typedef struct mon_fd_t mon_fd_t;
97 QLIST_ENTRY(mon_fd_t) next;
100 typedef struct MonitorControl {
103 JSONMessageParser parser;
107 CharDriverState *chr;
112 uint8_t outbuf[1024];
117 BlockDriverCompletionFunc *password_completion_cb;
118 void *password_opaque;
120 QLIST_HEAD(,mon_fd_t) fds;
121 QLIST_ENTRY(Monitor) entry;
124 static QLIST_HEAD(mon_list, Monitor) mon_list;
126 static const mon_cmd_t mon_cmds[];
127 static const mon_cmd_t info_cmds[];
129 Monitor *cur_mon = NULL;
131 static void monitor_command_cb(Monitor *mon, const char *cmdline,
134 /* Return true if in control mode, false otherwise */
135 static inline int monitor_ctrl_mode(const Monitor *mon)
137 return (mon->flags & MONITOR_USE_CONTROL);
140 static void monitor_read_command(Monitor *mon, int show_prompt)
142 readline_start(mon->rs, "(qemu) ", 0, monitor_command_cb, NULL);
144 readline_show_prompt(mon->rs);
147 static int monitor_read_password(Monitor *mon, ReadLineFunc *readline_func,
151 readline_start(mon->rs, "Password: ", 1, readline_func, opaque);
152 /* prompt is printed on return from the command handler */
155 monitor_printf(mon, "terminal does not support password prompting\n");
160 void monitor_flush(Monitor *mon)
162 if (mon && mon->outbuf_index != 0 && !mon->mux_out) {
163 qemu_chr_write(mon->chr, mon->outbuf, mon->outbuf_index);
164 mon->outbuf_index = 0;
168 /* flush at every end of line or if the buffer is full */
169 static void monitor_puts(Monitor *mon, const char *str)
181 mon->outbuf[mon->outbuf_index++] = '\r';
182 mon->outbuf[mon->outbuf_index++] = c;
183 if (mon->outbuf_index >= (sizeof(mon->outbuf) - 1)
189 void monitor_vprintf(Monitor *mon, const char *fmt, va_list ap)
191 if (mon->mc && !mon->mc->print_enabled) {
192 qemu_error_new(QERR_UNDEFINED_ERROR);
195 vsnprintf(buf, sizeof(buf), fmt, ap);
196 monitor_puts(mon, buf);
200 void monitor_printf(Monitor *mon, const char *fmt, ...)
204 monitor_vprintf(mon, fmt, ap);
208 void monitor_print_filename(Monitor *mon, const char *filename)
212 for (i = 0; filename[i]; i++) {
213 switch (filename[i]) {
217 monitor_printf(mon, "\\%c", filename[i]);
220 monitor_printf(mon, "\\t");
223 monitor_printf(mon, "\\r");
226 monitor_printf(mon, "\\n");
229 monitor_printf(mon, "%c", filename[i]);
235 static int monitor_fprintf(FILE *stream, const char *fmt, ...)
239 monitor_vprintf((Monitor *)stream, fmt, ap);
244 static void monitor_user_noop(Monitor *mon, const QObject *data) { }
246 static inline int monitor_handler_ported(const mon_cmd_t *cmd)
248 return cmd->user_print != NULL;
251 static inline int monitor_has_error(const Monitor *mon)
253 return mon->error != NULL;
256 static void monitor_print_qobject(Monitor *mon, const QObject *data)
258 switch (qobject_type(data)) {
260 monitor_printf(mon, "%s",qstring_get_str(qobject_to_qstring(data)));
263 monitor_printf(mon, "%" PRId64,qint_get_int(qobject_to_qint(data)));
266 monitor_printf(mon, "ERROR: unsupported type: %d",
271 monitor_puts(mon, "\n");
274 static void monitor_json_emitter(Monitor *mon, const QObject *data)
278 json = qobject_to_json(data);
279 assert(json != NULL);
281 mon->mc->print_enabled = 1;
282 monitor_printf(mon, "%s\n", qstring_get_str(json));
283 mon->mc->print_enabled = 0;
288 static void monitor_protocol_emitter(Monitor *mon, QObject *data)
294 if (!monitor_has_error(mon)) {
295 /* success response */
297 qobject_incref(data);
298 qdict_put_obj(qmp, "return", data);
300 qdict_put(qmp, "return", qstring_from_str("OK"));
304 qdict_put(qmp, "error", mon->error->error);
305 QINCREF(mon->error->error);
311 qdict_put_obj(qmp, "id", mon->mc->id);
315 monitor_json_emitter(mon, QOBJECT(qmp));
319 static void timestamp_put(QDict *qdict)
325 err = gettimeofday(&tv, NULL);
329 obj = qobject_from_jsonf("{ 'seconds': %" PRId64 ", "
330 "'microseconds': %" PRId64 " }",
331 (int64_t) tv.tv_sec, (int64_t) tv.tv_usec);
334 qdict_put_obj(qdict, "timestamp", obj);
338 * monitor_protocol_event(): Generate a Monitor event
340 * Event-specific data can be emitted through the (optional) 'data' parameter.
342 void monitor_protocol_event(MonitorEvent event, QObject *data)
345 const char *event_name;
346 Monitor *mon = cur_mon;
348 assert(event < EVENT_MAX);
350 if (!monitor_ctrl_mode(mon))
355 event_name = "DEBUG";
358 event_name = "SHUTDOWN";
361 event_name = "RESET";
363 case EVENT_POWERDOWN:
364 event_name = "POWERDOWN";
376 qdict_put(qmp, "event", qstring_from_str(event_name));
378 qdict_put_obj(qmp, "data", data);
380 monitor_json_emitter(mon, QOBJECT(qmp));
384 static int compare_cmd(const char *name, const char *list)
386 const char *p, *pstart;
394 p = pstart + strlen(pstart);
395 if ((p - pstart) == len && !memcmp(pstart, name, len))
404 static void help_cmd_dump(Monitor *mon, const mon_cmd_t *cmds,
405 const char *prefix, const char *name)
407 const mon_cmd_t *cmd;
409 for(cmd = cmds; cmd->name != NULL; cmd++) {
410 if (!name || !strcmp(name, cmd->name))
411 monitor_printf(mon, "%s%s %s -- %s\n", prefix, cmd->name,
412 cmd->params, cmd->help);
416 static void help_cmd(Monitor *mon, const char *name)
418 if (name && !strcmp(name, "info")) {
419 help_cmd_dump(mon, info_cmds, "info ", NULL);
421 help_cmd_dump(mon, mon_cmds, "", name);
422 if (name && !strcmp(name, "log")) {
423 const CPULogItem *item;
424 monitor_printf(mon, "Log items (comma separated):\n");
425 monitor_printf(mon, "%-10s %s\n", "none", "remove all logs");
426 for(item = cpu_log_items; item->mask != 0; item++) {
427 monitor_printf(mon, "%-10s %s\n", item->name, item->help);
433 static void do_help_cmd(Monitor *mon, const QDict *qdict)
435 help_cmd(mon, qdict_get_try_str(qdict, "name"));
438 static void do_commit(Monitor *mon, const QDict *qdict)
442 const char *device = qdict_get_str(qdict, "device");
444 all_devices = !strcmp(device, "all");
445 QTAILQ_FOREACH(dinfo, &drives, next) {
447 if (strcmp(bdrv_get_device_name(dinfo->bdrv), device))
449 bdrv_commit(dinfo->bdrv);
453 static void do_info(Monitor *mon, const QDict *qdict, QObject **ret_data)
455 const mon_cmd_t *cmd;
456 const char *item = qdict_get_try_str(qdict, "item");
459 assert(monitor_ctrl_mode(mon) == 0);
463 for (cmd = info_cmds; cmd->name != NULL; cmd++) {
464 if (compare_cmd(item, cmd->name))
468 if (cmd->name == NULL) {
469 if (monitor_ctrl_mode(mon)) {
470 qemu_error_new(QERR_COMMAND_NOT_FOUND, item);
476 if (monitor_handler_ported(cmd)) {
477 cmd->mhandler.info_new(mon, ret_data);
479 if (!monitor_ctrl_mode(mon)) {
481 * User Protocol function is called here, Monitor Protocol is
482 * handled by monitor_call_handler()
485 cmd->user_print(mon, *ret_data);
488 if (monitor_ctrl_mode(mon)) {
489 /* handler not converted yet */
490 qemu_error_new(QERR_COMMAND_NOT_FOUND, item);
492 cmd->mhandler.info(mon);
499 help_cmd(mon, "info");
503 * do_info_version(): Show QEMU version
505 static void do_info_version(Monitor *mon, QObject **ret_data)
507 *ret_data = QOBJECT(qstring_from_str(QEMU_VERSION QEMU_PKGVERSION));
510 static void do_info_name(Monitor *mon)
513 monitor_printf(mon, "%s\n", qemu_name);
517 * do_info_commands(): List QMP available commands
519 * Return a QList of QStrings.
521 static void do_info_commands(Monitor *mon, QObject **ret_data)
524 const mon_cmd_t *cmd;
526 cmd_list = qlist_new();
528 for (cmd = mon_cmds; cmd->name != NULL; cmd++) {
529 if (monitor_handler_ported(cmd) && !compare_cmd(cmd->name, "info")) {
530 qlist_append(cmd_list, qstring_from_str(cmd->name));
534 for (cmd = info_cmds; cmd->name != NULL; cmd++) {
535 if (monitor_handler_ported(cmd)) {
537 snprintf(buf, sizeof(buf), "query-%s", cmd->name);
538 qlist_append(cmd_list, qstring_from_str(buf));
542 *ret_data = QOBJECT(cmd_list);
545 #if defined(TARGET_I386)
546 static void do_info_hpet(Monitor *mon)
548 monitor_printf(mon, "HPET is %s by QEMU\n",
549 (no_hpet) ? "disabled" : "enabled");
553 static void do_info_uuid(Monitor *mon)
555 monitor_printf(mon, UUID_FMT "\n", qemu_uuid[0], qemu_uuid[1],
556 qemu_uuid[2], qemu_uuid[3], qemu_uuid[4], qemu_uuid[5],
557 qemu_uuid[6], qemu_uuid[7], qemu_uuid[8], qemu_uuid[9],
558 qemu_uuid[10], qemu_uuid[11], qemu_uuid[12], qemu_uuid[13],
559 qemu_uuid[14], qemu_uuid[15]);
562 /* get the current CPU defined by the user */
563 static int mon_set_cpu(int cpu_index)
567 for(env = first_cpu; env != NULL; env = env->next_cpu) {
568 if (env->cpu_index == cpu_index) {
569 cur_mon->mon_cpu = env;
576 static CPUState *mon_get_cpu(void)
578 if (!cur_mon->mon_cpu) {
581 cpu_synchronize_state(cur_mon->mon_cpu);
582 return cur_mon->mon_cpu;
585 static void do_info_registers(Monitor *mon)
592 cpu_dump_state(env, (FILE *)mon, monitor_fprintf,
595 cpu_dump_state(env, (FILE *)mon, monitor_fprintf,
600 static void print_cpu_iter(QObject *obj, void *opaque)
604 Monitor *mon = opaque;
606 assert(qobject_type(obj) == QTYPE_QDICT);
607 cpu = qobject_to_qdict(obj);
609 if (strcmp(qdict_get_str(cpu, "current"), "yes") == 0)
612 monitor_printf(mon, "%c CPU #%d: ", active, (int)qdict_get_int(cpu, "CPU"));
614 #if defined(TARGET_I386)
615 monitor_printf(mon, "pc=0x" TARGET_FMT_lx,
616 (target_ulong) qdict_get_int(cpu, "pc"));
617 #elif defined(TARGET_PPC)
618 monitor_printf(mon, "nip=0x" TARGET_FMT_lx,
619 (target_long) qdict_get_int(cpu, "nip"));
620 #elif defined(TARGET_SPARC)
621 monitor_printf(mon, "pc=0x " TARGET_FMT_lx,
622 (target_long) qdict_get_int(cpu, "pc"));
623 monitor_printf(mon, "npc=0x" TARGET_FMT_lx,
624 (target_long) qdict_get_int(cpu, "npc"));
625 #elif defined(TARGET_MIPS)
626 monitor_printf(mon, "PC=0x" TARGET_FMT_lx,
627 (target_long) qdict_get_int(cpu, "PC"));
630 if (strcmp(qdict_get_str(cpu, "halted"), "yes") == 0)
631 monitor_printf(mon, " (halted)");
633 monitor_printf(mon, "\n");
636 static void monitor_print_cpus(Monitor *mon, const QObject *data)
640 assert(qobject_type(data) == QTYPE_QLIST);
641 cpu_list = qobject_to_qlist(data);
642 qlist_iter(cpu_list, print_cpu_iter, mon);
646 * do_info_cpus(): Show CPU information
648 * Return a QList with a QDict for each CPU.
652 * [ { "CPU": 0, "current": "yes", "pc": 0x..., "halted": "no" },
653 * { "CPU": 1, "current": "no", "pc": 0x..., "halted": "yes" } ]
655 static void do_info_cpus(Monitor *mon, QObject **ret_data)
660 cpu_list = qlist_new();
662 /* just to set the default cpu if not already done */
665 for(env = first_cpu; env != NULL; env = env->next_cpu) {
667 QDict *cpu = qdict_new();
669 cpu_synchronize_state(env);
671 qdict_put(cpu, "CPU", qint_from_int(env->cpu_index));
672 answer = (env == mon->mon_cpu) ? "yes" : "no";
673 qdict_put(cpu, "current", qstring_from_str(answer));
675 #if defined(TARGET_I386)
676 qdict_put(cpu, "pc", qint_from_int(env->eip + env->segs[R_CS].base));
677 #elif defined(TARGET_PPC)
678 qdict_put(cpu, "nip", qint_from_int(env->nip));
679 #elif defined(TARGET_SPARC)
680 qdict_put(cpu, "pc", qint_from_int(env->pc));
681 qdict_put(cpu, "npc", qint_from_int(env->npc));
682 #elif defined(TARGET_MIPS)
683 qdict_put(cpu, "PC", qint_from_int(env->active_tc.PC));
685 answer = env->halted ? "yes" : "no";
686 qdict_put(cpu, "halted", qstring_from_str(answer));
688 qlist_append(cpu_list, cpu);
691 *ret_data = QOBJECT(cpu_list);
694 static void do_cpu_set(Monitor *mon, const QDict *qdict)
696 int index = qdict_get_int(qdict, "index");
697 if (mon_set_cpu(index) < 0)
698 monitor_printf(mon, "Invalid CPU index\n");
701 static void do_info_jit(Monitor *mon)
703 dump_exec_info((FILE *)mon, monitor_fprintf);
706 static void do_info_history(Monitor *mon)
715 str = readline_get_history(mon->rs, i);
718 monitor_printf(mon, "%d: '%s'\n", i, str);
723 #if defined(TARGET_PPC)
724 /* XXX: not implemented in other targets */
725 static void do_info_cpu_stats(Monitor *mon)
730 cpu_dump_statistics(env, (FILE *)mon, &monitor_fprintf, 0);
735 * do_quit(): Quit QEMU execution
737 static void do_quit(Monitor *mon, const QDict *qdict, QObject **ret_data)
742 static int eject_device(Monitor *mon, BlockDriverState *bs, int force)
744 if (bdrv_is_inserted(bs)) {
746 if (!bdrv_is_removable(bs)) {
747 monitor_printf(mon, "device is not removable\n");
750 if (bdrv_is_locked(bs)) {
751 monitor_printf(mon, "device is locked\n");
760 static void do_eject(Monitor *mon, const QDict *qdict, QObject **ret_data)
762 BlockDriverState *bs;
763 int force = qdict_get_int(qdict, "force");
764 const char *filename = qdict_get_str(qdict, "filename");
766 bs = bdrv_find(filename);
768 monitor_printf(mon, "device not found\n");
771 eject_device(mon, bs, force);
774 static void do_change_block(Monitor *mon, const char *device,
775 const char *filename, const char *fmt)
777 BlockDriverState *bs;
778 BlockDriver *drv = NULL;
780 bs = bdrv_find(device);
782 monitor_printf(mon, "device not found\n");
786 drv = bdrv_find_whitelisted_format(fmt);
788 monitor_printf(mon, "invalid format %s\n", fmt);
792 if (eject_device(mon, bs, 0) < 0)
794 bdrv_open2(bs, filename, 0, drv);
795 monitor_read_bdrv_key_start(mon, bs, NULL, NULL);
798 static void change_vnc_password_cb(Monitor *mon, const char *password,
801 if (vnc_display_password(NULL, password) < 0)
802 monitor_printf(mon, "could not set VNC server password\n");
804 monitor_read_command(mon, 1);
807 static void do_change_vnc(Monitor *mon, const char *target, const char *arg)
809 if (strcmp(target, "passwd") == 0 ||
810 strcmp(target, "password") == 0) {
813 strncpy(password, arg, sizeof(password));
814 password[sizeof(password) - 1] = '\0';
815 change_vnc_password_cb(mon, password, NULL);
817 monitor_read_password(mon, change_vnc_password_cb, NULL);
820 if (vnc_display_open(NULL, target) < 0)
821 monitor_printf(mon, "could not start VNC server on %s\n", target);
825 static void do_change(Monitor *mon, const QDict *qdict)
827 const char *device = qdict_get_str(qdict, "device");
828 const char *target = qdict_get_str(qdict, "target");
829 const char *arg = qdict_get_try_str(qdict, "arg");
830 if (strcmp(device, "vnc") == 0) {
831 do_change_vnc(mon, target, arg);
833 do_change_block(mon, device, target, arg);
837 static void do_screen_dump(Monitor *mon, const QDict *qdict)
839 vga_hw_screen_dump(qdict_get_str(qdict, "filename"));
842 static void do_logfile(Monitor *mon, const QDict *qdict)
844 cpu_set_log_filename(qdict_get_str(qdict, "filename"));
847 static void do_log(Monitor *mon, const QDict *qdict)
850 const char *items = qdict_get_str(qdict, "items");
852 if (!strcmp(items, "none")) {
855 mask = cpu_str_to_log_mask(items);
857 help_cmd(mon, "log");
864 static void do_singlestep(Monitor *mon, const QDict *qdict)
866 const char *option = qdict_get_try_str(qdict, "option");
867 if (!option || !strcmp(option, "on")) {
869 } else if (!strcmp(option, "off")) {
872 monitor_printf(mon, "unexpected option %s\n", option);
877 * do_stop(): Stop VM execution
879 static void do_stop(Monitor *mon, const QDict *qdict, QObject **ret_data)
881 vm_stop(EXCP_INTERRUPT);
884 static void encrypted_bdrv_it(void *opaque, BlockDriverState *bs);
886 struct bdrv_iterate_context {
892 * do_cont(): Resume emulation.
894 static void do_cont(Monitor *mon, const QDict *qdict, QObject **ret_data)
896 struct bdrv_iterate_context context = { mon, 0 };
898 bdrv_iterate(encrypted_bdrv_it, &context);
899 /* only resume the vm if all keys are set and valid */
904 static void bdrv_key_cb(void *opaque, int err)
906 Monitor *mon = opaque;
908 /* another key was set successfully, retry to continue */
910 do_cont(mon, NULL, NULL);
913 static void encrypted_bdrv_it(void *opaque, BlockDriverState *bs)
915 struct bdrv_iterate_context *context = opaque;
917 if (!context->err && bdrv_key_required(bs)) {
918 context->err = -EBUSY;
919 monitor_read_bdrv_key_start(context->mon, bs, bdrv_key_cb,
924 static void do_gdbserver(Monitor *mon, const QDict *qdict)
926 const char *device = qdict_get_try_str(qdict, "device");
928 device = "tcp::" DEFAULT_GDBSTUB_PORT;
929 if (gdbserver_start(device) < 0) {
930 monitor_printf(mon, "Could not open gdbserver on device '%s'\n",
932 } else if (strcmp(device, "none") == 0) {
933 monitor_printf(mon, "Disabled gdbserver\n");
935 monitor_printf(mon, "Waiting for gdb connection on device '%s'\n",
940 static void do_watchdog_action(Monitor *mon, const QDict *qdict)
942 const char *action = qdict_get_str(qdict, "action");
943 if (select_watchdog_action(action) == -1) {
944 monitor_printf(mon, "Unknown watchdog action '%s'\n", action);
948 static void monitor_printc(Monitor *mon, int c)
950 monitor_printf(mon, "'");
953 monitor_printf(mon, "\\'");
956 monitor_printf(mon, "\\\\");
959 monitor_printf(mon, "\\n");
962 monitor_printf(mon, "\\r");
965 if (c >= 32 && c <= 126) {
966 monitor_printf(mon, "%c", c);
968 monitor_printf(mon, "\\x%02x", c);
972 monitor_printf(mon, "'");
975 static void memory_dump(Monitor *mon, int count, int format, int wsize,
976 target_phys_addr_t addr, int is_physical)
979 int nb_per_line, l, line_size, i, max_digits, len;
987 if (!env && !is_physical)
992 } else if (wsize == 4) {
995 /* as default we use the current CS size */
999 if ((env->efer & MSR_EFER_LMA) &&
1000 (env->segs[R_CS].flags & DESC_L_MASK))
1004 if (!(env->segs[R_CS].flags & DESC_B_MASK))
1009 monitor_disas(mon, env, addr, count, is_physical, flags);
1013 len = wsize * count;
1018 nb_per_line = line_size / wsize;
1023 max_digits = (wsize * 8 + 2) / 3;
1027 max_digits = (wsize * 8) / 4;
1031 max_digits = (wsize * 8 * 10 + 32) / 33;
1040 monitor_printf(mon, TARGET_FMT_plx ":", addr);
1042 monitor_printf(mon, TARGET_FMT_lx ":", (target_ulong)addr);
1047 cpu_physical_memory_rw(addr, buf, l, 0);
1049 env = mon_get_cpu();
1052 if (cpu_memory_rw_debug(env, addr, buf, l, 0) < 0) {
1053 monitor_printf(mon, " Cannot access memory\n");
1062 v = ldub_raw(buf + i);
1065 v = lduw_raw(buf + i);
1068 v = (uint32_t)ldl_raw(buf + i);
1071 v = ldq_raw(buf + i);
1074 monitor_printf(mon, " ");
1077 monitor_printf(mon, "%#*" PRIo64, max_digits, v);
1080 monitor_printf(mon, "0x%0*" PRIx64, max_digits, v);
1083 monitor_printf(mon, "%*" PRIu64, max_digits, v);
1086 monitor_printf(mon, "%*" PRId64, max_digits, v);
1089 monitor_printc(mon, v);
1094 monitor_printf(mon, "\n");
1100 static void do_memory_dump(Monitor *mon, const QDict *qdict)
1102 int count = qdict_get_int(qdict, "count");
1103 int format = qdict_get_int(qdict, "format");
1104 int size = qdict_get_int(qdict, "size");
1105 target_long addr = qdict_get_int(qdict, "addr");
1107 memory_dump(mon, count, format, size, addr, 0);
1110 static void do_physical_memory_dump(Monitor *mon, const QDict *qdict)
1112 int count = qdict_get_int(qdict, "count");
1113 int format = qdict_get_int(qdict, "format");
1114 int size = qdict_get_int(qdict, "size");
1115 target_phys_addr_t addr = qdict_get_int(qdict, "addr");
1117 memory_dump(mon, count, format, size, addr, 1);
1120 static void do_print(Monitor *mon, const QDict *qdict)
1122 int format = qdict_get_int(qdict, "format");
1123 target_phys_addr_t val = qdict_get_int(qdict, "val");
1125 #if TARGET_PHYS_ADDR_BITS == 32
1128 monitor_printf(mon, "%#o", val);
1131 monitor_printf(mon, "%#x", val);
1134 monitor_printf(mon, "%u", val);
1138 monitor_printf(mon, "%d", val);
1141 monitor_printc(mon, val);
1147 monitor_printf(mon, "%#" PRIo64, val);
1150 monitor_printf(mon, "%#" PRIx64, val);
1153 monitor_printf(mon, "%" PRIu64, val);
1157 monitor_printf(mon, "%" PRId64, val);
1160 monitor_printc(mon, val);
1164 monitor_printf(mon, "\n");
1167 static void do_memory_save(Monitor *mon, const QDict *qdict, QObject **ret_data)
1170 uint32_t size = qdict_get_int(qdict, "size");
1171 const char *filename = qdict_get_str(qdict, "filename");
1172 target_long addr = qdict_get_int(qdict, "val");
1177 env = mon_get_cpu();
1181 f = fopen(filename, "wb");
1183 monitor_printf(mon, "could not open '%s'\n", filename);
1190 cpu_memory_rw_debug(env, addr, buf, l, 0);
1191 fwrite(buf, 1, l, f);
1198 static void do_physical_memory_save(Monitor *mon, const QDict *qdict,
1204 uint32_t size = qdict_get_int(qdict, "size");
1205 const char *filename = qdict_get_str(qdict, "filename");
1206 target_phys_addr_t addr = qdict_get_int(qdict, "val");
1208 f = fopen(filename, "wb");
1210 monitor_printf(mon, "could not open '%s'\n", filename);
1217 cpu_physical_memory_rw(addr, buf, l, 0);
1218 fwrite(buf, 1, l, f);
1226 static void do_sum(Monitor *mon, const QDict *qdict)
1231 uint32_t start = qdict_get_int(qdict, "start");
1232 uint32_t size = qdict_get_int(qdict, "size");
1235 for(addr = start; addr < (start + size); addr++) {
1236 cpu_physical_memory_rw(addr, buf, 1, 0);
1237 /* BSD sum algorithm ('sum' Unix command) */
1238 sum = (sum >> 1) | (sum << 15);
1241 monitor_printf(mon, "%05d\n", sum);
1249 static const KeyDef key_defs[] = {
1251 { 0x36, "shift_r" },
1256 { 0xe4, "altgr_r" },
1276 { 0x0e, "backspace" },
1313 { 0x37, "asterisk" },
1316 { 0x3a, "caps_lock" },
1327 { 0x45, "num_lock" },
1328 { 0x46, "scroll_lock" },
1330 { 0xb5, "kp_divide" },
1331 { 0x37, "kp_multiply" },
1332 { 0x4a, "kp_subtract" },
1334 { 0x9c, "kp_enter" },
1335 { 0x53, "kp_decimal" },
1368 #if defined(TARGET_SPARC) && !defined(TARGET_SPARC64)
1383 { 0xfe, "compose" },
1388 static int get_keycode(const char *key)
1394 for(p = key_defs; p->name != NULL; p++) {
1395 if (!strcmp(key, p->name))
1398 if (strstart(key, "0x", NULL)) {
1399 ret = strtoul(key, &endp, 0);
1400 if (*endp == '\0' && ret >= 0x01 && ret <= 0xff)
1406 #define MAX_KEYCODES 16
1407 static uint8_t keycodes[MAX_KEYCODES];
1408 static int nb_pending_keycodes;
1409 static QEMUTimer *key_timer;
1411 static void release_keys(void *opaque)
1415 while (nb_pending_keycodes > 0) {
1416 nb_pending_keycodes--;
1417 keycode = keycodes[nb_pending_keycodes];
1419 kbd_put_keycode(0xe0);
1420 kbd_put_keycode(keycode | 0x80);
1424 static void do_sendkey(Monitor *mon, const QDict *qdict)
1426 char keyname_buf[16];
1428 int keyname_len, keycode, i;
1429 const char *string = qdict_get_str(qdict, "string");
1430 int has_hold_time = qdict_haskey(qdict, "hold_time");
1431 int hold_time = qdict_get_try_int(qdict, "hold_time", -1);
1433 if (nb_pending_keycodes > 0) {
1434 qemu_del_timer(key_timer);
1441 separator = strchr(string, '-');
1442 keyname_len = separator ? separator - string : strlen(string);
1443 if (keyname_len > 0) {
1444 pstrcpy(keyname_buf, sizeof(keyname_buf), string);
1445 if (keyname_len > sizeof(keyname_buf) - 1) {
1446 monitor_printf(mon, "invalid key: '%s...'\n", keyname_buf);
1449 if (i == MAX_KEYCODES) {
1450 monitor_printf(mon, "too many keys\n");
1453 keyname_buf[keyname_len] = 0;
1454 keycode = get_keycode(keyname_buf);
1456 monitor_printf(mon, "unknown key: '%s'\n", keyname_buf);
1459 keycodes[i++] = keycode;
1463 string = separator + 1;
1465 nb_pending_keycodes = i;
1466 /* key down events */
1467 for (i = 0; i < nb_pending_keycodes; i++) {
1468 keycode = keycodes[i];
1470 kbd_put_keycode(0xe0);
1471 kbd_put_keycode(keycode & 0x7f);
1473 /* delayed key up events */
1474 qemu_mod_timer(key_timer, qemu_get_clock(vm_clock) +
1475 muldiv64(get_ticks_per_sec(), hold_time, 1000));
1478 static int mouse_button_state;
1480 static void do_mouse_move(Monitor *mon, const QDict *qdict)
1483 const char *dx_str = qdict_get_str(qdict, "dx_str");
1484 const char *dy_str = qdict_get_str(qdict, "dy_str");
1485 const char *dz_str = qdict_get_try_str(qdict, "dz_str");
1486 dx = strtol(dx_str, NULL, 0);
1487 dy = strtol(dy_str, NULL, 0);
1490 dz = strtol(dz_str, NULL, 0);
1491 kbd_mouse_event(dx, dy, dz, mouse_button_state);
1494 static void do_mouse_button(Monitor *mon, const QDict *qdict)
1496 int button_state = qdict_get_int(qdict, "button_state");
1497 mouse_button_state = button_state;
1498 kbd_mouse_event(0, 0, 0, mouse_button_state);
1501 static void do_ioport_read(Monitor *mon, const QDict *qdict)
1503 int size = qdict_get_int(qdict, "size");
1504 int addr = qdict_get_int(qdict, "addr");
1505 int has_index = qdict_haskey(qdict, "index");
1510 int index = qdict_get_int(qdict, "index");
1511 cpu_outb(addr & IOPORTS_MASK, index & 0xff);
1519 val = cpu_inb(addr);
1523 val = cpu_inw(addr);
1527 val = cpu_inl(addr);
1531 monitor_printf(mon, "port%c[0x%04x] = %#0*x\n",
1532 suffix, addr, size * 2, val);
1535 static void do_ioport_write(Monitor *mon, const QDict *qdict)
1537 int size = qdict_get_int(qdict, "size");
1538 int addr = qdict_get_int(qdict, "addr");
1539 int val = qdict_get_int(qdict, "val");
1541 addr &= IOPORTS_MASK;
1546 cpu_outb(addr, val);
1549 cpu_outw(addr, val);
1552 cpu_outl(addr, val);
1557 static void do_boot_set(Monitor *mon, const QDict *qdict)
1560 const char *bootdevice = qdict_get_str(qdict, "bootdevice");
1562 res = qemu_boot_set(bootdevice);
1564 monitor_printf(mon, "boot device list now set to %s\n", bootdevice);
1565 } else if (res > 0) {
1566 monitor_printf(mon, "setting boot device list failed\n");
1568 monitor_printf(mon, "no function defined to set boot device list for "
1569 "this architecture\n");
1574 * do_system_reset(): Issue a machine reset
1576 static void do_system_reset(Monitor *mon, const QDict *qdict,
1579 qemu_system_reset_request();
1583 * do_system_powerdown(): Issue a machine powerdown
1585 static void do_system_powerdown(Monitor *mon, const QDict *qdict,
1588 qemu_system_powerdown_request();
1591 #if defined(TARGET_I386)
1592 static void print_pte(Monitor *mon, uint32_t addr, uint32_t pte, uint32_t mask)
1594 monitor_printf(mon, "%08x: %08x %c%c%c%c%c%c%c%c\n",
1597 pte & PG_GLOBAL_MASK ? 'G' : '-',
1598 pte & PG_PSE_MASK ? 'P' : '-',
1599 pte & PG_DIRTY_MASK ? 'D' : '-',
1600 pte & PG_ACCESSED_MASK ? 'A' : '-',
1601 pte & PG_PCD_MASK ? 'C' : '-',
1602 pte & PG_PWT_MASK ? 'T' : '-',
1603 pte & PG_USER_MASK ? 'U' : '-',
1604 pte & PG_RW_MASK ? 'W' : '-');
1607 static void tlb_info(Monitor *mon)
1611 uint32_t pgd, pde, pte;
1613 env = mon_get_cpu();
1617 if (!(env->cr[0] & CR0_PG_MASK)) {
1618 monitor_printf(mon, "PG disabled\n");
1621 pgd = env->cr[3] & ~0xfff;
1622 for(l1 = 0; l1 < 1024; l1++) {
1623 cpu_physical_memory_read(pgd + l1 * 4, (uint8_t *)&pde, 4);
1624 pde = le32_to_cpu(pde);
1625 if (pde & PG_PRESENT_MASK) {
1626 if ((pde & PG_PSE_MASK) && (env->cr[4] & CR4_PSE_MASK)) {
1627 print_pte(mon, (l1 << 22), pde, ~((1 << 20) - 1));
1629 for(l2 = 0; l2 < 1024; l2++) {
1630 cpu_physical_memory_read((pde & ~0xfff) + l2 * 4,
1631 (uint8_t *)&pte, 4);
1632 pte = le32_to_cpu(pte);
1633 if (pte & PG_PRESENT_MASK) {
1634 print_pte(mon, (l1 << 22) + (l2 << 12),
1644 static void mem_print(Monitor *mon, uint32_t *pstart, int *plast_prot,
1645 uint32_t end, int prot)
1648 prot1 = *plast_prot;
1649 if (prot != prot1) {
1650 if (*pstart != -1) {
1651 monitor_printf(mon, "%08x-%08x %08x %c%c%c\n",
1652 *pstart, end, end - *pstart,
1653 prot1 & PG_USER_MASK ? 'u' : '-',
1655 prot1 & PG_RW_MASK ? 'w' : '-');
1665 static void mem_info(Monitor *mon)
1668 int l1, l2, prot, last_prot;
1669 uint32_t pgd, pde, pte, start, end;
1671 env = mon_get_cpu();
1675 if (!(env->cr[0] & CR0_PG_MASK)) {
1676 monitor_printf(mon, "PG disabled\n");
1679 pgd = env->cr[3] & ~0xfff;
1682 for(l1 = 0; l1 < 1024; l1++) {
1683 cpu_physical_memory_read(pgd + l1 * 4, (uint8_t *)&pde, 4);
1684 pde = le32_to_cpu(pde);
1686 if (pde & PG_PRESENT_MASK) {
1687 if ((pde & PG_PSE_MASK) && (env->cr[4] & CR4_PSE_MASK)) {
1688 prot = pde & (PG_USER_MASK | PG_RW_MASK | PG_PRESENT_MASK);
1689 mem_print(mon, &start, &last_prot, end, prot);
1691 for(l2 = 0; l2 < 1024; l2++) {
1692 cpu_physical_memory_read((pde & ~0xfff) + l2 * 4,
1693 (uint8_t *)&pte, 4);
1694 pte = le32_to_cpu(pte);
1695 end = (l1 << 22) + (l2 << 12);
1696 if (pte & PG_PRESENT_MASK) {
1697 prot = pte & (PG_USER_MASK | PG_RW_MASK | PG_PRESENT_MASK);
1701 mem_print(mon, &start, &last_prot, end, prot);
1706 mem_print(mon, &start, &last_prot, end, prot);
1712 #if defined(TARGET_SH4)
1714 static void print_tlb(Monitor *mon, int idx, tlb_t *tlb)
1716 monitor_printf(mon, " tlb%i:\t"
1717 "asid=%hhu vpn=%x\tppn=%x\tsz=%hhu size=%u\t"
1718 "v=%hhu shared=%hhu cached=%hhu prot=%hhu "
1719 "dirty=%hhu writethrough=%hhu\n",
1721 tlb->asid, tlb->vpn, tlb->ppn, tlb->sz, tlb->size,
1722 tlb->v, tlb->sh, tlb->c, tlb->pr,
1726 static void tlb_info(Monitor *mon)
1728 CPUState *env = mon_get_cpu();
1731 monitor_printf (mon, "ITLB:\n");
1732 for (i = 0 ; i < ITLB_SIZE ; i++)
1733 print_tlb (mon, i, &env->itlb[i]);
1734 monitor_printf (mon, "UTLB:\n");
1735 for (i = 0 ; i < UTLB_SIZE ; i++)
1736 print_tlb (mon, i, &env->utlb[i]);
1741 static void do_info_kvm(Monitor *mon)
1744 monitor_printf(mon, "kvm support: ");
1746 monitor_printf(mon, "enabled\n");
1748 monitor_printf(mon, "disabled\n");
1750 monitor_printf(mon, "kvm support: not compiled\n");
1754 static void do_info_numa(Monitor *mon)
1759 monitor_printf(mon, "%d nodes\n", nb_numa_nodes);
1760 for (i = 0; i < nb_numa_nodes; i++) {
1761 monitor_printf(mon, "node %d cpus:", i);
1762 for (env = first_cpu; env != NULL; env = env->next_cpu) {
1763 if (env->numa_node == i) {
1764 monitor_printf(mon, " %d", env->cpu_index);
1767 monitor_printf(mon, "\n");
1768 monitor_printf(mon, "node %d size: %" PRId64 " MB\n", i,
1773 #ifdef CONFIG_PROFILER
1778 static void do_info_profile(Monitor *mon)
1784 monitor_printf(mon, "async time %" PRId64 " (%0.3f)\n",
1785 dev_time, dev_time / (double)get_ticks_per_sec());
1786 monitor_printf(mon, "qemu time %" PRId64 " (%0.3f)\n",
1787 qemu_time, qemu_time / (double)get_ticks_per_sec());
1792 static void do_info_profile(Monitor *mon)
1794 monitor_printf(mon, "Internal profiler not compiled\n");
1798 /* Capture support */
1799 static QLIST_HEAD (capture_list_head, CaptureState) capture_head;
1801 static void do_info_capture(Monitor *mon)
1806 for (s = capture_head.lh_first, i = 0; s; s = s->entries.le_next, ++i) {
1807 monitor_printf(mon, "[%d]: ", i);
1808 s->ops.info (s->opaque);
1813 static void do_stop_capture(Monitor *mon, const QDict *qdict)
1816 int n = qdict_get_int(qdict, "n");
1819 for (s = capture_head.lh_first, i = 0; s; s = s->entries.le_next, ++i) {
1821 s->ops.destroy (s->opaque);
1822 QLIST_REMOVE (s, entries);
1829 static void do_wav_capture(Monitor *mon, const QDict *qdict)
1831 const char *path = qdict_get_str(qdict, "path");
1832 int has_freq = qdict_haskey(qdict, "freq");
1833 int freq = qdict_get_try_int(qdict, "freq", -1);
1834 int has_bits = qdict_haskey(qdict, "bits");
1835 int bits = qdict_get_try_int(qdict, "bits", -1);
1836 int has_channels = qdict_haskey(qdict, "nchannels");
1837 int nchannels = qdict_get_try_int(qdict, "nchannels", -1);
1840 s = qemu_mallocz (sizeof (*s));
1842 freq = has_freq ? freq : 44100;
1843 bits = has_bits ? bits : 16;
1844 nchannels = has_channels ? nchannels : 2;
1846 if (wav_start_capture (s, path, freq, bits, nchannels)) {
1847 monitor_printf(mon, "Faied to add wave capture\n");
1850 QLIST_INSERT_HEAD (&capture_head, s, entries);
1854 #if defined(TARGET_I386)
1855 static void do_inject_nmi(Monitor *mon, const QDict *qdict)
1858 int cpu_index = qdict_get_int(qdict, "cpu_index");
1860 for (env = first_cpu; env != NULL; env = env->next_cpu)
1861 if (env->cpu_index == cpu_index) {
1862 cpu_interrupt(env, CPU_INTERRUPT_NMI);
1868 static void do_info_status(Monitor *mon)
1872 monitor_printf(mon, "VM status: running (single step mode)\n");
1874 monitor_printf(mon, "VM status: running\n");
1877 monitor_printf(mon, "VM status: paused\n");
1881 * do_balloon(): Request VM to change its memory allocation
1883 static void do_balloon(Monitor *mon, const QDict *qdict, QObject **ret_data)
1885 int value = qdict_get_int(qdict, "value");
1886 ram_addr_t target = value;
1887 qemu_balloon(target << 20);
1890 static void monitor_print_balloon(Monitor *mon, const QObject *data)
1892 monitor_printf(mon, "balloon: actual=%d\n",
1893 (int)qint_get_int(qobject_to_qint(data)));
1897 * do_info_balloon(): Balloon information
1899 static void do_info_balloon(Monitor *mon, QObject **ret_data)
1903 actual = qemu_balloon_status();
1904 if (kvm_enabled() && !kvm_has_sync_mmu())
1905 qemu_error_new(QERR_KVM_MISSING_CAP, "synchronous MMU", "balloon");
1906 else if (actual == 0)
1907 qemu_error_new(QERR_DEVICE_NOT_ACTIVE, "balloon");
1909 *ret_data = QOBJECT(qint_from_int((int)(actual >> 20)));
1912 static qemu_acl *find_acl(Monitor *mon, const char *name)
1914 qemu_acl *acl = qemu_acl_find(name);
1917 monitor_printf(mon, "acl: unknown list '%s'\n", name);
1922 static void do_acl_show(Monitor *mon, const QDict *qdict)
1924 const char *aclname = qdict_get_str(qdict, "aclname");
1925 qemu_acl *acl = find_acl(mon, aclname);
1926 qemu_acl_entry *entry;
1930 monitor_printf(mon, "policy: %s\n",
1931 acl->defaultDeny ? "deny" : "allow");
1932 QTAILQ_FOREACH(entry, &acl->entries, next) {
1934 monitor_printf(mon, "%d: %s %s\n", i,
1935 entry->deny ? "deny" : "allow", entry->match);
1940 static void do_acl_reset(Monitor *mon, const QDict *qdict)
1942 const char *aclname = qdict_get_str(qdict, "aclname");
1943 qemu_acl *acl = find_acl(mon, aclname);
1946 qemu_acl_reset(acl);
1947 monitor_printf(mon, "acl: removed all rules\n");
1951 static void do_acl_policy(Monitor *mon, const QDict *qdict)
1953 const char *aclname = qdict_get_str(qdict, "aclname");
1954 const char *policy = qdict_get_str(qdict, "policy");
1955 qemu_acl *acl = find_acl(mon, aclname);
1958 if (strcmp(policy, "allow") == 0) {
1959 acl->defaultDeny = 0;
1960 monitor_printf(mon, "acl: policy set to 'allow'\n");
1961 } else if (strcmp(policy, "deny") == 0) {
1962 acl->defaultDeny = 1;
1963 monitor_printf(mon, "acl: policy set to 'deny'\n");
1965 monitor_printf(mon, "acl: unknown policy '%s', "
1966 "expected 'deny' or 'allow'\n", policy);
1971 static void do_acl_add(Monitor *mon, const QDict *qdict)
1973 const char *aclname = qdict_get_str(qdict, "aclname");
1974 const char *match = qdict_get_str(qdict, "match");
1975 const char *policy = qdict_get_str(qdict, "policy");
1976 int has_index = qdict_haskey(qdict, "index");
1977 int index = qdict_get_try_int(qdict, "index", -1);
1978 qemu_acl *acl = find_acl(mon, aclname);
1982 if (strcmp(policy, "allow") == 0) {
1984 } else if (strcmp(policy, "deny") == 0) {
1987 monitor_printf(mon, "acl: unknown policy '%s', "
1988 "expected 'deny' or 'allow'\n", policy);
1992 ret = qemu_acl_insert(acl, deny, match, index);
1994 ret = qemu_acl_append(acl, deny, match);
1996 monitor_printf(mon, "acl: unable to add acl entry\n");
1998 monitor_printf(mon, "acl: added rule at position %d\n", ret);
2002 static void do_acl_remove(Monitor *mon, const QDict *qdict)
2004 const char *aclname = qdict_get_str(qdict, "aclname");
2005 const char *match = qdict_get_str(qdict, "match");
2006 qemu_acl *acl = find_acl(mon, aclname);
2010 ret = qemu_acl_remove(acl, match);
2012 monitor_printf(mon, "acl: no matching acl entry\n");
2014 monitor_printf(mon, "acl: removed rule at position %d\n", ret);
2018 #if defined(TARGET_I386)
2019 static void do_inject_mce(Monitor *mon, const QDict *qdict)
2022 int cpu_index = qdict_get_int(qdict, "cpu_index");
2023 int bank = qdict_get_int(qdict, "bank");
2024 uint64_t status = qdict_get_int(qdict, "status");
2025 uint64_t mcg_status = qdict_get_int(qdict, "mcg_status");
2026 uint64_t addr = qdict_get_int(qdict, "addr");
2027 uint64_t misc = qdict_get_int(qdict, "misc");
2029 for (cenv = first_cpu; cenv != NULL; cenv = cenv->next_cpu)
2030 if (cenv->cpu_index == cpu_index && cenv->mcg_cap) {
2031 cpu_inject_x86_mce(cenv, bank, status, mcg_status, addr, misc);
2037 static void do_getfd(Monitor *mon, const QDict *qdict, QObject **ret_data)
2039 const char *fdname = qdict_get_str(qdict, "fdname");
2043 fd = qemu_chr_get_msgfd(mon->chr);
2045 monitor_printf(mon, "getfd: no file descriptor supplied via SCM_RIGHTS\n");
2049 if (qemu_isdigit(fdname[0])) {
2050 monitor_printf(mon, "getfd: monitor names may not begin with a number\n");
2056 monitor_printf(mon, "Failed to dup() file descriptor: %s\n",
2061 QLIST_FOREACH(monfd, &mon->fds, next) {
2062 if (strcmp(monfd->name, fdname) != 0) {
2071 monfd = qemu_mallocz(sizeof(mon_fd_t));
2072 monfd->name = qemu_strdup(fdname);
2075 QLIST_INSERT_HEAD(&mon->fds, monfd, next);
2078 static void do_closefd(Monitor *mon, const QDict *qdict, QObject **ret_data)
2080 const char *fdname = qdict_get_str(qdict, "fdname");
2083 QLIST_FOREACH(monfd, &mon->fds, next) {
2084 if (strcmp(monfd->name, fdname) != 0) {
2088 QLIST_REMOVE(monfd, next);
2090 qemu_free(monfd->name);
2095 monitor_printf(mon, "Failed to find file descriptor named %s\n",
2099 static void do_loadvm(Monitor *mon, const QDict *qdict)
2101 int saved_vm_running = vm_running;
2102 const char *name = qdict_get_str(qdict, "name");
2106 if (load_vmstate(mon, name) >= 0 && saved_vm_running)
2110 int monitor_get_fd(Monitor *mon, const char *fdname)
2114 QLIST_FOREACH(monfd, &mon->fds, next) {
2117 if (strcmp(monfd->name, fdname) != 0) {
2123 /* caller takes ownership of fd */
2124 QLIST_REMOVE(monfd, next);
2125 qemu_free(monfd->name);
2134 static const mon_cmd_t mon_cmds[] = {
2135 #include "qemu-monitor.h"
2139 /* Please update qemu-monitor.hx when adding or changing commands */
2140 static const mon_cmd_t info_cmds[] = {
2145 .help = "show the version of QEMU",
2146 .user_print = monitor_print_qobject,
2147 .mhandler.info_new = do_info_version,
2153 .help = "list QMP available commands",
2154 .user_print = monitor_user_noop,
2155 .mhandler.info_new = do_info_commands,
2161 .help = "show the network state",
2162 .mhandler.info = do_info_network,
2168 .help = "show the character devices",
2169 .mhandler.info = qemu_chr_info,
2175 .help = "show the block devices",
2176 .mhandler.info = bdrv_info,
2179 .name = "blockstats",
2182 .help = "show block device statistics",
2183 .mhandler.info = bdrv_info_stats,
2186 .name = "registers",
2189 .help = "show the cpu registers",
2190 .mhandler.info = do_info_registers,
2196 .help = "show infos for each CPU",
2197 .user_print = monitor_print_cpus,
2198 .mhandler.info_new = do_info_cpus,
2204 .help = "show the command line history",
2205 .mhandler.info = do_info_history,
2211 .help = "show the interrupts statistics (if available)",
2212 .mhandler.info = irq_info,
2218 .help = "show i8259 (PIC) state",
2219 .mhandler.info = pic_info,
2225 .help = "show PCI info",
2226 .mhandler.info = pci_info,
2228 #if defined(TARGET_I386) || defined(TARGET_SH4)
2233 .help = "show virtual to physical memory mappings",
2234 .mhandler.info = tlb_info,
2237 #if defined(TARGET_I386)
2242 .help = "show the active virtual memory mappings",
2243 .mhandler.info = mem_info,
2249 .help = "show state of HPET",
2250 .mhandler.info = do_info_hpet,
2257 .help = "show dynamic compiler info",
2258 .mhandler.info = do_info_jit,
2264 .help = "show KVM information",
2265 .mhandler.info = do_info_kvm,
2271 .help = "show NUMA information",
2272 .mhandler.info = do_info_numa,
2278 .help = "show guest USB devices",
2279 .mhandler.info = usb_info,
2285 .help = "show host USB devices",
2286 .mhandler.info = usb_host_info,
2292 .help = "show profiling information",
2293 .mhandler.info = do_info_profile,
2299 .help = "show capture information",
2300 .mhandler.info = do_info_capture,
2303 .name = "snapshots",
2306 .help = "show the currently saved VM snapshots",
2307 .mhandler.info = do_info_snapshots,
2313 .help = "show the current VM status (running|paused)",
2314 .mhandler.info = do_info_status,
2320 .help = "show guest PCMCIA status",
2321 .mhandler.info = pcmcia_info,
2327 .help = "show which guest mouse is receiving events",
2328 .mhandler.info = do_info_mice,
2334 .help = "show the vnc server status",
2335 .mhandler.info = do_info_vnc,
2341 .help = "show the current VM name",
2342 .mhandler.info = do_info_name,
2348 .help = "show the current VM UUID",
2349 .mhandler.info = do_info_uuid,
2351 #if defined(TARGET_PPC)
2356 .help = "show CPU statistics",
2357 .mhandler.info = do_info_cpu_stats,
2360 #if defined(CONFIG_SLIRP)
2365 .help = "show user network stack connection states",
2366 .mhandler.info = do_info_usernet,
2373 .help = "show migration status",
2374 .mhandler.info = do_info_migrate,
2380 .help = "show balloon information",
2381 .user_print = monitor_print_balloon,
2382 .mhandler.info_new = do_info_balloon,
2388 .help = "show device tree",
2389 .mhandler.info = do_info_qtree,
2395 .help = "show qdev device model list",
2396 .mhandler.info = do_info_qdm,
2402 .help = "show roms",
2403 .mhandler.info = do_info_roms,
2410 /*******************************************************************/
2412 static const char *pch;
2413 static jmp_buf expr_env;
2418 typedef struct MonitorDef {
2421 target_long (*get_value)(const struct MonitorDef *md, int val);
2425 #if defined(TARGET_I386)
2426 static target_long monitor_get_pc (const struct MonitorDef *md, int val)
2428 CPUState *env = mon_get_cpu();
2431 return env->eip + env->segs[R_CS].base;
2435 #if defined(TARGET_PPC)
2436 static target_long monitor_get_ccr (const struct MonitorDef *md, int val)
2438 CPUState *env = mon_get_cpu();
2446 for (i = 0; i < 8; i++)
2447 u |= env->crf[i] << (32 - (4 * i));
2452 static target_long monitor_get_msr (const struct MonitorDef *md, int val)
2454 CPUState *env = mon_get_cpu();
2460 static target_long monitor_get_xer (const struct MonitorDef *md, int val)
2462 CPUState *env = mon_get_cpu();
2468 static target_long monitor_get_decr (const struct MonitorDef *md, int val)
2470 CPUState *env = mon_get_cpu();
2473 return cpu_ppc_load_decr(env);
2476 static target_long monitor_get_tbu (const struct MonitorDef *md, int val)
2478 CPUState *env = mon_get_cpu();
2481 return cpu_ppc_load_tbu(env);
2484 static target_long monitor_get_tbl (const struct MonitorDef *md, int val)
2486 CPUState *env = mon_get_cpu();
2489 return cpu_ppc_load_tbl(env);
2493 #if defined(TARGET_SPARC)
2494 #ifndef TARGET_SPARC64
2495 static target_long monitor_get_psr (const struct MonitorDef *md, int val)
2497 CPUState *env = mon_get_cpu();
2500 return GET_PSR(env);
2504 static target_long monitor_get_reg(const struct MonitorDef *md, int val)
2506 CPUState *env = mon_get_cpu();
2509 return env->regwptr[val];
2513 static const MonitorDef monitor_defs[] = {
2516 #define SEG(name, seg) \
2517 { name, offsetof(CPUState, segs[seg].selector), NULL, MD_I32 },\
2518 { name ".base", offsetof(CPUState, segs[seg].base) },\
2519 { name ".limit", offsetof(CPUState, segs[seg].limit), NULL, MD_I32 },
2521 { "eax", offsetof(CPUState, regs[0]) },
2522 { "ecx", offsetof(CPUState, regs[1]) },
2523 { "edx", offsetof(CPUState, regs[2]) },
2524 { "ebx", offsetof(CPUState, regs[3]) },
2525 { "esp|sp", offsetof(CPUState, regs[4]) },
2526 { "ebp|fp", offsetof(CPUState, regs[5]) },
2527 { "esi", offsetof(CPUState, regs[6]) },
2528 { "edi", offsetof(CPUState, regs[7]) },
2529 #ifdef TARGET_X86_64
2530 { "r8", offsetof(CPUState, regs[8]) },
2531 { "r9", offsetof(CPUState, regs[9]) },
2532 { "r10", offsetof(CPUState, regs[10]) },
2533 { "r11", offsetof(CPUState, regs[11]) },
2534 { "r12", offsetof(CPUState, regs[12]) },
2535 { "r13", offsetof(CPUState, regs[13]) },
2536 { "r14", offsetof(CPUState, regs[14]) },
2537 { "r15", offsetof(CPUState, regs[15]) },
2539 { "eflags", offsetof(CPUState, eflags) },
2540 { "eip", offsetof(CPUState, eip) },
2547 { "pc", 0, monitor_get_pc, },
2548 #elif defined(TARGET_PPC)
2549 /* General purpose registers */
2550 { "r0", offsetof(CPUState, gpr[0]) },
2551 { "r1", offsetof(CPUState, gpr[1]) },
2552 { "r2", offsetof(CPUState, gpr[2]) },
2553 { "r3", offsetof(CPUState, gpr[3]) },
2554 { "r4", offsetof(CPUState, gpr[4]) },
2555 { "r5", offsetof(CPUState, gpr[5]) },
2556 { "r6", offsetof(CPUState, gpr[6]) },
2557 { "r7", offsetof(CPUState, gpr[7]) },
2558 { "r8", offsetof(CPUState, gpr[8]) },
2559 { "r9", offsetof(CPUState, gpr[9]) },
2560 { "r10", offsetof(CPUState, gpr[10]) },
2561 { "r11", offsetof(CPUState, gpr[11]) },
2562 { "r12", offsetof(CPUState, gpr[12]) },
2563 { "r13", offsetof(CPUState, gpr[13]) },
2564 { "r14", offsetof(CPUState, gpr[14]) },
2565 { "r15", offsetof(CPUState, gpr[15]) },
2566 { "r16", offsetof(CPUState, gpr[16]) },
2567 { "r17", offsetof(CPUState, gpr[17]) },
2568 { "r18", offsetof(CPUState, gpr[18]) },
2569 { "r19", offsetof(CPUState, gpr[19]) },
2570 { "r20", offsetof(CPUState, gpr[20]) },
2571 { "r21", offsetof(CPUState, gpr[21]) },
2572 { "r22", offsetof(CPUState, gpr[22]) },
2573 { "r23", offsetof(CPUState, gpr[23]) },
2574 { "r24", offsetof(CPUState, gpr[24]) },
2575 { "r25", offsetof(CPUState, gpr[25]) },
2576 { "r26", offsetof(CPUState, gpr[26]) },
2577 { "r27", offsetof(CPUState, gpr[27]) },
2578 { "r28", offsetof(CPUState, gpr[28]) },
2579 { "r29", offsetof(CPUState, gpr[29]) },
2580 { "r30", offsetof(CPUState, gpr[30]) },
2581 { "r31", offsetof(CPUState, gpr[31]) },
2582 /* Floating point registers */
2583 { "f0", offsetof(CPUState, fpr[0]) },
2584 { "f1", offsetof(CPUState, fpr[1]) },
2585 { "f2", offsetof(CPUState, fpr[2]) },
2586 { "f3", offsetof(CPUState, fpr[3]) },
2587 { "f4", offsetof(CPUState, fpr[4]) },
2588 { "f5", offsetof(CPUState, fpr[5]) },
2589 { "f6", offsetof(CPUState, fpr[6]) },
2590 { "f7", offsetof(CPUState, fpr[7]) },
2591 { "f8", offsetof(CPUState, fpr[8]) },
2592 { "f9", offsetof(CPUState, fpr[9]) },
2593 { "f10", offsetof(CPUState, fpr[10]) },
2594 { "f11", offsetof(CPUState, fpr[11]) },
2595 { "f12", offsetof(CPUState, fpr[12]) },
2596 { "f13", offsetof(CPUState, fpr[13]) },
2597 { "f14", offsetof(CPUState, fpr[14]) },
2598 { "f15", offsetof(CPUState, fpr[15]) },
2599 { "f16", offsetof(CPUState, fpr[16]) },
2600 { "f17", offsetof(CPUState, fpr[17]) },
2601 { "f18", offsetof(CPUState, fpr[18]) },
2602 { "f19", offsetof(CPUState, fpr[19]) },
2603 { "f20", offsetof(CPUState, fpr[20]) },
2604 { "f21", offsetof(CPUState, fpr[21]) },
2605 { "f22", offsetof(CPUState, fpr[22]) },
2606 { "f23", offsetof(CPUState, fpr[23]) },
2607 { "f24", offsetof(CPUState, fpr[24]) },
2608 { "f25", offsetof(CPUState, fpr[25]) },
2609 { "f26", offsetof(CPUState, fpr[26]) },
2610 { "f27", offsetof(CPUState, fpr[27]) },
2611 { "f28", offsetof(CPUState, fpr[28]) },
2612 { "f29", offsetof(CPUState, fpr[29]) },
2613 { "f30", offsetof(CPUState, fpr[30]) },
2614 { "f31", offsetof(CPUState, fpr[31]) },
2615 { "fpscr", offsetof(CPUState, fpscr) },
2616 /* Next instruction pointer */
2617 { "nip|pc", offsetof(CPUState, nip) },
2618 { "lr", offsetof(CPUState, lr) },
2619 { "ctr", offsetof(CPUState, ctr) },
2620 { "decr", 0, &monitor_get_decr, },
2621 { "ccr", 0, &monitor_get_ccr, },
2622 /* Machine state register */
2623 { "msr", 0, &monitor_get_msr, },
2624 { "xer", 0, &monitor_get_xer, },
2625 { "tbu", 0, &monitor_get_tbu, },
2626 { "tbl", 0, &monitor_get_tbl, },
2627 #if defined(TARGET_PPC64)
2628 /* Address space register */
2629 { "asr", offsetof(CPUState, asr) },
2631 /* Segment registers */
2632 { "sdr1", offsetof(CPUState, sdr1) },
2633 { "sr0", offsetof(CPUState, sr[0]) },
2634 { "sr1", offsetof(CPUState, sr[1]) },
2635 { "sr2", offsetof(CPUState, sr[2]) },
2636 { "sr3", offsetof(CPUState, sr[3]) },
2637 { "sr4", offsetof(CPUState, sr[4]) },
2638 { "sr5", offsetof(CPUState, sr[5]) },
2639 { "sr6", offsetof(CPUState, sr[6]) },
2640 { "sr7", offsetof(CPUState, sr[7]) },
2641 { "sr8", offsetof(CPUState, sr[8]) },
2642 { "sr9", offsetof(CPUState, sr[9]) },
2643 { "sr10", offsetof(CPUState, sr[10]) },
2644 { "sr11", offsetof(CPUState, sr[11]) },
2645 { "sr12", offsetof(CPUState, sr[12]) },
2646 { "sr13", offsetof(CPUState, sr[13]) },
2647 { "sr14", offsetof(CPUState, sr[14]) },
2648 { "sr15", offsetof(CPUState, sr[15]) },
2649 /* Too lazy to put BATs and SPRs ... */
2650 #elif defined(TARGET_SPARC)
2651 { "g0", offsetof(CPUState, gregs[0]) },
2652 { "g1", offsetof(CPUState, gregs[1]) },
2653 { "g2", offsetof(CPUState, gregs[2]) },
2654 { "g3", offsetof(CPUState, gregs[3]) },
2655 { "g4", offsetof(CPUState, gregs[4]) },
2656 { "g5", offsetof(CPUState, gregs[5]) },
2657 { "g6", offsetof(CPUState, gregs[6]) },
2658 { "g7", offsetof(CPUState, gregs[7]) },
2659 { "o0", 0, monitor_get_reg },
2660 { "o1", 1, monitor_get_reg },
2661 { "o2", 2, monitor_get_reg },
2662 { "o3", 3, monitor_get_reg },
2663 { "o4", 4, monitor_get_reg },
2664 { "o5", 5, monitor_get_reg },
2665 { "o6", 6, monitor_get_reg },
2666 { "o7", 7, monitor_get_reg },
2667 { "l0", 8, monitor_get_reg },
2668 { "l1", 9, monitor_get_reg },
2669 { "l2", 10, monitor_get_reg },
2670 { "l3", 11, monitor_get_reg },
2671 { "l4", 12, monitor_get_reg },
2672 { "l5", 13, monitor_get_reg },
2673 { "l6", 14, monitor_get_reg },
2674 { "l7", 15, monitor_get_reg },
2675 { "i0", 16, monitor_get_reg },
2676 { "i1", 17, monitor_get_reg },
2677 { "i2", 18, monitor_get_reg },
2678 { "i3", 19, monitor_get_reg },
2679 { "i4", 20, monitor_get_reg },
2680 { "i5", 21, monitor_get_reg },
2681 { "i6", 22, monitor_get_reg },
2682 { "i7", 23, monitor_get_reg },
2683 { "pc", offsetof(CPUState, pc) },
2684 { "npc", offsetof(CPUState, npc) },
2685 { "y", offsetof(CPUState, y) },
2686 #ifndef TARGET_SPARC64
2687 { "psr", 0, &monitor_get_psr, },
2688 { "wim", offsetof(CPUState, wim) },
2690 { "tbr", offsetof(CPUState, tbr) },
2691 { "fsr", offsetof(CPUState, fsr) },
2692 { "f0", offsetof(CPUState, fpr[0]) },
2693 { "f1", offsetof(CPUState, fpr[1]) },
2694 { "f2", offsetof(CPUState, fpr[2]) },
2695 { "f3", offsetof(CPUState, fpr[3]) },
2696 { "f4", offsetof(CPUState, fpr[4]) },
2697 { "f5", offsetof(CPUState, fpr[5]) },
2698 { "f6", offsetof(CPUState, fpr[6]) },
2699 { "f7", offsetof(CPUState, fpr[7]) },
2700 { "f8", offsetof(CPUState, fpr[8]) },
2701 { "f9", offsetof(CPUState, fpr[9]) },
2702 { "f10", offsetof(CPUState, fpr[10]) },
2703 { "f11", offsetof(CPUState, fpr[11]) },
2704 { "f12", offsetof(CPUState, fpr[12]) },
2705 { "f13", offsetof(CPUState, fpr[13]) },
2706 { "f14", offsetof(CPUState, fpr[14]) },
2707 { "f15", offsetof(CPUState, fpr[15]) },
2708 { "f16", offsetof(CPUState, fpr[16]) },
2709 { "f17", offsetof(CPUState, fpr[17]) },
2710 { "f18", offsetof(CPUState, fpr[18]) },
2711 { "f19", offsetof(CPUState, fpr[19]) },
2712 { "f20", offsetof(CPUState, fpr[20]) },
2713 { "f21", offsetof(CPUState, fpr[21]) },
2714 { "f22", offsetof(CPUState, fpr[22]) },
2715 { "f23", offsetof(CPUState, fpr[23]) },
2716 { "f24", offsetof(CPUState, fpr[24]) },
2717 { "f25", offsetof(CPUState, fpr[25]) },
2718 { "f26", offsetof(CPUState, fpr[26]) },
2719 { "f27", offsetof(CPUState, fpr[27]) },
2720 { "f28", offsetof(CPUState, fpr[28]) },
2721 { "f29", offsetof(CPUState, fpr[29]) },
2722 { "f30", offsetof(CPUState, fpr[30]) },
2723 { "f31", offsetof(CPUState, fpr[31]) },
2724 #ifdef TARGET_SPARC64
2725 { "f32", offsetof(CPUState, fpr[32]) },
2726 { "f34", offsetof(CPUState, fpr[34]) },
2727 { "f36", offsetof(CPUState, fpr[36]) },
2728 { "f38", offsetof(CPUState, fpr[38]) },
2729 { "f40", offsetof(CPUState, fpr[40]) },
2730 { "f42", offsetof(CPUState, fpr[42]) },
2731 { "f44", offsetof(CPUState, fpr[44]) },
2732 { "f46", offsetof(CPUState, fpr[46]) },
2733 { "f48", offsetof(CPUState, fpr[48]) },
2734 { "f50", offsetof(CPUState, fpr[50]) },
2735 { "f52", offsetof(CPUState, fpr[52]) },
2736 { "f54", offsetof(CPUState, fpr[54]) },
2737 { "f56", offsetof(CPUState, fpr[56]) },
2738 { "f58", offsetof(CPUState, fpr[58]) },
2739 { "f60", offsetof(CPUState, fpr[60]) },
2740 { "f62", offsetof(CPUState, fpr[62]) },
2741 { "asi", offsetof(CPUState, asi) },
2742 { "pstate", offsetof(CPUState, pstate) },
2743 { "cansave", offsetof(CPUState, cansave) },
2744 { "canrestore", offsetof(CPUState, canrestore) },
2745 { "otherwin", offsetof(CPUState, otherwin) },
2746 { "wstate", offsetof(CPUState, wstate) },
2747 { "cleanwin", offsetof(CPUState, cleanwin) },
2748 { "fprs", offsetof(CPUState, fprs) },
2754 static void expr_error(Monitor *mon, const char *msg)
2756 monitor_printf(mon, "%s\n", msg);
2757 longjmp(expr_env, 1);
2760 /* return 0 if OK, -1 if not found, -2 if no CPU defined */
2761 static int get_monitor_def(target_long *pval, const char *name)
2763 const MonitorDef *md;
2766 for(md = monitor_defs; md->name != NULL; md++) {
2767 if (compare_cmd(name, md->name)) {
2768 if (md->get_value) {
2769 *pval = md->get_value(md, md->offset);
2771 CPUState *env = mon_get_cpu();
2774 ptr = (uint8_t *)env + md->offset;
2777 *pval = *(int32_t *)ptr;
2780 *pval = *(target_long *)ptr;
2793 static void next(void)
2797 while (qemu_isspace(*pch))
2802 static int64_t expr_sum(Monitor *mon);
2804 static int64_t expr_unary(Monitor *mon)
2813 n = expr_unary(mon);
2817 n = -expr_unary(mon);
2821 n = ~expr_unary(mon);
2827 expr_error(mon, "')' expected");
2834 expr_error(mon, "character constant expected");
2838 expr_error(mon, "missing terminating \' character");
2848 while ((*pch >= 'a' && *pch <= 'z') ||
2849 (*pch >= 'A' && *pch <= 'Z') ||
2850 (*pch >= '0' && *pch <= '9') ||
2851 *pch == '_' || *pch == '.') {
2852 if ((q - buf) < sizeof(buf) - 1)
2856 while (qemu_isspace(*pch))
2859 ret = get_monitor_def(®, buf);
2861 expr_error(mon, "unknown register");
2863 expr_error(mon, "no cpu defined");
2868 expr_error(mon, "unexpected end of expression");
2872 #if TARGET_PHYS_ADDR_BITS > 32
2873 n = strtoull(pch, &p, 0);
2875 n = strtoul(pch, &p, 0);
2878 expr_error(mon, "invalid char in expression");
2881 while (qemu_isspace(*pch))
2889 static int64_t expr_prod(Monitor *mon)
2894 val = expr_unary(mon);
2897 if (op != '*' && op != '/' && op != '%')
2900 val2 = expr_unary(mon);
2909 expr_error(mon, "division by zero");
2920 static int64_t expr_logic(Monitor *mon)
2925 val = expr_prod(mon);
2928 if (op != '&' && op != '|' && op != '^')
2931 val2 = expr_prod(mon);
2948 static int64_t expr_sum(Monitor *mon)
2953 val = expr_logic(mon);
2956 if (op != '+' && op != '-')
2959 val2 = expr_logic(mon);
2968 static int get_expr(Monitor *mon, int64_t *pval, const char **pp)
2971 if (setjmp(expr_env)) {
2975 while (qemu_isspace(*pch))
2977 *pval = expr_sum(mon);
2982 static int get_str(char *buf, int buf_size, const char **pp)
2990 while (qemu_isspace(*p))
3000 while (*p != '\0' && *p != '\"') {
3016 qemu_printf("unsupported escape code: '\\%c'\n", c);
3019 if ((q - buf) < buf_size - 1) {
3023 if ((q - buf) < buf_size - 1) {
3030 qemu_printf("unterminated string\n");
3035 while (*p != '\0' && !qemu_isspace(*p)) {
3036 if ((q - buf) < buf_size - 1) {
3048 * Store the command-name in cmdname, and return a pointer to
3049 * the remaining of the command string.
3051 static const char *get_command_name(const char *cmdline,
3052 char *cmdname, size_t nlen)
3055 const char *p, *pstart;
3058 while (qemu_isspace(*p))
3063 while (*p != '\0' && *p != '/' && !qemu_isspace(*p))
3068 memcpy(cmdname, pstart, len);
3069 cmdname[len] = '\0';
3074 * Read key of 'type' into 'key' and return the current
3077 static char *key_get_info(const char *type, char **key)
3085 p = strchr(type, ':');
3092 str = qemu_malloc(len + 1);
3093 memcpy(str, type, len);
3100 static int default_fmt_format = 'x';
3101 static int default_fmt_size = 4;
3105 static int is_valid_option(const char *c, const char *typestr)
3113 typestr = strstr(typestr, option);
3114 return (typestr != NULL);
3117 static const mon_cmd_t *monitor_find_command(const char *cmdname)
3119 const mon_cmd_t *cmd;
3121 for (cmd = mon_cmds; cmd->name != NULL; cmd++) {
3122 if (compare_cmd(cmdname, cmd->name)) {
3130 static const mon_cmd_t *monitor_parse_command(Monitor *mon,
3131 const char *cmdline,
3134 const char *p, *typestr;
3136 const mon_cmd_t *cmd;
3142 monitor_printf(mon, "command='%s'\n", cmdline);
3145 /* extract the command name */
3146 p = get_command_name(cmdline, cmdname, sizeof(cmdname));
3150 cmd = monitor_find_command(cmdname);
3152 monitor_printf(mon, "unknown command: '%s'\n", cmdname);
3156 /* parse the parameters */
3157 typestr = cmd->args_type;
3159 typestr = key_get_info(typestr, &key);
3171 while (qemu_isspace(*p))
3173 if (*typestr == '?') {
3176 /* no optional string: NULL argument */
3180 ret = get_str(buf, sizeof(buf), &p);
3184 monitor_printf(mon, "%s: filename expected\n",
3188 monitor_printf(mon, "%s: block device name expected\n",
3192 monitor_printf(mon, "%s: string expected\n", cmdname);
3197 qdict_put(qdict, key, qstring_from_str(buf));
3202 int count, format, size;
3204 while (qemu_isspace(*p))
3210 if (qemu_isdigit(*p)) {
3212 while (qemu_isdigit(*p)) {
3213 count = count * 10 + (*p - '0');
3251 if (*p != '\0' && !qemu_isspace(*p)) {
3252 monitor_printf(mon, "invalid char in format: '%c'\n",
3257 format = default_fmt_format;
3258 if (format != 'i') {
3259 /* for 'i', not specifying a size gives -1 as size */
3261 size = default_fmt_size;
3262 default_fmt_size = size;
3264 default_fmt_format = format;
3267 format = default_fmt_format;
3268 if (format != 'i') {
3269 size = default_fmt_size;
3274 qdict_put(qdict, "count", qint_from_int(count));
3275 qdict_put(qdict, "format", qint_from_int(format));
3276 qdict_put(qdict, "size", qint_from_int(size));
3284 while (qemu_isspace(*p))
3286 if (*typestr == '?' || *typestr == '.') {
3287 if (*typestr == '?') {
3295 while (qemu_isspace(*p))
3304 if (get_expr(mon, &val, &p))
3306 /* Check if 'i' is greater than 32-bit */
3307 if ((c == 'i') && ((val >> 32) & 0xffffffff)) {
3308 monitor_printf(mon, "\'%s\' has failed: ", cmdname);
3309 monitor_printf(mon, "integer is for 32-bit values\n");
3312 qdict_put(qdict, key, qint_from_int(val));
3317 const char *tmp = p;
3318 int has_option, skip_key = 0;
3324 while (qemu_isspace(*p))
3330 if(!is_valid_option(p, typestr)) {
3332 monitor_printf(mon, "%s: unsupported option -%c\n",
3346 qdict_put(qdict, key, qint_from_int(has_option));
3351 monitor_printf(mon, "%s: unknown type '%c'\n", cmdname, c);
3357 /* check that all arguments were parsed */
3358 while (qemu_isspace(*p))
3361 monitor_printf(mon, "%s: extraneous characters at the end of line\n",
3373 static void monitor_print_error(Monitor *mon)
3375 qerror_print(mon->error);
3376 QDECREF(mon->error);
3380 static void monitor_call_handler(Monitor *mon, const mon_cmd_t *cmd,
3381 const QDict *params)
3383 QObject *data = NULL;
3385 cmd->mhandler.cmd_new(mon, params, &data);
3387 if (monitor_ctrl_mode(mon)) {
3388 /* Monitor Protocol */
3389 monitor_protocol_emitter(mon, data);
3393 cmd->user_print(mon, data);
3396 qobject_decref(data);
3399 static void handle_user_command(Monitor *mon, const char *cmdline)
3402 const mon_cmd_t *cmd;
3404 qdict = qdict_new();
3406 cmd = monitor_parse_command(mon, cmdline, qdict);
3410 qemu_errors_to_mon(mon);
3412 if (monitor_handler_ported(cmd)) {
3413 monitor_call_handler(mon, cmd, qdict);
3415 cmd->mhandler.cmd(mon, qdict);
3418 if (monitor_has_error(mon))
3419 monitor_print_error(mon);
3421 qemu_errors_to_previous();
3427 static void cmd_completion(const char *name, const char *list)
3429 const char *p, *pstart;
3438 p = pstart + strlen(pstart);
3440 if (len > sizeof(cmd) - 2)
3441 len = sizeof(cmd) - 2;
3442 memcpy(cmd, pstart, len);
3444 if (name[0] == '\0' || !strncmp(name, cmd, strlen(name))) {
3445 readline_add_completion(cur_mon->rs, cmd);
3453 static void file_completion(const char *input)
3458 char file[1024], file_prefix[1024];
3462 p = strrchr(input, '/');
3465 pstrcpy(file_prefix, sizeof(file_prefix), input);
3466 pstrcpy(path, sizeof(path), ".");
3468 input_path_len = p - input + 1;
3469 memcpy(path, input, input_path_len);
3470 if (input_path_len > sizeof(path) - 1)
3471 input_path_len = sizeof(path) - 1;
3472 path[input_path_len] = '\0';
3473 pstrcpy(file_prefix, sizeof(file_prefix), p + 1);
3475 #ifdef DEBUG_COMPLETION
3476 monitor_printf(cur_mon, "input='%s' path='%s' prefix='%s'\n",
3477 input, path, file_prefix);
3479 ffs = opendir(path);
3487 if (strstart(d->d_name, file_prefix, NULL)) {
3488 memcpy(file, input, input_path_len);
3489 if (input_path_len < sizeof(file))
3490 pstrcpy(file + input_path_len, sizeof(file) - input_path_len,
3492 /* stat the file to find out if it's a directory.
3493 * In that case add a slash to speed up typing long paths
3496 if(S_ISDIR(sb.st_mode))
3497 pstrcat(file, sizeof(file), "/");
3498 readline_add_completion(cur_mon->rs, file);
3504 static void block_completion_it(void *opaque, BlockDriverState *bs)
3506 const char *name = bdrv_get_device_name(bs);
3507 const char *input = opaque;
3509 if (input[0] == '\0' ||
3510 !strncmp(name, (char *)input, strlen(input))) {
3511 readline_add_completion(cur_mon->rs, name);
3515 /* NOTE: this parser is an approximate form of the real command parser */
3516 static void parse_cmdline(const char *cmdline,
3517 int *pnb_args, char **args)
3526 while (qemu_isspace(*p))
3530 if (nb_args >= MAX_ARGS)
3532 ret = get_str(buf, sizeof(buf), &p);
3533 args[nb_args] = qemu_strdup(buf);
3538 *pnb_args = nb_args;
3541 static const char *next_arg_type(const char *typestr)
3543 const char *p = strchr(typestr, ':');
3544 return (p != NULL ? ++p : typestr);
3547 static void monitor_find_completion(const char *cmdline)
3549 const char *cmdname;
3550 char *args[MAX_ARGS];
3551 int nb_args, i, len;
3552 const char *ptype, *str;
3553 const mon_cmd_t *cmd;
3556 parse_cmdline(cmdline, &nb_args, args);
3557 #ifdef DEBUG_COMPLETION
3558 for(i = 0; i < nb_args; i++) {
3559 monitor_printf(cur_mon, "arg%d = '%s'\n", i, (char *)args[i]);
3563 /* if the line ends with a space, it means we want to complete the
3565 len = strlen(cmdline);
3566 if (len > 0 && qemu_isspace(cmdline[len - 1])) {
3567 if (nb_args >= MAX_ARGS)
3569 args[nb_args++] = qemu_strdup("");
3572 /* command completion */
3577 readline_set_completion_index(cur_mon->rs, strlen(cmdname));
3578 for(cmd = mon_cmds; cmd->name != NULL; cmd++) {
3579 cmd_completion(cmdname, cmd->name);
3582 /* find the command */
3583 for(cmd = mon_cmds; cmd->name != NULL; cmd++) {
3584 if (compare_cmd(args[0], cmd->name))
3589 ptype = next_arg_type(cmd->args_type);
3590 for(i = 0; i < nb_args - 2; i++) {
3591 if (*ptype != '\0') {
3592 ptype = next_arg_type(ptype);
3593 while (*ptype == '?')
3594 ptype = next_arg_type(ptype);
3597 str = args[nb_args - 1];
3598 if (*ptype == '-' && ptype[1] != '\0') {
3603 /* file completion */
3604 readline_set_completion_index(cur_mon->rs, strlen(str));
3605 file_completion(str);
3608 /* block device name completion */
3609 readline_set_completion_index(cur_mon->rs, strlen(str));
3610 bdrv_iterate(block_completion_it, (void *)str);
3613 /* XXX: more generic ? */
3614 if (!strcmp(cmd->name, "info")) {
3615 readline_set_completion_index(cur_mon->rs, strlen(str));
3616 for(cmd = info_cmds; cmd->name != NULL; cmd++) {
3617 cmd_completion(str, cmd->name);
3619 } else if (!strcmp(cmd->name, "sendkey")) {
3620 char *sep = strrchr(str, '-');
3623 readline_set_completion_index(cur_mon->rs, strlen(str));
3624 for(key = key_defs; key->name != NULL; key++) {
3625 cmd_completion(str, key->name);
3627 } else if (!strcmp(cmd->name, "help|?")) {
3628 readline_set_completion_index(cur_mon->rs, strlen(str));
3629 for (cmd = mon_cmds; cmd->name != NULL; cmd++) {
3630 cmd_completion(str, cmd->name);
3638 for(i = 0; i < nb_args; i++)
3642 static int monitor_can_read(void *opaque)
3644 Monitor *mon = opaque;
3646 return (mon->suspend_cnt == 0) ? 128 : 0;
3649 typedef struct CmdArgs {
3656 static int check_opt(const CmdArgs *cmd_args, const char *name, QDict *args)
3658 if (!cmd_args->optional) {
3659 qemu_error_new(QERR_MISSING_PARAMETER, name);
3663 if (cmd_args->type == '-') {
3664 /* handlers expect a value, they need to be changed */
3665 qdict_put(args, name, qint_from_int(0));
3671 static int check_arg(const CmdArgs *cmd_args, QDict *args)
3676 name = qstring_get_str(cmd_args->name);
3679 return check_opt(cmd_args, name, args);
3682 value = qdict_get(args, name);
3684 return check_opt(cmd_args, name, args);
3687 switch (cmd_args->type) {
3691 if (qobject_type(value) != QTYPE_QSTRING) {
3692 qemu_error_new(QERR_INVALID_PARAMETER_TYPE, name, "string");
3698 const char *keys[] = { "count", "format", "size", NULL };
3700 for (i = 0; keys[i]; i++) {
3701 QObject *obj = qdict_get(args, keys[i]);
3703 qemu_error_new(QERR_MISSING_PARAMETER, name);
3706 if (qobject_type(obj) != QTYPE_QINT) {
3707 qemu_error_new(QERR_INVALID_PARAMETER_TYPE, name, "int");
3715 if (qobject_type(value) != QTYPE_QINT) {
3716 qemu_error_new(QERR_INVALID_PARAMETER_TYPE, name, "int");
3721 if (qobject_type(value) != QTYPE_QINT &&
3722 qobject_type(value) != QTYPE_QBOOL) {
3723 qemu_error_new(QERR_INVALID_PARAMETER_TYPE, name, "bool");
3726 if (qobject_type(value) == QTYPE_QBOOL) {
3727 /* handlers expect a QInt, they need to be changed */
3728 qdict_put(args, name,
3729 qint_from_int(qbool_get_int(qobject_to_qbool(value))));
3740 static void cmd_args_init(CmdArgs *cmd_args)
3742 cmd_args->name = qstring_new();
3743 cmd_args->type = cmd_args->flag = cmd_args->optional = 0;
3747 * This is not trivial, we have to parse Monitor command's argument
3748 * type syntax to be able to check the arguments provided by clients.
3750 * In the near future we will be using an array for that and will be
3751 * able to drop all this parsing...
3753 static int monitor_check_qmp_args(const mon_cmd_t *cmd, QDict *args)
3759 if (cmd->args_type == '\0') {
3760 return (qdict_size(args) == 0 ? 0 : -1);
3764 cmd_args_init(&cmd_args);
3766 for (p = cmd->args_type;; p++) {
3768 cmd_args.type = *++p;
3770 if (cmd_args.type == '-') {
3771 cmd_args.flag = *p++;
3772 cmd_args.optional = 1;
3773 } else if (*p == '?') {
3774 cmd_args.optional = 1;
3778 assert(*p == ',' || *p == '\0');
3779 err = check_arg(&cmd_args, args);
3781 QDECREF(cmd_args.name);
3782 cmd_args_init(&cmd_args);
3788 qstring_append_chr(cmd_args.name, *p);
3796 QDECREF(cmd_args.name);
3800 static void handle_qmp_command(JSONMessageParser *parser, QList *tokens)
3804 QDict *input, *args;
3805 const mon_cmd_t *cmd;
3806 Monitor *mon = cur_mon;
3807 const char *cmd_name, *info_item;
3810 qemu_errors_to_mon(mon);
3812 obj = json_parser_parse(tokens, NULL);
3814 // FIXME: should be triggered in json_parser_parse()
3815 qemu_error_new(QERR_JSON_PARSING);
3817 } else if (qobject_type(obj) != QTYPE_QDICT) {
3818 qemu_error_new(QERR_QMP_BAD_INPUT_OBJECT, "object");
3819 qobject_decref(obj);
3823 input = qobject_to_qdict(obj);
3825 mon->mc->id = qdict_get(input, "id");
3826 qobject_incref(mon->mc->id);
3828 obj = qdict_get(input, "execute");
3830 qemu_error_new(QERR_QMP_BAD_INPUT_OBJECT, "execute");
3832 } else if (qobject_type(obj) != QTYPE_QSTRING) {
3833 qemu_error_new(QERR_QMP_BAD_INPUT_OBJECT, "string");
3837 cmd_name = qstring_get_str(qobject_to_qstring(obj));
3840 * XXX: We need this special case until we get info handlers
3841 * converted into 'query-' commands
3843 if (compare_cmd(cmd_name, "info")) {
3844 qemu_error_new(QERR_COMMAND_NOT_FOUND, cmd_name);
3846 } else if (strstart(cmd_name, "query-", &info_item)) {
3847 cmd = monitor_find_command("info");
3848 qdict_put_obj(input, "arguments",
3849 qobject_from_jsonf("{ 'item': %s }", info_item));
3851 cmd = monitor_find_command(cmd_name);
3853 qemu_error_new(QERR_COMMAND_NOT_FOUND, cmd_name);
3858 obj = qdict_get(input, "arguments");
3862 args = qobject_to_qdict(obj);
3868 err = monitor_check_qmp_args(cmd, args);
3873 monitor_call_handler(mon, cmd, args);
3879 monitor_protocol_emitter(mon, NULL);
3882 qemu_errors_to_previous();
3886 * monitor_control_read(): Read and handle QMP input
3888 static void monitor_control_read(void *opaque, const uint8_t *buf, int size)
3890 Monitor *old_mon = cur_mon;
3894 json_message_parser_feed(&cur_mon->mc->parser, (const char *) buf, size);
3899 static void monitor_read(void *opaque, const uint8_t *buf, int size)
3901 Monitor *old_mon = cur_mon;
3907 for (i = 0; i < size; i++)
3908 readline_handle_byte(cur_mon->rs, buf[i]);
3910 if (size == 0 || buf[size - 1] != 0)
3911 monitor_printf(cur_mon, "corrupted command\n");
3913 handle_user_command(cur_mon, (char *)buf);
3919 static void monitor_command_cb(Monitor *mon, const char *cmdline, void *opaque)
3921 monitor_suspend(mon);
3922 handle_user_command(mon, cmdline);
3923 monitor_resume(mon);
3926 int monitor_suspend(Monitor *mon)
3934 void monitor_resume(Monitor *mon)
3938 if (--mon->suspend_cnt == 0)
3939 readline_show_prompt(mon->rs);
3943 * monitor_control_event(): Print QMP gretting
3945 static void monitor_control_event(void *opaque, int event)
3947 if (event == CHR_EVENT_OPENED) {
3949 Monitor *mon = opaque;
3951 json_message_parser_init(&mon->mc->parser, handle_qmp_command);
3953 data = qobject_from_jsonf("{ 'QMP': { 'capabilities': [] } }");
3954 assert(data != NULL);
3956 monitor_json_emitter(mon, data);
3957 qobject_decref(data);
3961 static void monitor_event(void *opaque, int event)
3963 Monitor *mon = opaque;
3966 case CHR_EVENT_MUX_IN:
3968 if (mon->reset_seen) {
3969 readline_restart(mon->rs);
3970 monitor_resume(mon);
3973 mon->suspend_cnt = 0;
3977 case CHR_EVENT_MUX_OUT:
3978 if (mon->reset_seen) {
3979 if (mon->suspend_cnt == 0) {
3980 monitor_printf(mon, "\n");
3983 monitor_suspend(mon);
3990 case CHR_EVENT_OPENED:
3991 monitor_printf(mon, "QEMU %s monitor - type 'help' for more "
3992 "information\n", QEMU_VERSION);
3993 if (!mon->mux_out) {
3994 readline_show_prompt(mon->rs);
3996 mon->reset_seen = 1;
4010 const char *monitor_cmdline_parse(const char *cmdline, int *flags)
4014 if (strstart(cmdline, "control,", &dev)) {
4015 if (strstart(dev, "vc", NULL)) {
4016 fprintf(stderr, "qemu: control mode is for low-level interaction ");
4017 fprintf(stderr, "cannot be used with device 'vc'\n");
4020 *flags &= ~MONITOR_USE_READLINE;
4021 *flags |= MONITOR_USE_CONTROL;
4028 void monitor_init(CharDriverState *chr, int flags)
4030 static int is_first_init = 1;
4033 if (is_first_init) {
4034 key_timer = qemu_new_timer(vm_clock, release_keys, NULL);
4038 mon = qemu_mallocz(sizeof(*mon));
4042 if (flags & MONITOR_USE_READLINE) {
4043 mon->rs = readline_init(mon, monitor_find_completion);
4044 monitor_read_command(mon, 0);
4047 if (monitor_ctrl_mode(mon)) {
4048 mon->mc = qemu_mallocz(sizeof(MonitorControl));
4049 /* Control mode requires special handlers */
4050 qemu_chr_add_handlers(chr, monitor_can_read, monitor_control_read,
4051 monitor_control_event, mon);
4053 qemu_chr_add_handlers(chr, monitor_can_read, monitor_read,
4054 monitor_event, mon);
4057 QLIST_INSERT_HEAD(&mon_list, mon, entry);
4058 if (!cur_mon || (flags & MONITOR_IS_DEFAULT))
4062 static void bdrv_password_cb(Monitor *mon, const char *password, void *opaque)
4064 BlockDriverState *bs = opaque;
4067 if (bdrv_set_key(bs, password) != 0) {
4068 monitor_printf(mon, "invalid password\n");
4071 if (mon->password_completion_cb)
4072 mon->password_completion_cb(mon->password_opaque, ret);
4074 monitor_read_command(mon, 1);
4077 void monitor_read_bdrv_key_start(Monitor *mon, BlockDriverState *bs,
4078 BlockDriverCompletionFunc *completion_cb,
4083 if (!bdrv_key_required(bs)) {
4085 completion_cb(opaque, 0);
4089 monitor_printf(mon, "%s (%s) is encrypted.\n", bdrv_get_device_name(bs),
4090 bdrv_get_encrypted_filename(bs));
4092 mon->password_completion_cb = completion_cb;
4093 mon->password_opaque = opaque;
4095 err = monitor_read_password(mon, bdrv_password_cb, bs);
4097 if (err && completion_cb)
4098 completion_cb(opaque, err);
4101 typedef struct QemuErrorSink QemuErrorSink;
4102 struct QemuErrorSink {
4111 QemuErrorSink *previous;
4114 static QemuErrorSink *qemu_error_sink;
4116 void qemu_errors_to_file(FILE *fp)
4118 QemuErrorSink *sink;
4120 sink = qemu_mallocz(sizeof(*sink));
4121 sink->dest = ERR_SINK_FILE;
4123 sink->previous = qemu_error_sink;
4124 qemu_error_sink = sink;
4127 void qemu_errors_to_mon(Monitor *mon)
4129 QemuErrorSink *sink;
4131 sink = qemu_mallocz(sizeof(*sink));
4132 sink->dest = ERR_SINK_MONITOR;
4134 sink->previous = qemu_error_sink;
4135 qemu_error_sink = sink;
4138 void qemu_errors_to_previous(void)
4140 QemuErrorSink *sink;
4142 assert(qemu_error_sink != NULL);
4143 sink = qemu_error_sink;
4144 qemu_error_sink = sink->previous;
4148 void qemu_error(const char *fmt, ...)
4152 assert(qemu_error_sink != NULL);
4153 switch (qemu_error_sink->dest) {
4155 va_start(args, fmt);
4156 vfprintf(qemu_error_sink->fp, fmt, args);
4159 case ERR_SINK_MONITOR:
4160 va_start(args, fmt);
4161 monitor_vprintf(qemu_error_sink->mon, fmt, args);
4167 void qemu_error_internal(const char *file, int linenr, const char *func,
4168 const char *fmt, ...)
4173 assert(qemu_error_sink != NULL);
4176 qerror = qerror_from_info(file, linenr, func, fmt, &va);
4179 switch (qemu_error_sink->dest) {
4181 qerror_print(qerror);
4184 case ERR_SINK_MONITOR:
4185 assert(qemu_error_sink->mon->error == NULL);
4186 qemu_error_sink->mon->error = qerror;