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);
1024 qemu_system_exit_request();
1028 static int eject_device(Monitor *mon, BlockDriverState *bs, int force)
1030 if (bdrv_is_inserted(bs)) {
1032 if (!bdrv_is_removable(bs)) {
1033 qerror_report(QERR_DEVICE_NOT_REMOVABLE,
1034 bdrv_get_device_name(bs));
1037 if (bdrv_is_locked(bs)) {
1038 qerror_report(QERR_DEVICE_LOCKED, bdrv_get_device_name(bs));
1047 static int do_eject(Monitor *mon, const QDict *qdict, QObject **ret_data)
1049 BlockDriverState *bs;
1050 int force = qdict_get_int(qdict, "force");
1051 const char *filename = qdict_get_str(qdict, "device");
1053 bs = bdrv_find(filename);
1055 qerror_report(QERR_DEVICE_NOT_FOUND, filename);
1058 return eject_device(mon, bs, force);
1061 static int do_block_set_passwd(Monitor *mon, const QDict *qdict,
1064 BlockDriverState *bs;
1067 bs = bdrv_find(qdict_get_str(qdict, "device"));
1069 qerror_report(QERR_DEVICE_NOT_FOUND, qdict_get_str(qdict, "device"));
1073 err = bdrv_set_key(bs, qdict_get_str(qdict, "password"));
1074 if (err == -EINVAL) {
1075 qerror_report(QERR_DEVICE_NOT_ENCRYPTED, bdrv_get_device_name(bs));
1077 } else if (err < 0) {
1078 qerror_report(QERR_INVALID_PASSWORD);
1085 static int do_change_block(Monitor *mon, const char *device,
1086 const char *filename, const char *fmt)
1088 BlockDriverState *bs;
1089 BlockDriver *drv = NULL;
1092 bs = bdrv_find(device);
1094 qerror_report(QERR_DEVICE_NOT_FOUND, device);
1098 drv = bdrv_find_whitelisted_format(fmt);
1100 qerror_report(QERR_INVALID_BLOCK_FORMAT, fmt);
1104 if (eject_device(mon, bs, 0) < 0) {
1107 bdrv_flags = bdrv_get_type_hint(bs) == BDRV_TYPE_CDROM ? 0 : BDRV_O_RDWR;
1108 if (bdrv_open(bs, filename, bdrv_flags, drv) < 0) {
1109 qerror_report(QERR_OPEN_FILE_FAILED, filename);
1112 return monitor_read_bdrv_key_start(mon, bs, NULL, NULL);
1115 static int change_vnc_password(const char *password)
1117 if (vnc_display_password(NULL, password) < 0) {
1118 qerror_report(QERR_SET_PASSWD_FAILED);
1125 static void change_vnc_password_cb(Monitor *mon, const char *password,
1128 change_vnc_password(password);
1129 monitor_read_command(mon, 1);
1132 static int do_change_vnc(Monitor *mon, const char *target, const char *arg)
1134 if (strcmp(target, "passwd") == 0 ||
1135 strcmp(target, "password") == 0) {
1138 strncpy(password, arg, sizeof(password));
1139 password[sizeof(password) - 1] = '\0';
1140 return change_vnc_password(password);
1142 return monitor_read_password(mon, change_vnc_password_cb, NULL);
1145 if (vnc_display_open(NULL, target) < 0) {
1146 qerror_report(QERR_VNC_SERVER_FAILED, target);
1155 * do_change(): Change a removable medium, or VNC configuration
1157 static int do_change(Monitor *mon, const QDict *qdict, QObject **ret_data)
1159 const char *device = qdict_get_str(qdict, "device");
1160 const char *target = qdict_get_str(qdict, "target");
1161 const char *arg = qdict_get_try_str(qdict, "arg");
1164 if (strcmp(device, "vnc") == 0) {
1165 ret = do_change_vnc(mon, target, arg);
1167 ret = do_change_block(mon, device, target, arg);
1173 static int do_screen_dump(Monitor *mon, const QDict *qdict, QObject **ret_data)
1175 vga_hw_screen_dump(qdict_get_str(qdict, "filename"));
1179 static void do_logfile(Monitor *mon, const QDict *qdict)
1181 cpu_set_log_filename(qdict_get_str(qdict, "filename"));
1184 static void do_log(Monitor *mon, const QDict *qdict)
1187 const char *items = qdict_get_str(qdict, "items");
1189 if (!strcmp(items, "none")) {
1192 mask = cpu_str_to_log_mask(items);
1194 help_cmd(mon, "log");
1201 static void do_singlestep(Monitor *mon, const QDict *qdict)
1203 const char *option = qdict_get_try_str(qdict, "option");
1204 if (!option || !strcmp(option, "on")) {
1206 } else if (!strcmp(option, "off")) {
1209 monitor_printf(mon, "unexpected option %s\n", option);
1214 * do_stop(): Stop VM execution
1216 static int do_stop(Monitor *mon, const QDict *qdict, QObject **ret_data)
1218 vm_stop(EXCP_INTERRUPT);
1222 static void encrypted_bdrv_it(void *opaque, BlockDriverState *bs);
1224 struct bdrv_iterate_context {
1230 * do_cont(): Resume emulation.
1232 static int do_cont(Monitor *mon, const QDict *qdict, QObject **ret_data)
1234 struct bdrv_iterate_context context = { mon, 0 };
1236 bdrv_iterate(encrypted_bdrv_it, &context);
1237 /* only resume the vm if all keys are set and valid */
1246 static void bdrv_key_cb(void *opaque, int err)
1248 Monitor *mon = opaque;
1250 /* another key was set successfully, retry to continue */
1252 do_cont(mon, NULL, NULL);
1255 static void encrypted_bdrv_it(void *opaque, BlockDriverState *bs)
1257 struct bdrv_iterate_context *context = opaque;
1259 if (!context->err && bdrv_key_required(bs)) {
1260 context->err = -EBUSY;
1261 monitor_read_bdrv_key_start(context->mon, bs, bdrv_key_cb,
1266 static void do_gdbserver(Monitor *mon, const QDict *qdict)
1268 const char *device = qdict_get_try_str(qdict, "device");
1270 device = "tcp::" DEFAULT_GDBSTUB_PORT;
1271 if (gdbserver_start(device) < 0) {
1272 monitor_printf(mon, "Could not open gdbserver on device '%s'\n",
1274 } else if (strcmp(device, "none") == 0) {
1275 monitor_printf(mon, "Disabled gdbserver\n");
1277 monitor_printf(mon, "Waiting for gdb connection on device '%s'\n",
1282 static void do_watchdog_action(Monitor *mon, const QDict *qdict)
1284 const char *action = qdict_get_str(qdict, "action");
1285 if (select_watchdog_action(action) == -1) {
1286 monitor_printf(mon, "Unknown watchdog action '%s'\n", action);
1290 static void monitor_printc(Monitor *mon, int c)
1292 monitor_printf(mon, "'");
1295 monitor_printf(mon, "\\'");
1298 monitor_printf(mon, "\\\\");
1301 monitor_printf(mon, "\\n");
1304 monitor_printf(mon, "\\r");
1307 if (c >= 32 && c <= 126) {
1308 monitor_printf(mon, "%c", c);
1310 monitor_printf(mon, "\\x%02x", c);
1314 monitor_printf(mon, "'");
1317 static void memory_dump(Monitor *mon, int count, int format, int wsize,
1318 target_phys_addr_t addr, int is_physical)
1321 int l, line_size, i, max_digits, len;
1325 if (format == 'i') {
1328 env = mon_get_cpu();
1332 } else if (wsize == 4) {
1335 /* as default we use the current CS size */
1338 #ifdef TARGET_X86_64
1339 if ((env->efer & MSR_EFER_LMA) &&
1340 (env->segs[R_CS].flags & DESC_L_MASK))
1344 if (!(env->segs[R_CS].flags & DESC_B_MASK))
1349 monitor_disas(mon, env, addr, count, is_physical, flags);
1353 len = wsize * count;
1362 max_digits = (wsize * 8 + 2) / 3;
1366 max_digits = (wsize * 8) / 4;
1370 max_digits = (wsize * 8 * 10 + 32) / 33;
1379 monitor_printf(mon, TARGET_FMT_plx ":", addr);
1381 monitor_printf(mon, TARGET_FMT_lx ":", (target_ulong)addr);
1386 cpu_physical_memory_rw(addr, buf, l, 0);
1388 env = mon_get_cpu();
1389 if (cpu_memory_rw_debug(env, addr, buf, l, 0) < 0) {
1390 monitor_printf(mon, " Cannot access memory\n");
1399 v = ldub_raw(buf + i);
1402 v = lduw_raw(buf + i);
1405 v = (uint32_t)ldl_raw(buf + i);
1408 v = ldq_raw(buf + i);
1411 monitor_printf(mon, " ");
1414 monitor_printf(mon, "%#*" PRIo64, max_digits, v);
1417 monitor_printf(mon, "0x%0*" PRIx64, max_digits, v);
1420 monitor_printf(mon, "%*" PRIu64, max_digits, v);
1423 monitor_printf(mon, "%*" PRId64, max_digits, v);
1426 monitor_printc(mon, v);
1431 monitor_printf(mon, "\n");
1437 static void do_memory_dump(Monitor *mon, const QDict *qdict)
1439 int count = qdict_get_int(qdict, "count");
1440 int format = qdict_get_int(qdict, "format");
1441 int size = qdict_get_int(qdict, "size");
1442 target_long addr = qdict_get_int(qdict, "addr");
1444 memory_dump(mon, count, format, size, addr, 0);
1447 static void do_physical_memory_dump(Monitor *mon, const QDict *qdict)
1449 int count = qdict_get_int(qdict, "count");
1450 int format = qdict_get_int(qdict, "format");
1451 int size = qdict_get_int(qdict, "size");
1452 target_phys_addr_t addr = qdict_get_int(qdict, "addr");
1454 memory_dump(mon, count, format, size, addr, 1);
1457 static void do_print(Monitor *mon, const QDict *qdict)
1459 int format = qdict_get_int(qdict, "format");
1460 target_phys_addr_t val = qdict_get_int(qdict, "val");
1462 #if TARGET_PHYS_ADDR_BITS == 32
1465 monitor_printf(mon, "%#o", val);
1468 monitor_printf(mon, "%#x", val);
1471 monitor_printf(mon, "%u", val);
1475 monitor_printf(mon, "%d", val);
1478 monitor_printc(mon, val);
1484 monitor_printf(mon, "%#" PRIo64, val);
1487 monitor_printf(mon, "%#" PRIx64, val);
1490 monitor_printf(mon, "%" PRIu64, val);
1494 monitor_printf(mon, "%" PRId64, val);
1497 monitor_printc(mon, val);
1501 monitor_printf(mon, "\n");
1504 static int do_memory_save(Monitor *mon, const QDict *qdict, QObject **ret_data)
1507 uint32_t size = qdict_get_int(qdict, "size");
1508 const char *filename = qdict_get_str(qdict, "filename");
1509 target_long addr = qdict_get_int(qdict, "val");
1515 env = mon_get_cpu();
1517 f = fopen(filename, "wb");
1519 qerror_report(QERR_OPEN_FILE_FAILED, filename);
1526 cpu_memory_rw_debug(env, addr, buf, l, 0);
1527 if (fwrite(buf, 1, l, f) != l) {
1528 monitor_printf(mon, "fwrite() error in do_memory_save\n");
1542 static int do_physical_memory_save(Monitor *mon, const QDict *qdict,
1548 uint32_t size = qdict_get_int(qdict, "size");
1549 const char *filename = qdict_get_str(qdict, "filename");
1550 target_phys_addr_t addr = qdict_get_int(qdict, "val");
1553 f = fopen(filename, "wb");
1555 qerror_report(QERR_OPEN_FILE_FAILED, filename);
1562 cpu_physical_memory_rw(addr, buf, l, 0);
1563 if (fwrite(buf, 1, l, f) != l) {
1564 monitor_printf(mon, "fwrite() error in do_physical_memory_save\n");
1579 static void do_sum(Monitor *mon, const QDict *qdict)
1584 uint32_t start = qdict_get_int(qdict, "start");
1585 uint32_t size = qdict_get_int(qdict, "size");
1588 for(addr = start; addr < (start + size); addr++) {
1589 cpu_physical_memory_rw(addr, buf, 1, 0);
1590 /* BSD sum algorithm ('sum' Unix command) */
1591 sum = (sum >> 1) | (sum << 15);
1594 monitor_printf(mon, "%05d\n", sum);
1602 static const KeyDef key_defs[] = {
1604 { 0x36, "shift_r" },
1609 { 0xe4, "altgr_r" },
1629 { 0x0e, "backspace" },
1666 { 0x37, "asterisk" },
1669 { 0x3a, "caps_lock" },
1680 { 0x45, "num_lock" },
1681 { 0x46, "scroll_lock" },
1683 { 0xb5, "kp_divide" },
1684 { 0x37, "kp_multiply" },
1685 { 0x4a, "kp_subtract" },
1687 { 0x9c, "kp_enter" },
1688 { 0x53, "kp_decimal" },
1721 #if defined(TARGET_SPARC) && !defined(TARGET_SPARC64)
1736 { 0xfe, "compose" },
1741 static int get_keycode(const char *key)
1747 for(p = key_defs; p->name != NULL; p++) {
1748 if (!strcmp(key, p->name))
1751 if (strstart(key, "0x", NULL)) {
1752 ret = strtoul(key, &endp, 0);
1753 if (*endp == '\0' && ret >= 0x01 && ret <= 0xff)
1759 #define MAX_KEYCODES 16
1760 static uint8_t keycodes[MAX_KEYCODES];
1761 static int nb_pending_keycodes;
1762 static QEMUTimer *key_timer;
1764 static void release_keys(void *opaque)
1768 while (nb_pending_keycodes > 0) {
1769 nb_pending_keycodes--;
1770 keycode = keycodes[nb_pending_keycodes];
1772 kbd_put_keycode(0xe0);
1773 kbd_put_keycode(keycode | 0x80);
1777 static void do_sendkey(Monitor *mon, const QDict *qdict)
1779 char keyname_buf[16];
1781 int keyname_len, keycode, i;
1782 const char *string = qdict_get_str(qdict, "string");
1783 int has_hold_time = qdict_haskey(qdict, "hold_time");
1784 int hold_time = qdict_get_try_int(qdict, "hold_time", -1);
1786 if (nb_pending_keycodes > 0) {
1787 qemu_del_timer(key_timer);
1794 separator = strchr(string, '-');
1795 keyname_len = separator ? separator - string : strlen(string);
1796 if (keyname_len > 0) {
1797 pstrcpy(keyname_buf, sizeof(keyname_buf), string);
1798 if (keyname_len > sizeof(keyname_buf) - 1) {
1799 monitor_printf(mon, "invalid key: '%s...'\n", keyname_buf);
1802 if (i == MAX_KEYCODES) {
1803 monitor_printf(mon, "too many keys\n");
1806 keyname_buf[keyname_len] = 0;
1807 keycode = get_keycode(keyname_buf);
1809 monitor_printf(mon, "unknown key: '%s'\n", keyname_buf);
1812 keycodes[i++] = keycode;
1816 string = separator + 1;
1818 nb_pending_keycodes = i;
1819 /* key down events */
1820 for (i = 0; i < nb_pending_keycodes; i++) {
1821 keycode = keycodes[i];
1823 kbd_put_keycode(0xe0);
1824 kbd_put_keycode(keycode & 0x7f);
1826 /* delayed key up events */
1827 qemu_mod_timer(key_timer, qemu_get_clock(vm_clock) +
1828 muldiv64(get_ticks_per_sec(), hold_time, 1000));
1831 static int mouse_button_state;
1833 static void do_mouse_move(Monitor *mon, const QDict *qdict)
1836 const char *dx_str = qdict_get_str(qdict, "dx_str");
1837 const char *dy_str = qdict_get_str(qdict, "dy_str");
1838 const char *dz_str = qdict_get_try_str(qdict, "dz_str");
1839 dx = strtol(dx_str, NULL, 0);
1840 dy = strtol(dy_str, NULL, 0);
1843 dz = strtol(dz_str, NULL, 0);
1844 kbd_mouse_event(dx, dy, dz, mouse_button_state);
1847 static void do_mouse_button(Monitor *mon, const QDict *qdict)
1849 int button_state = qdict_get_int(qdict, "button_state");
1850 mouse_button_state = button_state;
1851 kbd_mouse_event(0, 0, 0, mouse_button_state);
1854 static void do_ioport_read(Monitor *mon, const QDict *qdict)
1856 int size = qdict_get_int(qdict, "size");
1857 int addr = qdict_get_int(qdict, "addr");
1858 int has_index = qdict_haskey(qdict, "index");
1863 int index = qdict_get_int(qdict, "index");
1864 cpu_outb(addr & IOPORTS_MASK, index & 0xff);
1872 val = cpu_inb(addr);
1876 val = cpu_inw(addr);
1880 val = cpu_inl(addr);
1884 monitor_printf(mon, "port%c[0x%04x] = %#0*x\n",
1885 suffix, addr, size * 2, val);
1888 static void do_ioport_write(Monitor *mon, const QDict *qdict)
1890 int size = qdict_get_int(qdict, "size");
1891 int addr = qdict_get_int(qdict, "addr");
1892 int val = qdict_get_int(qdict, "val");
1894 addr &= IOPORTS_MASK;
1899 cpu_outb(addr, val);
1902 cpu_outw(addr, val);
1905 cpu_outl(addr, val);
1910 static void do_boot_set(Monitor *mon, const QDict *qdict)
1913 const char *bootdevice = qdict_get_str(qdict, "bootdevice");
1915 res = qemu_boot_set(bootdevice);
1917 monitor_printf(mon, "boot device list now set to %s\n", bootdevice);
1918 } else if (res > 0) {
1919 monitor_printf(mon, "setting boot device list failed\n");
1921 monitor_printf(mon, "no function defined to set boot device list for "
1922 "this architecture\n");
1927 * do_system_reset(): Issue a machine reset
1929 static int do_system_reset(Monitor *mon, const QDict *qdict,
1932 qemu_system_reset_request();
1937 * do_system_powerdown(): Issue a machine powerdown
1939 static int do_system_powerdown(Monitor *mon, const QDict *qdict,
1942 qemu_system_powerdown_request();
1946 #if defined(TARGET_I386)
1947 static void print_pte(Monitor *mon, uint32_t addr, uint32_t pte, uint32_t mask)
1949 monitor_printf(mon, "%08x: %08x %c%c%c%c%c%c%c%c\n",
1952 pte & PG_GLOBAL_MASK ? 'G' : '-',
1953 pte & PG_PSE_MASK ? 'P' : '-',
1954 pte & PG_DIRTY_MASK ? 'D' : '-',
1955 pte & PG_ACCESSED_MASK ? 'A' : '-',
1956 pte & PG_PCD_MASK ? 'C' : '-',
1957 pte & PG_PWT_MASK ? 'T' : '-',
1958 pte & PG_USER_MASK ? 'U' : '-',
1959 pte & PG_RW_MASK ? 'W' : '-');
1962 static void tlb_info(Monitor *mon)
1966 uint32_t pgd, pde, pte;
1968 env = mon_get_cpu();
1970 if (!(env->cr[0] & CR0_PG_MASK)) {
1971 monitor_printf(mon, "PG disabled\n");
1974 pgd = env->cr[3] & ~0xfff;
1975 for(l1 = 0; l1 < 1024; l1++) {
1976 cpu_physical_memory_read(pgd + l1 * 4, (uint8_t *)&pde, 4);
1977 pde = le32_to_cpu(pde);
1978 if (pde & PG_PRESENT_MASK) {
1979 if ((pde & PG_PSE_MASK) && (env->cr[4] & CR4_PSE_MASK)) {
1980 print_pte(mon, (l1 << 22), pde, ~((1 << 20) - 1));
1982 for(l2 = 0; l2 < 1024; l2++) {
1983 cpu_physical_memory_read((pde & ~0xfff) + l2 * 4,
1984 (uint8_t *)&pte, 4);
1985 pte = le32_to_cpu(pte);
1986 if (pte & PG_PRESENT_MASK) {
1987 print_pte(mon, (l1 << 22) + (l2 << 12),
1997 static void mem_print(Monitor *mon, uint32_t *pstart, int *plast_prot,
1998 uint32_t end, int prot)
2001 prot1 = *plast_prot;
2002 if (prot != prot1) {
2003 if (*pstart != -1) {
2004 monitor_printf(mon, "%08x-%08x %08x %c%c%c\n",
2005 *pstart, end, end - *pstart,
2006 prot1 & PG_USER_MASK ? 'u' : '-',
2008 prot1 & PG_RW_MASK ? 'w' : '-');
2018 static void mem_info(Monitor *mon)
2021 int l1, l2, prot, last_prot;
2022 uint32_t pgd, pde, pte, start, end;
2024 env = mon_get_cpu();
2026 if (!(env->cr[0] & CR0_PG_MASK)) {
2027 monitor_printf(mon, "PG disabled\n");
2030 pgd = env->cr[3] & ~0xfff;
2033 for(l1 = 0; l1 < 1024; l1++) {
2034 cpu_physical_memory_read(pgd + l1 * 4, (uint8_t *)&pde, 4);
2035 pde = le32_to_cpu(pde);
2037 if (pde & PG_PRESENT_MASK) {
2038 if ((pde & PG_PSE_MASK) && (env->cr[4] & CR4_PSE_MASK)) {
2039 prot = pde & (PG_USER_MASK | PG_RW_MASK | PG_PRESENT_MASK);
2040 mem_print(mon, &start, &last_prot, end, prot);
2042 for(l2 = 0; l2 < 1024; l2++) {
2043 cpu_physical_memory_read((pde & ~0xfff) + l2 * 4,
2044 (uint8_t *)&pte, 4);
2045 pte = le32_to_cpu(pte);
2046 end = (l1 << 22) + (l2 << 12);
2047 if (pte & PG_PRESENT_MASK) {
2048 prot = pte & (PG_USER_MASK | PG_RW_MASK | PG_PRESENT_MASK);
2052 mem_print(mon, &start, &last_prot, end, prot);
2057 mem_print(mon, &start, &last_prot, end, prot);
2063 #if defined(TARGET_SH4)
2065 static void print_tlb(Monitor *mon, int idx, tlb_t *tlb)
2067 monitor_printf(mon, " tlb%i:\t"
2068 "asid=%hhu vpn=%x\tppn=%x\tsz=%hhu size=%u\t"
2069 "v=%hhu shared=%hhu cached=%hhu prot=%hhu "
2070 "dirty=%hhu writethrough=%hhu\n",
2072 tlb->asid, tlb->vpn, tlb->ppn, tlb->sz, tlb->size,
2073 tlb->v, tlb->sh, tlb->c, tlb->pr,
2077 static void tlb_info(Monitor *mon)
2079 CPUState *env = mon_get_cpu();
2082 monitor_printf (mon, "ITLB:\n");
2083 for (i = 0 ; i < ITLB_SIZE ; i++)
2084 print_tlb (mon, i, &env->itlb[i]);
2085 monitor_printf (mon, "UTLB:\n");
2086 for (i = 0 ; i < UTLB_SIZE ; i++)
2087 print_tlb (mon, i, &env->utlb[i]);
2092 static void do_info_kvm_print(Monitor *mon, const QObject *data)
2096 qdict = qobject_to_qdict(data);
2098 monitor_printf(mon, "kvm support: ");
2099 if (qdict_get_bool(qdict, "present")) {
2100 monitor_printf(mon, "%s\n", qdict_get_bool(qdict, "enabled") ?
2101 "enabled" : "disabled");
2103 monitor_printf(mon, "not compiled\n");
2108 * do_info_kvm(): Show KVM information
2110 * Return a QDict with the following information:
2112 * - "enabled": true if KVM support is enabled, false otherwise
2113 * - "present": true if QEMU has KVM support, false otherwise
2117 * { "enabled": true, "present": true }
2119 static void do_info_kvm(Monitor *mon, QObject **ret_data)
2122 *ret_data = qobject_from_jsonf("{ 'enabled': %i, 'present': true }",
2125 *ret_data = qobject_from_jsonf("{ 'enabled': false, 'present': false }");
2129 static void do_info_numa(Monitor *mon)
2134 monitor_printf(mon, "%d nodes\n", nb_numa_nodes);
2135 for (i = 0; i < nb_numa_nodes; i++) {
2136 monitor_printf(mon, "node %d cpus:", i);
2137 for (env = first_cpu; env != NULL; env = env->next_cpu) {
2138 if (env->numa_node == i) {
2139 monitor_printf(mon, " %d", env->cpu_index);
2142 monitor_printf(mon, "\n");
2143 monitor_printf(mon, "node %d size: %" PRId64 " MB\n", i,
2148 #ifdef CONFIG_PROFILER
2153 static void do_info_profile(Monitor *mon)
2159 monitor_printf(mon, "async time %" PRId64 " (%0.3f)\n",
2160 dev_time, dev_time / (double)get_ticks_per_sec());
2161 monitor_printf(mon, "qemu time %" PRId64 " (%0.3f)\n",
2162 qemu_time, qemu_time / (double)get_ticks_per_sec());
2167 static void do_info_profile(Monitor *mon)
2169 monitor_printf(mon, "Internal profiler not compiled\n");
2173 /* Capture support */
2174 static QLIST_HEAD (capture_list_head, CaptureState) capture_head;
2176 static void do_info_capture(Monitor *mon)
2181 for (s = capture_head.lh_first, i = 0; s; s = s->entries.le_next, ++i) {
2182 monitor_printf(mon, "[%d]: ", i);
2183 s->ops.info (s->opaque);
2188 static void do_stop_capture(Monitor *mon, const QDict *qdict)
2191 int n = qdict_get_int(qdict, "n");
2194 for (s = capture_head.lh_first, i = 0; s; s = s->entries.le_next, ++i) {
2196 s->ops.destroy (s->opaque);
2197 QLIST_REMOVE (s, entries);
2204 static void do_wav_capture(Monitor *mon, const QDict *qdict)
2206 const char *path = qdict_get_str(qdict, "path");
2207 int has_freq = qdict_haskey(qdict, "freq");
2208 int freq = qdict_get_try_int(qdict, "freq", -1);
2209 int has_bits = qdict_haskey(qdict, "bits");
2210 int bits = qdict_get_try_int(qdict, "bits", -1);
2211 int has_channels = qdict_haskey(qdict, "nchannels");
2212 int nchannels = qdict_get_try_int(qdict, "nchannels", -1);
2215 s = qemu_mallocz (sizeof (*s));
2217 freq = has_freq ? freq : 44100;
2218 bits = has_bits ? bits : 16;
2219 nchannels = has_channels ? nchannels : 2;
2221 if (wav_start_capture (s, path, freq, bits, nchannels)) {
2222 monitor_printf(mon, "Faied to add wave capture\n");
2225 QLIST_INSERT_HEAD (&capture_head, s, entries);
2229 #if defined(TARGET_I386)
2230 static void do_inject_nmi(Monitor *mon, const QDict *qdict)
2233 int cpu_index = qdict_get_int(qdict, "cpu_index");
2235 for (env = first_cpu; env != NULL; env = env->next_cpu)
2236 if (env->cpu_index == cpu_index) {
2237 cpu_interrupt(env, CPU_INTERRUPT_NMI);
2243 static void do_info_status_print(Monitor *mon, const QObject *data)
2247 qdict = qobject_to_qdict(data);
2249 monitor_printf(mon, "VM status: ");
2250 if (qdict_get_bool(qdict, "running")) {
2251 monitor_printf(mon, "running");
2252 if (qdict_get_bool(qdict, "singlestep")) {
2253 monitor_printf(mon, " (single step mode)");
2256 monitor_printf(mon, "paused");
2259 monitor_printf(mon, "\n");
2263 * do_info_status(): VM status
2265 * Return a QDict with the following information:
2267 * - "running": true if the VM is running, or false if it is paused
2268 * - "singlestep": true if the VM is in single step mode, false otherwise
2272 * { "running": true, "singlestep": false }
2274 static void do_info_status(Monitor *mon, QObject **ret_data)
2276 *ret_data = qobject_from_jsonf("{ 'running': %i, 'singlestep': %i }",
2277 vm_running, singlestep);
2280 static qemu_acl *find_acl(Monitor *mon, const char *name)
2282 qemu_acl *acl = qemu_acl_find(name);
2285 monitor_printf(mon, "acl: unknown list '%s'\n", name);
2290 static void do_acl_show(Monitor *mon, const QDict *qdict)
2292 const char *aclname = qdict_get_str(qdict, "aclname");
2293 qemu_acl *acl = find_acl(mon, aclname);
2294 qemu_acl_entry *entry;
2298 monitor_printf(mon, "policy: %s\n",
2299 acl->defaultDeny ? "deny" : "allow");
2300 QTAILQ_FOREACH(entry, &acl->entries, next) {
2302 monitor_printf(mon, "%d: %s %s\n", i,
2303 entry->deny ? "deny" : "allow", entry->match);
2308 static void do_acl_reset(Monitor *mon, const QDict *qdict)
2310 const char *aclname = qdict_get_str(qdict, "aclname");
2311 qemu_acl *acl = find_acl(mon, aclname);
2314 qemu_acl_reset(acl);
2315 monitor_printf(mon, "acl: removed all rules\n");
2319 static void do_acl_policy(Monitor *mon, const QDict *qdict)
2321 const char *aclname = qdict_get_str(qdict, "aclname");
2322 const char *policy = qdict_get_str(qdict, "policy");
2323 qemu_acl *acl = find_acl(mon, aclname);
2326 if (strcmp(policy, "allow") == 0) {
2327 acl->defaultDeny = 0;
2328 monitor_printf(mon, "acl: policy set to 'allow'\n");
2329 } else if (strcmp(policy, "deny") == 0) {
2330 acl->defaultDeny = 1;
2331 monitor_printf(mon, "acl: policy set to 'deny'\n");
2333 monitor_printf(mon, "acl: unknown policy '%s', "
2334 "expected 'deny' or 'allow'\n", policy);
2339 static void do_acl_add(Monitor *mon, const QDict *qdict)
2341 const char *aclname = qdict_get_str(qdict, "aclname");
2342 const char *match = qdict_get_str(qdict, "match");
2343 const char *policy = qdict_get_str(qdict, "policy");
2344 int has_index = qdict_haskey(qdict, "index");
2345 int index = qdict_get_try_int(qdict, "index", -1);
2346 qemu_acl *acl = find_acl(mon, aclname);
2350 if (strcmp(policy, "allow") == 0) {
2352 } else if (strcmp(policy, "deny") == 0) {
2355 monitor_printf(mon, "acl: unknown policy '%s', "
2356 "expected 'deny' or 'allow'\n", policy);
2360 ret = qemu_acl_insert(acl, deny, match, index);
2362 ret = qemu_acl_append(acl, deny, match);
2364 monitor_printf(mon, "acl: unable to add acl entry\n");
2366 monitor_printf(mon, "acl: added rule at position %d\n", ret);
2370 static void do_acl_remove(Monitor *mon, const QDict *qdict)
2372 const char *aclname = qdict_get_str(qdict, "aclname");
2373 const char *match = qdict_get_str(qdict, "match");
2374 qemu_acl *acl = find_acl(mon, aclname);
2378 ret = qemu_acl_remove(acl, match);
2380 monitor_printf(mon, "acl: no matching acl entry\n");
2382 monitor_printf(mon, "acl: removed rule at position %d\n", ret);
2386 #if defined(TARGET_I386)
2387 static void do_inject_mce(Monitor *mon, const QDict *qdict)
2390 int cpu_index = qdict_get_int(qdict, "cpu_index");
2391 int bank = qdict_get_int(qdict, "bank");
2392 uint64_t status = qdict_get_int(qdict, "status");
2393 uint64_t mcg_status = qdict_get_int(qdict, "mcg_status");
2394 uint64_t addr = qdict_get_int(qdict, "addr");
2395 uint64_t misc = qdict_get_int(qdict, "misc");
2397 for (cenv = first_cpu; cenv != NULL; cenv = cenv->next_cpu)
2398 if (cenv->cpu_index == cpu_index && cenv->mcg_cap) {
2399 cpu_inject_x86_mce(cenv, bank, status, mcg_status, addr, misc);
2405 static int do_getfd(Monitor *mon, const QDict *qdict, QObject **ret_data)
2407 const char *fdname = qdict_get_str(qdict, "fdname");
2411 fd = qemu_chr_get_msgfd(mon->chr);
2413 qerror_report(QERR_FD_NOT_SUPPLIED);
2417 if (qemu_isdigit(fdname[0])) {
2418 qerror_report(QERR_INVALID_PARAMETER_VALUE, "fdname",
2419 "a name not starting with a digit");
2423 QLIST_FOREACH(monfd, &mon->fds, next) {
2424 if (strcmp(monfd->name, fdname) != 0) {
2433 monfd = qemu_mallocz(sizeof(mon_fd_t));
2434 monfd->name = qemu_strdup(fdname);
2437 QLIST_INSERT_HEAD(&mon->fds, monfd, next);
2441 static int do_closefd(Monitor *mon, const QDict *qdict, QObject **ret_data)
2443 const char *fdname = qdict_get_str(qdict, "fdname");
2446 QLIST_FOREACH(monfd, &mon->fds, next) {
2447 if (strcmp(monfd->name, fdname) != 0) {
2451 QLIST_REMOVE(monfd, next);
2453 qemu_free(monfd->name);
2458 qerror_report(QERR_FD_NOT_FOUND, fdname);
2462 static void do_loadvm(Monitor *mon, const QDict *qdict)
2464 int saved_vm_running = vm_running;
2465 const char *name = qdict_get_str(qdict, "name");
2469 if (load_vmstate(name) >= 0 && saved_vm_running)
2473 int monitor_get_fd(Monitor *mon, const char *fdname)
2477 QLIST_FOREACH(monfd, &mon->fds, next) {
2480 if (strcmp(monfd->name, fdname) != 0) {
2486 /* caller takes ownership of fd */
2487 QLIST_REMOVE(monfd, next);
2488 qemu_free(monfd->name);
2497 static const mon_cmd_t mon_cmds[] = {
2498 #include "qemu-monitor.h"
2502 /* Please update qemu-monitor.hx when adding or changing commands */
2503 static const mon_cmd_t info_cmds[] = {
2508 .help = "show the version of QEMU",
2509 .user_print = do_info_version_print,
2510 .mhandler.info_new = do_info_version,
2516 .help = "list QMP available commands",
2517 .user_print = monitor_user_noop,
2518 .mhandler.info_new = do_info_commands,
2524 .help = "show the network state",
2525 .mhandler.info = do_info_network,
2531 .help = "show the character devices",
2532 .user_print = qemu_chr_info_print,
2533 .mhandler.info_new = qemu_chr_info,
2539 .help = "show the block devices",
2540 .user_print = bdrv_info_print,
2541 .mhandler.info_new = bdrv_info,
2544 .name = "blockstats",
2547 .help = "show block device statistics",
2548 .user_print = bdrv_stats_print,
2549 .mhandler.info_new = bdrv_info_stats,
2552 .name = "registers",
2555 .help = "show the cpu registers",
2556 .mhandler.info = do_info_registers,
2562 .help = "show infos for each CPU",
2563 .user_print = monitor_print_cpus,
2564 .mhandler.info_new = do_info_cpus,
2570 .help = "show the command line history",
2571 .mhandler.info = do_info_history,
2577 .help = "show the interrupts statistics (if available)",
2578 .mhandler.info = irq_info,
2584 .help = "show i8259 (PIC) state",
2585 .mhandler.info = pic_info,
2591 .help = "show PCI info",
2592 .user_print = do_pci_info_print,
2593 .mhandler.info_new = do_pci_info,
2595 #if defined(TARGET_I386) || defined(TARGET_SH4)
2600 .help = "show virtual to physical memory mappings",
2601 .mhandler.info = tlb_info,
2604 #if defined(TARGET_I386)
2609 .help = "show the active virtual memory mappings",
2610 .mhandler.info = mem_info,
2616 .help = "show state of HPET",
2617 .user_print = do_info_hpet_print,
2618 .mhandler.info_new = do_info_hpet,
2625 .help = "show dynamic compiler info",
2626 .mhandler.info = do_info_jit,
2632 .help = "show KVM information",
2633 .user_print = do_info_kvm_print,
2634 .mhandler.info_new = do_info_kvm,
2640 .help = "show NUMA information",
2641 .mhandler.info = do_info_numa,
2647 .help = "show guest USB devices",
2648 .mhandler.info = usb_info,
2654 .help = "show host USB devices",
2655 .mhandler.info = usb_host_info,
2661 .help = "show profiling information",
2662 .mhandler.info = do_info_profile,
2668 .help = "show capture information",
2669 .mhandler.info = do_info_capture,
2672 .name = "snapshots",
2675 .help = "show the currently saved VM snapshots",
2676 .mhandler.info = do_info_snapshots,
2682 .help = "show the current VM status (running|paused)",
2683 .user_print = do_info_status_print,
2684 .mhandler.info_new = do_info_status,
2690 .help = "show guest PCMCIA status",
2691 .mhandler.info = pcmcia_info,
2697 .help = "show which guest mouse is receiving events",
2698 .user_print = do_info_mice_print,
2699 .mhandler.info_new = do_info_mice,
2705 .help = "show the vnc server status",
2706 .user_print = do_info_vnc_print,
2707 .mhandler.info_new = do_info_vnc,
2713 .help = "show the current VM name",
2714 .user_print = do_info_name_print,
2715 .mhandler.info_new = do_info_name,
2721 .help = "show the current VM UUID",
2722 .user_print = do_info_uuid_print,
2723 .mhandler.info_new = do_info_uuid,
2725 #if defined(TARGET_PPC)
2730 .help = "show CPU statistics",
2731 .mhandler.info = do_info_cpu_stats,
2734 #if defined(CONFIG_SLIRP)
2739 .help = "show user network stack connection states",
2740 .mhandler.info = do_info_usernet,
2747 .help = "show migration status",
2748 .user_print = do_info_migrate_print,
2749 .mhandler.info_new = do_info_migrate,
2755 .help = "show balloon information",
2756 .user_print = monitor_print_balloon,
2757 .mhandler.info_async = do_info_balloon,
2764 .help = "show device tree",
2765 .mhandler.info = do_info_qtree,
2771 .help = "show qdev device model list",
2772 .mhandler.info = do_info_qdm,
2778 .help = "show roms",
2779 .mhandler.info = do_info_roms,
2786 /*******************************************************************/
2788 static const char *pch;
2789 static jmp_buf expr_env;
2794 typedef struct MonitorDef {
2797 target_long (*get_value)(const struct MonitorDef *md, int val);
2801 #if defined(TARGET_I386)
2802 static target_long monitor_get_pc (const struct MonitorDef *md, int val)
2804 CPUState *env = mon_get_cpu();
2805 return env->eip + env->segs[R_CS].base;
2809 #if defined(TARGET_PPC)
2810 static target_long monitor_get_ccr (const struct MonitorDef *md, int val)
2812 CPUState *env = mon_get_cpu();
2817 for (i = 0; i < 8; i++)
2818 u |= env->crf[i] << (32 - (4 * i));
2823 static target_long monitor_get_msr (const struct MonitorDef *md, int val)
2825 CPUState *env = mon_get_cpu();
2829 static target_long monitor_get_xer (const struct MonitorDef *md, int val)
2831 CPUState *env = mon_get_cpu();
2835 static target_long monitor_get_decr (const struct MonitorDef *md, int val)
2837 CPUState *env = mon_get_cpu();
2838 return cpu_ppc_load_decr(env);
2841 static target_long monitor_get_tbu (const struct MonitorDef *md, int val)
2843 CPUState *env = mon_get_cpu();
2844 return cpu_ppc_load_tbu(env);
2847 static target_long monitor_get_tbl (const struct MonitorDef *md, int val)
2849 CPUState *env = mon_get_cpu();
2850 return cpu_ppc_load_tbl(env);
2854 #if defined(TARGET_SPARC)
2855 #ifndef TARGET_SPARC64
2856 static target_long monitor_get_psr (const struct MonitorDef *md, int val)
2858 CPUState *env = mon_get_cpu();
2860 return cpu_get_psr(env);
2864 static target_long monitor_get_reg(const struct MonitorDef *md, int val)
2866 CPUState *env = mon_get_cpu();
2867 return env->regwptr[val];
2871 static const MonitorDef monitor_defs[] = {
2874 #define SEG(name, seg) \
2875 { name, offsetof(CPUState, segs[seg].selector), NULL, MD_I32 },\
2876 { name ".base", offsetof(CPUState, segs[seg].base) },\
2877 { name ".limit", offsetof(CPUState, segs[seg].limit), NULL, MD_I32 },
2879 { "eax", offsetof(CPUState, regs[0]) },
2880 { "ecx", offsetof(CPUState, regs[1]) },
2881 { "edx", offsetof(CPUState, regs[2]) },
2882 { "ebx", offsetof(CPUState, regs[3]) },
2883 { "esp|sp", offsetof(CPUState, regs[4]) },
2884 { "ebp|fp", offsetof(CPUState, regs[5]) },
2885 { "esi", offsetof(CPUState, regs[6]) },
2886 { "edi", offsetof(CPUState, regs[7]) },
2887 #ifdef TARGET_X86_64
2888 { "r8", offsetof(CPUState, regs[8]) },
2889 { "r9", offsetof(CPUState, regs[9]) },
2890 { "r10", offsetof(CPUState, regs[10]) },
2891 { "r11", offsetof(CPUState, regs[11]) },
2892 { "r12", offsetof(CPUState, regs[12]) },
2893 { "r13", offsetof(CPUState, regs[13]) },
2894 { "r14", offsetof(CPUState, regs[14]) },
2895 { "r15", offsetof(CPUState, regs[15]) },
2897 { "eflags", offsetof(CPUState, eflags) },
2898 { "eip", offsetof(CPUState, eip) },
2905 { "pc", 0, monitor_get_pc, },
2906 #elif defined(TARGET_PPC)
2907 /* General purpose registers */
2908 { "r0", offsetof(CPUState, gpr[0]) },
2909 { "r1", offsetof(CPUState, gpr[1]) },
2910 { "r2", offsetof(CPUState, gpr[2]) },
2911 { "r3", offsetof(CPUState, gpr[3]) },
2912 { "r4", offsetof(CPUState, gpr[4]) },
2913 { "r5", offsetof(CPUState, gpr[5]) },
2914 { "r6", offsetof(CPUState, gpr[6]) },
2915 { "r7", offsetof(CPUState, gpr[7]) },
2916 { "r8", offsetof(CPUState, gpr[8]) },
2917 { "r9", offsetof(CPUState, gpr[9]) },
2918 { "r10", offsetof(CPUState, gpr[10]) },
2919 { "r11", offsetof(CPUState, gpr[11]) },
2920 { "r12", offsetof(CPUState, gpr[12]) },
2921 { "r13", offsetof(CPUState, gpr[13]) },
2922 { "r14", offsetof(CPUState, gpr[14]) },
2923 { "r15", offsetof(CPUState, gpr[15]) },
2924 { "r16", offsetof(CPUState, gpr[16]) },
2925 { "r17", offsetof(CPUState, gpr[17]) },
2926 { "r18", offsetof(CPUState, gpr[18]) },
2927 { "r19", offsetof(CPUState, gpr[19]) },
2928 { "r20", offsetof(CPUState, gpr[20]) },
2929 { "r21", offsetof(CPUState, gpr[21]) },
2930 { "r22", offsetof(CPUState, gpr[22]) },
2931 { "r23", offsetof(CPUState, gpr[23]) },
2932 { "r24", offsetof(CPUState, gpr[24]) },
2933 { "r25", offsetof(CPUState, gpr[25]) },
2934 { "r26", offsetof(CPUState, gpr[26]) },
2935 { "r27", offsetof(CPUState, gpr[27]) },
2936 { "r28", offsetof(CPUState, gpr[28]) },
2937 { "r29", offsetof(CPUState, gpr[29]) },
2938 { "r30", offsetof(CPUState, gpr[30]) },
2939 { "r31", offsetof(CPUState, gpr[31]) },
2940 /* Floating point registers */
2941 { "f0", offsetof(CPUState, fpr[0]) },
2942 { "f1", offsetof(CPUState, fpr[1]) },
2943 { "f2", offsetof(CPUState, fpr[2]) },
2944 { "f3", offsetof(CPUState, fpr[3]) },
2945 { "f4", offsetof(CPUState, fpr[4]) },
2946 { "f5", offsetof(CPUState, fpr[5]) },
2947 { "f6", offsetof(CPUState, fpr[6]) },
2948 { "f7", offsetof(CPUState, fpr[7]) },
2949 { "f8", offsetof(CPUState, fpr[8]) },
2950 { "f9", offsetof(CPUState, fpr[9]) },
2951 { "f10", offsetof(CPUState, fpr[10]) },
2952 { "f11", offsetof(CPUState, fpr[11]) },
2953 { "f12", offsetof(CPUState, fpr[12]) },
2954 { "f13", offsetof(CPUState, fpr[13]) },
2955 { "f14", offsetof(CPUState, fpr[14]) },
2956 { "f15", offsetof(CPUState, fpr[15]) },
2957 { "f16", offsetof(CPUState, fpr[16]) },
2958 { "f17", offsetof(CPUState, fpr[17]) },
2959 { "f18", offsetof(CPUState, fpr[18]) },
2960 { "f19", offsetof(CPUState, fpr[19]) },
2961 { "f20", offsetof(CPUState, fpr[20]) },
2962 { "f21", offsetof(CPUState, fpr[21]) },
2963 { "f22", offsetof(CPUState, fpr[22]) },
2964 { "f23", offsetof(CPUState, fpr[23]) },
2965 { "f24", offsetof(CPUState, fpr[24]) },
2966 { "f25", offsetof(CPUState, fpr[25]) },
2967 { "f26", offsetof(CPUState, fpr[26]) },
2968 { "f27", offsetof(CPUState, fpr[27]) },
2969 { "f28", offsetof(CPUState, fpr[28]) },
2970 { "f29", offsetof(CPUState, fpr[29]) },
2971 { "f30", offsetof(CPUState, fpr[30]) },
2972 { "f31", offsetof(CPUState, fpr[31]) },
2973 { "fpscr", offsetof(CPUState, fpscr) },
2974 /* Next instruction pointer */
2975 { "nip|pc", offsetof(CPUState, nip) },
2976 { "lr", offsetof(CPUState, lr) },
2977 { "ctr", offsetof(CPUState, ctr) },
2978 { "decr", 0, &monitor_get_decr, },
2979 { "ccr", 0, &monitor_get_ccr, },
2980 /* Machine state register */
2981 { "msr", 0, &monitor_get_msr, },
2982 { "xer", 0, &monitor_get_xer, },
2983 { "tbu", 0, &monitor_get_tbu, },
2984 { "tbl", 0, &monitor_get_tbl, },
2985 #if defined(TARGET_PPC64)
2986 /* Address space register */
2987 { "asr", offsetof(CPUState, asr) },
2989 /* Segment registers */
2990 { "sdr1", offsetof(CPUState, sdr1) },
2991 { "sr0", offsetof(CPUState, sr[0]) },
2992 { "sr1", offsetof(CPUState, sr[1]) },
2993 { "sr2", offsetof(CPUState, sr[2]) },
2994 { "sr3", offsetof(CPUState, sr[3]) },
2995 { "sr4", offsetof(CPUState, sr[4]) },
2996 { "sr5", offsetof(CPUState, sr[5]) },
2997 { "sr6", offsetof(CPUState, sr[6]) },
2998 { "sr7", offsetof(CPUState, sr[7]) },
2999 { "sr8", offsetof(CPUState, sr[8]) },
3000 { "sr9", offsetof(CPUState, sr[9]) },
3001 { "sr10", offsetof(CPUState, sr[10]) },
3002 { "sr11", offsetof(CPUState, sr[11]) },
3003 { "sr12", offsetof(CPUState, sr[12]) },
3004 { "sr13", offsetof(CPUState, sr[13]) },
3005 { "sr14", offsetof(CPUState, sr[14]) },
3006 { "sr15", offsetof(CPUState, sr[15]) },
3007 /* Too lazy to put BATs and SPRs ... */
3008 #elif defined(TARGET_SPARC)
3009 { "g0", offsetof(CPUState, gregs[0]) },
3010 { "g1", offsetof(CPUState, gregs[1]) },
3011 { "g2", offsetof(CPUState, gregs[2]) },
3012 { "g3", offsetof(CPUState, gregs[3]) },
3013 { "g4", offsetof(CPUState, gregs[4]) },
3014 { "g5", offsetof(CPUState, gregs[5]) },
3015 { "g6", offsetof(CPUState, gregs[6]) },
3016 { "g7", offsetof(CPUState, gregs[7]) },
3017 { "o0", 0, monitor_get_reg },
3018 { "o1", 1, monitor_get_reg },
3019 { "o2", 2, monitor_get_reg },
3020 { "o3", 3, monitor_get_reg },
3021 { "o4", 4, monitor_get_reg },
3022 { "o5", 5, monitor_get_reg },
3023 { "o6", 6, monitor_get_reg },
3024 { "o7", 7, monitor_get_reg },
3025 { "l0", 8, monitor_get_reg },
3026 { "l1", 9, monitor_get_reg },
3027 { "l2", 10, monitor_get_reg },
3028 { "l3", 11, monitor_get_reg },
3029 { "l4", 12, monitor_get_reg },
3030 { "l5", 13, monitor_get_reg },
3031 { "l6", 14, monitor_get_reg },
3032 { "l7", 15, monitor_get_reg },
3033 { "i0", 16, monitor_get_reg },
3034 { "i1", 17, monitor_get_reg },
3035 { "i2", 18, monitor_get_reg },
3036 { "i3", 19, monitor_get_reg },
3037 { "i4", 20, monitor_get_reg },
3038 { "i5", 21, monitor_get_reg },
3039 { "i6", 22, monitor_get_reg },
3040 { "i7", 23, monitor_get_reg },
3041 { "pc", offsetof(CPUState, pc) },
3042 { "npc", offsetof(CPUState, npc) },
3043 { "y", offsetof(CPUState, y) },
3044 #ifndef TARGET_SPARC64
3045 { "psr", 0, &monitor_get_psr, },
3046 { "wim", offsetof(CPUState, wim) },
3048 { "tbr", offsetof(CPUState, tbr) },
3049 { "fsr", offsetof(CPUState, fsr) },
3050 { "f0", offsetof(CPUState, fpr[0]) },
3051 { "f1", offsetof(CPUState, fpr[1]) },
3052 { "f2", offsetof(CPUState, fpr[2]) },
3053 { "f3", offsetof(CPUState, fpr[3]) },
3054 { "f4", offsetof(CPUState, fpr[4]) },
3055 { "f5", offsetof(CPUState, fpr[5]) },
3056 { "f6", offsetof(CPUState, fpr[6]) },
3057 { "f7", offsetof(CPUState, fpr[7]) },
3058 { "f8", offsetof(CPUState, fpr[8]) },
3059 { "f9", offsetof(CPUState, fpr[9]) },
3060 { "f10", offsetof(CPUState, fpr[10]) },
3061 { "f11", offsetof(CPUState, fpr[11]) },
3062 { "f12", offsetof(CPUState, fpr[12]) },
3063 { "f13", offsetof(CPUState, fpr[13]) },
3064 { "f14", offsetof(CPUState, fpr[14]) },
3065 { "f15", offsetof(CPUState, fpr[15]) },
3066 { "f16", offsetof(CPUState, fpr[16]) },
3067 { "f17", offsetof(CPUState, fpr[17]) },
3068 { "f18", offsetof(CPUState, fpr[18]) },
3069 { "f19", offsetof(CPUState, fpr[19]) },
3070 { "f20", offsetof(CPUState, fpr[20]) },
3071 { "f21", offsetof(CPUState, fpr[21]) },
3072 { "f22", offsetof(CPUState, fpr[22]) },
3073 { "f23", offsetof(CPUState, fpr[23]) },
3074 { "f24", offsetof(CPUState, fpr[24]) },
3075 { "f25", offsetof(CPUState, fpr[25]) },
3076 { "f26", offsetof(CPUState, fpr[26]) },
3077 { "f27", offsetof(CPUState, fpr[27]) },
3078 { "f28", offsetof(CPUState, fpr[28]) },
3079 { "f29", offsetof(CPUState, fpr[29]) },
3080 { "f30", offsetof(CPUState, fpr[30]) },
3081 { "f31", offsetof(CPUState, fpr[31]) },
3082 #ifdef TARGET_SPARC64
3083 { "f32", offsetof(CPUState, fpr[32]) },
3084 { "f34", offsetof(CPUState, fpr[34]) },
3085 { "f36", offsetof(CPUState, fpr[36]) },
3086 { "f38", offsetof(CPUState, fpr[38]) },
3087 { "f40", offsetof(CPUState, fpr[40]) },
3088 { "f42", offsetof(CPUState, fpr[42]) },
3089 { "f44", offsetof(CPUState, fpr[44]) },
3090 { "f46", offsetof(CPUState, fpr[46]) },
3091 { "f48", offsetof(CPUState, fpr[48]) },
3092 { "f50", offsetof(CPUState, fpr[50]) },
3093 { "f52", offsetof(CPUState, fpr[52]) },
3094 { "f54", offsetof(CPUState, fpr[54]) },
3095 { "f56", offsetof(CPUState, fpr[56]) },
3096 { "f58", offsetof(CPUState, fpr[58]) },
3097 { "f60", offsetof(CPUState, fpr[60]) },
3098 { "f62", offsetof(CPUState, fpr[62]) },
3099 { "asi", offsetof(CPUState, asi) },
3100 { "pstate", offsetof(CPUState, pstate) },
3101 { "cansave", offsetof(CPUState, cansave) },
3102 { "canrestore", offsetof(CPUState, canrestore) },
3103 { "otherwin", offsetof(CPUState, otherwin) },
3104 { "wstate", offsetof(CPUState, wstate) },
3105 { "cleanwin", offsetof(CPUState, cleanwin) },
3106 { "fprs", offsetof(CPUState, fprs) },
3112 static void expr_error(Monitor *mon, const char *msg)
3114 monitor_printf(mon, "%s\n", msg);
3115 longjmp(expr_env, 1);
3118 /* return 0 if OK, -1 if not found */
3119 static int get_monitor_def(target_long *pval, const char *name)
3121 const MonitorDef *md;
3124 for(md = monitor_defs; md->name != NULL; md++) {
3125 if (compare_cmd(name, md->name)) {
3126 if (md->get_value) {
3127 *pval = md->get_value(md, md->offset);
3129 CPUState *env = mon_get_cpu();
3130 ptr = (uint8_t *)env + md->offset;
3133 *pval = *(int32_t *)ptr;
3136 *pval = *(target_long *)ptr;
3149 static void next(void)
3153 while (qemu_isspace(*pch))
3158 static int64_t expr_sum(Monitor *mon);
3160 static int64_t expr_unary(Monitor *mon)
3169 n = expr_unary(mon);
3173 n = -expr_unary(mon);
3177 n = ~expr_unary(mon);
3183 expr_error(mon, "')' expected");
3190 expr_error(mon, "character constant expected");
3194 expr_error(mon, "missing terminating \' character");
3204 while ((*pch >= 'a' && *pch <= 'z') ||
3205 (*pch >= 'A' && *pch <= 'Z') ||
3206 (*pch >= '0' && *pch <= '9') ||
3207 *pch == '_' || *pch == '.') {
3208 if ((q - buf) < sizeof(buf) - 1)
3212 while (qemu_isspace(*pch))
3215 ret = get_monitor_def(®, buf);
3217 expr_error(mon, "unknown register");
3222 expr_error(mon, "unexpected end of expression");
3226 #if TARGET_PHYS_ADDR_BITS > 32
3227 n = strtoull(pch, &p, 0);
3229 n = strtoul(pch, &p, 0);
3232 expr_error(mon, "invalid char in expression");
3235 while (qemu_isspace(*pch))
3243 static int64_t expr_prod(Monitor *mon)
3248 val = expr_unary(mon);
3251 if (op != '*' && op != '/' && op != '%')
3254 val2 = expr_unary(mon);
3263 expr_error(mon, "division by zero");
3274 static int64_t expr_logic(Monitor *mon)
3279 val = expr_prod(mon);
3282 if (op != '&' && op != '|' && op != '^')
3285 val2 = expr_prod(mon);
3302 static int64_t expr_sum(Monitor *mon)
3307 val = expr_logic(mon);
3310 if (op != '+' && op != '-')
3313 val2 = expr_logic(mon);
3322 static int get_expr(Monitor *mon, int64_t *pval, const char **pp)
3325 if (setjmp(expr_env)) {
3329 while (qemu_isspace(*pch))
3331 *pval = expr_sum(mon);
3336 static int get_double(Monitor *mon, double *pval, const char **pp)
3338 const char *p = *pp;
3342 d = strtod(p, &tailp);
3344 monitor_printf(mon, "Number expected\n");
3347 if (d != d || d - d != 0) {
3348 /* NaN or infinity */
3349 monitor_printf(mon, "Bad number\n");
3357 static int get_str(char *buf, int buf_size, const char **pp)
3365 while (qemu_isspace(*p))
3375 while (*p != '\0' && *p != '\"') {
3391 qemu_printf("unsupported escape code: '\\%c'\n", c);
3394 if ((q - buf) < buf_size - 1) {
3398 if ((q - buf) < buf_size - 1) {
3405 qemu_printf("unterminated string\n");
3410 while (*p != '\0' && !qemu_isspace(*p)) {
3411 if ((q - buf) < buf_size - 1) {
3423 * Store the command-name in cmdname, and return a pointer to
3424 * the remaining of the command string.
3426 static const char *get_command_name(const char *cmdline,
3427 char *cmdname, size_t nlen)
3430 const char *p, *pstart;
3433 while (qemu_isspace(*p))
3438 while (*p != '\0' && *p != '/' && !qemu_isspace(*p))
3443 memcpy(cmdname, pstart, len);
3444 cmdname[len] = '\0';
3449 * Read key of 'type' into 'key' and return the current
3452 static char *key_get_info(const char *type, char **key)
3460 p = strchr(type, ':');
3467 str = qemu_malloc(len + 1);
3468 memcpy(str, type, len);
3475 static int default_fmt_format = 'x';
3476 static int default_fmt_size = 4;
3480 static int is_valid_option(const char *c, const char *typestr)
3488 typestr = strstr(typestr, option);
3489 return (typestr != NULL);
3492 static const mon_cmd_t *monitor_find_command(const char *cmdname)
3494 const mon_cmd_t *cmd;
3496 for (cmd = mon_cmds; cmd->name != NULL; cmd++) {
3497 if (compare_cmd(cmdname, cmd->name)) {
3505 static const mon_cmd_t *monitor_parse_command(Monitor *mon,
3506 const char *cmdline,
3509 const char *p, *typestr;
3511 const mon_cmd_t *cmd;
3517 monitor_printf(mon, "command='%s'\n", cmdline);
3520 /* extract the command name */
3521 p = get_command_name(cmdline, cmdname, sizeof(cmdname));
3525 cmd = monitor_find_command(cmdname);
3527 monitor_printf(mon, "unknown command: '%s'\n", cmdname);
3531 /* parse the parameters */
3532 typestr = cmd->args_type;
3534 typestr = key_get_info(typestr, &key);
3546 while (qemu_isspace(*p))
3548 if (*typestr == '?') {
3551 /* no optional string: NULL argument */
3555 ret = get_str(buf, sizeof(buf), &p);
3559 monitor_printf(mon, "%s: filename expected\n",
3563 monitor_printf(mon, "%s: block device name expected\n",
3567 monitor_printf(mon, "%s: string expected\n", cmdname);
3572 qdict_put(qdict, key, qstring_from_str(buf));
3577 QemuOptsList *opts_list;
3580 opts_list = qemu_find_opts(key);
3581 if (!opts_list || opts_list->desc->name) {
3584 while (qemu_isspace(*p)) {
3589 if (get_str(buf, sizeof(buf), &p) < 0) {
3592 opts = qemu_opts_parse(opts_list, buf, 1);
3596 qemu_opts_to_qdict(opts, qdict);
3597 qemu_opts_del(opts);
3602 int count, format, size;
3604 while (qemu_isspace(*p))
3610 if (qemu_isdigit(*p)) {
3612 while (qemu_isdigit(*p)) {
3613 count = count * 10 + (*p - '0');
3651 if (*p != '\0' && !qemu_isspace(*p)) {
3652 monitor_printf(mon, "invalid char in format: '%c'\n",
3657 format = default_fmt_format;
3658 if (format != 'i') {
3659 /* for 'i', not specifying a size gives -1 as size */
3661 size = default_fmt_size;
3662 default_fmt_size = size;
3664 default_fmt_format = format;
3667 format = default_fmt_format;
3668 if (format != 'i') {
3669 size = default_fmt_size;
3674 qdict_put(qdict, "count", qint_from_int(count));
3675 qdict_put(qdict, "format", qint_from_int(format));
3676 qdict_put(qdict, "size", qint_from_int(size));
3685 while (qemu_isspace(*p))
3687 if (*typestr == '?' || *typestr == '.') {
3688 if (*typestr == '?') {
3696 while (qemu_isspace(*p))
3705 if (get_expr(mon, &val, &p))
3707 /* Check if 'i' is greater than 32-bit */
3708 if ((c == 'i') && ((val >> 32) & 0xffffffff)) {
3709 monitor_printf(mon, "\'%s\' has failed: ", cmdname);
3710 monitor_printf(mon, "integer is for 32-bit values\n");
3712 } else if (c == 'M') {
3715 qdict_put(qdict, key, qint_from_int(val));
3723 while (qemu_isspace(*p))
3725 if (*typestr == '?') {
3731 if (get_double(mon, &val, &p) < 0) {
3734 if (c == 'f' && *p) {
3737 val *= 1 << 10; p++; break;
3739 val *= 1 << 20; p++; break;
3741 val *= 1 << 30; p++; break;
3744 if (c == 'T' && p[0] && p[1] == 's') {
3747 val /= 1e3; p += 2; break;
3749 val /= 1e6; p += 2; break;
3751 val /= 1e9; p += 2; break;
3754 if (*p && !qemu_isspace(*p)) {
3755 monitor_printf(mon, "Unknown unit suffix\n");
3758 qdict_put(qdict, key, qfloat_from_double(val));
3766 while (qemu_isspace(*p)) {
3770 while (qemu_isgraph(*p)) {
3773 if (p - beg == 2 && !memcmp(beg, "on", p - beg)) {
3775 } else if (p - beg == 3 && !memcmp(beg, "off", p - beg)) {
3778 monitor_printf(mon, "Expected 'on' or 'off'\n");
3781 qdict_put(qdict, key, qbool_from_int(val));
3786 const char *tmp = p;
3787 int has_option, skip_key = 0;
3793 while (qemu_isspace(*p))
3799 if(!is_valid_option(p, typestr)) {
3801 monitor_printf(mon, "%s: unsupported option -%c\n",
3815 qdict_put(qdict, key, qint_from_int(has_option));
3820 monitor_printf(mon, "%s: unknown type '%c'\n", cmdname, c);
3826 /* check that all arguments were parsed */
3827 while (qemu_isspace(*p))
3830 monitor_printf(mon, "%s: extraneous characters at the end of line\n",
3842 void monitor_set_error(Monitor *mon, QError *qerror)
3844 /* report only the first error */
3846 mon->error = qerror;
3848 MON_DEBUG("Additional error report at %s:%d\n",
3849 qerror->file, qerror->linenr);
3854 static int is_async_return(const QObject *data)
3856 if (data && qobject_type(data) == QTYPE_QDICT) {
3857 return qdict_haskey(qobject_to_qdict(data), "__mon_async");
3863 static void handler_audit(Monitor *mon, const mon_cmd_t *cmd, int ret)
3865 if (monitor_ctrl_mode(mon)) {
3866 if (ret && !monitor_has_error(mon)) {
3868 * If it returns failure, it must have passed on error.
3870 * Action: Report an internal error to the client if in QMP.
3872 qerror_report(QERR_UNDEFINED_ERROR);
3873 MON_DEBUG("command '%s' returned failure but did not pass an error\n",
3877 #ifdef CONFIG_DEBUG_MONITOR
3878 if (!ret && monitor_has_error(mon)) {
3880 * If it returns success, it must not have passed an error.
3882 * Action: Report the passed error to the client.
3884 MON_DEBUG("command '%s' returned success but passed an error\n",
3888 if (mon_print_count_get(mon) > 0 && strcmp(cmd->name, "info") != 0) {
3890 * Handlers should not call Monitor print functions.
3892 * Action: Ignore them in QMP.
3894 * (XXX: we don't check any 'info' or 'query' command here
3895 * because the user print function _is_ called by do_info(), hence
3896 * we will trigger this check. This problem will go away when we
3897 * make 'query' commands real and kill do_info())
3899 MON_DEBUG("command '%s' called print functions %d time(s)\n",
3900 cmd->name, mon_print_count_get(mon));
3904 assert(!monitor_has_error(mon));
3905 QDECREF(mon->error);
3910 static void monitor_call_handler(Monitor *mon, const mon_cmd_t *cmd,
3911 const QDict *params)
3914 QObject *data = NULL;
3916 mon_print_count_init(mon);
3918 ret = cmd->mhandler.cmd_new(mon, params, &data);
3919 handler_audit(mon, cmd, ret);
3921 if (is_async_return(data)) {
3923 * Asynchronous commands have no initial return data but they can
3924 * generate errors. Data is returned via the async completion handler.
3926 if (monitor_ctrl_mode(mon) && monitor_has_error(mon)) {
3927 monitor_protocol_emitter(mon, NULL);
3929 } else if (monitor_ctrl_mode(mon)) {
3930 /* Monitor Protocol */
3931 monitor_protocol_emitter(mon, data);
3935 cmd->user_print(mon, data);
3938 qobject_decref(data);
3941 static void handle_user_command(Monitor *mon, const char *cmdline)
3944 const mon_cmd_t *cmd;
3946 qdict = qdict_new();
3948 cmd = monitor_parse_command(mon, cmdline, qdict);
3952 if (monitor_handler_is_async(cmd)) {
3953 user_async_cmd_handler(mon, cmd, qdict);
3954 } else if (monitor_handler_ported(cmd)) {
3955 monitor_call_handler(mon, cmd, qdict);
3957 cmd->mhandler.cmd(mon, qdict);
3964 static void cmd_completion(const char *name, const char *list)
3966 const char *p, *pstart;
3975 p = pstart + strlen(pstart);
3977 if (len > sizeof(cmd) - 2)
3978 len = sizeof(cmd) - 2;
3979 memcpy(cmd, pstart, len);
3981 if (name[0] == '\0' || !strncmp(name, cmd, strlen(name))) {
3982 readline_add_completion(cur_mon->rs, cmd);
3990 static void file_completion(const char *input)
3995 char file[1024], file_prefix[1024];
3999 p = strrchr(input, '/');
4002 pstrcpy(file_prefix, sizeof(file_prefix), input);
4003 pstrcpy(path, sizeof(path), ".");
4005 input_path_len = p - input + 1;
4006 memcpy(path, input, input_path_len);
4007 if (input_path_len > sizeof(path) - 1)
4008 input_path_len = sizeof(path) - 1;
4009 path[input_path_len] = '\0';
4010 pstrcpy(file_prefix, sizeof(file_prefix), p + 1);
4012 #ifdef DEBUG_COMPLETION
4013 monitor_printf(cur_mon, "input='%s' path='%s' prefix='%s'\n",
4014 input, path, file_prefix);
4016 ffs = opendir(path);
4024 if (strstart(d->d_name, file_prefix, NULL)) {
4025 memcpy(file, input, input_path_len);
4026 if (input_path_len < sizeof(file))
4027 pstrcpy(file + input_path_len, sizeof(file) - input_path_len,
4029 /* stat the file to find out if it's a directory.
4030 * In that case add a slash to speed up typing long paths
4033 if(S_ISDIR(sb.st_mode))
4034 pstrcat(file, sizeof(file), "/");
4035 readline_add_completion(cur_mon->rs, file);
4041 static void block_completion_it(void *opaque, BlockDriverState *bs)
4043 const char *name = bdrv_get_device_name(bs);
4044 const char *input = opaque;
4046 if (input[0] == '\0' ||
4047 !strncmp(name, (char *)input, strlen(input))) {
4048 readline_add_completion(cur_mon->rs, name);
4052 /* NOTE: this parser is an approximate form of the real command parser */
4053 static void parse_cmdline(const char *cmdline,
4054 int *pnb_args, char **args)
4063 while (qemu_isspace(*p))
4067 if (nb_args >= MAX_ARGS)
4069 ret = get_str(buf, sizeof(buf), &p);
4070 args[nb_args] = qemu_strdup(buf);
4075 *pnb_args = nb_args;
4078 static const char *next_arg_type(const char *typestr)
4080 const char *p = strchr(typestr, ':');
4081 return (p != NULL ? ++p : typestr);
4084 static void monitor_find_completion(const char *cmdline)
4086 const char *cmdname;
4087 char *args[MAX_ARGS];
4088 int nb_args, i, len;
4089 const char *ptype, *str;
4090 const mon_cmd_t *cmd;
4093 parse_cmdline(cmdline, &nb_args, args);
4094 #ifdef DEBUG_COMPLETION
4095 for(i = 0; i < nb_args; i++) {
4096 monitor_printf(cur_mon, "arg%d = '%s'\n", i, (char *)args[i]);
4100 /* if the line ends with a space, it means we want to complete the
4102 len = strlen(cmdline);
4103 if (len > 0 && qemu_isspace(cmdline[len - 1])) {
4104 if (nb_args >= MAX_ARGS)
4106 args[nb_args++] = qemu_strdup("");
4109 /* command completion */
4114 readline_set_completion_index(cur_mon->rs, strlen(cmdname));
4115 for(cmd = mon_cmds; cmd->name != NULL; cmd++) {
4116 cmd_completion(cmdname, cmd->name);
4119 /* find the command */
4120 for(cmd = mon_cmds; cmd->name != NULL; cmd++) {
4121 if (compare_cmd(args[0], cmd->name))
4126 ptype = next_arg_type(cmd->args_type);
4127 for(i = 0; i < nb_args - 2; i++) {
4128 if (*ptype != '\0') {
4129 ptype = next_arg_type(ptype);
4130 while (*ptype == '?')
4131 ptype = next_arg_type(ptype);
4134 str = args[nb_args - 1];
4135 if (*ptype == '-' && ptype[1] != '\0') {
4140 /* file completion */
4141 readline_set_completion_index(cur_mon->rs, strlen(str));
4142 file_completion(str);
4145 /* block device name completion */
4146 readline_set_completion_index(cur_mon->rs, strlen(str));
4147 bdrv_iterate(block_completion_it, (void *)str);
4150 /* XXX: more generic ? */
4151 if (!strcmp(cmd->name, "info")) {
4152 readline_set_completion_index(cur_mon->rs, strlen(str));
4153 for(cmd = info_cmds; cmd->name != NULL; cmd++) {
4154 cmd_completion(str, cmd->name);
4156 } else if (!strcmp(cmd->name, "sendkey")) {
4157 char *sep = strrchr(str, '-');
4160 readline_set_completion_index(cur_mon->rs, strlen(str));
4161 for(key = key_defs; key->name != NULL; key++) {
4162 cmd_completion(str, key->name);
4164 } else if (!strcmp(cmd->name, "help|?")) {
4165 readline_set_completion_index(cur_mon->rs, strlen(str));
4166 for (cmd = mon_cmds; cmd->name != NULL; cmd++) {
4167 cmd_completion(str, cmd->name);
4175 for(i = 0; i < nb_args; i++)
4179 static int monitor_can_read(void *opaque)
4181 Monitor *mon = opaque;
4183 return (mon->suspend_cnt == 0) ? 1 : 0;
4186 typedef struct CmdArgs {
4193 static int check_opt(const CmdArgs *cmd_args, const char *name, QDict *args)
4195 if (!cmd_args->optional) {
4196 qerror_report(QERR_MISSING_PARAMETER, name);
4200 if (cmd_args->type == '-') {
4201 /* handlers expect a value, they need to be changed */
4202 qdict_put(args, name, qint_from_int(0));
4208 static int check_arg(const CmdArgs *cmd_args, QDict *args)
4213 name = qstring_get_str(cmd_args->name);
4216 return check_opt(cmd_args, name, args);
4219 value = qdict_get(args, name);
4221 return check_opt(cmd_args, name, args);
4224 switch (cmd_args->type) {
4228 if (qobject_type(value) != QTYPE_QSTRING) {
4229 qerror_report(QERR_INVALID_PARAMETER_TYPE, name, "string");
4235 const char *keys[] = { "count", "format", "size", NULL };
4237 for (i = 0; keys[i]; i++) {
4238 QObject *obj = qdict_get(args, keys[i]);
4240 qerror_report(QERR_MISSING_PARAMETER, name);
4243 if (qobject_type(obj) != QTYPE_QINT) {
4244 qerror_report(QERR_INVALID_PARAMETER_TYPE, name, "int");
4253 if (qobject_type(value) != QTYPE_QINT) {
4254 qerror_report(QERR_INVALID_PARAMETER_TYPE, name, "int");
4260 if (qobject_type(value) != QTYPE_QINT && qobject_type(value) != QTYPE_QFLOAT) {
4261 qerror_report(QERR_INVALID_PARAMETER_TYPE, name, "number");
4266 if (qobject_type(value) != QTYPE_QBOOL) {
4267 qerror_report(QERR_INVALID_PARAMETER_TYPE, name, "bool");
4272 if (qobject_type(value) != QTYPE_QINT &&
4273 qobject_type(value) != QTYPE_QBOOL) {
4274 qerror_report(QERR_INVALID_PARAMETER_TYPE, name, "bool");
4277 if (qobject_type(value) == QTYPE_QBOOL) {
4278 /* handlers expect a QInt, they need to be changed */
4279 qdict_put(args, name,
4280 qint_from_int(qbool_get_int(qobject_to_qbool(value))));
4292 static void cmd_args_init(CmdArgs *cmd_args)
4294 cmd_args->name = qstring_new();
4295 cmd_args->type = cmd_args->flag = cmd_args->optional = 0;
4298 static int check_opts(QemuOptsList *opts_list, QDict *args)
4300 assert(!opts_list->desc->name);
4305 * This is not trivial, we have to parse Monitor command's argument
4306 * type syntax to be able to check the arguments provided by clients.
4308 * In the near future we will be using an array for that and will be
4309 * able to drop all this parsing...
4311 static int monitor_check_qmp_args(const mon_cmd_t *cmd, QDict *args)
4316 QemuOptsList *opts_list;
4318 if (cmd->args_type == NULL) {
4319 return (qdict_size(args) == 0 ? 0 : -1);
4323 cmd_args_init(&cmd_args);
4326 for (p = cmd->args_type;; p++) {
4328 cmd_args.type = *++p;
4330 if (cmd_args.type == '-') {
4331 cmd_args.flag = *p++;
4332 cmd_args.optional = 1;
4333 } else if (cmd_args.type == 'O') {
4334 opts_list = qemu_find_opts(qstring_get_str(cmd_args.name));
4336 } else if (*p == '?') {
4337 cmd_args.optional = 1;
4341 assert(*p == ',' || *p == '\0');
4343 err = check_opts(opts_list, args);
4346 err = check_arg(&cmd_args, args);
4347 QDECREF(cmd_args.name);
4348 cmd_args_init(&cmd_args);
4355 qstring_append_chr(cmd_args.name, *p);
4363 QDECREF(cmd_args.name);
4367 static int invalid_qmp_mode(const Monitor *mon, const char *cmd_name)
4369 int is_cap = compare_cmd(cmd_name, "qmp_capabilities");
4370 return (qmp_cmd_mode(mon) ? is_cap : !is_cap);
4373 static void handle_qmp_command(JSONMessageParser *parser, QList *tokens)
4377 QDict *input, *args;
4378 const mon_cmd_t *cmd;
4379 Monitor *mon = cur_mon;
4380 const char *cmd_name, *info_item;
4384 obj = json_parser_parse(tokens, NULL);
4386 // FIXME: should be triggered in json_parser_parse()
4387 qerror_report(QERR_JSON_PARSING);
4389 } else if (qobject_type(obj) != QTYPE_QDICT) {
4390 qerror_report(QERR_QMP_BAD_INPUT_OBJECT, "object");
4391 qobject_decref(obj);
4395 input = qobject_to_qdict(obj);
4397 mon->mc->id = qdict_get(input, "id");
4398 qobject_incref(mon->mc->id);
4400 obj = qdict_get(input, "execute");
4402 qerror_report(QERR_QMP_BAD_INPUT_OBJECT, "execute");
4404 } else if (qobject_type(obj) != QTYPE_QSTRING) {
4405 qerror_report(QERR_QMP_BAD_INPUT_OBJECT_MEMBER, "execute", "string");
4409 cmd_name = qstring_get_str(qobject_to_qstring(obj));
4411 if (invalid_qmp_mode(mon, cmd_name)) {
4412 qerror_report(QERR_COMMAND_NOT_FOUND, cmd_name);
4417 * XXX: We need this special case until we get info handlers
4418 * converted into 'query-' commands
4420 if (compare_cmd(cmd_name, "info")) {
4421 qerror_report(QERR_COMMAND_NOT_FOUND, cmd_name);
4423 } else if (strstart(cmd_name, "query-", &info_item)) {
4424 cmd = monitor_find_command("info");
4425 qdict_put_obj(input, "arguments",
4426 qobject_from_jsonf("{ 'item': %s }", info_item));
4428 cmd = monitor_find_command(cmd_name);
4429 if (!cmd || !monitor_handler_ported(cmd)) {
4430 qerror_report(QERR_COMMAND_NOT_FOUND, cmd_name);
4435 obj = qdict_get(input, "arguments");
4438 } else if (qobject_type(obj) != QTYPE_QDICT) {
4439 qerror_report(QERR_QMP_BAD_INPUT_OBJECT_MEMBER, "arguments", "object");
4442 args = qobject_to_qdict(obj);
4448 err = monitor_check_qmp_args(cmd, args);
4453 if (monitor_handler_is_async(cmd)) {
4454 qmp_async_cmd_handler(mon, cmd, args);
4456 monitor_call_handler(mon, cmd, args);
4463 monitor_protocol_emitter(mon, NULL);
4469 * monitor_control_read(): Read and handle QMP input
4471 static void monitor_control_read(void *opaque, const uint8_t *buf, int size)
4473 Monitor *old_mon = cur_mon;
4477 json_message_parser_feed(&cur_mon->mc->parser, (const char *) buf, size);
4482 static void monitor_read(void *opaque, const uint8_t *buf, int size)
4484 Monitor *old_mon = cur_mon;
4490 for (i = 0; i < size; i++)
4491 readline_handle_byte(cur_mon->rs, buf[i]);
4493 if (size == 0 || buf[size - 1] != 0)
4494 monitor_printf(cur_mon, "corrupted command\n");
4496 handle_user_command(cur_mon, (char *)buf);
4502 static void monitor_command_cb(Monitor *mon, const char *cmdline, void *opaque)
4504 monitor_suspend(mon);
4505 handle_user_command(mon, cmdline);
4506 monitor_resume(mon);
4509 int monitor_suspend(Monitor *mon)
4517 void monitor_resume(Monitor *mon)
4521 if (--mon->suspend_cnt == 0)
4522 readline_show_prompt(mon->rs);
4525 static QObject *get_qmp_greeting(void)
4529 do_info_version(NULL, &ver);
4530 return qobject_from_jsonf("{'QMP':{'version': %p,'capabilities': []}}",ver);
4534 * monitor_control_event(): Print QMP gretting
4536 static void monitor_control_event(void *opaque, int event)
4539 Monitor *mon = opaque;
4542 case CHR_EVENT_OPENED:
4543 mon->mc->command_mode = 0;
4544 json_message_parser_init(&mon->mc->parser, handle_qmp_command);
4545 data = get_qmp_greeting();
4546 monitor_json_emitter(mon, data);
4547 qobject_decref(data);
4549 case CHR_EVENT_CLOSED:
4550 json_message_parser_destroy(&mon->mc->parser);
4555 static void monitor_event(void *opaque, int event)
4557 Monitor *mon = opaque;
4560 case CHR_EVENT_MUX_IN:
4562 if (mon->reset_seen) {
4563 readline_restart(mon->rs);
4564 monitor_resume(mon);
4567 mon->suspend_cnt = 0;
4571 case CHR_EVENT_MUX_OUT:
4572 if (mon->reset_seen) {
4573 if (mon->suspend_cnt == 0) {
4574 monitor_printf(mon, "\n");
4577 monitor_suspend(mon);
4584 case CHR_EVENT_OPENED:
4585 monitor_printf(mon, "QEMU %s monitor - type 'help' for more "
4586 "information\n", QEMU_VERSION);
4587 if (!mon->mux_out) {
4588 readline_show_prompt(mon->rs);
4590 mon->reset_seen = 1;
4604 void monitor_init(CharDriverState *chr, int flags)
4606 static int is_first_init = 1;
4609 if (is_first_init) {
4610 key_timer = qemu_new_timer(vm_clock, release_keys, NULL);
4614 mon = qemu_mallocz(sizeof(*mon));
4618 if (flags & MONITOR_USE_READLINE) {
4619 mon->rs = readline_init(mon, monitor_find_completion);
4620 monitor_read_command(mon, 0);
4623 if (monitor_ctrl_mode(mon)) {
4624 mon->mc = qemu_mallocz(sizeof(MonitorControl));
4625 /* Control mode requires special handlers */
4626 qemu_chr_add_handlers(chr, monitor_can_read, monitor_control_read,
4627 monitor_control_event, mon);
4629 qemu_chr_add_handlers(chr, monitor_can_read, monitor_read,
4630 monitor_event, mon);
4633 QLIST_INSERT_HEAD(&mon_list, mon, entry);
4634 if (!default_mon || (flags & MONITOR_IS_DEFAULT))
4638 static void bdrv_password_cb(Monitor *mon, const char *password, void *opaque)
4640 BlockDriverState *bs = opaque;
4643 if (bdrv_set_key(bs, password) != 0) {
4644 monitor_printf(mon, "invalid password\n");
4647 if (mon->password_completion_cb)
4648 mon->password_completion_cb(mon->password_opaque, ret);
4650 monitor_read_command(mon, 1);
4653 int monitor_read_bdrv_key_start(Monitor *mon, BlockDriverState *bs,
4654 BlockDriverCompletionFunc *completion_cb,
4659 if (!bdrv_key_required(bs)) {
4661 completion_cb(opaque, 0);
4665 if (monitor_ctrl_mode(mon)) {
4666 qerror_report(QERR_DEVICE_ENCRYPTED, bdrv_get_device_name(bs));
4670 monitor_printf(mon, "%s (%s) is encrypted.\n", bdrv_get_device_name(bs),
4671 bdrv_get_encrypted_filename(bs));
4673 mon->password_completion_cb = completion_cb;
4674 mon->password_opaque = opaque;
4676 err = monitor_read_password(mon, bdrv_password_cb, bs);
4678 if (err && completion_cb)
4679 completion_cb(opaque, err);