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"
60 //#define DEBUG_COMPLETION
66 * 'B' block device name
67 * 's' string (accept optional quote)
68 * 'O' option string of the form NAME=VALUE,...
69 * parsed according to QemuOptsList given by its name
70 * Example: 'device:O' uses qemu_device_opts.
71 * Restriction: only lists with empty desc are supported
72 * TODO lift the restriction
74 * 'l' target long (32 or 64 bit)
75 * 'M' just like 'l', except in user mode the value is
76 * multiplied by 2^20 (think Mebibyte)
78 * user mode accepts an optional G, g, M, m, K, k suffix,
79 * which multiplies the value by 2^30 for suffixes G and
80 * g, 2^20 for M and m, 2^10 for K and k
82 * user mode accepts an optional ms, us, ns suffix,
83 * which divides the value by 1e3, 1e6, 1e9, respectively
84 * '/' optional gdb-like print format (like "/10x")
86 * '?' optional type (for all types, except '/')
87 * '.' other form of optional type (for 'i' and 'l')
89 * user mode accepts "on" or "off"
90 * '-' optional parameter (eg. '-f')
94 typedef struct MonitorCompletionData MonitorCompletionData;
95 struct MonitorCompletionData {
97 void (*user_print)(Monitor *mon, const QObject *data);
100 typedef struct mon_cmd_t {
102 const char *args_type;
105 void (*user_print)(Monitor *mon, const QObject *data);
107 void (*info)(Monitor *mon);
108 void (*info_new)(Monitor *mon, QObject **ret_data);
109 int (*info_async)(Monitor *mon, MonitorCompletion *cb, void *opaque);
110 void (*cmd)(Monitor *mon, const QDict *qdict);
111 int (*cmd_new)(Monitor *mon, const QDict *params, QObject **ret_data);
112 int (*cmd_async)(Monitor *mon, const QDict *params,
113 MonitorCompletion *cb, void *opaque);
118 /* file descriptors passed via SCM_RIGHTS */
119 typedef struct mon_fd_t mon_fd_t;
123 QLIST_ENTRY(mon_fd_t) next;
126 typedef struct MonitorControl {
128 JSONMessageParser parser;
133 CharDriverState *chr;
138 uint8_t outbuf[1024];
143 BlockDriverCompletionFunc *password_completion_cb;
144 void *password_opaque;
145 #ifdef CONFIG_DEBUG_MONITOR
149 QLIST_HEAD(,mon_fd_t) fds;
150 QLIST_ENTRY(Monitor) entry;
153 #ifdef CONFIG_DEBUG_MONITOR
154 #define MON_DEBUG(fmt, ...) do { \
155 fprintf(stderr, "Monitor: "); \
156 fprintf(stderr, fmt, ## __VA_ARGS__); } while (0)
158 static inline void mon_print_count_inc(Monitor *mon)
160 mon->print_calls_nr++;
163 static inline void mon_print_count_init(Monitor *mon)
165 mon->print_calls_nr = 0;
168 static inline int mon_print_count_get(const Monitor *mon)
170 return mon->print_calls_nr;
173 #else /* !CONFIG_DEBUG_MONITOR */
174 #define MON_DEBUG(fmt, ...) do { } while (0)
175 static inline void mon_print_count_inc(Monitor *mon) { }
176 static inline void mon_print_count_init(Monitor *mon) { }
177 static inline int mon_print_count_get(const Monitor *mon) { return 0; }
178 #endif /* CONFIG_DEBUG_MONITOR */
180 static QLIST_HEAD(mon_list, Monitor) mon_list;
182 static const mon_cmd_t mon_cmds[];
183 static const mon_cmd_t info_cmds[];
186 Monitor *default_mon;
188 static void monitor_command_cb(Monitor *mon, const char *cmdline,
191 static inline int qmp_cmd_mode(const Monitor *mon)
193 return (mon->mc ? mon->mc->command_mode : 0);
196 /* Return true if in control mode, false otherwise */
197 static inline int monitor_ctrl_mode(const Monitor *mon)
199 return (mon->flags & MONITOR_USE_CONTROL);
202 /* Return non-zero iff we have a current monitor, and it is in QMP mode. */
203 int monitor_cur_is_qmp(void)
205 return cur_mon && monitor_ctrl_mode(cur_mon);
208 static void monitor_read_command(Monitor *mon, int show_prompt)
213 readline_start(mon->rs, "(qemu) ", 0, monitor_command_cb, NULL);
215 readline_show_prompt(mon->rs);
218 static int monitor_read_password(Monitor *mon, ReadLineFunc *readline_func,
221 if (monitor_ctrl_mode(mon)) {
222 qerror_report(QERR_MISSING_PARAMETER, "password");
224 } else if (mon->rs) {
225 readline_start(mon->rs, "Password: ", 1, readline_func, opaque);
226 /* prompt is printed on return from the command handler */
229 monitor_printf(mon, "terminal does not support password prompting\n");
234 void monitor_flush(Monitor *mon)
236 if (mon && mon->outbuf_index != 0 && !mon->mux_out) {
237 qemu_chr_write(mon->chr, mon->outbuf, mon->outbuf_index);
238 mon->outbuf_index = 0;
242 /* flush at every end of line or if the buffer is full */
243 static void monitor_puts(Monitor *mon, const char *str)
252 mon->outbuf[mon->outbuf_index++] = '\r';
253 mon->outbuf[mon->outbuf_index++] = c;
254 if (mon->outbuf_index >= (sizeof(mon->outbuf) - 1)
260 void monitor_vprintf(Monitor *mon, const char *fmt, va_list ap)
267 mon_print_count_inc(mon);
269 if (monitor_ctrl_mode(mon)) {
273 vsnprintf(buf, sizeof(buf), fmt, ap);
274 monitor_puts(mon, buf);
277 void monitor_printf(Monitor *mon, const char *fmt, ...)
281 monitor_vprintf(mon, fmt, ap);
285 void monitor_print_filename(Monitor *mon, const char *filename)
289 for (i = 0; filename[i]; i++) {
290 switch (filename[i]) {
294 monitor_printf(mon, "\\%c", filename[i]);
297 monitor_printf(mon, "\\t");
300 monitor_printf(mon, "\\r");
303 monitor_printf(mon, "\\n");
306 monitor_printf(mon, "%c", filename[i]);
312 static int monitor_fprintf(FILE *stream, const char *fmt, ...)
316 monitor_vprintf((Monitor *)stream, fmt, ap);
321 static void monitor_user_noop(Monitor *mon, const QObject *data) { }
323 static inline int monitor_handler_ported(const mon_cmd_t *cmd)
325 return cmd->user_print != NULL;
328 static inline bool monitor_handler_is_async(const mon_cmd_t *cmd)
330 return cmd->async != 0;
333 static inline int monitor_has_error(const Monitor *mon)
335 return mon->error != NULL;
338 static void monitor_json_emitter(Monitor *mon, const QObject *data)
342 json = qobject_to_json(data);
343 assert(json != NULL);
345 qstring_append_chr(json, '\n');
346 monitor_puts(mon, qstring_get_str(json));
351 static void monitor_protocol_emitter(Monitor *mon, QObject *data)
357 if (!monitor_has_error(mon)) {
358 /* success response */
360 qobject_incref(data);
361 qdict_put_obj(qmp, "return", data);
363 /* return an empty QDict by default */
364 qdict_put(qmp, "return", qdict_new());
368 qdict_put(mon->error->error, "desc", qerror_human(mon->error));
369 qdict_put(qmp, "error", mon->error->error);
370 QINCREF(mon->error->error);
376 qdict_put_obj(qmp, "id", mon->mc->id);
380 monitor_json_emitter(mon, QOBJECT(qmp));
384 static void timestamp_put(QDict *qdict)
390 err = qemu_gettimeofday(&tv);
394 obj = qobject_from_jsonf("{ 'seconds': %" PRId64 ", "
395 "'microseconds': %" PRId64 " }",
396 (int64_t) tv.tv_sec, (int64_t) tv.tv_usec);
397 qdict_put_obj(qdict, "timestamp", obj);
401 * monitor_protocol_event(): Generate a Monitor event
403 * Event-specific data can be emitted through the (optional) 'data' parameter.
405 void monitor_protocol_event(MonitorEvent event, QObject *data)
408 const char *event_name;
411 assert(event < QEVENT_MAX);
414 case QEVENT_SHUTDOWN:
415 event_name = "SHUTDOWN";
418 event_name = "RESET";
420 case QEVENT_POWERDOWN:
421 event_name = "POWERDOWN";
427 event_name = "RESUME";
429 case QEVENT_VNC_CONNECTED:
430 event_name = "VNC_CONNECTED";
432 case QEVENT_VNC_INITIALIZED:
433 event_name = "VNC_INITIALIZED";
435 case QEVENT_VNC_DISCONNECTED:
436 event_name = "VNC_DISCONNECTED";
438 case QEVENT_BLOCK_IO_ERROR:
439 event_name = "BLOCK_IO_ERROR";
441 case QEVENT_RTC_CHANGE:
442 event_name = "RTC_CHANGE";
444 case QEVENT_WATCHDOG:
445 event_name = "WATCHDOG";
454 qdict_put(qmp, "event", qstring_from_str(event_name));
456 qobject_incref(data);
457 qdict_put_obj(qmp, "data", data);
460 QLIST_FOREACH(mon, &mon_list, entry) {
461 if (monitor_ctrl_mode(mon) && qmp_cmd_mode(mon)) {
462 monitor_json_emitter(mon, QOBJECT(qmp));
468 static int do_qmp_capabilities(Monitor *mon, const QDict *params,
471 /* Will setup QMP capabilities in the future */
472 if (monitor_ctrl_mode(mon)) {
473 mon->mc->command_mode = 1;
479 static int compare_cmd(const char *name, const char *list)
481 const char *p, *pstart;
489 p = pstart + strlen(pstart);
490 if ((p - pstart) == len && !memcmp(pstart, name, len))
499 static void help_cmd_dump(Monitor *mon, const mon_cmd_t *cmds,
500 const char *prefix, const char *name)
502 const mon_cmd_t *cmd;
504 for(cmd = cmds; cmd->name != NULL; cmd++) {
505 if (!name || !strcmp(name, cmd->name))
506 monitor_printf(mon, "%s%s %s -- %s\n", prefix, cmd->name,
507 cmd->params, cmd->help);
511 static void help_cmd(Monitor *mon, const char *name)
513 if (name && !strcmp(name, "info")) {
514 help_cmd_dump(mon, info_cmds, "info ", NULL);
516 help_cmd_dump(mon, mon_cmds, "", name);
517 if (name && !strcmp(name, "log")) {
518 const CPULogItem *item;
519 monitor_printf(mon, "Log items (comma separated):\n");
520 monitor_printf(mon, "%-10s %s\n", "none", "remove all logs");
521 for(item = cpu_log_items; item->mask != 0; item++) {
522 monitor_printf(mon, "%-10s %s\n", item->name, item->help);
528 static void do_help_cmd(Monitor *mon, const QDict *qdict)
530 help_cmd(mon, qdict_get_try_str(qdict, "name"));
533 static void do_commit(Monitor *mon, const QDict *qdict)
537 const char *device = qdict_get_str(qdict, "device");
539 all_devices = !strcmp(device, "all");
540 QTAILQ_FOREACH(dinfo, &drives, next) {
542 if (strcmp(bdrv_get_device_name(dinfo->bdrv), device))
544 bdrv_commit(dinfo->bdrv);
548 static void user_monitor_complete(void *opaque, QObject *ret_data)
550 MonitorCompletionData *data = (MonitorCompletionData *)opaque;
553 data->user_print(data->mon, ret_data);
555 monitor_resume(data->mon);
559 static void qmp_monitor_complete(void *opaque, QObject *ret_data)
561 monitor_protocol_emitter(opaque, ret_data);
564 static void qmp_async_cmd_handler(Monitor *mon, const mon_cmd_t *cmd,
567 cmd->mhandler.cmd_async(mon, params, qmp_monitor_complete, mon);
570 static void qmp_async_info_handler(Monitor *mon, const mon_cmd_t *cmd)
572 cmd->mhandler.info_async(mon, qmp_monitor_complete, mon);
575 static void user_async_cmd_handler(Monitor *mon, const mon_cmd_t *cmd,
580 MonitorCompletionData *cb_data = qemu_malloc(sizeof(*cb_data));
582 cb_data->user_print = cmd->user_print;
583 monitor_suspend(mon);
584 ret = cmd->mhandler.cmd_async(mon, params,
585 user_monitor_complete, cb_data);
592 static void user_async_info_handler(Monitor *mon, const mon_cmd_t *cmd)
596 MonitorCompletionData *cb_data = qemu_malloc(sizeof(*cb_data));
598 cb_data->user_print = cmd->user_print;
599 monitor_suspend(mon);
600 ret = cmd->mhandler.info_async(mon, user_monitor_complete, cb_data);
607 static int do_info(Monitor *mon, const QDict *qdict, QObject **ret_data)
609 const mon_cmd_t *cmd;
610 const char *item = qdict_get_try_str(qdict, "item");
613 assert(monitor_ctrl_mode(mon) == 0);
617 for (cmd = info_cmds; cmd->name != NULL; cmd++) {
618 if (compare_cmd(item, cmd->name))
622 if (cmd->name == NULL) {
623 if (monitor_ctrl_mode(mon)) {
624 qerror_report(QERR_COMMAND_NOT_FOUND, item);
630 if (monitor_handler_is_async(cmd)) {
631 if (monitor_ctrl_mode(mon)) {
632 qmp_async_info_handler(mon, cmd);
634 user_async_info_handler(mon, cmd);
637 * Indicate that this command is asynchronous and will not return any
638 * data (not even empty). Instead, the data will be returned via a
639 * completion callback.
641 *ret_data = qobject_from_jsonf("{ '__mon_async': 'return' }");
642 } else if (monitor_handler_ported(cmd)) {
643 cmd->mhandler.info_new(mon, ret_data);
645 if (!monitor_ctrl_mode(mon)) {
647 * User Protocol function is called here, Monitor Protocol is
648 * handled by monitor_call_handler()
651 cmd->user_print(mon, *ret_data);
654 if (monitor_ctrl_mode(mon)) {
655 /* handler not converted yet */
656 qerror_report(QERR_COMMAND_NOT_FOUND, item);
659 cmd->mhandler.info(mon);
666 help_cmd(mon, "info");
670 static void do_info_version_print(Monitor *mon, const QObject *data)
674 qdict = qobject_to_qdict(data);
676 monitor_printf(mon, "%s%s\n", qdict_get_str(qdict, "qemu"),
677 qdict_get_str(qdict, "package"));
681 * do_info_version(): Show QEMU version
683 * Return a QDict with the following information:
685 * - "qemu": QEMU's version
686 * - "package": package's version
690 * { "qemu": "0.11.50", "package": "" }
692 static void do_info_version(Monitor *mon, QObject **ret_data)
694 *ret_data = qobject_from_jsonf("{ 'qemu': %s, 'package': %s }",
695 QEMU_VERSION, QEMU_PKGVERSION);
698 static void do_info_name_print(Monitor *mon, const QObject *data)
702 qdict = qobject_to_qdict(data);
703 if (qdict_size(qdict) == 0) {
707 monitor_printf(mon, "%s\n", qdict_get_str(qdict, "name"));
711 * do_info_name(): Show VM name
713 * Return a QDict with the following information:
715 * - "name": VM's name (optional)
719 * { "name": "qemu-name" }
721 static void do_info_name(Monitor *mon, QObject **ret_data)
723 *ret_data = qemu_name ? qobject_from_jsonf("{'name': %s }", qemu_name) :
724 qobject_from_jsonf("{}");
727 static QObject *get_cmd_dict(const char *name)
731 /* Remove '|' from some commands */
732 p = strchr(name, '|');
739 return qobject_from_jsonf("{ 'name': %s }", p);
743 * do_info_commands(): List QMP available commands
745 * Each command is represented by a QDict, the returned QObject is a QList
748 * The QDict contains:
750 * - "name": command's name
754 * { [ { "name": "query-balloon" }, { "name": "system_powerdown" } ] }
756 static void do_info_commands(Monitor *mon, QObject **ret_data)
759 const mon_cmd_t *cmd;
761 cmd_list = qlist_new();
763 for (cmd = mon_cmds; cmd->name != NULL; cmd++) {
764 if (monitor_handler_ported(cmd) && !compare_cmd(cmd->name, "info")) {
765 qlist_append_obj(cmd_list, get_cmd_dict(cmd->name));
769 for (cmd = info_cmds; cmd->name != NULL; cmd++) {
770 if (monitor_handler_ported(cmd)) {
772 snprintf(buf, sizeof(buf), "query-%s", cmd->name);
773 qlist_append_obj(cmd_list, get_cmd_dict(buf));
777 *ret_data = QOBJECT(cmd_list);
780 #if defined(TARGET_I386)
781 static void do_info_hpet_print(Monitor *mon, const QObject *data)
783 monitor_printf(mon, "HPET is %s by QEMU\n",
784 qdict_get_bool(qobject_to_qdict(data), "enabled") ?
785 "enabled" : "disabled");
789 * do_info_hpet(): Show HPET state
791 * Return a QDict with the following information:
793 * - "enabled": true if hpet if enabled, false otherwise
797 * { "enabled": true }
799 static void do_info_hpet(Monitor *mon, QObject **ret_data)
801 *ret_data = qobject_from_jsonf("{ 'enabled': %i }", !no_hpet);
805 static void do_info_uuid_print(Monitor *mon, const QObject *data)
807 monitor_printf(mon, "%s\n", qdict_get_str(qobject_to_qdict(data), "UUID"));
811 * do_info_uuid(): Show VM UUID
813 * Return a QDict with the following information:
815 * - "UUID": Universally Unique Identifier
819 * { "UUID": "550e8400-e29b-41d4-a716-446655440000" }
821 static void do_info_uuid(Monitor *mon, QObject **ret_data)
825 snprintf(uuid, sizeof(uuid), UUID_FMT, qemu_uuid[0], qemu_uuid[1],
826 qemu_uuid[2], qemu_uuid[3], qemu_uuid[4], qemu_uuid[5],
827 qemu_uuid[6], qemu_uuid[7], qemu_uuid[8], qemu_uuid[9],
828 qemu_uuid[10], qemu_uuid[11], qemu_uuid[12], qemu_uuid[13],
829 qemu_uuid[14], qemu_uuid[15]);
830 *ret_data = qobject_from_jsonf("{ 'UUID': %s }", uuid);
833 /* get the current CPU defined by the user */
834 static int mon_set_cpu(int cpu_index)
838 for(env = first_cpu; env != NULL; env = env->next_cpu) {
839 if (env->cpu_index == cpu_index) {
840 cur_mon->mon_cpu = env;
847 static CPUState *mon_get_cpu(void)
849 if (!cur_mon->mon_cpu) {
852 cpu_synchronize_state(cur_mon->mon_cpu);
853 return cur_mon->mon_cpu;
856 static void do_info_registers(Monitor *mon)
861 cpu_dump_state(env, (FILE *)mon, monitor_fprintf,
864 cpu_dump_state(env, (FILE *)mon, monitor_fprintf,
869 static void print_cpu_iter(QObject *obj, void *opaque)
873 Monitor *mon = opaque;
875 assert(qobject_type(obj) == QTYPE_QDICT);
876 cpu = qobject_to_qdict(obj);
878 if (qdict_get_bool(cpu, "current")) {
882 monitor_printf(mon, "%c CPU #%d: ", active, (int)qdict_get_int(cpu, "CPU"));
884 #if defined(TARGET_I386)
885 monitor_printf(mon, "pc=0x" TARGET_FMT_lx,
886 (target_ulong) qdict_get_int(cpu, "pc"));
887 #elif defined(TARGET_PPC)
888 monitor_printf(mon, "nip=0x" TARGET_FMT_lx,
889 (target_long) qdict_get_int(cpu, "nip"));
890 #elif defined(TARGET_SPARC)
891 monitor_printf(mon, "pc=0x " TARGET_FMT_lx,
892 (target_long) qdict_get_int(cpu, "pc"));
893 monitor_printf(mon, "npc=0x" TARGET_FMT_lx,
894 (target_long) qdict_get_int(cpu, "npc"));
895 #elif defined(TARGET_MIPS)
896 monitor_printf(mon, "PC=0x" TARGET_FMT_lx,
897 (target_long) qdict_get_int(cpu, "PC"));
900 if (qdict_get_bool(cpu, "halted")) {
901 monitor_printf(mon, " (halted)");
904 monitor_printf(mon, "\n");
907 static void monitor_print_cpus(Monitor *mon, const QObject *data)
911 assert(qobject_type(data) == QTYPE_QLIST);
912 cpu_list = qobject_to_qlist(data);
913 qlist_iter(cpu_list, print_cpu_iter, mon);
917 * do_info_cpus(): Show CPU information
919 * Return a QList. Each CPU is represented by a QDict, which contains:
922 * - "current": true if this is the current CPU, false otherwise
923 * - "halted": true if the cpu is halted, false otherwise
924 * - Current program counter. The key's name depends on the architecture:
927 * "pc" and "npc": sparc
932 * [ { "CPU": 0, "current": true, "halted": false, "pc": 3227107138 },
933 * { "CPU": 1, "current": false, "halted": true, "pc": 7108165 } ]
935 static void do_info_cpus(Monitor *mon, QObject **ret_data)
940 cpu_list = qlist_new();
942 /* just to set the default cpu if not already done */
945 for(env = first_cpu; env != NULL; env = env->next_cpu) {
949 cpu_synchronize_state(env);
951 obj = qobject_from_jsonf("{ 'CPU': %d, 'current': %i, 'halted': %i }",
952 env->cpu_index, env == mon->mon_cpu,
955 cpu = qobject_to_qdict(obj);
957 #if defined(TARGET_I386)
958 qdict_put(cpu, "pc", qint_from_int(env->eip + env->segs[R_CS].base));
959 #elif defined(TARGET_PPC)
960 qdict_put(cpu, "nip", qint_from_int(env->nip));
961 #elif defined(TARGET_SPARC)
962 qdict_put(cpu, "pc", qint_from_int(env->pc));
963 qdict_put(cpu, "npc", qint_from_int(env->npc));
964 #elif defined(TARGET_MIPS)
965 qdict_put(cpu, "PC", qint_from_int(env->active_tc.PC));
968 qlist_append(cpu_list, cpu);
971 *ret_data = QOBJECT(cpu_list);
974 static int do_cpu_set(Monitor *mon, const QDict *qdict, QObject **ret_data)
976 int index = qdict_get_int(qdict, "index");
977 if (mon_set_cpu(index) < 0) {
978 qerror_report(QERR_INVALID_PARAMETER_VALUE, "index",
985 static void do_info_jit(Monitor *mon)
987 dump_exec_info((FILE *)mon, monitor_fprintf);
990 static void do_info_history(Monitor *mon)
999 str = readline_get_history(mon->rs, i);
1002 monitor_printf(mon, "%d: '%s'\n", i, str);
1007 #if defined(TARGET_PPC)
1008 /* XXX: not implemented in other targets */
1009 static void do_info_cpu_stats(Monitor *mon)
1013 env = mon_get_cpu();
1014 cpu_dump_statistics(env, (FILE *)mon, &monitor_fprintf, 0);
1019 * do_quit(): Quit QEMU execution
1021 static int do_quit(Monitor *mon, const QDict *qdict, QObject **ret_data)
1023 monitor_suspend(mon);
1025 qemu_system_shutdown_request();
1030 static int eject_device(Monitor *mon, BlockDriverState *bs, int force)
1032 if (bdrv_is_inserted(bs)) {
1034 if (!bdrv_is_removable(bs)) {
1035 qerror_report(QERR_DEVICE_NOT_REMOVABLE,
1036 bdrv_get_device_name(bs));
1039 if (bdrv_is_locked(bs)) {
1040 qerror_report(QERR_DEVICE_LOCKED, bdrv_get_device_name(bs));
1049 static int do_eject(Monitor *mon, const QDict *qdict, QObject **ret_data)
1051 BlockDriverState *bs;
1052 int force = qdict_get_int(qdict, "force");
1053 const char *filename = qdict_get_str(qdict, "device");
1055 bs = bdrv_find(filename);
1057 qerror_report(QERR_DEVICE_NOT_FOUND, filename);
1060 return eject_device(mon, bs, force);
1063 static int do_block_set_passwd(Monitor *mon, const QDict *qdict,
1066 BlockDriverState *bs;
1069 bs = bdrv_find(qdict_get_str(qdict, "device"));
1071 qerror_report(QERR_DEVICE_NOT_FOUND, qdict_get_str(qdict, "device"));
1075 err = bdrv_set_key(bs, qdict_get_str(qdict, "password"));
1076 if (err == -EINVAL) {
1077 qerror_report(QERR_DEVICE_NOT_ENCRYPTED, bdrv_get_device_name(bs));
1079 } else if (err < 0) {
1080 qerror_report(QERR_INVALID_PASSWORD);
1087 static int do_change_block(Monitor *mon, const char *device,
1088 const char *filename, const char *fmt)
1090 BlockDriverState *bs;
1091 BlockDriver *drv = NULL;
1094 bs = bdrv_find(device);
1096 qerror_report(QERR_DEVICE_NOT_FOUND, device);
1100 drv = bdrv_find_whitelisted_format(fmt);
1102 qerror_report(QERR_INVALID_BLOCK_FORMAT, fmt);
1106 if (eject_device(mon, bs, 0) < 0) {
1109 bdrv_flags = bdrv_get_type_hint(bs) == BDRV_TYPE_CDROM ? 0 : BDRV_O_RDWR;
1110 if (bdrv_open(bs, filename, bdrv_flags, drv) < 0) {
1111 qerror_report(QERR_OPEN_FILE_FAILED, filename);
1114 return monitor_read_bdrv_key_start(mon, bs, NULL, NULL);
1117 static int change_vnc_password(const char *password)
1119 if (vnc_display_password(NULL, password) < 0) {
1120 qerror_report(QERR_SET_PASSWD_FAILED);
1127 static void change_vnc_password_cb(Monitor *mon, const char *password,
1130 change_vnc_password(password);
1131 monitor_read_command(mon, 1);
1134 static int do_change_vnc(Monitor *mon, const char *target, const char *arg)
1136 if (strcmp(target, "passwd") == 0 ||
1137 strcmp(target, "password") == 0) {
1140 strncpy(password, arg, sizeof(password));
1141 password[sizeof(password) - 1] = '\0';
1142 return change_vnc_password(password);
1144 return monitor_read_password(mon, change_vnc_password_cb, NULL);
1147 if (vnc_display_open(NULL, target) < 0) {
1148 qerror_report(QERR_VNC_SERVER_FAILED, target);
1157 * do_change(): Change a removable medium, or VNC configuration
1159 static int do_change(Monitor *mon, const QDict *qdict, QObject **ret_data)
1161 const char *device = qdict_get_str(qdict, "device");
1162 const char *target = qdict_get_str(qdict, "target");
1163 const char *arg = qdict_get_try_str(qdict, "arg");
1166 if (strcmp(device, "vnc") == 0) {
1167 ret = do_change_vnc(mon, target, arg);
1169 ret = do_change_block(mon, device, target, arg);
1175 static int do_screen_dump(Monitor *mon, const QDict *qdict, QObject **ret_data)
1177 vga_hw_screen_dump(qdict_get_str(qdict, "filename"));
1181 static void do_logfile(Monitor *mon, const QDict *qdict)
1183 cpu_set_log_filename(qdict_get_str(qdict, "filename"));
1186 static void do_log(Monitor *mon, const QDict *qdict)
1189 const char *items = qdict_get_str(qdict, "items");
1191 if (!strcmp(items, "none")) {
1194 mask = cpu_str_to_log_mask(items);
1196 help_cmd(mon, "log");
1203 static void do_singlestep(Monitor *mon, const QDict *qdict)
1205 const char *option = qdict_get_try_str(qdict, "option");
1206 if (!option || !strcmp(option, "on")) {
1208 } else if (!strcmp(option, "off")) {
1211 monitor_printf(mon, "unexpected option %s\n", option);
1216 * do_stop(): Stop VM execution
1218 static int do_stop(Monitor *mon, const QDict *qdict, QObject **ret_data)
1220 vm_stop(EXCP_INTERRUPT);
1224 static void encrypted_bdrv_it(void *opaque, BlockDriverState *bs);
1226 struct bdrv_iterate_context {
1232 * do_cont(): Resume emulation.
1234 static int do_cont(Monitor *mon, const QDict *qdict, QObject **ret_data)
1236 struct bdrv_iterate_context context = { mon, 0 };
1238 bdrv_iterate(encrypted_bdrv_it, &context);
1239 /* only resume the vm if all keys are set and valid */
1248 static void bdrv_key_cb(void *opaque, int err)
1250 Monitor *mon = opaque;
1252 /* another key was set successfully, retry to continue */
1254 do_cont(mon, NULL, NULL);
1257 static void encrypted_bdrv_it(void *opaque, BlockDriverState *bs)
1259 struct bdrv_iterate_context *context = opaque;
1261 if (!context->err && bdrv_key_required(bs)) {
1262 context->err = -EBUSY;
1263 monitor_read_bdrv_key_start(context->mon, bs, bdrv_key_cb,
1268 static void do_gdbserver(Monitor *mon, const QDict *qdict)
1270 const char *device = qdict_get_try_str(qdict, "device");
1272 device = "tcp::" DEFAULT_GDBSTUB_PORT;
1273 if (gdbserver_start(device) < 0) {
1274 monitor_printf(mon, "Could not open gdbserver on device '%s'\n",
1276 } else if (strcmp(device, "none") == 0) {
1277 monitor_printf(mon, "Disabled gdbserver\n");
1279 monitor_printf(mon, "Waiting for gdb connection on device '%s'\n",
1284 static void do_watchdog_action(Monitor *mon, const QDict *qdict)
1286 const char *action = qdict_get_str(qdict, "action");
1287 if (select_watchdog_action(action) == -1) {
1288 monitor_printf(mon, "Unknown watchdog action '%s'\n", action);
1292 static void monitor_printc(Monitor *mon, int c)
1294 monitor_printf(mon, "'");
1297 monitor_printf(mon, "\\'");
1300 monitor_printf(mon, "\\\\");
1303 monitor_printf(mon, "\\n");
1306 monitor_printf(mon, "\\r");
1309 if (c >= 32 && c <= 126) {
1310 monitor_printf(mon, "%c", c);
1312 monitor_printf(mon, "\\x%02x", c);
1316 monitor_printf(mon, "'");
1319 static void memory_dump(Monitor *mon, int count, int format, int wsize,
1320 target_phys_addr_t addr, int is_physical)
1323 int l, line_size, i, max_digits, len;
1327 if (format == 'i') {
1330 env = mon_get_cpu();
1334 } else if (wsize == 4) {
1337 /* as default we use the current CS size */
1340 #ifdef TARGET_X86_64
1341 if ((env->efer & MSR_EFER_LMA) &&
1342 (env->segs[R_CS].flags & DESC_L_MASK))
1346 if (!(env->segs[R_CS].flags & DESC_B_MASK))
1351 monitor_disas(mon, env, addr, count, is_physical, flags);
1355 len = wsize * count;
1364 max_digits = (wsize * 8 + 2) / 3;
1368 max_digits = (wsize * 8) / 4;
1372 max_digits = (wsize * 8 * 10 + 32) / 33;
1381 monitor_printf(mon, TARGET_FMT_plx ":", addr);
1383 monitor_printf(mon, TARGET_FMT_lx ":", (target_ulong)addr);
1388 cpu_physical_memory_rw(addr, buf, l, 0);
1390 env = mon_get_cpu();
1391 if (cpu_memory_rw_debug(env, addr, buf, l, 0) < 0) {
1392 monitor_printf(mon, " Cannot access memory\n");
1401 v = ldub_raw(buf + i);
1404 v = lduw_raw(buf + i);
1407 v = (uint32_t)ldl_raw(buf + i);
1410 v = ldq_raw(buf + i);
1413 monitor_printf(mon, " ");
1416 monitor_printf(mon, "%#*" PRIo64, max_digits, v);
1419 monitor_printf(mon, "0x%0*" PRIx64, max_digits, v);
1422 monitor_printf(mon, "%*" PRIu64, max_digits, v);
1425 monitor_printf(mon, "%*" PRId64, max_digits, v);
1428 monitor_printc(mon, v);
1433 monitor_printf(mon, "\n");
1439 static void do_memory_dump(Monitor *mon, const QDict *qdict)
1441 int count = qdict_get_int(qdict, "count");
1442 int format = qdict_get_int(qdict, "format");
1443 int size = qdict_get_int(qdict, "size");
1444 target_long addr = qdict_get_int(qdict, "addr");
1446 memory_dump(mon, count, format, size, addr, 0);
1449 static void do_physical_memory_dump(Monitor *mon, const QDict *qdict)
1451 int count = qdict_get_int(qdict, "count");
1452 int format = qdict_get_int(qdict, "format");
1453 int size = qdict_get_int(qdict, "size");
1454 target_phys_addr_t addr = qdict_get_int(qdict, "addr");
1456 memory_dump(mon, count, format, size, addr, 1);
1459 static void do_print(Monitor *mon, const QDict *qdict)
1461 int format = qdict_get_int(qdict, "format");
1462 target_phys_addr_t val = qdict_get_int(qdict, "val");
1464 #if TARGET_PHYS_ADDR_BITS == 32
1467 monitor_printf(mon, "%#o", val);
1470 monitor_printf(mon, "%#x", val);
1473 monitor_printf(mon, "%u", val);
1477 monitor_printf(mon, "%d", val);
1480 monitor_printc(mon, val);
1486 monitor_printf(mon, "%#" PRIo64, val);
1489 monitor_printf(mon, "%#" PRIx64, val);
1492 monitor_printf(mon, "%" PRIu64, val);
1496 monitor_printf(mon, "%" PRId64, val);
1499 monitor_printc(mon, val);
1503 monitor_printf(mon, "\n");
1506 static int do_memory_save(Monitor *mon, const QDict *qdict, QObject **ret_data)
1509 uint32_t size = qdict_get_int(qdict, "size");
1510 const char *filename = qdict_get_str(qdict, "filename");
1511 target_long addr = qdict_get_int(qdict, "val");
1517 env = mon_get_cpu();
1519 f = fopen(filename, "wb");
1521 qerror_report(QERR_OPEN_FILE_FAILED, filename);
1528 cpu_memory_rw_debug(env, addr, buf, l, 0);
1529 if (fwrite(buf, 1, l, f) != l) {
1530 monitor_printf(mon, "fwrite() error in do_memory_save\n");
1544 static int do_physical_memory_save(Monitor *mon, const QDict *qdict,
1550 uint32_t size = qdict_get_int(qdict, "size");
1551 const char *filename = qdict_get_str(qdict, "filename");
1552 target_phys_addr_t addr = qdict_get_int(qdict, "val");
1555 f = fopen(filename, "wb");
1557 qerror_report(QERR_OPEN_FILE_FAILED, filename);
1564 cpu_physical_memory_rw(addr, buf, l, 0);
1565 if (fwrite(buf, 1, l, f) != l) {
1566 monitor_printf(mon, "fwrite() error in do_physical_memory_save\n");
1581 static void do_sum(Monitor *mon, const QDict *qdict)
1586 uint32_t start = qdict_get_int(qdict, "start");
1587 uint32_t size = qdict_get_int(qdict, "size");
1590 for(addr = start; addr < (start + size); addr++) {
1591 cpu_physical_memory_rw(addr, buf, 1, 0);
1592 /* BSD sum algorithm ('sum' Unix command) */
1593 sum = (sum >> 1) | (sum << 15);
1596 monitor_printf(mon, "%05d\n", sum);
1604 static const KeyDef key_defs[] = {
1606 { 0x36, "shift_r" },
1611 { 0xe4, "altgr_r" },
1631 { 0x0e, "backspace" },
1668 { 0x37, "asterisk" },
1671 { 0x3a, "caps_lock" },
1682 { 0x45, "num_lock" },
1683 { 0x46, "scroll_lock" },
1685 { 0xb5, "kp_divide" },
1686 { 0x37, "kp_multiply" },
1687 { 0x4a, "kp_subtract" },
1689 { 0x9c, "kp_enter" },
1690 { 0x53, "kp_decimal" },
1723 #if defined(TARGET_SPARC) && !defined(TARGET_SPARC64)
1738 { 0xfe, "compose" },
1743 static int get_keycode(const char *key)
1749 for(p = key_defs; p->name != NULL; p++) {
1750 if (!strcmp(key, p->name))
1753 if (strstart(key, "0x", NULL)) {
1754 ret = strtoul(key, &endp, 0);
1755 if (*endp == '\0' && ret >= 0x01 && ret <= 0xff)
1761 #define MAX_KEYCODES 16
1762 static uint8_t keycodes[MAX_KEYCODES];
1763 static int nb_pending_keycodes;
1764 static QEMUTimer *key_timer;
1766 static void release_keys(void *opaque)
1770 while (nb_pending_keycodes > 0) {
1771 nb_pending_keycodes--;
1772 keycode = keycodes[nb_pending_keycodes];
1774 kbd_put_keycode(0xe0);
1775 kbd_put_keycode(keycode | 0x80);
1779 static void do_sendkey(Monitor *mon, const QDict *qdict)
1781 char keyname_buf[16];
1783 int keyname_len, keycode, i;
1784 const char *string = qdict_get_str(qdict, "string");
1785 int has_hold_time = qdict_haskey(qdict, "hold_time");
1786 int hold_time = qdict_get_try_int(qdict, "hold_time", -1);
1788 if (nb_pending_keycodes > 0) {
1789 qemu_del_timer(key_timer);
1796 separator = strchr(string, '-');
1797 keyname_len = separator ? separator - string : strlen(string);
1798 if (keyname_len > 0) {
1799 pstrcpy(keyname_buf, sizeof(keyname_buf), string);
1800 if (keyname_len > sizeof(keyname_buf) - 1) {
1801 monitor_printf(mon, "invalid key: '%s...'\n", keyname_buf);
1804 if (i == MAX_KEYCODES) {
1805 monitor_printf(mon, "too many keys\n");
1808 keyname_buf[keyname_len] = 0;
1809 keycode = get_keycode(keyname_buf);
1811 monitor_printf(mon, "unknown key: '%s'\n", keyname_buf);
1814 keycodes[i++] = keycode;
1818 string = separator + 1;
1820 nb_pending_keycodes = i;
1821 /* key down events */
1822 for (i = 0; i < nb_pending_keycodes; i++) {
1823 keycode = keycodes[i];
1825 kbd_put_keycode(0xe0);
1826 kbd_put_keycode(keycode & 0x7f);
1828 /* delayed key up events */
1829 qemu_mod_timer(key_timer, qemu_get_clock(vm_clock) +
1830 muldiv64(get_ticks_per_sec(), hold_time, 1000));
1833 static int mouse_button_state;
1835 static void do_mouse_move(Monitor *mon, const QDict *qdict)
1838 const char *dx_str = qdict_get_str(qdict, "dx_str");
1839 const char *dy_str = qdict_get_str(qdict, "dy_str");
1840 const char *dz_str = qdict_get_try_str(qdict, "dz_str");
1841 dx = strtol(dx_str, NULL, 0);
1842 dy = strtol(dy_str, NULL, 0);
1845 dz = strtol(dz_str, NULL, 0);
1846 kbd_mouse_event(dx, dy, dz, mouse_button_state);
1849 static void do_mouse_button(Monitor *mon, const QDict *qdict)
1851 int button_state = qdict_get_int(qdict, "button_state");
1852 mouse_button_state = button_state;
1853 kbd_mouse_event(0, 0, 0, mouse_button_state);
1856 static void do_ioport_read(Monitor *mon, const QDict *qdict)
1858 int size = qdict_get_int(qdict, "size");
1859 int addr = qdict_get_int(qdict, "addr");
1860 int has_index = qdict_haskey(qdict, "index");
1865 int index = qdict_get_int(qdict, "index");
1866 cpu_outb(addr & IOPORTS_MASK, index & 0xff);
1874 val = cpu_inb(addr);
1878 val = cpu_inw(addr);
1882 val = cpu_inl(addr);
1886 monitor_printf(mon, "port%c[0x%04x] = %#0*x\n",
1887 suffix, addr, size * 2, val);
1890 static void do_ioport_write(Monitor *mon, const QDict *qdict)
1892 int size = qdict_get_int(qdict, "size");
1893 int addr = qdict_get_int(qdict, "addr");
1894 int val = qdict_get_int(qdict, "val");
1896 addr &= IOPORTS_MASK;
1901 cpu_outb(addr, val);
1904 cpu_outw(addr, val);
1907 cpu_outl(addr, val);
1912 static void do_boot_set(Monitor *mon, const QDict *qdict)
1915 const char *bootdevice = qdict_get_str(qdict, "bootdevice");
1917 res = qemu_boot_set(bootdevice);
1919 monitor_printf(mon, "boot device list now set to %s\n", bootdevice);
1920 } else if (res > 0) {
1921 monitor_printf(mon, "setting boot device list failed\n");
1923 monitor_printf(mon, "no function defined to set boot device list for "
1924 "this architecture\n");
1929 * do_system_reset(): Issue a machine reset
1931 static int do_system_reset(Monitor *mon, const QDict *qdict,
1934 qemu_system_reset_request();
1939 * do_system_powerdown(): Issue a machine powerdown
1941 static int do_system_powerdown(Monitor *mon, const QDict *qdict,
1944 qemu_system_powerdown_request();
1948 #if defined(TARGET_I386)
1949 static void print_pte(Monitor *mon, uint32_t addr, uint32_t pte, uint32_t mask)
1951 monitor_printf(mon, "%08x: %08x %c%c%c%c%c%c%c%c\n",
1954 pte & PG_GLOBAL_MASK ? 'G' : '-',
1955 pte & PG_PSE_MASK ? 'P' : '-',
1956 pte & PG_DIRTY_MASK ? 'D' : '-',
1957 pte & PG_ACCESSED_MASK ? 'A' : '-',
1958 pte & PG_PCD_MASK ? 'C' : '-',
1959 pte & PG_PWT_MASK ? 'T' : '-',
1960 pte & PG_USER_MASK ? 'U' : '-',
1961 pte & PG_RW_MASK ? 'W' : '-');
1964 static void tlb_info(Monitor *mon)
1968 uint32_t pgd, pde, pte;
1970 env = mon_get_cpu();
1972 if (!(env->cr[0] & CR0_PG_MASK)) {
1973 monitor_printf(mon, "PG disabled\n");
1976 pgd = env->cr[3] & ~0xfff;
1977 for(l1 = 0; l1 < 1024; l1++) {
1978 cpu_physical_memory_read(pgd + l1 * 4, (uint8_t *)&pde, 4);
1979 pde = le32_to_cpu(pde);
1980 if (pde & PG_PRESENT_MASK) {
1981 if ((pde & PG_PSE_MASK) && (env->cr[4] & CR4_PSE_MASK)) {
1982 print_pte(mon, (l1 << 22), pde, ~((1 << 20) - 1));
1984 for(l2 = 0; l2 < 1024; l2++) {
1985 cpu_physical_memory_read((pde & ~0xfff) + l2 * 4,
1986 (uint8_t *)&pte, 4);
1987 pte = le32_to_cpu(pte);
1988 if (pte & PG_PRESENT_MASK) {
1989 print_pte(mon, (l1 << 22) + (l2 << 12),
1999 static void mem_print(Monitor *mon, uint32_t *pstart, int *plast_prot,
2000 uint32_t end, int prot)
2003 prot1 = *plast_prot;
2004 if (prot != prot1) {
2005 if (*pstart != -1) {
2006 monitor_printf(mon, "%08x-%08x %08x %c%c%c\n",
2007 *pstart, end, end - *pstart,
2008 prot1 & PG_USER_MASK ? 'u' : '-',
2010 prot1 & PG_RW_MASK ? 'w' : '-');
2020 static void mem_info(Monitor *mon)
2023 int l1, l2, prot, last_prot;
2024 uint32_t pgd, pde, pte, start, end;
2026 env = mon_get_cpu();
2028 if (!(env->cr[0] & CR0_PG_MASK)) {
2029 monitor_printf(mon, "PG disabled\n");
2032 pgd = env->cr[3] & ~0xfff;
2035 for(l1 = 0; l1 < 1024; l1++) {
2036 cpu_physical_memory_read(pgd + l1 * 4, (uint8_t *)&pde, 4);
2037 pde = le32_to_cpu(pde);
2039 if (pde & PG_PRESENT_MASK) {
2040 if ((pde & PG_PSE_MASK) && (env->cr[4] & CR4_PSE_MASK)) {
2041 prot = pde & (PG_USER_MASK | PG_RW_MASK | PG_PRESENT_MASK);
2042 mem_print(mon, &start, &last_prot, end, prot);
2044 for(l2 = 0; l2 < 1024; l2++) {
2045 cpu_physical_memory_read((pde & ~0xfff) + l2 * 4,
2046 (uint8_t *)&pte, 4);
2047 pte = le32_to_cpu(pte);
2048 end = (l1 << 22) + (l2 << 12);
2049 if (pte & PG_PRESENT_MASK) {
2050 prot = pte & (PG_USER_MASK | PG_RW_MASK | PG_PRESENT_MASK);
2054 mem_print(mon, &start, &last_prot, end, prot);
2059 mem_print(mon, &start, &last_prot, end, prot);
2065 #if defined(TARGET_SH4)
2067 static void print_tlb(Monitor *mon, int idx, tlb_t *tlb)
2069 monitor_printf(mon, " tlb%i:\t"
2070 "asid=%hhu vpn=%x\tppn=%x\tsz=%hhu size=%u\t"
2071 "v=%hhu shared=%hhu cached=%hhu prot=%hhu "
2072 "dirty=%hhu writethrough=%hhu\n",
2074 tlb->asid, tlb->vpn, tlb->ppn, tlb->sz, tlb->size,
2075 tlb->v, tlb->sh, tlb->c, tlb->pr,
2079 static void tlb_info(Monitor *mon)
2081 CPUState *env = mon_get_cpu();
2084 monitor_printf (mon, "ITLB:\n");
2085 for (i = 0 ; i < ITLB_SIZE ; i++)
2086 print_tlb (mon, i, &env->itlb[i]);
2087 monitor_printf (mon, "UTLB:\n");
2088 for (i = 0 ; i < UTLB_SIZE ; i++)
2089 print_tlb (mon, i, &env->utlb[i]);
2094 static void do_info_kvm_print(Monitor *mon, const QObject *data)
2098 qdict = qobject_to_qdict(data);
2100 monitor_printf(mon, "kvm support: ");
2101 if (qdict_get_bool(qdict, "present")) {
2102 monitor_printf(mon, "%s\n", qdict_get_bool(qdict, "enabled") ?
2103 "enabled" : "disabled");
2105 monitor_printf(mon, "not compiled\n");
2110 * do_info_kvm(): Show KVM information
2112 * Return a QDict with the following information:
2114 * - "enabled": true if KVM support is enabled, false otherwise
2115 * - "present": true if QEMU has KVM support, false otherwise
2119 * { "enabled": true, "present": true }
2121 static void do_info_kvm(Monitor *mon, QObject **ret_data)
2124 *ret_data = qobject_from_jsonf("{ 'enabled': %i, 'present': true }",
2127 *ret_data = qobject_from_jsonf("{ 'enabled': false, 'present': false }");
2131 static void do_info_numa(Monitor *mon)
2136 monitor_printf(mon, "%d nodes\n", nb_numa_nodes);
2137 for (i = 0; i < nb_numa_nodes; i++) {
2138 monitor_printf(mon, "node %d cpus:", i);
2139 for (env = first_cpu; env != NULL; env = env->next_cpu) {
2140 if (env->numa_node == i) {
2141 monitor_printf(mon, " %d", env->cpu_index);
2144 monitor_printf(mon, "\n");
2145 monitor_printf(mon, "node %d size: %" PRId64 " MB\n", i,
2150 #ifdef CONFIG_PROFILER
2155 static void do_info_profile(Monitor *mon)
2161 monitor_printf(mon, "async time %" PRId64 " (%0.3f)\n",
2162 dev_time, dev_time / (double)get_ticks_per_sec());
2163 monitor_printf(mon, "qemu time %" PRId64 " (%0.3f)\n",
2164 qemu_time, qemu_time / (double)get_ticks_per_sec());
2169 static void do_info_profile(Monitor *mon)
2171 monitor_printf(mon, "Internal profiler not compiled\n");
2175 /* Capture support */
2176 static QLIST_HEAD (capture_list_head, CaptureState) capture_head;
2178 static void do_info_capture(Monitor *mon)
2183 for (s = capture_head.lh_first, i = 0; s; s = s->entries.le_next, ++i) {
2184 monitor_printf(mon, "[%d]: ", i);
2185 s->ops.info (s->opaque);
2190 static void do_stop_capture(Monitor *mon, const QDict *qdict)
2193 int n = qdict_get_int(qdict, "n");
2196 for (s = capture_head.lh_first, i = 0; s; s = s->entries.le_next, ++i) {
2198 s->ops.destroy (s->opaque);
2199 QLIST_REMOVE (s, entries);
2206 static void do_wav_capture(Monitor *mon, const QDict *qdict)
2208 const char *path = qdict_get_str(qdict, "path");
2209 int has_freq = qdict_haskey(qdict, "freq");
2210 int freq = qdict_get_try_int(qdict, "freq", -1);
2211 int has_bits = qdict_haskey(qdict, "bits");
2212 int bits = qdict_get_try_int(qdict, "bits", -1);
2213 int has_channels = qdict_haskey(qdict, "nchannels");
2214 int nchannels = qdict_get_try_int(qdict, "nchannels", -1);
2217 s = qemu_mallocz (sizeof (*s));
2219 freq = has_freq ? freq : 44100;
2220 bits = has_bits ? bits : 16;
2221 nchannels = has_channels ? nchannels : 2;
2223 if (wav_start_capture (s, path, freq, bits, nchannels)) {
2224 monitor_printf(mon, "Faied to add wave capture\n");
2227 QLIST_INSERT_HEAD (&capture_head, s, entries);
2231 #if defined(TARGET_I386)
2232 static void do_inject_nmi(Monitor *mon, const QDict *qdict)
2235 int cpu_index = qdict_get_int(qdict, "cpu_index");
2237 for (env = first_cpu; env != NULL; env = env->next_cpu)
2238 if (env->cpu_index == cpu_index) {
2239 cpu_interrupt(env, CPU_INTERRUPT_NMI);
2245 static void do_info_status_print(Monitor *mon, const QObject *data)
2249 qdict = qobject_to_qdict(data);
2251 monitor_printf(mon, "VM status: ");
2252 if (qdict_get_bool(qdict, "running")) {
2253 monitor_printf(mon, "running");
2254 if (qdict_get_bool(qdict, "singlestep")) {
2255 monitor_printf(mon, " (single step mode)");
2258 monitor_printf(mon, "paused");
2261 monitor_printf(mon, "\n");
2265 * do_info_status(): VM status
2267 * Return a QDict with the following information:
2269 * - "running": true if the VM is running, or false if it is paused
2270 * - "singlestep": true if the VM is in single step mode, false otherwise
2274 * { "running": true, "singlestep": false }
2276 static void do_info_status(Monitor *mon, QObject **ret_data)
2278 *ret_data = qobject_from_jsonf("{ 'running': %i, 'singlestep': %i }",
2279 vm_running, singlestep);
2282 static qemu_acl *find_acl(Monitor *mon, const char *name)
2284 qemu_acl *acl = qemu_acl_find(name);
2287 monitor_printf(mon, "acl: unknown list '%s'\n", name);
2292 static void do_acl_show(Monitor *mon, const QDict *qdict)
2294 const char *aclname = qdict_get_str(qdict, "aclname");
2295 qemu_acl *acl = find_acl(mon, aclname);
2296 qemu_acl_entry *entry;
2300 monitor_printf(mon, "policy: %s\n",
2301 acl->defaultDeny ? "deny" : "allow");
2302 QTAILQ_FOREACH(entry, &acl->entries, next) {
2304 monitor_printf(mon, "%d: %s %s\n", i,
2305 entry->deny ? "deny" : "allow", entry->match);
2310 static void do_acl_reset(Monitor *mon, const QDict *qdict)
2312 const char *aclname = qdict_get_str(qdict, "aclname");
2313 qemu_acl *acl = find_acl(mon, aclname);
2316 qemu_acl_reset(acl);
2317 monitor_printf(mon, "acl: removed all rules\n");
2321 static void do_acl_policy(Monitor *mon, const QDict *qdict)
2323 const char *aclname = qdict_get_str(qdict, "aclname");
2324 const char *policy = qdict_get_str(qdict, "policy");
2325 qemu_acl *acl = find_acl(mon, aclname);
2328 if (strcmp(policy, "allow") == 0) {
2329 acl->defaultDeny = 0;
2330 monitor_printf(mon, "acl: policy set to 'allow'\n");
2331 } else if (strcmp(policy, "deny") == 0) {
2332 acl->defaultDeny = 1;
2333 monitor_printf(mon, "acl: policy set to 'deny'\n");
2335 monitor_printf(mon, "acl: unknown policy '%s', "
2336 "expected 'deny' or 'allow'\n", policy);
2341 static void do_acl_add(Monitor *mon, const QDict *qdict)
2343 const char *aclname = qdict_get_str(qdict, "aclname");
2344 const char *match = qdict_get_str(qdict, "match");
2345 const char *policy = qdict_get_str(qdict, "policy");
2346 int has_index = qdict_haskey(qdict, "index");
2347 int index = qdict_get_try_int(qdict, "index", -1);
2348 qemu_acl *acl = find_acl(mon, aclname);
2352 if (strcmp(policy, "allow") == 0) {
2354 } else if (strcmp(policy, "deny") == 0) {
2357 monitor_printf(mon, "acl: unknown policy '%s', "
2358 "expected 'deny' or 'allow'\n", policy);
2362 ret = qemu_acl_insert(acl, deny, match, index);
2364 ret = qemu_acl_append(acl, deny, match);
2366 monitor_printf(mon, "acl: unable to add acl entry\n");
2368 monitor_printf(mon, "acl: added rule at position %d\n", ret);
2372 static void do_acl_remove(Monitor *mon, const QDict *qdict)
2374 const char *aclname = qdict_get_str(qdict, "aclname");
2375 const char *match = qdict_get_str(qdict, "match");
2376 qemu_acl *acl = find_acl(mon, aclname);
2380 ret = qemu_acl_remove(acl, match);
2382 monitor_printf(mon, "acl: no matching acl entry\n");
2384 monitor_printf(mon, "acl: removed rule at position %d\n", ret);
2388 #if defined(TARGET_I386)
2389 static void do_inject_mce(Monitor *mon, const QDict *qdict)
2392 int cpu_index = qdict_get_int(qdict, "cpu_index");
2393 int bank = qdict_get_int(qdict, "bank");
2394 uint64_t status = qdict_get_int(qdict, "status");
2395 uint64_t mcg_status = qdict_get_int(qdict, "mcg_status");
2396 uint64_t addr = qdict_get_int(qdict, "addr");
2397 uint64_t misc = qdict_get_int(qdict, "misc");
2399 for (cenv = first_cpu; cenv != NULL; cenv = cenv->next_cpu)
2400 if (cenv->cpu_index == cpu_index && cenv->mcg_cap) {
2401 cpu_inject_x86_mce(cenv, bank, status, mcg_status, addr, misc);
2407 static int do_getfd(Monitor *mon, const QDict *qdict, QObject **ret_data)
2409 const char *fdname = qdict_get_str(qdict, "fdname");
2413 fd = qemu_chr_get_msgfd(mon->chr);
2415 qerror_report(QERR_FD_NOT_SUPPLIED);
2419 if (qemu_isdigit(fdname[0])) {
2420 qerror_report(QERR_INVALID_PARAMETER_VALUE, "fdname",
2421 "a name not starting with a digit");
2425 QLIST_FOREACH(monfd, &mon->fds, next) {
2426 if (strcmp(monfd->name, fdname) != 0) {
2435 monfd = qemu_mallocz(sizeof(mon_fd_t));
2436 monfd->name = qemu_strdup(fdname);
2439 QLIST_INSERT_HEAD(&mon->fds, monfd, next);
2443 static int do_closefd(Monitor *mon, const QDict *qdict, QObject **ret_data)
2445 const char *fdname = qdict_get_str(qdict, "fdname");
2448 QLIST_FOREACH(monfd, &mon->fds, next) {
2449 if (strcmp(monfd->name, fdname) != 0) {
2453 QLIST_REMOVE(monfd, next);
2455 qemu_free(monfd->name);
2460 qerror_report(QERR_FD_NOT_FOUND, fdname);
2464 static void do_loadvm(Monitor *mon, const QDict *qdict)
2466 int saved_vm_running = vm_running;
2467 const char *name = qdict_get_str(qdict, "name");
2471 if (load_vmstate(name) >= 0 && saved_vm_running)
2475 int monitor_get_fd(Monitor *mon, const char *fdname)
2479 QLIST_FOREACH(monfd, &mon->fds, next) {
2482 if (strcmp(monfd->name, fdname) != 0) {
2488 /* caller takes ownership of fd */
2489 QLIST_REMOVE(monfd, next);
2490 qemu_free(monfd->name);
2499 static const mon_cmd_t mon_cmds[] = {
2500 #include "qemu-monitor.h"
2504 /* Please update qemu-monitor.hx when adding or changing commands */
2505 static const mon_cmd_t info_cmds[] = {
2510 .help = "show the version of QEMU",
2511 .user_print = do_info_version_print,
2512 .mhandler.info_new = do_info_version,
2518 .help = "list QMP available commands",
2519 .user_print = monitor_user_noop,
2520 .mhandler.info_new = do_info_commands,
2526 .help = "show the network state",
2527 .mhandler.info = do_info_network,
2533 .help = "show the character devices",
2534 .user_print = qemu_chr_info_print,
2535 .mhandler.info_new = qemu_chr_info,
2541 .help = "show the block devices",
2542 .user_print = bdrv_info_print,
2543 .mhandler.info_new = bdrv_info,
2546 .name = "blockstats",
2549 .help = "show block device statistics",
2550 .user_print = bdrv_stats_print,
2551 .mhandler.info_new = bdrv_info_stats,
2554 .name = "registers",
2557 .help = "show the cpu registers",
2558 .mhandler.info = do_info_registers,
2564 .help = "show infos for each CPU",
2565 .user_print = monitor_print_cpus,
2566 .mhandler.info_new = do_info_cpus,
2572 .help = "show the command line history",
2573 .mhandler.info = do_info_history,
2579 .help = "show the interrupts statistics (if available)",
2580 .mhandler.info = irq_info,
2586 .help = "show i8259 (PIC) state",
2587 .mhandler.info = pic_info,
2593 .help = "show PCI info",
2594 .user_print = do_pci_info_print,
2595 .mhandler.info_new = do_pci_info,
2597 #if defined(TARGET_I386) || defined(TARGET_SH4)
2602 .help = "show virtual to physical memory mappings",
2603 .mhandler.info = tlb_info,
2606 #if defined(TARGET_I386)
2611 .help = "show the active virtual memory mappings",
2612 .mhandler.info = mem_info,
2618 .help = "show state of HPET",
2619 .user_print = do_info_hpet_print,
2620 .mhandler.info_new = do_info_hpet,
2627 .help = "show dynamic compiler info",
2628 .mhandler.info = do_info_jit,
2634 .help = "show KVM information",
2635 .user_print = do_info_kvm_print,
2636 .mhandler.info_new = do_info_kvm,
2642 .help = "show NUMA information",
2643 .mhandler.info = do_info_numa,
2649 .help = "show guest USB devices",
2650 .mhandler.info = usb_info,
2656 .help = "show host USB devices",
2657 .mhandler.info = usb_host_info,
2663 .help = "show profiling information",
2664 .mhandler.info = do_info_profile,
2670 .help = "show capture information",
2671 .mhandler.info = do_info_capture,
2674 .name = "snapshots",
2677 .help = "show the currently saved VM snapshots",
2678 .mhandler.info = do_info_snapshots,
2684 .help = "show the current VM status (running|paused)",
2685 .user_print = do_info_status_print,
2686 .mhandler.info_new = do_info_status,
2692 .help = "show guest PCMCIA status",
2693 .mhandler.info = pcmcia_info,
2699 .help = "show which guest mouse is receiving events",
2700 .user_print = do_info_mice_print,
2701 .mhandler.info_new = do_info_mice,
2707 .help = "show the vnc server status",
2708 .user_print = do_info_vnc_print,
2709 .mhandler.info_new = do_info_vnc,
2715 .help = "show the current VM name",
2716 .user_print = do_info_name_print,
2717 .mhandler.info_new = do_info_name,
2723 .help = "show the current VM UUID",
2724 .user_print = do_info_uuid_print,
2725 .mhandler.info_new = do_info_uuid,
2727 #if defined(TARGET_PPC)
2732 .help = "show CPU statistics",
2733 .mhandler.info = do_info_cpu_stats,
2736 #if defined(CONFIG_SLIRP)
2741 .help = "show user network stack connection states",
2742 .mhandler.info = do_info_usernet,
2749 .help = "show migration status",
2750 .user_print = do_info_migrate_print,
2751 .mhandler.info_new = do_info_migrate,
2757 .help = "show balloon information",
2758 .user_print = monitor_print_balloon,
2759 .mhandler.info_async = do_info_balloon,
2766 .help = "show device tree",
2767 .mhandler.info = do_info_qtree,
2773 .help = "show qdev device model list",
2774 .mhandler.info = do_info_qdm,
2780 .help = "show roms",
2781 .mhandler.info = do_info_roms,
2788 /*******************************************************************/
2790 static const char *pch;
2791 static jmp_buf expr_env;
2796 typedef struct MonitorDef {
2799 target_long (*get_value)(const struct MonitorDef *md, int val);
2803 #if defined(TARGET_I386)
2804 static target_long monitor_get_pc (const struct MonitorDef *md, int val)
2806 CPUState *env = mon_get_cpu();
2807 return env->eip + env->segs[R_CS].base;
2811 #if defined(TARGET_PPC)
2812 static target_long monitor_get_ccr (const struct MonitorDef *md, int val)
2814 CPUState *env = mon_get_cpu();
2819 for (i = 0; i < 8; i++)
2820 u |= env->crf[i] << (32 - (4 * i));
2825 static target_long monitor_get_msr (const struct MonitorDef *md, int val)
2827 CPUState *env = mon_get_cpu();
2831 static target_long monitor_get_xer (const struct MonitorDef *md, int val)
2833 CPUState *env = mon_get_cpu();
2837 static target_long monitor_get_decr (const struct MonitorDef *md, int val)
2839 CPUState *env = mon_get_cpu();
2840 return cpu_ppc_load_decr(env);
2843 static target_long monitor_get_tbu (const struct MonitorDef *md, int val)
2845 CPUState *env = mon_get_cpu();
2846 return cpu_ppc_load_tbu(env);
2849 static target_long monitor_get_tbl (const struct MonitorDef *md, int val)
2851 CPUState *env = mon_get_cpu();
2852 return cpu_ppc_load_tbl(env);
2856 #if defined(TARGET_SPARC)
2857 #ifndef TARGET_SPARC64
2858 static target_long monitor_get_psr (const struct MonitorDef *md, int val)
2860 CPUState *env = mon_get_cpu();
2862 return cpu_get_psr(env);
2866 static target_long monitor_get_reg(const struct MonitorDef *md, int val)
2868 CPUState *env = mon_get_cpu();
2869 return env->regwptr[val];
2873 static const MonitorDef monitor_defs[] = {
2876 #define SEG(name, seg) \
2877 { name, offsetof(CPUState, segs[seg].selector), NULL, MD_I32 },\
2878 { name ".base", offsetof(CPUState, segs[seg].base) },\
2879 { name ".limit", offsetof(CPUState, segs[seg].limit), NULL, MD_I32 },
2881 { "eax", offsetof(CPUState, regs[0]) },
2882 { "ecx", offsetof(CPUState, regs[1]) },
2883 { "edx", offsetof(CPUState, regs[2]) },
2884 { "ebx", offsetof(CPUState, regs[3]) },
2885 { "esp|sp", offsetof(CPUState, regs[4]) },
2886 { "ebp|fp", offsetof(CPUState, regs[5]) },
2887 { "esi", offsetof(CPUState, regs[6]) },
2888 { "edi", offsetof(CPUState, regs[7]) },
2889 #ifdef TARGET_X86_64
2890 { "r8", offsetof(CPUState, regs[8]) },
2891 { "r9", offsetof(CPUState, regs[9]) },
2892 { "r10", offsetof(CPUState, regs[10]) },
2893 { "r11", offsetof(CPUState, regs[11]) },
2894 { "r12", offsetof(CPUState, regs[12]) },
2895 { "r13", offsetof(CPUState, regs[13]) },
2896 { "r14", offsetof(CPUState, regs[14]) },
2897 { "r15", offsetof(CPUState, regs[15]) },
2899 { "eflags", offsetof(CPUState, eflags) },
2900 { "eip", offsetof(CPUState, eip) },
2907 { "pc", 0, monitor_get_pc, },
2908 #elif defined(TARGET_PPC)
2909 /* General purpose registers */
2910 { "r0", offsetof(CPUState, gpr[0]) },
2911 { "r1", offsetof(CPUState, gpr[1]) },
2912 { "r2", offsetof(CPUState, gpr[2]) },
2913 { "r3", offsetof(CPUState, gpr[3]) },
2914 { "r4", offsetof(CPUState, gpr[4]) },
2915 { "r5", offsetof(CPUState, gpr[5]) },
2916 { "r6", offsetof(CPUState, gpr[6]) },
2917 { "r7", offsetof(CPUState, gpr[7]) },
2918 { "r8", offsetof(CPUState, gpr[8]) },
2919 { "r9", offsetof(CPUState, gpr[9]) },
2920 { "r10", offsetof(CPUState, gpr[10]) },
2921 { "r11", offsetof(CPUState, gpr[11]) },
2922 { "r12", offsetof(CPUState, gpr[12]) },
2923 { "r13", offsetof(CPUState, gpr[13]) },
2924 { "r14", offsetof(CPUState, gpr[14]) },
2925 { "r15", offsetof(CPUState, gpr[15]) },
2926 { "r16", offsetof(CPUState, gpr[16]) },
2927 { "r17", offsetof(CPUState, gpr[17]) },
2928 { "r18", offsetof(CPUState, gpr[18]) },
2929 { "r19", offsetof(CPUState, gpr[19]) },
2930 { "r20", offsetof(CPUState, gpr[20]) },
2931 { "r21", offsetof(CPUState, gpr[21]) },
2932 { "r22", offsetof(CPUState, gpr[22]) },
2933 { "r23", offsetof(CPUState, gpr[23]) },
2934 { "r24", offsetof(CPUState, gpr[24]) },
2935 { "r25", offsetof(CPUState, gpr[25]) },
2936 { "r26", offsetof(CPUState, gpr[26]) },
2937 { "r27", offsetof(CPUState, gpr[27]) },
2938 { "r28", offsetof(CPUState, gpr[28]) },
2939 { "r29", offsetof(CPUState, gpr[29]) },
2940 { "r30", offsetof(CPUState, gpr[30]) },
2941 { "r31", offsetof(CPUState, gpr[31]) },
2942 /* Floating point registers */
2943 { "f0", offsetof(CPUState, fpr[0]) },
2944 { "f1", offsetof(CPUState, fpr[1]) },
2945 { "f2", offsetof(CPUState, fpr[2]) },
2946 { "f3", offsetof(CPUState, fpr[3]) },
2947 { "f4", offsetof(CPUState, fpr[4]) },
2948 { "f5", offsetof(CPUState, fpr[5]) },
2949 { "f6", offsetof(CPUState, fpr[6]) },
2950 { "f7", offsetof(CPUState, fpr[7]) },
2951 { "f8", offsetof(CPUState, fpr[8]) },
2952 { "f9", offsetof(CPUState, fpr[9]) },
2953 { "f10", offsetof(CPUState, fpr[10]) },
2954 { "f11", offsetof(CPUState, fpr[11]) },
2955 { "f12", offsetof(CPUState, fpr[12]) },
2956 { "f13", offsetof(CPUState, fpr[13]) },
2957 { "f14", offsetof(CPUState, fpr[14]) },
2958 { "f15", offsetof(CPUState, fpr[15]) },
2959 { "f16", offsetof(CPUState, fpr[16]) },
2960 { "f17", offsetof(CPUState, fpr[17]) },
2961 { "f18", offsetof(CPUState, fpr[18]) },
2962 { "f19", offsetof(CPUState, fpr[19]) },
2963 { "f20", offsetof(CPUState, fpr[20]) },
2964 { "f21", offsetof(CPUState, fpr[21]) },
2965 { "f22", offsetof(CPUState, fpr[22]) },
2966 { "f23", offsetof(CPUState, fpr[23]) },
2967 { "f24", offsetof(CPUState, fpr[24]) },
2968 { "f25", offsetof(CPUState, fpr[25]) },
2969 { "f26", offsetof(CPUState, fpr[26]) },
2970 { "f27", offsetof(CPUState, fpr[27]) },
2971 { "f28", offsetof(CPUState, fpr[28]) },
2972 { "f29", offsetof(CPUState, fpr[29]) },
2973 { "f30", offsetof(CPUState, fpr[30]) },
2974 { "f31", offsetof(CPUState, fpr[31]) },
2975 { "fpscr", offsetof(CPUState, fpscr) },
2976 /* Next instruction pointer */
2977 { "nip|pc", offsetof(CPUState, nip) },
2978 { "lr", offsetof(CPUState, lr) },
2979 { "ctr", offsetof(CPUState, ctr) },
2980 { "decr", 0, &monitor_get_decr, },
2981 { "ccr", 0, &monitor_get_ccr, },
2982 /* Machine state register */
2983 { "msr", 0, &monitor_get_msr, },
2984 { "xer", 0, &monitor_get_xer, },
2985 { "tbu", 0, &monitor_get_tbu, },
2986 { "tbl", 0, &monitor_get_tbl, },
2987 #if defined(TARGET_PPC64)
2988 /* Address space register */
2989 { "asr", offsetof(CPUState, asr) },
2991 /* Segment registers */
2992 { "sdr1", offsetof(CPUState, sdr1) },
2993 { "sr0", offsetof(CPUState, sr[0]) },
2994 { "sr1", offsetof(CPUState, sr[1]) },
2995 { "sr2", offsetof(CPUState, sr[2]) },
2996 { "sr3", offsetof(CPUState, sr[3]) },
2997 { "sr4", offsetof(CPUState, sr[4]) },
2998 { "sr5", offsetof(CPUState, sr[5]) },
2999 { "sr6", offsetof(CPUState, sr[6]) },
3000 { "sr7", offsetof(CPUState, sr[7]) },
3001 { "sr8", offsetof(CPUState, sr[8]) },
3002 { "sr9", offsetof(CPUState, sr[9]) },
3003 { "sr10", offsetof(CPUState, sr[10]) },
3004 { "sr11", offsetof(CPUState, sr[11]) },
3005 { "sr12", offsetof(CPUState, sr[12]) },
3006 { "sr13", offsetof(CPUState, sr[13]) },
3007 { "sr14", offsetof(CPUState, sr[14]) },
3008 { "sr15", offsetof(CPUState, sr[15]) },
3009 /* Too lazy to put BATs and SPRs ... */
3010 #elif defined(TARGET_SPARC)
3011 { "g0", offsetof(CPUState, gregs[0]) },
3012 { "g1", offsetof(CPUState, gregs[1]) },
3013 { "g2", offsetof(CPUState, gregs[2]) },
3014 { "g3", offsetof(CPUState, gregs[3]) },
3015 { "g4", offsetof(CPUState, gregs[4]) },
3016 { "g5", offsetof(CPUState, gregs[5]) },
3017 { "g6", offsetof(CPUState, gregs[6]) },
3018 { "g7", offsetof(CPUState, gregs[7]) },
3019 { "o0", 0, monitor_get_reg },
3020 { "o1", 1, monitor_get_reg },
3021 { "o2", 2, monitor_get_reg },
3022 { "o3", 3, monitor_get_reg },
3023 { "o4", 4, monitor_get_reg },
3024 { "o5", 5, monitor_get_reg },
3025 { "o6", 6, monitor_get_reg },
3026 { "o7", 7, monitor_get_reg },
3027 { "l0", 8, monitor_get_reg },
3028 { "l1", 9, monitor_get_reg },
3029 { "l2", 10, monitor_get_reg },
3030 { "l3", 11, monitor_get_reg },
3031 { "l4", 12, monitor_get_reg },
3032 { "l5", 13, monitor_get_reg },
3033 { "l6", 14, monitor_get_reg },
3034 { "l7", 15, monitor_get_reg },
3035 { "i0", 16, monitor_get_reg },
3036 { "i1", 17, monitor_get_reg },
3037 { "i2", 18, monitor_get_reg },
3038 { "i3", 19, monitor_get_reg },
3039 { "i4", 20, monitor_get_reg },
3040 { "i5", 21, monitor_get_reg },
3041 { "i6", 22, monitor_get_reg },
3042 { "i7", 23, monitor_get_reg },
3043 { "pc", offsetof(CPUState, pc) },
3044 { "npc", offsetof(CPUState, npc) },
3045 { "y", offsetof(CPUState, y) },
3046 #ifndef TARGET_SPARC64
3047 { "psr", 0, &monitor_get_psr, },
3048 { "wim", offsetof(CPUState, wim) },
3050 { "tbr", offsetof(CPUState, tbr) },
3051 { "fsr", offsetof(CPUState, fsr) },
3052 { "f0", offsetof(CPUState, fpr[0]) },
3053 { "f1", offsetof(CPUState, fpr[1]) },
3054 { "f2", offsetof(CPUState, fpr[2]) },
3055 { "f3", offsetof(CPUState, fpr[3]) },
3056 { "f4", offsetof(CPUState, fpr[4]) },
3057 { "f5", offsetof(CPUState, fpr[5]) },
3058 { "f6", offsetof(CPUState, fpr[6]) },
3059 { "f7", offsetof(CPUState, fpr[7]) },
3060 { "f8", offsetof(CPUState, fpr[8]) },
3061 { "f9", offsetof(CPUState, fpr[9]) },
3062 { "f10", offsetof(CPUState, fpr[10]) },
3063 { "f11", offsetof(CPUState, fpr[11]) },
3064 { "f12", offsetof(CPUState, fpr[12]) },
3065 { "f13", offsetof(CPUState, fpr[13]) },
3066 { "f14", offsetof(CPUState, fpr[14]) },
3067 { "f15", offsetof(CPUState, fpr[15]) },
3068 { "f16", offsetof(CPUState, fpr[16]) },
3069 { "f17", offsetof(CPUState, fpr[17]) },
3070 { "f18", offsetof(CPUState, fpr[18]) },
3071 { "f19", offsetof(CPUState, fpr[19]) },
3072 { "f20", offsetof(CPUState, fpr[20]) },
3073 { "f21", offsetof(CPUState, fpr[21]) },
3074 { "f22", offsetof(CPUState, fpr[22]) },
3075 { "f23", offsetof(CPUState, fpr[23]) },
3076 { "f24", offsetof(CPUState, fpr[24]) },
3077 { "f25", offsetof(CPUState, fpr[25]) },
3078 { "f26", offsetof(CPUState, fpr[26]) },
3079 { "f27", offsetof(CPUState, fpr[27]) },
3080 { "f28", offsetof(CPUState, fpr[28]) },
3081 { "f29", offsetof(CPUState, fpr[29]) },
3082 { "f30", offsetof(CPUState, fpr[30]) },
3083 { "f31", offsetof(CPUState, fpr[31]) },
3084 #ifdef TARGET_SPARC64
3085 { "f32", offsetof(CPUState, fpr[32]) },
3086 { "f34", offsetof(CPUState, fpr[34]) },
3087 { "f36", offsetof(CPUState, fpr[36]) },
3088 { "f38", offsetof(CPUState, fpr[38]) },
3089 { "f40", offsetof(CPUState, fpr[40]) },
3090 { "f42", offsetof(CPUState, fpr[42]) },
3091 { "f44", offsetof(CPUState, fpr[44]) },
3092 { "f46", offsetof(CPUState, fpr[46]) },
3093 { "f48", offsetof(CPUState, fpr[48]) },
3094 { "f50", offsetof(CPUState, fpr[50]) },
3095 { "f52", offsetof(CPUState, fpr[52]) },
3096 { "f54", offsetof(CPUState, fpr[54]) },
3097 { "f56", offsetof(CPUState, fpr[56]) },
3098 { "f58", offsetof(CPUState, fpr[58]) },
3099 { "f60", offsetof(CPUState, fpr[60]) },
3100 { "f62", offsetof(CPUState, fpr[62]) },
3101 { "asi", offsetof(CPUState, asi) },
3102 { "pstate", offsetof(CPUState, pstate) },
3103 { "cansave", offsetof(CPUState, cansave) },
3104 { "canrestore", offsetof(CPUState, canrestore) },
3105 { "otherwin", offsetof(CPUState, otherwin) },
3106 { "wstate", offsetof(CPUState, wstate) },
3107 { "cleanwin", offsetof(CPUState, cleanwin) },
3108 { "fprs", offsetof(CPUState, fprs) },
3114 static void expr_error(Monitor *mon, const char *msg)
3116 monitor_printf(mon, "%s\n", msg);
3117 longjmp(expr_env, 1);
3120 /* return 0 if OK, -1 if not found */
3121 static int get_monitor_def(target_long *pval, const char *name)
3123 const MonitorDef *md;
3126 for(md = monitor_defs; md->name != NULL; md++) {
3127 if (compare_cmd(name, md->name)) {
3128 if (md->get_value) {
3129 *pval = md->get_value(md, md->offset);
3131 CPUState *env = mon_get_cpu();
3132 ptr = (uint8_t *)env + md->offset;
3135 *pval = *(int32_t *)ptr;
3138 *pval = *(target_long *)ptr;
3151 static void next(void)
3155 while (qemu_isspace(*pch))
3160 static int64_t expr_sum(Monitor *mon);
3162 static int64_t expr_unary(Monitor *mon)
3171 n = expr_unary(mon);
3175 n = -expr_unary(mon);
3179 n = ~expr_unary(mon);
3185 expr_error(mon, "')' expected");
3192 expr_error(mon, "character constant expected");
3196 expr_error(mon, "missing terminating \' character");
3206 while ((*pch >= 'a' && *pch <= 'z') ||
3207 (*pch >= 'A' && *pch <= 'Z') ||
3208 (*pch >= '0' && *pch <= '9') ||
3209 *pch == '_' || *pch == '.') {
3210 if ((q - buf) < sizeof(buf) - 1)
3214 while (qemu_isspace(*pch))
3217 ret = get_monitor_def(®, buf);
3219 expr_error(mon, "unknown register");
3224 expr_error(mon, "unexpected end of expression");
3228 #if TARGET_PHYS_ADDR_BITS > 32
3229 n = strtoull(pch, &p, 0);
3231 n = strtoul(pch, &p, 0);
3234 expr_error(mon, "invalid char in expression");
3237 while (qemu_isspace(*pch))
3245 static int64_t expr_prod(Monitor *mon)
3250 val = expr_unary(mon);
3253 if (op != '*' && op != '/' && op != '%')
3256 val2 = expr_unary(mon);
3265 expr_error(mon, "division by zero");
3276 static int64_t expr_logic(Monitor *mon)
3281 val = expr_prod(mon);
3284 if (op != '&' && op != '|' && op != '^')
3287 val2 = expr_prod(mon);
3304 static int64_t expr_sum(Monitor *mon)
3309 val = expr_logic(mon);
3312 if (op != '+' && op != '-')
3315 val2 = expr_logic(mon);
3324 static int get_expr(Monitor *mon, int64_t *pval, const char **pp)
3327 if (setjmp(expr_env)) {
3331 while (qemu_isspace(*pch))
3333 *pval = expr_sum(mon);
3338 static int get_double(Monitor *mon, double *pval, const char **pp)
3340 const char *p = *pp;
3344 d = strtod(p, &tailp);
3346 monitor_printf(mon, "Number expected\n");
3349 if (d != d || d - d != 0) {
3350 /* NaN or infinity */
3351 monitor_printf(mon, "Bad number\n");
3359 static int get_str(char *buf, int buf_size, const char **pp)
3367 while (qemu_isspace(*p))
3377 while (*p != '\0' && *p != '\"') {
3393 qemu_printf("unsupported escape code: '\\%c'\n", c);
3396 if ((q - buf) < buf_size - 1) {
3400 if ((q - buf) < buf_size - 1) {
3407 qemu_printf("unterminated string\n");
3412 while (*p != '\0' && !qemu_isspace(*p)) {
3413 if ((q - buf) < buf_size - 1) {
3425 * Store the command-name in cmdname, and return a pointer to
3426 * the remaining of the command string.
3428 static const char *get_command_name(const char *cmdline,
3429 char *cmdname, size_t nlen)
3432 const char *p, *pstart;
3435 while (qemu_isspace(*p))
3440 while (*p != '\0' && *p != '/' && !qemu_isspace(*p))
3445 memcpy(cmdname, pstart, len);
3446 cmdname[len] = '\0';
3451 * Read key of 'type' into 'key' and return the current
3454 static char *key_get_info(const char *type, char **key)
3462 p = strchr(type, ':');
3469 str = qemu_malloc(len + 1);
3470 memcpy(str, type, len);
3477 static int default_fmt_format = 'x';
3478 static int default_fmt_size = 4;
3482 static int is_valid_option(const char *c, const char *typestr)
3490 typestr = strstr(typestr, option);
3491 return (typestr != NULL);
3494 static const mon_cmd_t *monitor_find_command(const char *cmdname)
3496 const mon_cmd_t *cmd;
3498 for (cmd = mon_cmds; cmd->name != NULL; cmd++) {
3499 if (compare_cmd(cmdname, cmd->name)) {
3507 static const mon_cmd_t *monitor_parse_command(Monitor *mon,
3508 const char *cmdline,
3511 const char *p, *typestr;
3513 const mon_cmd_t *cmd;
3519 monitor_printf(mon, "command='%s'\n", cmdline);
3522 /* extract the command name */
3523 p = get_command_name(cmdline, cmdname, sizeof(cmdname));
3527 cmd = monitor_find_command(cmdname);
3529 monitor_printf(mon, "unknown command: '%s'\n", cmdname);
3533 /* parse the parameters */
3534 typestr = cmd->args_type;
3536 typestr = key_get_info(typestr, &key);
3548 while (qemu_isspace(*p))
3550 if (*typestr == '?') {
3553 /* no optional string: NULL argument */
3557 ret = get_str(buf, sizeof(buf), &p);
3561 monitor_printf(mon, "%s: filename expected\n",
3565 monitor_printf(mon, "%s: block device name expected\n",
3569 monitor_printf(mon, "%s: string expected\n", cmdname);
3574 qdict_put(qdict, key, qstring_from_str(buf));
3579 QemuOptsList *opts_list;
3582 opts_list = qemu_find_opts(key);
3583 if (!opts_list || opts_list->desc->name) {
3586 while (qemu_isspace(*p)) {
3591 if (get_str(buf, sizeof(buf), &p) < 0) {
3594 opts = qemu_opts_parse(opts_list, buf, 1);
3598 qemu_opts_to_qdict(opts, qdict);
3599 qemu_opts_del(opts);
3604 int count, format, size;
3606 while (qemu_isspace(*p))
3612 if (qemu_isdigit(*p)) {
3614 while (qemu_isdigit(*p)) {
3615 count = count * 10 + (*p - '0');
3653 if (*p != '\0' && !qemu_isspace(*p)) {
3654 monitor_printf(mon, "invalid char in format: '%c'\n",
3659 format = default_fmt_format;
3660 if (format != 'i') {
3661 /* for 'i', not specifying a size gives -1 as size */
3663 size = default_fmt_size;
3664 default_fmt_size = size;
3666 default_fmt_format = format;
3669 format = default_fmt_format;
3670 if (format != 'i') {
3671 size = default_fmt_size;
3676 qdict_put(qdict, "count", qint_from_int(count));
3677 qdict_put(qdict, "format", qint_from_int(format));
3678 qdict_put(qdict, "size", qint_from_int(size));
3687 while (qemu_isspace(*p))
3689 if (*typestr == '?' || *typestr == '.') {
3690 if (*typestr == '?') {
3698 while (qemu_isspace(*p))
3707 if (get_expr(mon, &val, &p))
3709 /* Check if 'i' is greater than 32-bit */
3710 if ((c == 'i') && ((val >> 32) & 0xffffffff)) {
3711 monitor_printf(mon, "\'%s\' has failed: ", cmdname);
3712 monitor_printf(mon, "integer is for 32-bit values\n");
3714 } else if (c == 'M') {
3717 qdict_put(qdict, key, qint_from_int(val));
3725 while (qemu_isspace(*p))
3727 if (*typestr == '?') {
3733 if (get_double(mon, &val, &p) < 0) {
3736 if (c == 'f' && *p) {
3739 val *= 1 << 10; p++; break;
3741 val *= 1 << 20; p++; break;
3743 val *= 1 << 30; p++; break;
3746 if (c == 'T' && p[0] && p[1] == 's') {
3749 val /= 1e3; p += 2; break;
3751 val /= 1e6; p += 2; break;
3753 val /= 1e9; p += 2; break;
3756 if (*p && !qemu_isspace(*p)) {
3757 monitor_printf(mon, "Unknown unit suffix\n");
3760 qdict_put(qdict, key, qfloat_from_double(val));
3768 while (qemu_isspace(*p)) {
3772 while (qemu_isgraph(*p)) {
3775 if (p - beg == 2 && !memcmp(beg, "on", p - beg)) {
3777 } else if (p - beg == 3 && !memcmp(beg, "off", p - beg)) {
3780 monitor_printf(mon, "Expected 'on' or 'off'\n");
3783 qdict_put(qdict, key, qbool_from_int(val));
3788 const char *tmp = p;
3789 int has_option, skip_key = 0;
3795 while (qemu_isspace(*p))
3801 if(!is_valid_option(p, typestr)) {
3803 monitor_printf(mon, "%s: unsupported option -%c\n",
3817 qdict_put(qdict, key, qint_from_int(has_option));
3822 monitor_printf(mon, "%s: unknown type '%c'\n", cmdname, c);
3828 /* check that all arguments were parsed */
3829 while (qemu_isspace(*p))
3832 monitor_printf(mon, "%s: extraneous characters at the end of line\n",
3844 void monitor_set_error(Monitor *mon, QError *qerror)
3846 /* report only the first error */
3848 mon->error = qerror;
3850 MON_DEBUG("Additional error report at %s:%d\n",
3851 qerror->file, qerror->linenr);
3856 static int is_async_return(const QObject *data)
3858 if (data && qobject_type(data) == QTYPE_QDICT) {
3859 return qdict_haskey(qobject_to_qdict(data), "__mon_async");
3865 static void handler_audit(Monitor *mon, const mon_cmd_t *cmd, int ret)
3867 if (monitor_ctrl_mode(mon)) {
3868 if (ret && !monitor_has_error(mon)) {
3870 * If it returns failure, it must have passed on error.
3872 * Action: Report an internal error to the client if in QMP.
3874 qerror_report(QERR_UNDEFINED_ERROR);
3875 MON_DEBUG("command '%s' returned failure but did not pass an error\n",
3879 #ifdef CONFIG_DEBUG_MONITOR
3880 if (!ret && monitor_has_error(mon)) {
3882 * If it returns success, it must not have passed an error.
3884 * Action: Report the passed error to the client.
3886 MON_DEBUG("command '%s' returned success but passed an error\n",
3890 if (mon_print_count_get(mon) > 0 && strcmp(cmd->name, "info") != 0) {
3892 * Handlers should not call Monitor print functions.
3894 * Action: Ignore them in QMP.
3896 * (XXX: we don't check any 'info' or 'query' command here
3897 * because the user print function _is_ called by do_info(), hence
3898 * we will trigger this check. This problem will go away when we
3899 * make 'query' commands real and kill do_info())
3901 MON_DEBUG("command '%s' called print functions %d time(s)\n",
3902 cmd->name, mon_print_count_get(mon));
3906 assert(!monitor_has_error(mon));
3907 QDECREF(mon->error);
3912 static void monitor_call_handler(Monitor *mon, const mon_cmd_t *cmd,
3913 const QDict *params)
3916 QObject *data = NULL;
3918 mon_print_count_init(mon);
3920 ret = cmd->mhandler.cmd_new(mon, params, &data);
3921 handler_audit(mon, cmd, ret);
3923 if (is_async_return(data)) {
3925 * Asynchronous commands have no initial return data but they can
3926 * generate errors. Data is returned via the async completion handler.
3928 if (monitor_ctrl_mode(mon) && monitor_has_error(mon)) {
3929 monitor_protocol_emitter(mon, NULL);
3931 } else if (monitor_ctrl_mode(mon)) {
3932 /* Monitor Protocol */
3933 monitor_protocol_emitter(mon, data);
3937 cmd->user_print(mon, data);
3940 qobject_decref(data);
3943 static void handle_user_command(Monitor *mon, const char *cmdline)
3946 const mon_cmd_t *cmd;
3948 qdict = qdict_new();
3950 cmd = monitor_parse_command(mon, cmdline, qdict);
3954 if (monitor_handler_is_async(cmd)) {
3955 user_async_cmd_handler(mon, cmd, qdict);
3956 } else if (monitor_handler_ported(cmd)) {
3957 monitor_call_handler(mon, cmd, qdict);
3959 cmd->mhandler.cmd(mon, qdict);
3966 static void cmd_completion(const char *name, const char *list)
3968 const char *p, *pstart;
3977 p = pstart + strlen(pstart);
3979 if (len > sizeof(cmd) - 2)
3980 len = sizeof(cmd) - 2;
3981 memcpy(cmd, pstart, len);
3983 if (name[0] == '\0' || !strncmp(name, cmd, strlen(name))) {
3984 readline_add_completion(cur_mon->rs, cmd);
3992 static void file_completion(const char *input)
3997 char file[1024], file_prefix[1024];
4001 p = strrchr(input, '/');
4004 pstrcpy(file_prefix, sizeof(file_prefix), input);
4005 pstrcpy(path, sizeof(path), ".");
4007 input_path_len = p - input + 1;
4008 memcpy(path, input, input_path_len);
4009 if (input_path_len > sizeof(path) - 1)
4010 input_path_len = sizeof(path) - 1;
4011 path[input_path_len] = '\0';
4012 pstrcpy(file_prefix, sizeof(file_prefix), p + 1);
4014 #ifdef DEBUG_COMPLETION
4015 monitor_printf(cur_mon, "input='%s' path='%s' prefix='%s'\n",
4016 input, path, file_prefix);
4018 ffs = opendir(path);
4026 if (strstart(d->d_name, file_prefix, NULL)) {
4027 memcpy(file, input, input_path_len);
4028 if (input_path_len < sizeof(file))
4029 pstrcpy(file + input_path_len, sizeof(file) - input_path_len,
4031 /* stat the file to find out if it's a directory.
4032 * In that case add a slash to speed up typing long paths
4035 if(S_ISDIR(sb.st_mode))
4036 pstrcat(file, sizeof(file), "/");
4037 readline_add_completion(cur_mon->rs, file);
4043 static void block_completion_it(void *opaque, BlockDriverState *bs)
4045 const char *name = bdrv_get_device_name(bs);
4046 const char *input = opaque;
4048 if (input[0] == '\0' ||
4049 !strncmp(name, (char *)input, strlen(input))) {
4050 readline_add_completion(cur_mon->rs, name);
4054 /* NOTE: this parser is an approximate form of the real command parser */
4055 static void parse_cmdline(const char *cmdline,
4056 int *pnb_args, char **args)
4065 while (qemu_isspace(*p))
4069 if (nb_args >= MAX_ARGS)
4071 ret = get_str(buf, sizeof(buf), &p);
4072 args[nb_args] = qemu_strdup(buf);
4077 *pnb_args = nb_args;
4080 static const char *next_arg_type(const char *typestr)
4082 const char *p = strchr(typestr, ':');
4083 return (p != NULL ? ++p : typestr);
4086 static void monitor_find_completion(const char *cmdline)
4088 const char *cmdname;
4089 char *args[MAX_ARGS];
4090 int nb_args, i, len;
4091 const char *ptype, *str;
4092 const mon_cmd_t *cmd;
4095 parse_cmdline(cmdline, &nb_args, args);
4096 #ifdef DEBUG_COMPLETION
4097 for(i = 0; i < nb_args; i++) {
4098 monitor_printf(cur_mon, "arg%d = '%s'\n", i, (char *)args[i]);
4102 /* if the line ends with a space, it means we want to complete the
4104 len = strlen(cmdline);
4105 if (len > 0 && qemu_isspace(cmdline[len - 1])) {
4106 if (nb_args >= MAX_ARGS)
4108 args[nb_args++] = qemu_strdup("");
4111 /* command completion */
4116 readline_set_completion_index(cur_mon->rs, strlen(cmdname));
4117 for(cmd = mon_cmds; cmd->name != NULL; cmd++) {
4118 cmd_completion(cmdname, cmd->name);
4121 /* find the command */
4122 for(cmd = mon_cmds; cmd->name != NULL; cmd++) {
4123 if (compare_cmd(args[0], cmd->name))
4128 ptype = next_arg_type(cmd->args_type);
4129 for(i = 0; i < nb_args - 2; i++) {
4130 if (*ptype != '\0') {
4131 ptype = next_arg_type(ptype);
4132 while (*ptype == '?')
4133 ptype = next_arg_type(ptype);
4136 str = args[nb_args - 1];
4137 if (*ptype == '-' && ptype[1] != '\0') {
4142 /* file completion */
4143 readline_set_completion_index(cur_mon->rs, strlen(str));
4144 file_completion(str);
4147 /* block device name completion */
4148 readline_set_completion_index(cur_mon->rs, strlen(str));
4149 bdrv_iterate(block_completion_it, (void *)str);
4152 /* XXX: more generic ? */
4153 if (!strcmp(cmd->name, "info")) {
4154 readline_set_completion_index(cur_mon->rs, strlen(str));
4155 for(cmd = info_cmds; cmd->name != NULL; cmd++) {
4156 cmd_completion(str, cmd->name);
4158 } else if (!strcmp(cmd->name, "sendkey")) {
4159 char *sep = strrchr(str, '-');
4162 readline_set_completion_index(cur_mon->rs, strlen(str));
4163 for(key = key_defs; key->name != NULL; key++) {
4164 cmd_completion(str, key->name);
4166 } else if (!strcmp(cmd->name, "help|?")) {
4167 readline_set_completion_index(cur_mon->rs, strlen(str));
4168 for (cmd = mon_cmds; cmd->name != NULL; cmd++) {
4169 cmd_completion(str, cmd->name);
4177 for(i = 0; i < nb_args; i++)
4181 static int monitor_can_read(void *opaque)
4183 Monitor *mon = opaque;
4185 return (mon->suspend_cnt == 0) ? 1 : 0;
4188 typedef struct CmdArgs {
4195 static int check_opt(const CmdArgs *cmd_args, const char *name, QDict *args)
4197 if (!cmd_args->optional) {
4198 qerror_report(QERR_MISSING_PARAMETER, name);
4202 if (cmd_args->type == '-') {
4203 /* handlers expect a value, they need to be changed */
4204 qdict_put(args, name, qint_from_int(0));
4210 static int check_arg(const CmdArgs *cmd_args, QDict *args)
4215 name = qstring_get_str(cmd_args->name);
4218 return check_opt(cmd_args, name, args);
4221 value = qdict_get(args, name);
4223 return check_opt(cmd_args, name, args);
4226 switch (cmd_args->type) {
4230 if (qobject_type(value) != QTYPE_QSTRING) {
4231 qerror_report(QERR_INVALID_PARAMETER_TYPE, name, "string");
4237 const char *keys[] = { "count", "format", "size", NULL };
4239 for (i = 0; keys[i]; i++) {
4240 QObject *obj = qdict_get(args, keys[i]);
4242 qerror_report(QERR_MISSING_PARAMETER, name);
4245 if (qobject_type(obj) != QTYPE_QINT) {
4246 qerror_report(QERR_INVALID_PARAMETER_TYPE, name, "int");
4255 if (qobject_type(value) != QTYPE_QINT) {
4256 qerror_report(QERR_INVALID_PARAMETER_TYPE, name, "int");
4262 if (qobject_type(value) != QTYPE_QINT && qobject_type(value) != QTYPE_QFLOAT) {
4263 qerror_report(QERR_INVALID_PARAMETER_TYPE, name, "number");
4268 if (qobject_type(value) != QTYPE_QBOOL) {
4269 qerror_report(QERR_INVALID_PARAMETER_TYPE, name, "bool");
4274 if (qobject_type(value) != QTYPE_QINT &&
4275 qobject_type(value) != QTYPE_QBOOL) {
4276 qerror_report(QERR_INVALID_PARAMETER_TYPE, name, "bool");
4279 if (qobject_type(value) == QTYPE_QBOOL) {
4280 /* handlers expect a QInt, they need to be changed */
4281 qdict_put(args, name,
4282 qint_from_int(qbool_get_int(qobject_to_qbool(value))));
4294 static void cmd_args_init(CmdArgs *cmd_args)
4296 cmd_args->name = qstring_new();
4297 cmd_args->type = cmd_args->flag = cmd_args->optional = 0;
4300 static int check_opts(QemuOptsList *opts_list, QDict *args)
4302 assert(!opts_list->desc->name);
4307 * This is not trivial, we have to parse Monitor command's argument
4308 * type syntax to be able to check the arguments provided by clients.
4310 * In the near future we will be using an array for that and will be
4311 * able to drop all this parsing...
4313 static int monitor_check_qmp_args(const mon_cmd_t *cmd, QDict *args)
4318 QemuOptsList *opts_list;
4320 if (cmd->args_type == NULL) {
4321 return (qdict_size(args) == 0 ? 0 : -1);
4325 cmd_args_init(&cmd_args);
4328 for (p = cmd->args_type;; p++) {
4330 cmd_args.type = *++p;
4332 if (cmd_args.type == '-') {
4333 cmd_args.flag = *p++;
4334 cmd_args.optional = 1;
4335 } else if (cmd_args.type == 'O') {
4336 opts_list = qemu_find_opts(qstring_get_str(cmd_args.name));
4338 } else if (*p == '?') {
4339 cmd_args.optional = 1;
4343 assert(*p == ',' || *p == '\0');
4345 err = check_opts(opts_list, args);
4348 err = check_arg(&cmd_args, args);
4349 QDECREF(cmd_args.name);
4350 cmd_args_init(&cmd_args);
4357 qstring_append_chr(cmd_args.name, *p);
4365 QDECREF(cmd_args.name);
4369 static int invalid_qmp_mode(const Monitor *mon, const char *cmd_name)
4371 int is_cap = compare_cmd(cmd_name, "qmp_capabilities");
4372 return (qmp_cmd_mode(mon) ? is_cap : !is_cap);
4375 static void handle_qmp_command(JSONMessageParser *parser, QList *tokens)
4379 QDict *input, *args;
4380 const mon_cmd_t *cmd;
4381 Monitor *mon = cur_mon;
4382 const char *cmd_name, *info_item;
4386 obj = json_parser_parse(tokens, NULL);
4388 // FIXME: should be triggered in json_parser_parse()
4389 qerror_report(QERR_JSON_PARSING);
4391 } else if (qobject_type(obj) != QTYPE_QDICT) {
4392 qerror_report(QERR_QMP_BAD_INPUT_OBJECT, "object");
4393 qobject_decref(obj);
4397 input = qobject_to_qdict(obj);
4399 mon->mc->id = qdict_get(input, "id");
4400 qobject_incref(mon->mc->id);
4402 obj = qdict_get(input, "execute");
4404 qerror_report(QERR_QMP_BAD_INPUT_OBJECT, "execute");
4406 } else if (qobject_type(obj) != QTYPE_QSTRING) {
4407 qerror_report(QERR_QMP_BAD_INPUT_OBJECT_MEMBER, "execute", "string");
4411 cmd_name = qstring_get_str(qobject_to_qstring(obj));
4413 if (invalid_qmp_mode(mon, cmd_name)) {
4414 qerror_report(QERR_COMMAND_NOT_FOUND, cmd_name);
4419 * XXX: We need this special case until we get info handlers
4420 * converted into 'query-' commands
4422 if (compare_cmd(cmd_name, "info")) {
4423 qerror_report(QERR_COMMAND_NOT_FOUND, cmd_name);
4425 } else if (strstart(cmd_name, "query-", &info_item)) {
4426 cmd = monitor_find_command("info");
4427 qdict_put_obj(input, "arguments",
4428 qobject_from_jsonf("{ 'item': %s }", info_item));
4430 cmd = monitor_find_command(cmd_name);
4431 if (!cmd || !monitor_handler_ported(cmd)) {
4432 qerror_report(QERR_COMMAND_NOT_FOUND, cmd_name);
4437 obj = qdict_get(input, "arguments");
4440 } else if (qobject_type(obj) != QTYPE_QDICT) {
4441 qerror_report(QERR_QMP_BAD_INPUT_OBJECT_MEMBER, "arguments", "object");
4444 args = qobject_to_qdict(obj);
4450 err = monitor_check_qmp_args(cmd, args);
4455 if (monitor_handler_is_async(cmd)) {
4456 qmp_async_cmd_handler(mon, cmd, args);
4458 monitor_call_handler(mon, cmd, args);
4465 monitor_protocol_emitter(mon, NULL);
4471 * monitor_control_read(): Read and handle QMP input
4473 static void monitor_control_read(void *opaque, const uint8_t *buf, int size)
4475 Monitor *old_mon = cur_mon;
4479 json_message_parser_feed(&cur_mon->mc->parser, (const char *) buf, size);
4484 static void monitor_read(void *opaque, const uint8_t *buf, int size)
4486 Monitor *old_mon = cur_mon;
4492 for (i = 0; i < size; i++)
4493 readline_handle_byte(cur_mon->rs, buf[i]);
4495 if (size == 0 || buf[size - 1] != 0)
4496 monitor_printf(cur_mon, "corrupted command\n");
4498 handle_user_command(cur_mon, (char *)buf);
4504 static void monitor_command_cb(Monitor *mon, const char *cmdline, void *opaque)
4506 monitor_suspend(mon);
4507 handle_user_command(mon, cmdline);
4508 monitor_resume(mon);
4511 int monitor_suspend(Monitor *mon)
4519 void monitor_resume(Monitor *mon)
4523 if (--mon->suspend_cnt == 0)
4524 readline_show_prompt(mon->rs);
4527 static QObject *get_qmp_greeting(void)
4531 do_info_version(NULL, &ver);
4532 return qobject_from_jsonf("{'QMP':{'version': %p,'capabilities': []}}",ver);
4536 * monitor_control_event(): Print QMP gretting
4538 static void monitor_control_event(void *opaque, int event)
4541 Monitor *mon = opaque;
4544 case CHR_EVENT_OPENED:
4545 mon->mc->command_mode = 0;
4546 json_message_parser_init(&mon->mc->parser, handle_qmp_command);
4547 data = get_qmp_greeting();
4548 monitor_json_emitter(mon, data);
4549 qobject_decref(data);
4551 case CHR_EVENT_CLOSED:
4552 json_message_parser_destroy(&mon->mc->parser);
4557 static void monitor_event(void *opaque, int event)
4559 Monitor *mon = opaque;
4562 case CHR_EVENT_MUX_IN:
4564 if (mon->reset_seen) {
4565 readline_restart(mon->rs);
4566 monitor_resume(mon);
4569 mon->suspend_cnt = 0;
4573 case CHR_EVENT_MUX_OUT:
4574 if (mon->reset_seen) {
4575 if (mon->suspend_cnt == 0) {
4576 monitor_printf(mon, "\n");
4579 monitor_suspend(mon);
4586 case CHR_EVENT_OPENED:
4587 monitor_printf(mon, "QEMU %s monitor - type 'help' for more "
4588 "information\n", QEMU_VERSION);
4589 if (!mon->mux_out) {
4590 readline_show_prompt(mon->rs);
4592 mon->reset_seen = 1;
4606 void monitor_init(CharDriverState *chr, int flags)
4608 static int is_first_init = 1;
4611 if (is_first_init) {
4612 key_timer = qemu_new_timer(vm_clock, release_keys, NULL);
4616 mon = qemu_mallocz(sizeof(*mon));
4620 if (flags & MONITOR_USE_READLINE) {
4621 mon->rs = readline_init(mon, monitor_find_completion);
4622 monitor_read_command(mon, 0);
4625 if (monitor_ctrl_mode(mon)) {
4626 mon->mc = qemu_mallocz(sizeof(MonitorControl));
4627 /* Control mode requires special handlers */
4628 qemu_chr_add_handlers(chr, monitor_can_read, monitor_control_read,
4629 monitor_control_event, mon);
4631 qemu_chr_add_handlers(chr, monitor_can_read, monitor_read,
4632 monitor_event, mon);
4635 QLIST_INSERT_HEAD(&mon_list, mon, entry);
4636 if (!default_mon || (flags & MONITOR_IS_DEFAULT))
4640 static void bdrv_password_cb(Monitor *mon, const char *password, void *opaque)
4642 BlockDriverState *bs = opaque;
4645 if (bdrv_set_key(bs, password) != 0) {
4646 monitor_printf(mon, "invalid password\n");
4649 if (mon->password_completion_cb)
4650 mon->password_completion_cb(mon->password_opaque, ret);
4652 monitor_read_command(mon, 1);
4655 int monitor_read_bdrv_key_start(Monitor *mon, BlockDriverState *bs,
4656 BlockDriverCompletionFunc *completion_cb,
4661 if (!bdrv_key_required(bs)) {
4663 completion_cb(opaque, 0);
4667 if (monitor_ctrl_mode(mon)) {
4668 qerror_report(QERR_DEVICE_ENCRYPTED, bdrv_get_device_name(bs));
4672 monitor_printf(mon, "%s (%s) is encrypted.\n", bdrv_get_device_name(bs),
4673 bdrv_get_encrypted_filename(bs));
4675 mon->password_completion_cb = completion_cb;
4676 mon->password_opaque = opaque;
4678 err = monitor_read_password(mon, bdrv_password_cb, bs);
4680 if (err && completion_cb)
4681 completion_cb(opaque, err);