4 * Copyright (c) 2003-2004 Fabrice Bellard
6 * Permission is hereby granted, free of charge, to any person obtaining a copy
7 * of this software and associated documentation files (the "Software"), to deal
8 * in the Software without restriction, including without limitation the rights
9 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 * copies of the Software, and to permit persons to whom the Software is
11 * furnished to do so, subject to the following conditions:
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
28 #include "hw/pcmcia.h"
31 #include "hw/watchdog.h"
32 #include "hw/loader.h"
35 #include "net/slirp.h"
36 #include "qemu-char.h"
42 #include "audio/audio.h"
45 #include "qemu-timer.h"
46 #include "migration.h"
55 #include "json-streamer.h"
56 #include "json-parser.h"
59 #ifdef CONFIG_SIMPLE_TRACE
64 //#define DEBUG_COMPLETION
70 * 'B' block device name
71 * 's' string (accept optional quote)
72 * 'O' option string of the form NAME=VALUE,...
73 * parsed according to QemuOptsList given by its name
74 * Example: 'device:O' uses qemu_device_opts.
75 * Restriction: only lists with empty desc are supported
76 * TODO lift the restriction
78 * 'l' target long (32 or 64 bit)
79 * 'M' just like 'l', except in user mode the value is
80 * multiplied by 2^20 (think Mebibyte)
81 * 'o' octets (aka bytes)
82 * user mode accepts an optional T, t, G, g, M, m, K, k
83 * suffix, which multiplies the value by 2^40 for
84 * suffixes T and t, 2^30 for suffixes G and g, 2^20 for
85 * M and m, 2^10 for K and k
87 * user mode accepts an optional ms, us, ns suffix,
88 * which divides the value by 1e3, 1e6, 1e9, respectively
89 * '/' optional gdb-like print format (like "/10x")
91 * '?' optional type (for all types, except '/')
92 * '.' other form of optional type (for 'i' and 'l')
94 * user mode accepts "on" or "off"
95 * '-' optional parameter (eg. '-f')
99 typedef struct MonitorCompletionData MonitorCompletionData;
100 struct MonitorCompletionData {
102 void (*user_print)(Monitor *mon, const QObject *data);
105 typedef struct mon_cmd_t {
107 const char *args_type;
110 void (*user_print)(Monitor *mon, const QObject *data);
112 void (*info)(Monitor *mon);
113 void (*info_new)(Monitor *mon, QObject **ret_data);
114 int (*info_async)(Monitor *mon, MonitorCompletion *cb, void *opaque);
115 void (*cmd)(Monitor *mon, const QDict *qdict);
116 int (*cmd_new)(Monitor *mon, const QDict *params, QObject **ret_data);
117 int (*cmd_async)(Monitor *mon, const QDict *params,
118 MonitorCompletion *cb, void *opaque);
123 /* file descriptors passed via SCM_RIGHTS */
124 typedef struct mon_fd_t mon_fd_t;
128 QLIST_ENTRY(mon_fd_t) next;
131 typedef struct MonitorControl {
133 JSONMessageParser parser;
138 CharDriverState *chr;
143 uint8_t outbuf[1024];
148 BlockDriverCompletionFunc *password_completion_cb;
149 void *password_opaque;
150 #ifdef CONFIG_DEBUG_MONITOR
154 QLIST_HEAD(,mon_fd_t) fds;
155 QLIST_ENTRY(Monitor) entry;
158 #ifdef CONFIG_DEBUG_MONITOR
159 #define MON_DEBUG(fmt, ...) do { \
160 fprintf(stderr, "Monitor: "); \
161 fprintf(stderr, fmt, ## __VA_ARGS__); } while (0)
163 static inline void mon_print_count_inc(Monitor *mon)
165 mon->print_calls_nr++;
168 static inline void mon_print_count_init(Monitor *mon)
170 mon->print_calls_nr = 0;
173 static inline int mon_print_count_get(const Monitor *mon)
175 return mon->print_calls_nr;
178 #else /* !CONFIG_DEBUG_MONITOR */
179 #define MON_DEBUG(fmt, ...) do { } while (0)
180 static inline void mon_print_count_inc(Monitor *mon) { }
181 static inline void mon_print_count_init(Monitor *mon) { }
182 static inline int mon_print_count_get(const Monitor *mon) { return 0; }
183 #endif /* CONFIG_DEBUG_MONITOR */
185 /* QMP checker flags */
186 #define QMP_ACCEPT_UNKNOWNS 1
188 static QLIST_HEAD(mon_list, Monitor) mon_list;
190 static const mon_cmd_t mon_cmds[];
191 static const mon_cmd_t info_cmds[];
193 static const mon_cmd_t qmp_cmds[];
194 static const mon_cmd_t qmp_query_cmds[];
197 Monitor *default_mon;
199 static void monitor_command_cb(Monitor *mon, const char *cmdline,
202 static inline int qmp_cmd_mode(const Monitor *mon)
204 return (mon->mc ? mon->mc->command_mode : 0);
207 /* Return true if in control mode, false otherwise */
208 static inline int monitor_ctrl_mode(const Monitor *mon)
210 return (mon->flags & MONITOR_USE_CONTROL);
213 /* Return non-zero iff we have a current monitor, and it is in QMP mode. */
214 int monitor_cur_is_qmp(void)
216 return cur_mon && monitor_ctrl_mode(cur_mon);
219 static void monitor_read_command(Monitor *mon, int show_prompt)
224 readline_start(mon->rs, "(qemu) ", 0, monitor_command_cb, NULL);
226 readline_show_prompt(mon->rs);
229 static int monitor_read_password(Monitor *mon, ReadLineFunc *readline_func,
232 if (monitor_ctrl_mode(mon)) {
233 qerror_report(QERR_MISSING_PARAMETER, "password");
235 } else if (mon->rs) {
236 readline_start(mon->rs, "Password: ", 1, readline_func, opaque);
237 /* prompt is printed on return from the command handler */
240 monitor_printf(mon, "terminal does not support password prompting\n");
245 void monitor_flush(Monitor *mon)
247 if (mon && mon->outbuf_index != 0 && !mon->mux_out) {
248 qemu_chr_write(mon->chr, mon->outbuf, mon->outbuf_index);
249 mon->outbuf_index = 0;
253 /* flush at every end of line or if the buffer is full */
254 static void monitor_puts(Monitor *mon, const char *str)
263 mon->outbuf[mon->outbuf_index++] = '\r';
264 mon->outbuf[mon->outbuf_index++] = c;
265 if (mon->outbuf_index >= (sizeof(mon->outbuf) - 1)
271 void monitor_vprintf(Monitor *mon, const char *fmt, va_list ap)
278 mon_print_count_inc(mon);
280 if (monitor_ctrl_mode(mon)) {
284 vsnprintf(buf, sizeof(buf), fmt, ap);
285 monitor_puts(mon, buf);
288 void monitor_printf(Monitor *mon, const char *fmt, ...)
292 monitor_vprintf(mon, fmt, ap);
296 void monitor_print_filename(Monitor *mon, const char *filename)
300 for (i = 0; filename[i]; i++) {
301 switch (filename[i]) {
305 monitor_printf(mon, "\\%c", filename[i]);
308 monitor_printf(mon, "\\t");
311 monitor_printf(mon, "\\r");
314 monitor_printf(mon, "\\n");
317 monitor_printf(mon, "%c", filename[i]);
323 static int GCC_FMT_ATTR(2, 3) monitor_fprintf(FILE *stream,
324 const char *fmt, ...)
328 monitor_vprintf((Monitor *)stream, fmt, ap);
333 static void monitor_user_noop(Monitor *mon, const QObject *data) { }
335 static inline int handler_is_qobject(const mon_cmd_t *cmd)
337 return cmd->user_print != NULL;
340 static inline bool handler_is_async(const mon_cmd_t *cmd)
342 return cmd->flags & MONITOR_CMD_ASYNC;
345 static inline int monitor_has_error(const Monitor *mon)
347 return mon->error != NULL;
350 static void monitor_json_emitter(Monitor *mon, const QObject *data)
354 if (mon->flags & MONITOR_USE_PRETTY)
355 json = qobject_to_json_pretty(data);
357 json = qobject_to_json(data);
358 assert(json != NULL);
360 qstring_append_chr(json, '\n');
361 monitor_puts(mon, qstring_get_str(json));
366 static void monitor_protocol_emitter(Monitor *mon, QObject *data)
372 if (!monitor_has_error(mon)) {
373 /* success response */
375 qobject_incref(data);
376 qdict_put_obj(qmp, "return", data);
378 /* return an empty QDict by default */
379 qdict_put(qmp, "return", qdict_new());
383 qdict_put(mon->error->error, "desc", qerror_human(mon->error));
384 qdict_put(qmp, "error", mon->error->error);
385 QINCREF(mon->error->error);
391 qdict_put_obj(qmp, "id", mon->mc->id);
395 monitor_json_emitter(mon, QOBJECT(qmp));
399 static void timestamp_put(QDict *qdict)
405 err = qemu_gettimeofday(&tv);
409 obj = qobject_from_jsonf("{ 'seconds': %" PRId64 ", "
410 "'microseconds': %" PRId64 " }",
411 (int64_t) tv.tv_sec, (int64_t) tv.tv_usec);
412 qdict_put_obj(qdict, "timestamp", obj);
416 * monitor_protocol_event(): Generate a Monitor event
418 * Event-specific data can be emitted through the (optional) 'data' parameter.
420 void monitor_protocol_event(MonitorEvent event, QObject *data)
423 const char *event_name;
426 assert(event < QEVENT_MAX);
429 case QEVENT_SHUTDOWN:
430 event_name = "SHUTDOWN";
433 event_name = "RESET";
435 case QEVENT_POWERDOWN:
436 event_name = "POWERDOWN";
442 event_name = "RESUME";
444 case QEVENT_VNC_CONNECTED:
445 event_name = "VNC_CONNECTED";
447 case QEVENT_VNC_INITIALIZED:
448 event_name = "VNC_INITIALIZED";
450 case QEVENT_VNC_DISCONNECTED:
451 event_name = "VNC_DISCONNECTED";
453 case QEVENT_BLOCK_IO_ERROR:
454 event_name = "BLOCK_IO_ERROR";
456 case QEVENT_RTC_CHANGE:
457 event_name = "RTC_CHANGE";
459 case QEVENT_WATCHDOG:
460 event_name = "WATCHDOG";
469 qdict_put(qmp, "event", qstring_from_str(event_name));
471 qobject_incref(data);
472 qdict_put_obj(qmp, "data", data);
475 QLIST_FOREACH(mon, &mon_list, entry) {
476 if (monitor_ctrl_mode(mon) && qmp_cmd_mode(mon)) {
477 monitor_json_emitter(mon, QOBJECT(qmp));
483 static int do_qmp_capabilities(Monitor *mon, const QDict *params,
486 /* Will setup QMP capabilities in the future */
487 if (monitor_ctrl_mode(mon)) {
488 mon->mc->command_mode = 1;
494 static int mon_set_cpu(int cpu_index);
495 static void handle_user_command(Monitor *mon, const char *cmdline);
497 static int do_hmp_passthrough(Monitor *mon, const QDict *params,
501 Monitor *old_mon, hmp;
502 CharDriverState mchar;
504 memset(&hmp, 0, sizeof(hmp));
505 qemu_chr_init_mem(&mchar);
511 if (qdict_haskey(params, "cpu-index")) {
512 ret = mon_set_cpu(qdict_get_int(params, "cpu-index"));
515 qerror_report(QERR_INVALID_PARAMETER_VALUE, "cpu-index", "a CPU number");
520 handle_user_command(&hmp, qdict_get_str(params, "command-line"));
523 if (qemu_chr_mem_osize(hmp.chr) > 0) {
524 *ret_data = QOBJECT(qemu_chr_mem_to_qs(hmp.chr));
528 qemu_chr_close_mem(hmp.chr);
532 static int compare_cmd(const char *name, const char *list)
534 const char *p, *pstart;
542 p = pstart + strlen(pstart);
543 if ((p - pstart) == len && !memcmp(pstart, name, len))
552 static void help_cmd_dump(Monitor *mon, const mon_cmd_t *cmds,
553 const char *prefix, const char *name)
555 const mon_cmd_t *cmd;
557 for(cmd = cmds; cmd->name != NULL; cmd++) {
558 if (!name || !strcmp(name, cmd->name))
559 monitor_printf(mon, "%s%s %s -- %s\n", prefix, cmd->name,
560 cmd->params, cmd->help);
564 static void help_cmd(Monitor *mon, const char *name)
566 if (name && !strcmp(name, "info")) {
567 help_cmd_dump(mon, info_cmds, "info ", NULL);
569 help_cmd_dump(mon, mon_cmds, "", name);
570 if (name && !strcmp(name, "log")) {
571 const CPULogItem *item;
572 monitor_printf(mon, "Log items (comma separated):\n");
573 monitor_printf(mon, "%-10s %s\n", "none", "remove all logs");
574 for(item = cpu_log_items; item->mask != 0; item++) {
575 monitor_printf(mon, "%-10s %s\n", item->name, item->help);
581 static void do_help_cmd(Monitor *mon, const QDict *qdict)
583 help_cmd(mon, qdict_get_try_str(qdict, "name"));
586 #ifdef CONFIG_SIMPLE_TRACE
587 static void do_change_trace_event_state(Monitor *mon, const QDict *qdict)
589 const char *tp_name = qdict_get_str(qdict, "name");
590 bool new_state = qdict_get_bool(qdict, "option");
591 int ret = st_change_trace_event_state(tp_name, new_state);
594 monitor_printf(mon, "unknown event name \"%s\"\n", tp_name);
598 static void do_trace_file(Monitor *mon, const QDict *qdict)
600 const char *op = qdict_get_try_str(qdict, "op");
601 const char *arg = qdict_get_try_str(qdict, "arg");
604 st_print_trace_file_status((FILE *)mon, &monitor_fprintf);
605 } else if (!strcmp(op, "on")) {
606 st_set_trace_file_enabled(true);
607 } else if (!strcmp(op, "off")) {
608 st_set_trace_file_enabled(false);
609 } else if (!strcmp(op, "flush")) {
610 st_flush_trace_buffer();
611 } else if (!strcmp(op, "set")) {
613 st_set_trace_file(arg);
616 monitor_printf(mon, "unexpected argument \"%s\"\n", op);
617 help_cmd(mon, "trace-file");
622 static void user_monitor_complete(void *opaque, QObject *ret_data)
624 MonitorCompletionData *data = (MonitorCompletionData *)opaque;
627 data->user_print(data->mon, ret_data);
629 monitor_resume(data->mon);
633 static void qmp_monitor_complete(void *opaque, QObject *ret_data)
635 monitor_protocol_emitter(opaque, ret_data);
638 static int qmp_async_cmd_handler(Monitor *mon, const mon_cmd_t *cmd,
641 return cmd->mhandler.cmd_async(mon, params, qmp_monitor_complete, mon);
644 static void qmp_async_info_handler(Monitor *mon, const mon_cmd_t *cmd)
646 cmd->mhandler.info_async(mon, qmp_monitor_complete, mon);
649 static void user_async_cmd_handler(Monitor *mon, const mon_cmd_t *cmd,
654 MonitorCompletionData *cb_data = qemu_malloc(sizeof(*cb_data));
656 cb_data->user_print = cmd->user_print;
657 monitor_suspend(mon);
658 ret = cmd->mhandler.cmd_async(mon, params,
659 user_monitor_complete, cb_data);
666 static void user_async_info_handler(Monitor *mon, const mon_cmd_t *cmd)
670 MonitorCompletionData *cb_data = qemu_malloc(sizeof(*cb_data));
672 cb_data->user_print = cmd->user_print;
673 monitor_suspend(mon);
674 ret = cmd->mhandler.info_async(mon, user_monitor_complete, cb_data);
681 static void do_info(Monitor *mon, const QDict *qdict)
683 const mon_cmd_t *cmd;
684 const char *item = qdict_get_try_str(qdict, "item");
690 for (cmd = info_cmds; cmd->name != NULL; cmd++) {
691 if (compare_cmd(item, cmd->name))
695 if (cmd->name == NULL) {
699 if (handler_is_async(cmd)) {
700 user_async_info_handler(mon, cmd);
701 } else if (handler_is_qobject(cmd)) {
702 QObject *info_data = NULL;
704 cmd->mhandler.info_new(mon, &info_data);
706 cmd->user_print(mon, info_data);
707 qobject_decref(info_data);
710 cmd->mhandler.info(mon);
716 help_cmd(mon, "info");
719 static void do_info_version_print(Monitor *mon, const QObject *data)
724 qdict = qobject_to_qdict(data);
725 qemu = qdict_get_qdict(qdict, "qemu");
727 monitor_printf(mon, "%" PRId64 ".%" PRId64 ".%" PRId64 "%s\n",
728 qdict_get_int(qemu, "major"),
729 qdict_get_int(qemu, "minor"),
730 qdict_get_int(qemu, "micro"),
731 qdict_get_str(qdict, "package"));
734 static void do_info_version(Monitor *mon, QObject **ret_data)
736 const char *version = QEMU_VERSION;
737 int major = 0, minor = 0, micro = 0;
740 major = strtol(version, &tmp, 10);
742 minor = strtol(tmp, &tmp, 10);
744 micro = strtol(tmp, &tmp, 10);
746 *ret_data = qobject_from_jsonf("{ 'qemu': { 'major': %d, 'minor': %d, \
747 'micro': %d }, 'package': %s }", major, minor, micro, QEMU_PKGVERSION);
750 static void do_info_name_print(Monitor *mon, const QObject *data)
754 qdict = qobject_to_qdict(data);
755 if (qdict_size(qdict) == 0) {
759 monitor_printf(mon, "%s\n", qdict_get_str(qdict, "name"));
762 static void do_info_name(Monitor *mon, QObject **ret_data)
764 *ret_data = qemu_name ? qobject_from_jsonf("{'name': %s }", qemu_name) :
765 qobject_from_jsonf("{}");
768 static QObject *get_cmd_dict(const char *name)
772 /* Remove '|' from some commands */
773 p = strchr(name, '|');
780 return qobject_from_jsonf("{ 'name': %s }", p);
783 static void do_info_commands(Monitor *mon, QObject **ret_data)
786 const mon_cmd_t *cmd;
788 cmd_list = qlist_new();
790 for (cmd = qmp_cmds; cmd->name != NULL; cmd++) {
791 qlist_append_obj(cmd_list, get_cmd_dict(cmd->name));
794 for (cmd = qmp_query_cmds; cmd->name != NULL; cmd++) {
796 snprintf(buf, sizeof(buf), "query-%s", cmd->name);
797 qlist_append_obj(cmd_list, get_cmd_dict(buf));
800 *ret_data = QOBJECT(cmd_list);
803 static void do_info_uuid_print(Monitor *mon, const QObject *data)
805 monitor_printf(mon, "%s\n", qdict_get_str(qobject_to_qdict(data), "UUID"));
808 static void do_info_uuid(Monitor *mon, QObject **ret_data)
812 snprintf(uuid, sizeof(uuid), UUID_FMT, qemu_uuid[0], qemu_uuid[1],
813 qemu_uuid[2], qemu_uuid[3], qemu_uuid[4], qemu_uuid[5],
814 qemu_uuid[6], qemu_uuid[7], qemu_uuid[8], qemu_uuid[9],
815 qemu_uuid[10], qemu_uuid[11], qemu_uuid[12], qemu_uuid[13],
816 qemu_uuid[14], qemu_uuid[15]);
817 *ret_data = qobject_from_jsonf("{ 'UUID': %s }", uuid);
820 /* get the current CPU defined by the user */
821 static int mon_set_cpu(int cpu_index)
825 for(env = first_cpu; env != NULL; env = env->next_cpu) {
826 if (env->cpu_index == cpu_index) {
827 cur_mon->mon_cpu = env;
834 static CPUState *mon_get_cpu(void)
836 if (!cur_mon->mon_cpu) {
839 cpu_synchronize_state(cur_mon->mon_cpu);
840 return cur_mon->mon_cpu;
843 static void do_info_registers(Monitor *mon)
848 cpu_dump_state(env, (FILE *)mon, monitor_fprintf,
851 cpu_dump_state(env, (FILE *)mon, monitor_fprintf,
856 static void print_cpu_iter(QObject *obj, void *opaque)
860 Monitor *mon = opaque;
862 assert(qobject_type(obj) == QTYPE_QDICT);
863 cpu = qobject_to_qdict(obj);
865 if (qdict_get_bool(cpu, "current")) {
869 monitor_printf(mon, "%c CPU #%d: ", active, (int)qdict_get_int(cpu, "CPU"));
871 #if defined(TARGET_I386)
872 monitor_printf(mon, "pc=0x" TARGET_FMT_lx,
873 (target_ulong) qdict_get_int(cpu, "pc"));
874 #elif defined(TARGET_PPC)
875 monitor_printf(mon, "nip=0x" TARGET_FMT_lx,
876 (target_long) qdict_get_int(cpu, "nip"));
877 #elif defined(TARGET_SPARC)
878 monitor_printf(mon, "pc=0x " TARGET_FMT_lx,
879 (target_long) qdict_get_int(cpu, "pc"));
880 monitor_printf(mon, "npc=0x" TARGET_FMT_lx,
881 (target_long) qdict_get_int(cpu, "npc"));
882 #elif defined(TARGET_MIPS)
883 monitor_printf(mon, "PC=0x" TARGET_FMT_lx,
884 (target_long) qdict_get_int(cpu, "PC"));
887 if (qdict_get_bool(cpu, "halted")) {
888 monitor_printf(mon, " (halted)");
891 monitor_printf(mon, "\n");
894 static void monitor_print_cpus(Monitor *mon, const QObject *data)
898 assert(qobject_type(data) == QTYPE_QLIST);
899 cpu_list = qobject_to_qlist(data);
900 qlist_iter(cpu_list, print_cpu_iter, mon);
903 static void do_info_cpus(Monitor *mon, QObject **ret_data)
908 cpu_list = qlist_new();
910 /* just to set the default cpu if not already done */
913 for(env = first_cpu; env != NULL; env = env->next_cpu) {
917 cpu_synchronize_state(env);
919 obj = qobject_from_jsonf("{ 'CPU': %d, 'current': %i, 'halted': %i }",
920 env->cpu_index, env == mon->mon_cpu,
923 cpu = qobject_to_qdict(obj);
925 #if defined(TARGET_I386)
926 qdict_put(cpu, "pc", qint_from_int(env->eip + env->segs[R_CS].base));
927 #elif defined(TARGET_PPC)
928 qdict_put(cpu, "nip", qint_from_int(env->nip));
929 #elif defined(TARGET_SPARC)
930 qdict_put(cpu, "pc", qint_from_int(env->pc));
931 qdict_put(cpu, "npc", qint_from_int(env->npc));
932 #elif defined(TARGET_MIPS)
933 qdict_put(cpu, "PC", qint_from_int(env->active_tc.PC));
936 qlist_append(cpu_list, cpu);
939 *ret_data = QOBJECT(cpu_list);
942 static int do_cpu_set(Monitor *mon, const QDict *qdict, QObject **ret_data)
944 int index = qdict_get_int(qdict, "index");
945 if (mon_set_cpu(index) < 0) {
946 qerror_report(QERR_INVALID_PARAMETER_VALUE, "index",
953 static void do_info_jit(Monitor *mon)
955 dump_exec_info((FILE *)mon, monitor_fprintf);
958 static void do_info_history(Monitor *mon)
967 str = readline_get_history(mon->rs, i);
970 monitor_printf(mon, "%d: '%s'\n", i, str);
975 #if defined(TARGET_PPC)
976 /* XXX: not implemented in other targets */
977 static void do_info_cpu_stats(Monitor *mon)
982 cpu_dump_statistics(env, (FILE *)mon, &monitor_fprintf, 0);
986 #if defined(CONFIG_SIMPLE_TRACE)
987 static void do_info_trace(Monitor *mon)
989 st_print_trace((FILE *)mon, &monitor_fprintf);
992 static void do_info_trace_events(Monitor *mon)
994 st_print_trace_events((FILE *)mon, &monitor_fprintf);
999 * do_quit(): Quit QEMU execution
1001 static int do_quit(Monitor *mon, const QDict *qdict, QObject **ret_data)
1003 monitor_suspend(mon);
1005 qemu_system_shutdown_request();
1010 static int change_vnc_password(const char *password)
1012 if (vnc_display_password(NULL, password) < 0) {
1013 qerror_report(QERR_SET_PASSWD_FAILED);
1020 static void change_vnc_password_cb(Monitor *mon, const char *password,
1023 change_vnc_password(password);
1024 monitor_read_command(mon, 1);
1027 static int do_change_vnc(Monitor *mon, const char *target, const char *arg)
1029 if (strcmp(target, "passwd") == 0 ||
1030 strcmp(target, "password") == 0) {
1033 strncpy(password, arg, sizeof(password));
1034 password[sizeof(password) - 1] = '\0';
1035 return change_vnc_password(password);
1037 return monitor_read_password(mon, change_vnc_password_cb, NULL);
1040 if (vnc_display_open(NULL, target) < 0) {
1041 qerror_report(QERR_VNC_SERVER_FAILED, target);
1050 * do_change(): Change a removable medium, or VNC configuration
1052 static int do_change(Monitor *mon, const QDict *qdict, QObject **ret_data)
1054 const char *device = qdict_get_str(qdict, "device");
1055 const char *target = qdict_get_str(qdict, "target");
1056 const char *arg = qdict_get_try_str(qdict, "arg");
1059 if (strcmp(device, "vnc") == 0) {
1060 ret = do_change_vnc(mon, target, arg);
1062 ret = do_change_block(mon, device, target, arg);
1068 static int do_screen_dump(Monitor *mon, const QDict *qdict, QObject **ret_data)
1070 vga_hw_screen_dump(qdict_get_str(qdict, "filename"));
1074 static void do_logfile(Monitor *mon, const QDict *qdict)
1076 cpu_set_log_filename(qdict_get_str(qdict, "filename"));
1079 static void do_log(Monitor *mon, const QDict *qdict)
1082 const char *items = qdict_get_str(qdict, "items");
1084 if (!strcmp(items, "none")) {
1087 mask = cpu_str_to_log_mask(items);
1089 help_cmd(mon, "log");
1096 static void do_singlestep(Monitor *mon, const QDict *qdict)
1098 const char *option = qdict_get_try_str(qdict, "option");
1099 if (!option || !strcmp(option, "on")) {
1101 } else if (!strcmp(option, "off")) {
1104 monitor_printf(mon, "unexpected option %s\n", option);
1109 * do_stop(): Stop VM execution
1111 static int do_stop(Monitor *mon, const QDict *qdict, QObject **ret_data)
1113 vm_stop(EXCP_INTERRUPT);
1117 static void encrypted_bdrv_it(void *opaque, BlockDriverState *bs);
1119 struct bdrv_iterate_context {
1125 * do_cont(): Resume emulation.
1127 static int do_cont(Monitor *mon, const QDict *qdict, QObject **ret_data)
1129 struct bdrv_iterate_context context = { mon, 0 };
1131 if (incoming_expected) {
1132 qerror_report(QERR_MIGRATION_EXPECTED);
1135 bdrv_iterate(encrypted_bdrv_it, &context);
1136 /* only resume the vm if all keys are set and valid */
1145 static void bdrv_key_cb(void *opaque, int err)
1147 Monitor *mon = opaque;
1149 /* another key was set successfully, retry to continue */
1151 do_cont(mon, NULL, NULL);
1154 static void encrypted_bdrv_it(void *opaque, BlockDriverState *bs)
1156 struct bdrv_iterate_context *context = opaque;
1158 if (!context->err && bdrv_key_required(bs)) {
1159 context->err = -EBUSY;
1160 monitor_read_bdrv_key_start(context->mon, bs, bdrv_key_cb,
1165 static void do_gdbserver(Monitor *mon, const QDict *qdict)
1167 const char *device = qdict_get_try_str(qdict, "device");
1169 device = "tcp::" DEFAULT_GDBSTUB_PORT;
1170 if (gdbserver_start(device) < 0) {
1171 monitor_printf(mon, "Could not open gdbserver on device '%s'\n",
1173 } else if (strcmp(device, "none") == 0) {
1174 monitor_printf(mon, "Disabled gdbserver\n");
1176 monitor_printf(mon, "Waiting for gdb connection on device '%s'\n",
1181 static void do_watchdog_action(Monitor *mon, const QDict *qdict)
1183 const char *action = qdict_get_str(qdict, "action");
1184 if (select_watchdog_action(action) == -1) {
1185 monitor_printf(mon, "Unknown watchdog action '%s'\n", action);
1189 static void monitor_printc(Monitor *mon, int c)
1191 monitor_printf(mon, "'");
1194 monitor_printf(mon, "\\'");
1197 monitor_printf(mon, "\\\\");
1200 monitor_printf(mon, "\\n");
1203 monitor_printf(mon, "\\r");
1206 if (c >= 32 && c <= 126) {
1207 monitor_printf(mon, "%c", c);
1209 monitor_printf(mon, "\\x%02x", c);
1213 monitor_printf(mon, "'");
1216 static void memory_dump(Monitor *mon, int count, int format, int wsize,
1217 target_phys_addr_t addr, int is_physical)
1220 int l, line_size, i, max_digits, len;
1224 if (format == 'i') {
1227 env = mon_get_cpu();
1231 } else if (wsize == 4) {
1234 /* as default we use the current CS size */
1237 #ifdef TARGET_X86_64
1238 if ((env->efer & MSR_EFER_LMA) &&
1239 (env->segs[R_CS].flags & DESC_L_MASK))
1243 if (!(env->segs[R_CS].flags & DESC_B_MASK))
1248 monitor_disas(mon, env, addr, count, is_physical, flags);
1252 len = wsize * count;
1261 max_digits = (wsize * 8 + 2) / 3;
1265 max_digits = (wsize * 8) / 4;
1269 max_digits = (wsize * 8 * 10 + 32) / 33;
1278 monitor_printf(mon, TARGET_FMT_plx ":", addr);
1280 monitor_printf(mon, TARGET_FMT_lx ":", (target_ulong)addr);
1285 cpu_physical_memory_rw(addr, buf, l, 0);
1287 env = mon_get_cpu();
1288 if (cpu_memory_rw_debug(env, addr, buf, l, 0) < 0) {
1289 monitor_printf(mon, " Cannot access memory\n");
1298 v = ldub_raw(buf + i);
1301 v = lduw_raw(buf + i);
1304 v = (uint32_t)ldl_raw(buf + i);
1307 v = ldq_raw(buf + i);
1310 monitor_printf(mon, " ");
1313 monitor_printf(mon, "%#*" PRIo64, max_digits, v);
1316 monitor_printf(mon, "0x%0*" PRIx64, max_digits, v);
1319 monitor_printf(mon, "%*" PRIu64, max_digits, v);
1322 monitor_printf(mon, "%*" PRId64, max_digits, v);
1325 monitor_printc(mon, v);
1330 monitor_printf(mon, "\n");
1336 static void do_memory_dump(Monitor *mon, const QDict *qdict)
1338 int count = qdict_get_int(qdict, "count");
1339 int format = qdict_get_int(qdict, "format");
1340 int size = qdict_get_int(qdict, "size");
1341 target_long addr = qdict_get_int(qdict, "addr");
1343 memory_dump(mon, count, format, size, addr, 0);
1346 static void do_physical_memory_dump(Monitor *mon, const QDict *qdict)
1348 int count = qdict_get_int(qdict, "count");
1349 int format = qdict_get_int(qdict, "format");
1350 int size = qdict_get_int(qdict, "size");
1351 target_phys_addr_t addr = qdict_get_int(qdict, "addr");
1353 memory_dump(mon, count, format, size, addr, 1);
1356 static void do_print(Monitor *mon, const QDict *qdict)
1358 int format = qdict_get_int(qdict, "format");
1359 target_phys_addr_t val = qdict_get_int(qdict, "val");
1361 #if TARGET_PHYS_ADDR_BITS == 32
1364 monitor_printf(mon, "%#o", val);
1367 monitor_printf(mon, "%#x", val);
1370 monitor_printf(mon, "%u", val);
1374 monitor_printf(mon, "%d", val);
1377 monitor_printc(mon, val);
1383 monitor_printf(mon, "%#" PRIo64, val);
1386 monitor_printf(mon, "%#" PRIx64, val);
1389 monitor_printf(mon, "%" PRIu64, val);
1393 monitor_printf(mon, "%" PRId64, val);
1396 monitor_printc(mon, val);
1400 monitor_printf(mon, "\n");
1403 static int do_memory_save(Monitor *mon, const QDict *qdict, QObject **ret_data)
1406 uint32_t size = qdict_get_int(qdict, "size");
1407 const char *filename = qdict_get_str(qdict, "filename");
1408 target_long addr = qdict_get_int(qdict, "val");
1414 env = mon_get_cpu();
1416 f = fopen(filename, "wb");
1418 qerror_report(QERR_OPEN_FILE_FAILED, filename);
1425 cpu_memory_rw_debug(env, addr, buf, l, 0);
1426 if (fwrite(buf, 1, l, f) != l) {
1427 monitor_printf(mon, "fwrite() error in do_memory_save\n");
1441 static int do_physical_memory_save(Monitor *mon, const QDict *qdict,
1447 uint32_t size = qdict_get_int(qdict, "size");
1448 const char *filename = qdict_get_str(qdict, "filename");
1449 target_phys_addr_t addr = qdict_get_int(qdict, "val");
1452 f = fopen(filename, "wb");
1454 qerror_report(QERR_OPEN_FILE_FAILED, filename);
1461 cpu_physical_memory_rw(addr, buf, l, 0);
1462 if (fwrite(buf, 1, l, f) != l) {
1463 monitor_printf(mon, "fwrite() error in do_physical_memory_save\n");
1478 static void do_sum(Monitor *mon, const QDict *qdict)
1483 uint32_t start = qdict_get_int(qdict, "start");
1484 uint32_t size = qdict_get_int(qdict, "size");
1487 for(addr = start; addr < (start + size); addr++) {
1488 cpu_physical_memory_rw(addr, buf, 1, 0);
1489 /* BSD sum algorithm ('sum' Unix command) */
1490 sum = (sum >> 1) | (sum << 15);
1493 monitor_printf(mon, "%05d\n", sum);
1501 static const KeyDef key_defs[] = {
1503 { 0x36, "shift_r" },
1508 { 0xe4, "altgr_r" },
1528 { 0x0e, "backspace" },
1541 { 0x1a, "bracket_left" },
1542 { 0x1b, "bracket_right" },
1554 { 0x27, "semicolon" },
1555 { 0x28, "apostrophe" },
1556 { 0x29, "grave_accent" },
1558 { 0x2b, "backslash" },
1570 { 0x37, "asterisk" },
1573 { 0x3a, "caps_lock" },
1584 { 0x45, "num_lock" },
1585 { 0x46, "scroll_lock" },
1587 { 0xb5, "kp_divide" },
1588 { 0x37, "kp_multiply" },
1589 { 0x4a, "kp_subtract" },
1591 { 0x9c, "kp_enter" },
1592 { 0x53, "kp_decimal" },
1625 #if defined(TARGET_SPARC) && !defined(TARGET_SPARC64)
1640 { 0xfe, "compose" },
1645 static int get_keycode(const char *key)
1651 for(p = key_defs; p->name != NULL; p++) {
1652 if (!strcmp(key, p->name))
1655 if (strstart(key, "0x", NULL)) {
1656 ret = strtoul(key, &endp, 0);
1657 if (*endp == '\0' && ret >= 0x01 && ret <= 0xff)
1663 #define MAX_KEYCODES 16
1664 static uint8_t keycodes[MAX_KEYCODES];
1665 static int nb_pending_keycodes;
1666 static QEMUTimer *key_timer;
1668 static void release_keys(void *opaque)
1672 while (nb_pending_keycodes > 0) {
1673 nb_pending_keycodes--;
1674 keycode = keycodes[nb_pending_keycodes];
1676 kbd_put_keycode(0xe0);
1677 kbd_put_keycode(keycode | 0x80);
1681 static void do_sendkey(Monitor *mon, const QDict *qdict)
1683 char keyname_buf[16];
1685 int keyname_len, keycode, i;
1686 const char *string = qdict_get_str(qdict, "string");
1687 int has_hold_time = qdict_haskey(qdict, "hold_time");
1688 int hold_time = qdict_get_try_int(qdict, "hold_time", -1);
1690 if (nb_pending_keycodes > 0) {
1691 qemu_del_timer(key_timer);
1698 separator = strchr(string, '-');
1699 keyname_len = separator ? separator - string : strlen(string);
1700 if (keyname_len > 0) {
1701 pstrcpy(keyname_buf, sizeof(keyname_buf), string);
1702 if (keyname_len > sizeof(keyname_buf) - 1) {
1703 monitor_printf(mon, "invalid key: '%s...'\n", keyname_buf);
1706 if (i == MAX_KEYCODES) {
1707 monitor_printf(mon, "too many keys\n");
1710 keyname_buf[keyname_len] = 0;
1711 keycode = get_keycode(keyname_buf);
1713 monitor_printf(mon, "unknown key: '%s'\n", keyname_buf);
1716 keycodes[i++] = keycode;
1720 string = separator + 1;
1722 nb_pending_keycodes = i;
1723 /* key down events */
1724 for (i = 0; i < nb_pending_keycodes; i++) {
1725 keycode = keycodes[i];
1727 kbd_put_keycode(0xe0);
1728 kbd_put_keycode(keycode & 0x7f);
1730 /* delayed key up events */
1731 qemu_mod_timer(key_timer, qemu_get_clock(vm_clock) +
1732 muldiv64(get_ticks_per_sec(), hold_time, 1000));
1735 static int mouse_button_state;
1737 static void do_mouse_move(Monitor *mon, const QDict *qdict)
1740 const char *dx_str = qdict_get_str(qdict, "dx_str");
1741 const char *dy_str = qdict_get_str(qdict, "dy_str");
1742 const char *dz_str = qdict_get_try_str(qdict, "dz_str");
1743 dx = strtol(dx_str, NULL, 0);
1744 dy = strtol(dy_str, NULL, 0);
1747 dz = strtol(dz_str, NULL, 0);
1748 kbd_mouse_event(dx, dy, dz, mouse_button_state);
1751 static void do_mouse_button(Monitor *mon, const QDict *qdict)
1753 int button_state = qdict_get_int(qdict, "button_state");
1754 mouse_button_state = button_state;
1755 kbd_mouse_event(0, 0, 0, mouse_button_state);
1758 static void do_ioport_read(Monitor *mon, const QDict *qdict)
1760 int size = qdict_get_int(qdict, "size");
1761 int addr = qdict_get_int(qdict, "addr");
1762 int has_index = qdict_haskey(qdict, "index");
1767 int index = qdict_get_int(qdict, "index");
1768 cpu_outb(addr & IOPORTS_MASK, index & 0xff);
1776 val = cpu_inb(addr);
1780 val = cpu_inw(addr);
1784 val = cpu_inl(addr);
1788 monitor_printf(mon, "port%c[0x%04x] = %#0*x\n",
1789 suffix, addr, size * 2, val);
1792 static void do_ioport_write(Monitor *mon, const QDict *qdict)
1794 int size = qdict_get_int(qdict, "size");
1795 int addr = qdict_get_int(qdict, "addr");
1796 int val = qdict_get_int(qdict, "val");
1798 addr &= IOPORTS_MASK;
1803 cpu_outb(addr, val);
1806 cpu_outw(addr, val);
1809 cpu_outl(addr, val);
1814 static void do_boot_set(Monitor *mon, const QDict *qdict)
1817 const char *bootdevice = qdict_get_str(qdict, "bootdevice");
1819 res = qemu_boot_set(bootdevice);
1821 monitor_printf(mon, "boot device list now set to %s\n", bootdevice);
1822 } else if (res > 0) {
1823 monitor_printf(mon, "setting boot device list failed\n");
1825 monitor_printf(mon, "no function defined to set boot device list for "
1826 "this architecture\n");
1831 * do_system_reset(): Issue a machine reset
1833 static int do_system_reset(Monitor *mon, const QDict *qdict,
1836 qemu_system_reset_request();
1841 * do_system_powerdown(): Issue a machine powerdown
1843 static int do_system_powerdown(Monitor *mon, const QDict *qdict,
1846 qemu_system_powerdown_request();
1850 #if defined(TARGET_I386)
1851 static void print_pte(Monitor *mon, uint32_t addr, uint32_t pte, uint32_t mask)
1853 monitor_printf(mon, "%08x: %08x %c%c%c%c%c%c%c%c\n",
1856 pte & PG_GLOBAL_MASK ? 'G' : '-',
1857 pte & PG_PSE_MASK ? 'P' : '-',
1858 pte & PG_DIRTY_MASK ? 'D' : '-',
1859 pte & PG_ACCESSED_MASK ? 'A' : '-',
1860 pte & PG_PCD_MASK ? 'C' : '-',
1861 pte & PG_PWT_MASK ? 'T' : '-',
1862 pte & PG_USER_MASK ? 'U' : '-',
1863 pte & PG_RW_MASK ? 'W' : '-');
1866 static void tlb_info(Monitor *mon)
1870 uint32_t pgd, pde, pte;
1872 env = mon_get_cpu();
1874 if (!(env->cr[0] & CR0_PG_MASK)) {
1875 monitor_printf(mon, "PG disabled\n");
1878 pgd = env->cr[3] & ~0xfff;
1879 for(l1 = 0; l1 < 1024; l1++) {
1880 cpu_physical_memory_read(pgd + l1 * 4, (uint8_t *)&pde, 4);
1881 pde = le32_to_cpu(pde);
1882 if (pde & PG_PRESENT_MASK) {
1883 if ((pde & PG_PSE_MASK) && (env->cr[4] & CR4_PSE_MASK)) {
1884 print_pte(mon, (l1 << 22), pde, ~((1 << 20) - 1));
1886 for(l2 = 0; l2 < 1024; l2++) {
1887 cpu_physical_memory_read((pde & ~0xfff) + l2 * 4,
1888 (uint8_t *)&pte, 4);
1889 pte = le32_to_cpu(pte);
1890 if (pte & PG_PRESENT_MASK) {
1891 print_pte(mon, (l1 << 22) + (l2 << 12),
1901 static void mem_print(Monitor *mon, uint32_t *pstart, int *plast_prot,
1902 uint32_t end, int prot)
1905 prot1 = *plast_prot;
1906 if (prot != prot1) {
1907 if (*pstart != -1) {
1908 monitor_printf(mon, "%08x-%08x %08x %c%c%c\n",
1909 *pstart, end, end - *pstart,
1910 prot1 & PG_USER_MASK ? 'u' : '-',
1912 prot1 & PG_RW_MASK ? 'w' : '-');
1922 static void mem_info(Monitor *mon)
1925 int l1, l2, prot, last_prot;
1926 uint32_t pgd, pde, pte, start, end;
1928 env = mon_get_cpu();
1930 if (!(env->cr[0] & CR0_PG_MASK)) {
1931 monitor_printf(mon, "PG disabled\n");
1934 pgd = env->cr[3] & ~0xfff;
1937 for(l1 = 0; l1 < 1024; l1++) {
1938 cpu_physical_memory_read(pgd + l1 * 4, (uint8_t *)&pde, 4);
1939 pde = le32_to_cpu(pde);
1941 if (pde & PG_PRESENT_MASK) {
1942 if ((pde & PG_PSE_MASK) && (env->cr[4] & CR4_PSE_MASK)) {
1943 prot = pde & (PG_USER_MASK | PG_RW_MASK | PG_PRESENT_MASK);
1944 mem_print(mon, &start, &last_prot, end, prot);
1946 for(l2 = 0; l2 < 1024; l2++) {
1947 cpu_physical_memory_read((pde & ~0xfff) + l2 * 4,
1948 (uint8_t *)&pte, 4);
1949 pte = le32_to_cpu(pte);
1950 end = (l1 << 22) + (l2 << 12);
1951 if (pte & PG_PRESENT_MASK) {
1952 prot = pte & (PG_USER_MASK | PG_RW_MASK | PG_PRESENT_MASK);
1956 mem_print(mon, &start, &last_prot, end, prot);
1961 mem_print(mon, &start, &last_prot, end, prot);
1967 #if defined(TARGET_SH4)
1969 static void print_tlb(Monitor *mon, int idx, tlb_t *tlb)
1971 monitor_printf(mon, " tlb%i:\t"
1972 "asid=%hhu vpn=%x\tppn=%x\tsz=%hhu size=%u\t"
1973 "v=%hhu shared=%hhu cached=%hhu prot=%hhu "
1974 "dirty=%hhu writethrough=%hhu\n",
1976 tlb->asid, tlb->vpn, tlb->ppn, tlb->sz, tlb->size,
1977 tlb->v, tlb->sh, tlb->c, tlb->pr,
1981 static void tlb_info(Monitor *mon)
1983 CPUState *env = mon_get_cpu();
1986 monitor_printf (mon, "ITLB:\n");
1987 for (i = 0 ; i < ITLB_SIZE ; i++)
1988 print_tlb (mon, i, &env->itlb[i]);
1989 monitor_printf (mon, "UTLB:\n");
1990 for (i = 0 ; i < UTLB_SIZE ; i++)
1991 print_tlb (mon, i, &env->utlb[i]);
1996 static void do_info_kvm_print(Monitor *mon, const QObject *data)
2000 qdict = qobject_to_qdict(data);
2002 monitor_printf(mon, "kvm support: ");
2003 if (qdict_get_bool(qdict, "present")) {
2004 monitor_printf(mon, "%s\n", qdict_get_bool(qdict, "enabled") ?
2005 "enabled" : "disabled");
2007 monitor_printf(mon, "not compiled\n");
2011 static void do_info_kvm(Monitor *mon, QObject **ret_data)
2014 *ret_data = qobject_from_jsonf("{ 'enabled': %i, 'present': true }",
2017 *ret_data = qobject_from_jsonf("{ 'enabled': false, 'present': false }");
2021 static void do_info_numa(Monitor *mon)
2026 monitor_printf(mon, "%d nodes\n", nb_numa_nodes);
2027 for (i = 0; i < nb_numa_nodes; i++) {
2028 monitor_printf(mon, "node %d cpus:", i);
2029 for (env = first_cpu; env != NULL; env = env->next_cpu) {
2030 if (env->numa_node == i) {
2031 monitor_printf(mon, " %d", env->cpu_index);
2034 monitor_printf(mon, "\n");
2035 monitor_printf(mon, "node %d size: %" PRId64 " MB\n", i,
2040 #ifdef CONFIG_PROFILER
2045 static void do_info_profile(Monitor *mon)
2051 monitor_printf(mon, "async time %" PRId64 " (%0.3f)\n",
2052 dev_time, dev_time / (double)get_ticks_per_sec());
2053 monitor_printf(mon, "qemu time %" PRId64 " (%0.3f)\n",
2054 qemu_time, qemu_time / (double)get_ticks_per_sec());
2059 static void do_info_profile(Monitor *mon)
2061 monitor_printf(mon, "Internal profiler not compiled\n");
2065 /* Capture support */
2066 static QLIST_HEAD (capture_list_head, CaptureState) capture_head;
2068 static void do_info_capture(Monitor *mon)
2073 for (s = capture_head.lh_first, i = 0; s; s = s->entries.le_next, ++i) {
2074 monitor_printf(mon, "[%d]: ", i);
2075 s->ops.info (s->opaque);
2080 static void do_stop_capture(Monitor *mon, const QDict *qdict)
2083 int n = qdict_get_int(qdict, "n");
2086 for (s = capture_head.lh_first, i = 0; s; s = s->entries.le_next, ++i) {
2088 s->ops.destroy (s->opaque);
2089 QLIST_REMOVE (s, entries);
2096 static void do_wav_capture(Monitor *mon, const QDict *qdict)
2098 const char *path = qdict_get_str(qdict, "path");
2099 int has_freq = qdict_haskey(qdict, "freq");
2100 int freq = qdict_get_try_int(qdict, "freq", -1);
2101 int has_bits = qdict_haskey(qdict, "bits");
2102 int bits = qdict_get_try_int(qdict, "bits", -1);
2103 int has_channels = qdict_haskey(qdict, "nchannels");
2104 int nchannels = qdict_get_try_int(qdict, "nchannels", -1);
2107 s = qemu_mallocz (sizeof (*s));
2109 freq = has_freq ? freq : 44100;
2110 bits = has_bits ? bits : 16;
2111 nchannels = has_channels ? nchannels : 2;
2113 if (wav_start_capture (s, path, freq, bits, nchannels)) {
2114 monitor_printf(mon, "Faied to add wave capture\n");
2117 QLIST_INSERT_HEAD (&capture_head, s, entries);
2121 #if defined(TARGET_I386)
2122 static void do_inject_nmi(Monitor *mon, const QDict *qdict)
2125 int cpu_index = qdict_get_int(qdict, "cpu_index");
2127 for (env = first_cpu; env != NULL; env = env->next_cpu)
2128 if (env->cpu_index == cpu_index) {
2129 cpu_interrupt(env, CPU_INTERRUPT_NMI);
2135 static void do_info_status_print(Monitor *mon, const QObject *data)
2139 qdict = qobject_to_qdict(data);
2141 monitor_printf(mon, "VM status: ");
2142 if (qdict_get_bool(qdict, "running")) {
2143 monitor_printf(mon, "running");
2144 if (qdict_get_bool(qdict, "singlestep")) {
2145 monitor_printf(mon, " (single step mode)");
2148 monitor_printf(mon, "paused");
2151 monitor_printf(mon, "\n");
2154 static void do_info_status(Monitor *mon, QObject **ret_data)
2156 *ret_data = qobject_from_jsonf("{ 'running': %i, 'singlestep': %i }",
2157 vm_running, singlestep);
2160 static qemu_acl *find_acl(Monitor *mon, const char *name)
2162 qemu_acl *acl = qemu_acl_find(name);
2165 monitor_printf(mon, "acl: unknown list '%s'\n", name);
2170 static void do_acl_show(Monitor *mon, const QDict *qdict)
2172 const char *aclname = qdict_get_str(qdict, "aclname");
2173 qemu_acl *acl = find_acl(mon, aclname);
2174 qemu_acl_entry *entry;
2178 monitor_printf(mon, "policy: %s\n",
2179 acl->defaultDeny ? "deny" : "allow");
2180 QTAILQ_FOREACH(entry, &acl->entries, next) {
2182 monitor_printf(mon, "%d: %s %s\n", i,
2183 entry->deny ? "deny" : "allow", entry->match);
2188 static void do_acl_reset(Monitor *mon, const QDict *qdict)
2190 const char *aclname = qdict_get_str(qdict, "aclname");
2191 qemu_acl *acl = find_acl(mon, aclname);
2194 qemu_acl_reset(acl);
2195 monitor_printf(mon, "acl: removed all rules\n");
2199 static void do_acl_policy(Monitor *mon, const QDict *qdict)
2201 const char *aclname = qdict_get_str(qdict, "aclname");
2202 const char *policy = qdict_get_str(qdict, "policy");
2203 qemu_acl *acl = find_acl(mon, aclname);
2206 if (strcmp(policy, "allow") == 0) {
2207 acl->defaultDeny = 0;
2208 monitor_printf(mon, "acl: policy set to 'allow'\n");
2209 } else if (strcmp(policy, "deny") == 0) {
2210 acl->defaultDeny = 1;
2211 monitor_printf(mon, "acl: policy set to 'deny'\n");
2213 monitor_printf(mon, "acl: unknown policy '%s', "
2214 "expected 'deny' or 'allow'\n", policy);
2219 static void do_acl_add(Monitor *mon, const QDict *qdict)
2221 const char *aclname = qdict_get_str(qdict, "aclname");
2222 const char *match = qdict_get_str(qdict, "match");
2223 const char *policy = qdict_get_str(qdict, "policy");
2224 int has_index = qdict_haskey(qdict, "index");
2225 int index = qdict_get_try_int(qdict, "index", -1);
2226 qemu_acl *acl = find_acl(mon, aclname);
2230 if (strcmp(policy, "allow") == 0) {
2232 } else if (strcmp(policy, "deny") == 0) {
2235 monitor_printf(mon, "acl: unknown policy '%s', "
2236 "expected 'deny' or 'allow'\n", policy);
2240 ret = qemu_acl_insert(acl, deny, match, index);
2242 ret = qemu_acl_append(acl, deny, match);
2244 monitor_printf(mon, "acl: unable to add acl entry\n");
2246 monitor_printf(mon, "acl: added rule at position %d\n", ret);
2250 static void do_acl_remove(Monitor *mon, const QDict *qdict)
2252 const char *aclname = qdict_get_str(qdict, "aclname");
2253 const char *match = qdict_get_str(qdict, "match");
2254 qemu_acl *acl = find_acl(mon, aclname);
2258 ret = qemu_acl_remove(acl, match);
2260 monitor_printf(mon, "acl: no matching acl entry\n");
2262 monitor_printf(mon, "acl: removed rule at position %d\n", ret);
2266 #if defined(TARGET_I386)
2267 static void do_inject_mce(Monitor *mon, const QDict *qdict)
2270 int cpu_index = qdict_get_int(qdict, "cpu_index");
2271 int bank = qdict_get_int(qdict, "bank");
2272 uint64_t status = qdict_get_int(qdict, "status");
2273 uint64_t mcg_status = qdict_get_int(qdict, "mcg_status");
2274 uint64_t addr = qdict_get_int(qdict, "addr");
2275 uint64_t misc = qdict_get_int(qdict, "misc");
2277 for (cenv = first_cpu; cenv != NULL; cenv = cenv->next_cpu)
2278 if (cenv->cpu_index == cpu_index && cenv->mcg_cap) {
2279 cpu_inject_x86_mce(cenv, bank, status, mcg_status, addr, misc);
2285 static int do_getfd(Monitor *mon, const QDict *qdict, QObject **ret_data)
2287 const char *fdname = qdict_get_str(qdict, "fdname");
2291 fd = qemu_chr_get_msgfd(mon->chr);
2293 qerror_report(QERR_FD_NOT_SUPPLIED);
2297 if (qemu_isdigit(fdname[0])) {
2298 qerror_report(QERR_INVALID_PARAMETER_VALUE, "fdname",
2299 "a name not starting with a digit");
2303 QLIST_FOREACH(monfd, &mon->fds, next) {
2304 if (strcmp(monfd->name, fdname) != 0) {
2313 monfd = qemu_mallocz(sizeof(mon_fd_t));
2314 monfd->name = qemu_strdup(fdname);
2317 QLIST_INSERT_HEAD(&mon->fds, monfd, next);
2321 static int do_closefd(Monitor *mon, const QDict *qdict, QObject **ret_data)
2323 const char *fdname = qdict_get_str(qdict, "fdname");
2326 QLIST_FOREACH(monfd, &mon->fds, next) {
2327 if (strcmp(monfd->name, fdname) != 0) {
2331 QLIST_REMOVE(monfd, next);
2333 qemu_free(monfd->name);
2338 qerror_report(QERR_FD_NOT_FOUND, fdname);
2342 static void do_loadvm(Monitor *mon, const QDict *qdict)
2344 int saved_vm_running = vm_running;
2345 const char *name = qdict_get_str(qdict, "name");
2349 if (load_vmstate(name) == 0 && saved_vm_running) {
2354 int monitor_get_fd(Monitor *mon, const char *fdname)
2358 QLIST_FOREACH(monfd, &mon->fds, next) {
2361 if (strcmp(monfd->name, fdname) != 0) {
2367 /* caller takes ownership of fd */
2368 QLIST_REMOVE(monfd, next);
2369 qemu_free(monfd->name);
2378 static const mon_cmd_t mon_cmds[] = {
2379 #include "hmp-commands.h"
2383 /* Please update hmp-commands.hx when adding or changing commands */
2384 static const mon_cmd_t info_cmds[] = {
2389 .help = "show the version of QEMU",
2390 .user_print = do_info_version_print,
2391 .mhandler.info_new = do_info_version,
2397 .help = "show the network state",
2398 .mhandler.info = do_info_network,
2404 .help = "show the character devices",
2405 .user_print = qemu_chr_info_print,
2406 .mhandler.info_new = qemu_chr_info,
2412 .help = "show the block devices",
2413 .user_print = bdrv_info_print,
2414 .mhandler.info_new = bdrv_info,
2417 .name = "blockstats",
2420 .help = "show block device statistics",
2421 .user_print = bdrv_stats_print,
2422 .mhandler.info_new = bdrv_info_stats,
2425 .name = "registers",
2428 .help = "show the cpu registers",
2429 .mhandler.info = do_info_registers,
2435 .help = "show infos for each CPU",
2436 .user_print = monitor_print_cpus,
2437 .mhandler.info_new = do_info_cpus,
2443 .help = "show the command line history",
2444 .mhandler.info = do_info_history,
2450 .help = "show the interrupts statistics (if available)",
2451 .mhandler.info = irq_info,
2457 .help = "show i8259 (PIC) state",
2458 .mhandler.info = pic_info,
2464 .help = "show PCI info",
2465 .user_print = do_pci_info_print,
2466 .mhandler.info_new = do_pci_info,
2468 #if defined(TARGET_I386) || defined(TARGET_SH4)
2473 .help = "show virtual to physical memory mappings",
2474 .mhandler.info = tlb_info,
2477 #if defined(TARGET_I386)
2482 .help = "show the active virtual memory mappings",
2483 .mhandler.info = mem_info,
2490 .help = "show dynamic compiler info",
2491 .mhandler.info = do_info_jit,
2497 .help = "show KVM information",
2498 .user_print = do_info_kvm_print,
2499 .mhandler.info_new = do_info_kvm,
2505 .help = "show NUMA information",
2506 .mhandler.info = do_info_numa,
2512 .help = "show guest USB devices",
2513 .mhandler.info = usb_info,
2519 .help = "show host USB devices",
2520 .mhandler.info = usb_host_info,
2526 .help = "show profiling information",
2527 .mhandler.info = do_info_profile,
2533 .help = "show capture information",
2534 .mhandler.info = do_info_capture,
2537 .name = "snapshots",
2540 .help = "show the currently saved VM snapshots",
2541 .mhandler.info = do_info_snapshots,
2547 .help = "show the current VM status (running|paused)",
2548 .user_print = do_info_status_print,
2549 .mhandler.info_new = do_info_status,
2555 .help = "show guest PCMCIA status",
2556 .mhandler.info = pcmcia_info,
2562 .help = "show which guest mouse is receiving events",
2563 .user_print = do_info_mice_print,
2564 .mhandler.info_new = do_info_mice,
2570 .help = "show the vnc server status",
2571 .user_print = do_info_vnc_print,
2572 .mhandler.info_new = do_info_vnc,
2578 .help = "show the current VM name",
2579 .user_print = do_info_name_print,
2580 .mhandler.info_new = do_info_name,
2586 .help = "show the current VM UUID",
2587 .user_print = do_info_uuid_print,
2588 .mhandler.info_new = do_info_uuid,
2590 #if defined(TARGET_PPC)
2595 .help = "show CPU statistics",
2596 .mhandler.info = do_info_cpu_stats,
2599 #if defined(CONFIG_SLIRP)
2604 .help = "show user network stack connection states",
2605 .mhandler.info = do_info_usernet,
2612 .help = "show migration status",
2613 .user_print = do_info_migrate_print,
2614 .mhandler.info_new = do_info_migrate,
2620 .help = "show balloon information",
2621 .user_print = monitor_print_balloon,
2622 .mhandler.info_async = do_info_balloon,
2623 .flags = MONITOR_CMD_ASYNC,
2629 .help = "show device tree",
2630 .mhandler.info = do_info_qtree,
2636 .help = "show qdev device model list",
2637 .mhandler.info = do_info_qdm,
2643 .help = "show roms",
2644 .mhandler.info = do_info_roms,
2646 #if defined(CONFIG_SIMPLE_TRACE)
2651 .help = "show current contents of trace buffer",
2652 .mhandler.info = do_info_trace,
2655 .name = "trace-events",
2658 .help = "show available trace-events & their state",
2659 .mhandler.info = do_info_trace_events,
2667 static const mon_cmd_t qmp_cmds[] = {
2668 #include "qmp-commands.h"
2672 static const mon_cmd_t qmp_query_cmds[] = {
2677 .help = "show the version of QEMU",
2678 .user_print = do_info_version_print,
2679 .mhandler.info_new = do_info_version,
2685 .help = "list QMP available commands",
2686 .user_print = monitor_user_noop,
2687 .mhandler.info_new = do_info_commands,
2693 .help = "show the character devices",
2694 .user_print = qemu_chr_info_print,
2695 .mhandler.info_new = qemu_chr_info,
2701 .help = "show the block devices",
2702 .user_print = bdrv_info_print,
2703 .mhandler.info_new = bdrv_info,
2706 .name = "blockstats",
2709 .help = "show block device statistics",
2710 .user_print = bdrv_stats_print,
2711 .mhandler.info_new = bdrv_info_stats,
2717 .help = "show infos for each CPU",
2718 .user_print = monitor_print_cpus,
2719 .mhandler.info_new = do_info_cpus,
2725 .help = "show PCI info",
2726 .user_print = do_pci_info_print,
2727 .mhandler.info_new = do_pci_info,
2733 .help = "show KVM information",
2734 .user_print = do_info_kvm_print,
2735 .mhandler.info_new = do_info_kvm,
2741 .help = "show the current VM status (running|paused)",
2742 .user_print = do_info_status_print,
2743 .mhandler.info_new = do_info_status,
2749 .help = "show which guest mouse is receiving events",
2750 .user_print = do_info_mice_print,
2751 .mhandler.info_new = do_info_mice,
2757 .help = "show the vnc server status",
2758 .user_print = do_info_vnc_print,
2759 .mhandler.info_new = do_info_vnc,
2765 .help = "show the current VM name",
2766 .user_print = do_info_name_print,
2767 .mhandler.info_new = do_info_name,
2773 .help = "show the current VM UUID",
2774 .user_print = do_info_uuid_print,
2775 .mhandler.info_new = do_info_uuid,
2781 .help = "show migration status",
2782 .user_print = do_info_migrate_print,
2783 .mhandler.info_new = do_info_migrate,
2789 .help = "show balloon information",
2790 .user_print = monitor_print_balloon,
2791 .mhandler.info_async = do_info_balloon,
2792 .flags = MONITOR_CMD_ASYNC,
2797 /*******************************************************************/
2799 static const char *pch;
2800 static jmp_buf expr_env;
2805 typedef struct MonitorDef {
2808 target_long (*get_value)(const struct MonitorDef *md, int val);
2812 #if defined(TARGET_I386)
2813 static target_long monitor_get_pc (const struct MonitorDef *md, int val)
2815 CPUState *env = mon_get_cpu();
2816 return env->eip + env->segs[R_CS].base;
2820 #if defined(TARGET_PPC)
2821 static target_long monitor_get_ccr (const struct MonitorDef *md, int val)
2823 CPUState *env = mon_get_cpu();
2828 for (i = 0; i < 8; i++)
2829 u |= env->crf[i] << (32 - (4 * i));
2834 static target_long monitor_get_msr (const struct MonitorDef *md, int val)
2836 CPUState *env = mon_get_cpu();
2840 static target_long monitor_get_xer (const struct MonitorDef *md, int val)
2842 CPUState *env = mon_get_cpu();
2846 static target_long monitor_get_decr (const struct MonitorDef *md, int val)
2848 CPUState *env = mon_get_cpu();
2849 return cpu_ppc_load_decr(env);
2852 static target_long monitor_get_tbu (const struct MonitorDef *md, int val)
2854 CPUState *env = mon_get_cpu();
2855 return cpu_ppc_load_tbu(env);
2858 static target_long monitor_get_tbl (const struct MonitorDef *md, int val)
2860 CPUState *env = mon_get_cpu();
2861 return cpu_ppc_load_tbl(env);
2865 #if defined(TARGET_SPARC)
2866 #ifndef TARGET_SPARC64
2867 static target_long monitor_get_psr (const struct MonitorDef *md, int val)
2869 CPUState *env = mon_get_cpu();
2871 return cpu_get_psr(env);
2875 static target_long monitor_get_reg(const struct MonitorDef *md, int val)
2877 CPUState *env = mon_get_cpu();
2878 return env->regwptr[val];
2882 static const MonitorDef monitor_defs[] = {
2885 #define SEG(name, seg) \
2886 { name, offsetof(CPUState, segs[seg].selector), NULL, MD_I32 },\
2887 { name ".base", offsetof(CPUState, segs[seg].base) },\
2888 { name ".limit", offsetof(CPUState, segs[seg].limit), NULL, MD_I32 },
2890 { "eax", offsetof(CPUState, regs[0]) },
2891 { "ecx", offsetof(CPUState, regs[1]) },
2892 { "edx", offsetof(CPUState, regs[2]) },
2893 { "ebx", offsetof(CPUState, regs[3]) },
2894 { "esp|sp", offsetof(CPUState, regs[4]) },
2895 { "ebp|fp", offsetof(CPUState, regs[5]) },
2896 { "esi", offsetof(CPUState, regs[6]) },
2897 { "edi", offsetof(CPUState, regs[7]) },
2898 #ifdef TARGET_X86_64
2899 { "r8", offsetof(CPUState, regs[8]) },
2900 { "r9", offsetof(CPUState, regs[9]) },
2901 { "r10", offsetof(CPUState, regs[10]) },
2902 { "r11", offsetof(CPUState, regs[11]) },
2903 { "r12", offsetof(CPUState, regs[12]) },
2904 { "r13", offsetof(CPUState, regs[13]) },
2905 { "r14", offsetof(CPUState, regs[14]) },
2906 { "r15", offsetof(CPUState, regs[15]) },
2908 { "eflags", offsetof(CPUState, eflags) },
2909 { "eip", offsetof(CPUState, eip) },
2916 { "pc", 0, monitor_get_pc, },
2917 #elif defined(TARGET_PPC)
2918 /* General purpose registers */
2919 { "r0", offsetof(CPUState, gpr[0]) },
2920 { "r1", offsetof(CPUState, gpr[1]) },
2921 { "r2", offsetof(CPUState, gpr[2]) },
2922 { "r3", offsetof(CPUState, gpr[3]) },
2923 { "r4", offsetof(CPUState, gpr[4]) },
2924 { "r5", offsetof(CPUState, gpr[5]) },
2925 { "r6", offsetof(CPUState, gpr[6]) },
2926 { "r7", offsetof(CPUState, gpr[7]) },
2927 { "r8", offsetof(CPUState, gpr[8]) },
2928 { "r9", offsetof(CPUState, gpr[9]) },
2929 { "r10", offsetof(CPUState, gpr[10]) },
2930 { "r11", offsetof(CPUState, gpr[11]) },
2931 { "r12", offsetof(CPUState, gpr[12]) },
2932 { "r13", offsetof(CPUState, gpr[13]) },
2933 { "r14", offsetof(CPUState, gpr[14]) },
2934 { "r15", offsetof(CPUState, gpr[15]) },
2935 { "r16", offsetof(CPUState, gpr[16]) },
2936 { "r17", offsetof(CPUState, gpr[17]) },
2937 { "r18", offsetof(CPUState, gpr[18]) },
2938 { "r19", offsetof(CPUState, gpr[19]) },
2939 { "r20", offsetof(CPUState, gpr[20]) },
2940 { "r21", offsetof(CPUState, gpr[21]) },
2941 { "r22", offsetof(CPUState, gpr[22]) },
2942 { "r23", offsetof(CPUState, gpr[23]) },
2943 { "r24", offsetof(CPUState, gpr[24]) },
2944 { "r25", offsetof(CPUState, gpr[25]) },
2945 { "r26", offsetof(CPUState, gpr[26]) },
2946 { "r27", offsetof(CPUState, gpr[27]) },
2947 { "r28", offsetof(CPUState, gpr[28]) },
2948 { "r29", offsetof(CPUState, gpr[29]) },
2949 { "r30", offsetof(CPUState, gpr[30]) },
2950 { "r31", offsetof(CPUState, gpr[31]) },
2951 /* Floating point registers */
2952 { "f0", offsetof(CPUState, fpr[0]) },
2953 { "f1", offsetof(CPUState, fpr[1]) },
2954 { "f2", offsetof(CPUState, fpr[2]) },
2955 { "f3", offsetof(CPUState, fpr[3]) },
2956 { "f4", offsetof(CPUState, fpr[4]) },
2957 { "f5", offsetof(CPUState, fpr[5]) },
2958 { "f6", offsetof(CPUState, fpr[6]) },
2959 { "f7", offsetof(CPUState, fpr[7]) },
2960 { "f8", offsetof(CPUState, fpr[8]) },
2961 { "f9", offsetof(CPUState, fpr[9]) },
2962 { "f10", offsetof(CPUState, fpr[10]) },
2963 { "f11", offsetof(CPUState, fpr[11]) },
2964 { "f12", offsetof(CPUState, fpr[12]) },
2965 { "f13", offsetof(CPUState, fpr[13]) },
2966 { "f14", offsetof(CPUState, fpr[14]) },
2967 { "f15", offsetof(CPUState, fpr[15]) },
2968 { "f16", offsetof(CPUState, fpr[16]) },
2969 { "f17", offsetof(CPUState, fpr[17]) },
2970 { "f18", offsetof(CPUState, fpr[18]) },
2971 { "f19", offsetof(CPUState, fpr[19]) },
2972 { "f20", offsetof(CPUState, fpr[20]) },
2973 { "f21", offsetof(CPUState, fpr[21]) },
2974 { "f22", offsetof(CPUState, fpr[22]) },
2975 { "f23", offsetof(CPUState, fpr[23]) },
2976 { "f24", offsetof(CPUState, fpr[24]) },
2977 { "f25", offsetof(CPUState, fpr[25]) },
2978 { "f26", offsetof(CPUState, fpr[26]) },
2979 { "f27", offsetof(CPUState, fpr[27]) },
2980 { "f28", offsetof(CPUState, fpr[28]) },
2981 { "f29", offsetof(CPUState, fpr[29]) },
2982 { "f30", offsetof(CPUState, fpr[30]) },
2983 { "f31", offsetof(CPUState, fpr[31]) },
2984 { "fpscr", offsetof(CPUState, fpscr) },
2985 /* Next instruction pointer */
2986 { "nip|pc", offsetof(CPUState, nip) },
2987 { "lr", offsetof(CPUState, lr) },
2988 { "ctr", offsetof(CPUState, ctr) },
2989 { "decr", 0, &monitor_get_decr, },
2990 { "ccr", 0, &monitor_get_ccr, },
2991 /* Machine state register */
2992 { "msr", 0, &monitor_get_msr, },
2993 { "xer", 0, &monitor_get_xer, },
2994 { "tbu", 0, &monitor_get_tbu, },
2995 { "tbl", 0, &monitor_get_tbl, },
2996 #if defined(TARGET_PPC64)
2997 /* Address space register */
2998 { "asr", offsetof(CPUState, asr) },
3000 /* Segment registers */
3001 { "sdr1", offsetof(CPUState, sdr1) },
3002 { "sr0", offsetof(CPUState, sr[0]) },
3003 { "sr1", offsetof(CPUState, sr[1]) },
3004 { "sr2", offsetof(CPUState, sr[2]) },
3005 { "sr3", offsetof(CPUState, sr[3]) },
3006 { "sr4", offsetof(CPUState, sr[4]) },
3007 { "sr5", offsetof(CPUState, sr[5]) },
3008 { "sr6", offsetof(CPUState, sr[6]) },
3009 { "sr7", offsetof(CPUState, sr[7]) },
3010 { "sr8", offsetof(CPUState, sr[8]) },
3011 { "sr9", offsetof(CPUState, sr[9]) },
3012 { "sr10", offsetof(CPUState, sr[10]) },
3013 { "sr11", offsetof(CPUState, sr[11]) },
3014 { "sr12", offsetof(CPUState, sr[12]) },
3015 { "sr13", offsetof(CPUState, sr[13]) },
3016 { "sr14", offsetof(CPUState, sr[14]) },
3017 { "sr15", offsetof(CPUState, sr[15]) },
3018 /* Too lazy to put BATs and SPRs ... */
3019 #elif defined(TARGET_SPARC)
3020 { "g0", offsetof(CPUState, gregs[0]) },
3021 { "g1", offsetof(CPUState, gregs[1]) },
3022 { "g2", offsetof(CPUState, gregs[2]) },
3023 { "g3", offsetof(CPUState, gregs[3]) },
3024 { "g4", offsetof(CPUState, gregs[4]) },
3025 { "g5", offsetof(CPUState, gregs[5]) },
3026 { "g6", offsetof(CPUState, gregs[6]) },
3027 { "g7", offsetof(CPUState, gregs[7]) },
3028 { "o0", 0, monitor_get_reg },
3029 { "o1", 1, monitor_get_reg },
3030 { "o2", 2, monitor_get_reg },
3031 { "o3", 3, monitor_get_reg },
3032 { "o4", 4, monitor_get_reg },
3033 { "o5", 5, monitor_get_reg },
3034 { "o6", 6, monitor_get_reg },
3035 { "o7", 7, monitor_get_reg },
3036 { "l0", 8, monitor_get_reg },
3037 { "l1", 9, monitor_get_reg },
3038 { "l2", 10, monitor_get_reg },
3039 { "l3", 11, monitor_get_reg },
3040 { "l4", 12, monitor_get_reg },
3041 { "l5", 13, monitor_get_reg },
3042 { "l6", 14, monitor_get_reg },
3043 { "l7", 15, monitor_get_reg },
3044 { "i0", 16, monitor_get_reg },
3045 { "i1", 17, monitor_get_reg },
3046 { "i2", 18, monitor_get_reg },
3047 { "i3", 19, monitor_get_reg },
3048 { "i4", 20, monitor_get_reg },
3049 { "i5", 21, monitor_get_reg },
3050 { "i6", 22, monitor_get_reg },
3051 { "i7", 23, monitor_get_reg },
3052 { "pc", offsetof(CPUState, pc) },
3053 { "npc", offsetof(CPUState, npc) },
3054 { "y", offsetof(CPUState, y) },
3055 #ifndef TARGET_SPARC64
3056 { "psr", 0, &monitor_get_psr, },
3057 { "wim", offsetof(CPUState, wim) },
3059 { "tbr", offsetof(CPUState, tbr) },
3060 { "fsr", offsetof(CPUState, fsr) },
3061 { "f0", offsetof(CPUState, fpr[0]) },
3062 { "f1", offsetof(CPUState, fpr[1]) },
3063 { "f2", offsetof(CPUState, fpr[2]) },
3064 { "f3", offsetof(CPUState, fpr[3]) },
3065 { "f4", offsetof(CPUState, fpr[4]) },
3066 { "f5", offsetof(CPUState, fpr[5]) },
3067 { "f6", offsetof(CPUState, fpr[6]) },
3068 { "f7", offsetof(CPUState, fpr[7]) },
3069 { "f8", offsetof(CPUState, fpr[8]) },
3070 { "f9", offsetof(CPUState, fpr[9]) },
3071 { "f10", offsetof(CPUState, fpr[10]) },
3072 { "f11", offsetof(CPUState, fpr[11]) },
3073 { "f12", offsetof(CPUState, fpr[12]) },
3074 { "f13", offsetof(CPUState, fpr[13]) },
3075 { "f14", offsetof(CPUState, fpr[14]) },
3076 { "f15", offsetof(CPUState, fpr[15]) },
3077 { "f16", offsetof(CPUState, fpr[16]) },
3078 { "f17", offsetof(CPUState, fpr[17]) },
3079 { "f18", offsetof(CPUState, fpr[18]) },
3080 { "f19", offsetof(CPUState, fpr[19]) },
3081 { "f20", offsetof(CPUState, fpr[20]) },
3082 { "f21", offsetof(CPUState, fpr[21]) },
3083 { "f22", offsetof(CPUState, fpr[22]) },
3084 { "f23", offsetof(CPUState, fpr[23]) },
3085 { "f24", offsetof(CPUState, fpr[24]) },
3086 { "f25", offsetof(CPUState, fpr[25]) },
3087 { "f26", offsetof(CPUState, fpr[26]) },
3088 { "f27", offsetof(CPUState, fpr[27]) },
3089 { "f28", offsetof(CPUState, fpr[28]) },
3090 { "f29", offsetof(CPUState, fpr[29]) },
3091 { "f30", offsetof(CPUState, fpr[30]) },
3092 { "f31", offsetof(CPUState, fpr[31]) },
3093 #ifdef TARGET_SPARC64
3094 { "f32", offsetof(CPUState, fpr[32]) },
3095 { "f34", offsetof(CPUState, fpr[34]) },
3096 { "f36", offsetof(CPUState, fpr[36]) },
3097 { "f38", offsetof(CPUState, fpr[38]) },
3098 { "f40", offsetof(CPUState, fpr[40]) },
3099 { "f42", offsetof(CPUState, fpr[42]) },
3100 { "f44", offsetof(CPUState, fpr[44]) },
3101 { "f46", offsetof(CPUState, fpr[46]) },
3102 { "f48", offsetof(CPUState, fpr[48]) },
3103 { "f50", offsetof(CPUState, fpr[50]) },
3104 { "f52", offsetof(CPUState, fpr[52]) },
3105 { "f54", offsetof(CPUState, fpr[54]) },
3106 { "f56", offsetof(CPUState, fpr[56]) },
3107 { "f58", offsetof(CPUState, fpr[58]) },
3108 { "f60", offsetof(CPUState, fpr[60]) },
3109 { "f62", offsetof(CPUState, fpr[62]) },
3110 { "asi", offsetof(CPUState, asi) },
3111 { "pstate", offsetof(CPUState, pstate) },
3112 { "cansave", offsetof(CPUState, cansave) },
3113 { "canrestore", offsetof(CPUState, canrestore) },
3114 { "otherwin", offsetof(CPUState, otherwin) },
3115 { "wstate", offsetof(CPUState, wstate) },
3116 { "cleanwin", offsetof(CPUState, cleanwin) },
3117 { "fprs", offsetof(CPUState, fprs) },
3123 static void expr_error(Monitor *mon, const char *msg)
3125 monitor_printf(mon, "%s\n", msg);
3126 longjmp(expr_env, 1);
3129 /* return 0 if OK, -1 if not found */
3130 static int get_monitor_def(target_long *pval, const char *name)
3132 const MonitorDef *md;
3135 for(md = monitor_defs; md->name != NULL; md++) {
3136 if (compare_cmd(name, md->name)) {
3137 if (md->get_value) {
3138 *pval = md->get_value(md, md->offset);
3140 CPUState *env = mon_get_cpu();
3141 ptr = (uint8_t *)env + md->offset;
3144 *pval = *(int32_t *)ptr;
3147 *pval = *(target_long *)ptr;
3160 static void next(void)
3164 while (qemu_isspace(*pch))
3169 static int64_t expr_sum(Monitor *mon);
3171 static int64_t expr_unary(Monitor *mon)
3180 n = expr_unary(mon);
3184 n = -expr_unary(mon);
3188 n = ~expr_unary(mon);
3194 expr_error(mon, "')' expected");
3201 expr_error(mon, "character constant expected");
3205 expr_error(mon, "missing terminating \' character");
3215 while ((*pch >= 'a' && *pch <= 'z') ||
3216 (*pch >= 'A' && *pch <= 'Z') ||
3217 (*pch >= '0' && *pch <= '9') ||
3218 *pch == '_' || *pch == '.') {
3219 if ((q - buf) < sizeof(buf) - 1)
3223 while (qemu_isspace(*pch))
3226 ret = get_monitor_def(®, buf);
3228 expr_error(mon, "unknown register");
3233 expr_error(mon, "unexpected end of expression");
3237 #if TARGET_PHYS_ADDR_BITS > 32
3238 n = strtoull(pch, &p, 0);
3240 n = strtoul(pch, &p, 0);
3243 expr_error(mon, "invalid char in expression");
3246 while (qemu_isspace(*pch))
3254 static int64_t expr_prod(Monitor *mon)
3259 val = expr_unary(mon);
3262 if (op != '*' && op != '/' && op != '%')
3265 val2 = expr_unary(mon);
3274 expr_error(mon, "division by zero");
3285 static int64_t expr_logic(Monitor *mon)
3290 val = expr_prod(mon);
3293 if (op != '&' && op != '|' && op != '^')
3296 val2 = expr_prod(mon);
3313 static int64_t expr_sum(Monitor *mon)
3318 val = expr_logic(mon);
3321 if (op != '+' && op != '-')
3324 val2 = expr_logic(mon);
3333 static int get_expr(Monitor *mon, int64_t *pval, const char **pp)
3336 if (setjmp(expr_env)) {
3340 while (qemu_isspace(*pch))
3342 *pval = expr_sum(mon);
3347 static int get_double(Monitor *mon, double *pval, const char **pp)
3349 const char *p = *pp;
3353 d = strtod(p, &tailp);
3355 monitor_printf(mon, "Number expected\n");
3358 if (d != d || d - d != 0) {
3359 /* NaN or infinity */
3360 monitor_printf(mon, "Bad number\n");
3368 static int get_str(char *buf, int buf_size, const char **pp)
3376 while (qemu_isspace(*p))
3386 while (*p != '\0' && *p != '\"') {
3402 qemu_printf("unsupported escape code: '\\%c'\n", c);
3405 if ((q - buf) < buf_size - 1) {
3409 if ((q - buf) < buf_size - 1) {
3416 qemu_printf("unterminated string\n");
3421 while (*p != '\0' && !qemu_isspace(*p)) {
3422 if ((q - buf) < buf_size - 1) {
3434 * Store the command-name in cmdname, and return a pointer to
3435 * the remaining of the command string.
3437 static const char *get_command_name(const char *cmdline,
3438 char *cmdname, size_t nlen)
3441 const char *p, *pstart;
3444 while (qemu_isspace(*p))
3449 while (*p != '\0' && *p != '/' && !qemu_isspace(*p))
3454 memcpy(cmdname, pstart, len);
3455 cmdname[len] = '\0';
3460 * Read key of 'type' into 'key' and return the current
3463 static char *key_get_info(const char *type, char **key)
3471 p = strchr(type, ':');
3478 str = qemu_malloc(len + 1);
3479 memcpy(str, type, len);
3486 static int default_fmt_format = 'x';
3487 static int default_fmt_size = 4;
3491 static int is_valid_option(const char *c, const char *typestr)
3499 typestr = strstr(typestr, option);
3500 return (typestr != NULL);
3503 static const mon_cmd_t *search_dispatch_table(const mon_cmd_t *disp_table,
3504 const char *cmdname)
3506 const mon_cmd_t *cmd;
3508 for (cmd = disp_table; cmd->name != NULL; cmd++) {
3509 if (compare_cmd(cmdname, cmd->name)) {
3517 static const mon_cmd_t *monitor_find_command(const char *cmdname)
3519 return search_dispatch_table(mon_cmds, cmdname);
3522 static const mon_cmd_t *qmp_find_query_cmd(const char *info_item)
3524 return search_dispatch_table(qmp_query_cmds, info_item);
3527 static const mon_cmd_t *qmp_find_cmd(const char *cmdname)
3529 return search_dispatch_table(qmp_cmds, cmdname);
3532 static const mon_cmd_t *monitor_parse_command(Monitor *mon,
3533 const char *cmdline,
3536 const char *p, *typestr;
3538 const mon_cmd_t *cmd;
3544 monitor_printf(mon, "command='%s'\n", cmdline);
3547 /* extract the command name */
3548 p = get_command_name(cmdline, cmdname, sizeof(cmdname));
3552 cmd = monitor_find_command(cmdname);
3554 monitor_printf(mon, "unknown command: '%s'\n", cmdname);
3558 /* parse the parameters */
3559 typestr = cmd->args_type;
3561 typestr = key_get_info(typestr, &key);
3573 while (qemu_isspace(*p))
3575 if (*typestr == '?') {
3578 /* no optional string: NULL argument */
3582 ret = get_str(buf, sizeof(buf), &p);
3586 monitor_printf(mon, "%s: filename expected\n",
3590 monitor_printf(mon, "%s: block device name expected\n",
3594 monitor_printf(mon, "%s: string expected\n", cmdname);
3599 qdict_put(qdict, key, qstring_from_str(buf));
3604 QemuOptsList *opts_list;
3607 opts_list = qemu_find_opts(key);
3608 if (!opts_list || opts_list->desc->name) {
3611 while (qemu_isspace(*p)) {
3616 if (get_str(buf, sizeof(buf), &p) < 0) {
3619 opts = qemu_opts_parse(opts_list, buf, 1);
3623 qemu_opts_to_qdict(opts, qdict);
3624 qemu_opts_del(opts);
3629 int count, format, size;
3631 while (qemu_isspace(*p))
3637 if (qemu_isdigit(*p)) {
3639 while (qemu_isdigit(*p)) {
3640 count = count * 10 + (*p - '0');
3678 if (*p != '\0' && !qemu_isspace(*p)) {
3679 monitor_printf(mon, "invalid char in format: '%c'\n",
3684 format = default_fmt_format;
3685 if (format != 'i') {
3686 /* for 'i', not specifying a size gives -1 as size */
3688 size = default_fmt_size;
3689 default_fmt_size = size;
3691 default_fmt_format = format;
3694 format = default_fmt_format;
3695 if (format != 'i') {
3696 size = default_fmt_size;
3701 qdict_put(qdict, "count", qint_from_int(count));
3702 qdict_put(qdict, "format", qint_from_int(format));
3703 qdict_put(qdict, "size", qint_from_int(size));
3712 while (qemu_isspace(*p))
3714 if (*typestr == '?' || *typestr == '.') {
3715 if (*typestr == '?') {
3723 while (qemu_isspace(*p))
3732 if (get_expr(mon, &val, &p))
3734 /* Check if 'i' is greater than 32-bit */
3735 if ((c == 'i') && ((val >> 32) & 0xffffffff)) {
3736 monitor_printf(mon, "\'%s\' has failed: ", cmdname);
3737 monitor_printf(mon, "integer is for 32-bit values\n");
3739 } else if (c == 'M') {
3742 qdict_put(qdict, key, qint_from_int(val));
3750 while (qemu_isspace(*p)) {
3753 if (*typestr == '?') {
3759 val = strtosz(p, &end);
3761 monitor_printf(mon, "invalid size\n");
3764 qdict_put(qdict, key, qint_from_int(val));
3772 while (qemu_isspace(*p))
3774 if (*typestr == '?') {
3780 if (get_double(mon, &val, &p) < 0) {
3783 if (p[0] && p[1] == 's') {
3786 val /= 1e3; p += 2; break;
3788 val /= 1e6; p += 2; break;
3790 val /= 1e9; p += 2; break;
3793 if (*p && !qemu_isspace(*p)) {
3794 monitor_printf(mon, "Unknown unit suffix\n");
3797 qdict_put(qdict, key, qfloat_from_double(val));
3805 while (qemu_isspace(*p)) {
3809 while (qemu_isgraph(*p)) {
3812 if (p - beg == 2 && !memcmp(beg, "on", p - beg)) {
3814 } else if (p - beg == 3 && !memcmp(beg, "off", p - beg)) {
3817 monitor_printf(mon, "Expected 'on' or 'off'\n");
3820 qdict_put(qdict, key, qbool_from_int(val));
3825 const char *tmp = p;
3832 while (qemu_isspace(*p))
3837 if(!is_valid_option(p, typestr)) {
3839 monitor_printf(mon, "%s: unsupported option -%c\n",
3851 qdict_put(qdict, key, qbool_from_int(1));
3858 monitor_printf(mon, "%s: unknown type '%c'\n", cmdname, c);
3864 /* check that all arguments were parsed */
3865 while (qemu_isspace(*p))
3868 monitor_printf(mon, "%s: extraneous characters at the end of line\n",
3880 void monitor_set_error(Monitor *mon, QError *qerror)
3882 /* report only the first error */
3884 mon->error = qerror;
3886 MON_DEBUG("Additional error report at %s:%d\n",
3887 qerror->file, qerror->linenr);
3892 static void handler_audit(Monitor *mon, const mon_cmd_t *cmd, int ret)
3894 if (monitor_ctrl_mode(mon)) {
3895 if (ret && !monitor_has_error(mon)) {
3897 * If it returns failure, it must have passed on error.
3899 * Action: Report an internal error to the client if in QMP.
3901 qerror_report(QERR_UNDEFINED_ERROR);
3902 MON_DEBUG("command '%s' returned failure but did not pass an error\n",
3906 #ifdef CONFIG_DEBUG_MONITOR
3907 if (!ret && monitor_has_error(mon)) {
3909 * If it returns success, it must not have passed an error.
3911 * Action: Report the passed error to the client.
3913 MON_DEBUG("command '%s' returned success but passed an error\n",
3917 if (mon_print_count_get(mon) > 0 && strcmp(cmd->name, "info") != 0) {
3919 * Handlers should not call Monitor print functions.
3921 * Action: Ignore them in QMP.
3923 * (XXX: we don't check any 'info' or 'query' command here
3924 * because the user print function _is_ called by do_info(), hence
3925 * we will trigger this check. This problem will go away when we
3926 * make 'query' commands real and kill do_info())
3928 MON_DEBUG("command '%s' called print functions %d time(s)\n",
3929 cmd->name, mon_print_count_get(mon));
3933 assert(!monitor_has_error(mon));
3934 QDECREF(mon->error);
3939 static void handle_user_command(Monitor *mon, const char *cmdline)
3942 const mon_cmd_t *cmd;
3944 qdict = qdict_new();
3946 cmd = monitor_parse_command(mon, cmdline, qdict);
3950 if (handler_is_async(cmd)) {
3951 user_async_cmd_handler(mon, cmd, qdict);
3952 } else if (handler_is_qobject(cmd)) {
3953 QObject *data = NULL;
3955 /* XXX: ignores the error code */
3956 cmd->mhandler.cmd_new(mon, qdict, &data);
3957 assert(!monitor_has_error(mon));
3959 cmd->user_print(mon, data);
3960 qobject_decref(data);
3963 cmd->mhandler.cmd(mon, qdict);
3970 static void cmd_completion(const char *name, const char *list)
3972 const char *p, *pstart;
3981 p = pstart + strlen(pstart);
3983 if (len > sizeof(cmd) - 2)
3984 len = sizeof(cmd) - 2;
3985 memcpy(cmd, pstart, len);
3987 if (name[0] == '\0' || !strncmp(name, cmd, strlen(name))) {
3988 readline_add_completion(cur_mon->rs, cmd);
3996 static void file_completion(const char *input)
4001 char file[1024], file_prefix[1024];
4005 p = strrchr(input, '/');
4008 pstrcpy(file_prefix, sizeof(file_prefix), input);
4009 pstrcpy(path, sizeof(path), ".");
4011 input_path_len = p - input + 1;
4012 memcpy(path, input, input_path_len);
4013 if (input_path_len > sizeof(path) - 1)
4014 input_path_len = sizeof(path) - 1;
4015 path[input_path_len] = '\0';
4016 pstrcpy(file_prefix, sizeof(file_prefix), p + 1);
4018 #ifdef DEBUG_COMPLETION
4019 monitor_printf(cur_mon, "input='%s' path='%s' prefix='%s'\n",
4020 input, path, file_prefix);
4022 ffs = opendir(path);
4031 if (strcmp(d->d_name, ".") == 0 || strcmp(d->d_name, "..") == 0) {
4035 if (strstart(d->d_name, file_prefix, NULL)) {
4036 memcpy(file, input, input_path_len);
4037 if (input_path_len < sizeof(file))
4038 pstrcpy(file + input_path_len, sizeof(file) - input_path_len,
4040 /* stat the file to find out if it's a directory.
4041 * In that case add a slash to speed up typing long paths
4044 if(S_ISDIR(sb.st_mode))
4045 pstrcat(file, sizeof(file), "/");
4046 readline_add_completion(cur_mon->rs, file);
4052 static void block_completion_it(void *opaque, BlockDriverState *bs)
4054 const char *name = bdrv_get_device_name(bs);
4055 const char *input = opaque;
4057 if (input[0] == '\0' ||
4058 !strncmp(name, (char *)input, strlen(input))) {
4059 readline_add_completion(cur_mon->rs, name);
4063 /* NOTE: this parser is an approximate form of the real command parser */
4064 static void parse_cmdline(const char *cmdline,
4065 int *pnb_args, char **args)
4074 while (qemu_isspace(*p))
4078 if (nb_args >= MAX_ARGS)
4080 ret = get_str(buf, sizeof(buf), &p);
4081 args[nb_args] = qemu_strdup(buf);
4086 *pnb_args = nb_args;
4089 static const char *next_arg_type(const char *typestr)
4091 const char *p = strchr(typestr, ':');
4092 return (p != NULL ? ++p : typestr);
4095 static void monitor_find_completion(const char *cmdline)
4097 const char *cmdname;
4098 char *args[MAX_ARGS];
4099 int nb_args, i, len;
4100 const char *ptype, *str;
4101 const mon_cmd_t *cmd;
4104 parse_cmdline(cmdline, &nb_args, args);
4105 #ifdef DEBUG_COMPLETION
4106 for(i = 0; i < nb_args; i++) {
4107 monitor_printf(cur_mon, "arg%d = '%s'\n", i, (char *)args[i]);
4111 /* if the line ends with a space, it means we want to complete the
4113 len = strlen(cmdline);
4114 if (len > 0 && qemu_isspace(cmdline[len - 1])) {
4115 if (nb_args >= MAX_ARGS) {
4118 args[nb_args++] = qemu_strdup("");
4121 /* command completion */
4126 readline_set_completion_index(cur_mon->rs, strlen(cmdname));
4127 for(cmd = mon_cmds; cmd->name != NULL; cmd++) {
4128 cmd_completion(cmdname, cmd->name);
4131 /* find the command */
4132 for (cmd = mon_cmds; cmd->name != NULL; cmd++) {
4133 if (compare_cmd(args[0], cmd->name)) {
4141 ptype = next_arg_type(cmd->args_type);
4142 for(i = 0; i < nb_args - 2; i++) {
4143 if (*ptype != '\0') {
4144 ptype = next_arg_type(ptype);
4145 while (*ptype == '?')
4146 ptype = next_arg_type(ptype);
4149 str = args[nb_args - 1];
4150 if (*ptype == '-' && ptype[1] != '\0') {
4151 ptype = next_arg_type(ptype);
4155 /* file completion */
4156 readline_set_completion_index(cur_mon->rs, strlen(str));
4157 file_completion(str);
4160 /* block device name completion */
4161 readline_set_completion_index(cur_mon->rs, strlen(str));
4162 bdrv_iterate(block_completion_it, (void *)str);
4165 /* XXX: more generic ? */
4166 if (!strcmp(cmd->name, "info")) {
4167 readline_set_completion_index(cur_mon->rs, strlen(str));
4168 for(cmd = info_cmds; cmd->name != NULL; cmd++) {
4169 cmd_completion(str, cmd->name);
4171 } else if (!strcmp(cmd->name, "sendkey")) {
4172 char *sep = strrchr(str, '-');
4175 readline_set_completion_index(cur_mon->rs, strlen(str));
4176 for(key = key_defs; key->name != NULL; key++) {
4177 cmd_completion(str, key->name);
4179 } else if (!strcmp(cmd->name, "help|?")) {
4180 readline_set_completion_index(cur_mon->rs, strlen(str));
4181 for (cmd = mon_cmds; cmd->name != NULL; cmd++) {
4182 cmd_completion(str, cmd->name);
4192 for (i = 0; i < nb_args; i++) {
4197 static int monitor_can_read(void *opaque)
4199 Monitor *mon = opaque;
4201 return (mon->suspend_cnt == 0) ? 1 : 0;
4204 static int invalid_qmp_mode(const Monitor *mon, const char *cmd_name)
4206 int is_cap = compare_cmd(cmd_name, "qmp_capabilities");
4207 return (qmp_cmd_mode(mon) ? is_cap : !is_cap);
4211 * Argument validation rules:
4213 * 1. The argument must exist in cmd_args qdict
4214 * 2. The argument type must be the expected one
4216 * Special case: If the argument doesn't exist in cmd_args and
4217 * the QMP_ACCEPT_UNKNOWNS flag is set, then the
4218 * checking is skipped for it.
4220 static int check_client_args_type(const QDict *client_args,
4221 const QDict *cmd_args, int flags)
4223 const QDictEntry *ent;
4225 for (ent = qdict_first(client_args); ent;ent = qdict_next(client_args,ent)){
4228 const QObject *client_arg = qdict_entry_value(ent);
4229 const char *client_arg_name = qdict_entry_key(ent);
4231 obj = qdict_get(cmd_args, client_arg_name);
4233 if (flags & QMP_ACCEPT_UNKNOWNS) {
4234 /* handler accepts unknowns */
4237 /* client arg doesn't exist */
4238 qerror_report(QERR_INVALID_PARAMETER, client_arg_name);
4242 arg_type = qobject_to_qstring(obj);
4243 assert(arg_type != NULL);
4245 /* check if argument's type is correct */
4246 switch (qstring_get_str(arg_type)[0]) {
4250 if (qobject_type(client_arg) != QTYPE_QSTRING) {
4251 qerror_report(QERR_INVALID_PARAMETER_TYPE, client_arg_name,
4260 if (qobject_type(client_arg) != QTYPE_QINT) {
4261 qerror_report(QERR_INVALID_PARAMETER_TYPE, client_arg_name,
4267 if (qobject_type(client_arg) != QTYPE_QINT &&
4268 qobject_type(client_arg) != QTYPE_QFLOAT) {
4269 qerror_report(QERR_INVALID_PARAMETER_TYPE, client_arg_name,
4276 if (qobject_type(client_arg) != QTYPE_QBOOL) {
4277 qerror_report(QERR_INVALID_PARAMETER_TYPE, client_arg_name,
4283 assert(flags & QMP_ACCEPT_UNKNOWNS);
4288 * These types are not supported by QMP and thus are not
4289 * handled here. Fall through.
4300 * - Check if the client has passed all mandatory args
4301 * - Set special flags for argument validation
4303 static int check_mandatory_args(const QDict *cmd_args,
4304 const QDict *client_args, int *flags)
4306 const QDictEntry *ent;
4308 for (ent = qdict_first(cmd_args); ent; ent = qdict_next(cmd_args, ent)) {
4309 const char *cmd_arg_name = qdict_entry_key(ent);
4310 QString *type = qobject_to_qstring(qdict_entry_value(ent));
4311 assert(type != NULL);
4313 if (qstring_get_str(type)[0] == 'O') {
4314 assert((*flags & QMP_ACCEPT_UNKNOWNS) == 0);
4315 *flags |= QMP_ACCEPT_UNKNOWNS;
4316 } else if (qstring_get_str(type)[0] != '-' &&
4317 qstring_get_str(type)[1] != '?' &&
4318 !qdict_haskey(client_args, cmd_arg_name)) {
4319 qerror_report(QERR_MISSING_PARAMETER, cmd_arg_name);
4327 static QDict *qdict_from_args_type(const char *args_type)
4331 QString *key, *type, *cur_qs;
4333 assert(args_type != NULL);
4335 qdict = qdict_new();
4337 if (args_type == NULL || args_type[0] == '\0') {
4338 /* no args, empty qdict */
4342 key = qstring_new();
4343 type = qstring_new();
4348 switch (args_type[i]) {
4351 qdict_put(qdict, qstring_get_str(key), type);
4353 if (args_type[i] == '\0') {
4356 type = qstring_new(); /* qdict has ref */
4357 cur_qs = key = qstring_new();
4363 qstring_append_chr(cur_qs, args_type[i]);
4373 * Client argument checking rules:
4375 * 1. Client must provide all mandatory arguments
4376 * 2. Each argument provided by the client must be expected
4377 * 3. Each argument provided by the client must have the type expected
4380 static int qmp_check_client_args(const mon_cmd_t *cmd, QDict *client_args)
4385 cmd_args = qdict_from_args_type(cmd->args_type);
4388 err = check_mandatory_args(cmd_args, client_args, &flags);
4393 err = check_client_args_type(client_args, cmd_args, flags);
4401 * Input object checking rules
4403 * 1. Input object must be a dict
4404 * 2. The "execute" key must exist
4405 * 3. The "execute" key must be a string
4406 * 4. If the "arguments" key exists, it must be a dict
4407 * 5. If the "id" key exists, it can be anything (ie. json-value)
4408 * 6. Any argument not listed above is considered invalid
4410 static QDict *qmp_check_input_obj(QObject *input_obj)
4412 const QDictEntry *ent;
4413 int has_exec_key = 0;
4416 if (qobject_type(input_obj) != QTYPE_QDICT) {
4417 qerror_report(QERR_QMP_BAD_INPUT_OBJECT, "object");
4421 input_dict = qobject_to_qdict(input_obj);
4423 for (ent = qdict_first(input_dict); ent; ent = qdict_next(input_dict, ent)){
4424 const char *arg_name = qdict_entry_key(ent);
4425 const QObject *arg_obj = qdict_entry_value(ent);
4427 if (!strcmp(arg_name, "execute")) {
4428 if (qobject_type(arg_obj) != QTYPE_QSTRING) {
4429 qerror_report(QERR_QMP_BAD_INPUT_OBJECT_MEMBER, "execute",
4434 } else if (!strcmp(arg_name, "arguments")) {
4435 if (qobject_type(arg_obj) != QTYPE_QDICT) {
4436 qerror_report(QERR_QMP_BAD_INPUT_OBJECT_MEMBER, "arguments",
4440 } else if (!strcmp(arg_name, "id")) {
4441 /* FIXME: check duplicated IDs for async commands */
4443 qerror_report(QERR_QMP_EXTRA_MEMBER, arg_name);
4448 if (!has_exec_key) {
4449 qerror_report(QERR_QMP_BAD_INPUT_OBJECT, "execute");
4456 static void qmp_call_query_cmd(Monitor *mon, const mon_cmd_t *cmd)
4458 QObject *ret_data = NULL;
4460 if (handler_is_async(cmd)) {
4461 qmp_async_info_handler(mon, cmd);
4462 if (monitor_has_error(mon)) {
4463 monitor_protocol_emitter(mon, NULL);
4466 cmd->mhandler.info_new(mon, &ret_data);
4468 monitor_protocol_emitter(mon, ret_data);
4469 qobject_decref(ret_data);
4474 static void qmp_call_cmd(Monitor *mon, const mon_cmd_t *cmd,
4475 const QDict *params)
4478 QObject *data = NULL;
4480 mon_print_count_init(mon);
4482 ret = cmd->mhandler.cmd_new(mon, params, &data);
4483 handler_audit(mon, cmd, ret);
4484 monitor_protocol_emitter(mon, data);
4485 qobject_decref(data);
4488 static void handle_qmp_command(JSONMessageParser *parser, QList *tokens)
4492 QDict *input, *args;
4493 const mon_cmd_t *cmd;
4494 Monitor *mon = cur_mon;
4495 const char *cmd_name, *query_cmd;
4498 args = input = NULL;
4500 obj = json_parser_parse(tokens, NULL);
4502 // FIXME: should be triggered in json_parser_parse()
4503 qerror_report(QERR_JSON_PARSING);
4507 input = qmp_check_input_obj(obj);
4509 qobject_decref(obj);
4513 mon->mc->id = qdict_get(input, "id");
4514 qobject_incref(mon->mc->id);
4516 cmd_name = qdict_get_str(input, "execute");
4517 if (invalid_qmp_mode(mon, cmd_name)) {
4518 qerror_report(QERR_COMMAND_NOT_FOUND, cmd_name);
4522 if (strstart(cmd_name, "query-", &query_cmd)) {
4523 cmd = qmp_find_query_cmd(query_cmd);
4525 cmd = qmp_find_cmd(cmd_name);
4529 qerror_report(QERR_COMMAND_NOT_FOUND, cmd_name);
4533 obj = qdict_get(input, "arguments");
4537 args = qobject_to_qdict(obj);
4541 err = qmp_check_client_args(cmd, args);
4547 qmp_call_query_cmd(mon, cmd);
4548 } else if (handler_is_async(cmd)) {
4549 err = qmp_async_cmd_handler(mon, cmd, args);
4551 /* emit the error response */
4555 qmp_call_cmd(mon, cmd, args);
4561 monitor_protocol_emitter(mon, NULL);
4568 * monitor_control_read(): Read and handle QMP input
4570 static void monitor_control_read(void *opaque, const uint8_t *buf, int size)
4572 Monitor *old_mon = cur_mon;
4576 json_message_parser_feed(&cur_mon->mc->parser, (const char *) buf, size);
4581 static void monitor_read(void *opaque, const uint8_t *buf, int size)
4583 Monitor *old_mon = cur_mon;
4589 for (i = 0; i < size; i++)
4590 readline_handle_byte(cur_mon->rs, buf[i]);
4592 if (size == 0 || buf[size - 1] != 0)
4593 monitor_printf(cur_mon, "corrupted command\n");
4595 handle_user_command(cur_mon, (char *)buf);
4601 static void monitor_command_cb(Monitor *mon, const char *cmdline, void *opaque)
4603 monitor_suspend(mon);
4604 handle_user_command(mon, cmdline);
4605 monitor_resume(mon);
4608 int monitor_suspend(Monitor *mon)
4616 void monitor_resume(Monitor *mon)
4620 if (--mon->suspend_cnt == 0)
4621 readline_show_prompt(mon->rs);
4624 static QObject *get_qmp_greeting(void)
4628 do_info_version(NULL, &ver);
4629 return qobject_from_jsonf("{'QMP':{'version': %p,'capabilities': []}}",ver);
4633 * monitor_control_event(): Print QMP gretting
4635 static void monitor_control_event(void *opaque, int event)
4638 Monitor *mon = opaque;
4641 case CHR_EVENT_OPENED:
4642 mon->mc->command_mode = 0;
4643 json_message_parser_init(&mon->mc->parser, handle_qmp_command);
4644 data = get_qmp_greeting();
4645 monitor_json_emitter(mon, data);
4646 qobject_decref(data);
4648 case CHR_EVENT_CLOSED:
4649 json_message_parser_destroy(&mon->mc->parser);
4654 static void monitor_event(void *opaque, int event)
4656 Monitor *mon = opaque;
4659 case CHR_EVENT_MUX_IN:
4661 if (mon->reset_seen) {
4662 readline_restart(mon->rs);
4663 monitor_resume(mon);
4666 mon->suspend_cnt = 0;
4670 case CHR_EVENT_MUX_OUT:
4671 if (mon->reset_seen) {
4672 if (mon->suspend_cnt == 0) {
4673 monitor_printf(mon, "\n");
4676 monitor_suspend(mon);
4683 case CHR_EVENT_OPENED:
4684 monitor_printf(mon, "QEMU %s monitor - type 'help' for more "
4685 "information\n", QEMU_VERSION);
4686 if (!mon->mux_out) {
4687 readline_show_prompt(mon->rs);
4689 mon->reset_seen = 1;
4703 void monitor_init(CharDriverState *chr, int flags)
4705 static int is_first_init = 1;
4708 if (is_first_init) {
4709 key_timer = qemu_new_timer(vm_clock, release_keys, NULL);
4713 mon = qemu_mallocz(sizeof(*mon));
4717 if (flags & MONITOR_USE_READLINE) {
4718 mon->rs = readline_init(mon, monitor_find_completion);
4719 monitor_read_command(mon, 0);
4722 if (monitor_ctrl_mode(mon)) {
4723 mon->mc = qemu_mallocz(sizeof(MonitorControl));
4724 /* Control mode requires special handlers */
4725 qemu_chr_add_handlers(chr, monitor_can_read, monitor_control_read,
4726 monitor_control_event, mon);
4728 qemu_chr_add_handlers(chr, monitor_can_read, monitor_read,
4729 monitor_event, mon);
4732 QLIST_INSERT_HEAD(&mon_list, mon, entry);
4733 if (!default_mon || (flags & MONITOR_IS_DEFAULT))
4737 static void bdrv_password_cb(Monitor *mon, const char *password, void *opaque)
4739 BlockDriverState *bs = opaque;
4742 if (bdrv_set_key(bs, password) != 0) {
4743 monitor_printf(mon, "invalid password\n");
4746 if (mon->password_completion_cb)
4747 mon->password_completion_cb(mon->password_opaque, ret);
4749 monitor_read_command(mon, 1);
4752 int monitor_read_bdrv_key_start(Monitor *mon, BlockDriverState *bs,
4753 BlockDriverCompletionFunc *completion_cb,
4758 if (!bdrv_key_required(bs)) {
4760 completion_cb(opaque, 0);
4764 if (monitor_ctrl_mode(mon)) {
4765 qerror_report(QERR_DEVICE_ENCRYPTED, bdrv_get_device_name(bs));
4769 monitor_printf(mon, "%s (%s) is encrypted.\n", bdrv_get_device_name(bs),
4770 bdrv_get_encrypted_filename(bs));
4772 mon->password_completion_cb = completion_cb;
4773 mon->password_opaque = opaque;
4775 err = monitor_read_password(mon, bdrv_password_cb, bs);
4777 if (err && completion_cb)
4778 completion_cb(opaque, err);