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')
88 * '-' optional parameter (eg. '-f')
92 typedef struct MonitorCompletionData MonitorCompletionData;
93 struct MonitorCompletionData {
95 void (*user_print)(Monitor *mon, const QObject *data);
98 typedef struct mon_cmd_t {
100 const char *args_type;
103 void (*user_print)(Monitor *mon, const QObject *data);
105 void (*info)(Monitor *mon);
106 void (*info_new)(Monitor *mon, QObject **ret_data);
107 int (*info_async)(Monitor *mon, MonitorCompletion *cb, void *opaque);
108 void (*cmd)(Monitor *mon, const QDict *qdict);
109 int (*cmd_new)(Monitor *mon, const QDict *params, QObject **ret_data);
110 int (*cmd_async)(Monitor *mon, const QDict *params,
111 MonitorCompletion *cb, void *opaque);
116 /* file descriptors passed via SCM_RIGHTS */
117 typedef struct mon_fd_t mon_fd_t;
121 QLIST_ENTRY(mon_fd_t) next;
124 typedef struct MonitorControl {
126 JSONMessageParser parser;
131 CharDriverState *chr;
136 uint8_t outbuf[1024];
141 BlockDriverCompletionFunc *password_completion_cb;
142 void *password_opaque;
143 #ifdef CONFIG_DEBUG_MONITOR
147 QLIST_HEAD(,mon_fd_t) fds;
148 QLIST_ENTRY(Monitor) entry;
151 #ifdef CONFIG_DEBUG_MONITOR
152 #define MON_DEBUG(fmt, ...) do { \
153 fprintf(stderr, "Monitor: "); \
154 fprintf(stderr, fmt, ## __VA_ARGS__); } while (0)
156 static inline void mon_print_count_inc(Monitor *mon)
158 mon->print_calls_nr++;
161 static inline void mon_print_count_init(Monitor *mon)
163 mon->print_calls_nr = 0;
166 static inline int mon_print_count_get(const Monitor *mon)
168 return mon->print_calls_nr;
171 #else /* !CONFIG_DEBUG_MONITOR */
172 #define MON_DEBUG(fmt, ...) do { } while (0)
173 static inline void mon_print_count_inc(Monitor *mon) { }
174 static inline void mon_print_count_init(Monitor *mon) { }
175 static inline int mon_print_count_get(const Monitor *mon) { return 0; }
176 #endif /* CONFIG_DEBUG_MONITOR */
178 static QLIST_HEAD(mon_list, Monitor) mon_list;
180 static const mon_cmd_t mon_cmds[];
181 static const mon_cmd_t info_cmds[];
184 Monitor *default_mon;
186 static void monitor_command_cb(Monitor *mon, const char *cmdline,
189 static inline int qmp_cmd_mode(const Monitor *mon)
191 return (mon->mc ? mon->mc->command_mode : 0);
194 /* Return true if in control mode, false otherwise */
195 static inline int monitor_ctrl_mode(const Monitor *mon)
197 return (mon->flags & MONITOR_USE_CONTROL);
200 /* Return non-zero iff we have a current monitor, and it is in QMP mode. */
201 int monitor_cur_is_qmp(void)
203 return cur_mon && monitor_ctrl_mode(cur_mon);
206 static void monitor_read_command(Monitor *mon, int show_prompt)
211 readline_start(mon->rs, "(qemu) ", 0, monitor_command_cb, NULL);
213 readline_show_prompt(mon->rs);
216 static int monitor_read_password(Monitor *mon, ReadLineFunc *readline_func,
219 if (monitor_ctrl_mode(mon)) {
220 qerror_report(QERR_MISSING_PARAMETER, "password");
222 } else if (mon->rs) {
223 readline_start(mon->rs, "Password: ", 1, readline_func, opaque);
224 /* prompt is printed on return from the command handler */
227 monitor_printf(mon, "terminal does not support password prompting\n");
232 void monitor_flush(Monitor *mon)
234 if (mon && mon->outbuf_index != 0 && !mon->mux_out) {
235 qemu_chr_write(mon->chr, mon->outbuf, mon->outbuf_index);
236 mon->outbuf_index = 0;
240 /* flush at every end of line or if the buffer is full */
241 static void monitor_puts(Monitor *mon, const char *str)
250 mon->outbuf[mon->outbuf_index++] = '\r';
251 mon->outbuf[mon->outbuf_index++] = c;
252 if (mon->outbuf_index >= (sizeof(mon->outbuf) - 1)
258 void monitor_vprintf(Monitor *mon, const char *fmt, va_list ap)
265 mon_print_count_inc(mon);
267 if (monitor_ctrl_mode(mon)) {
271 vsnprintf(buf, sizeof(buf), fmt, ap);
272 monitor_puts(mon, buf);
275 void monitor_printf(Monitor *mon, const char *fmt, ...)
279 monitor_vprintf(mon, fmt, ap);
283 void monitor_print_filename(Monitor *mon, const char *filename)
287 for (i = 0; filename[i]; i++) {
288 switch (filename[i]) {
292 monitor_printf(mon, "\\%c", filename[i]);
295 monitor_printf(mon, "\\t");
298 monitor_printf(mon, "\\r");
301 monitor_printf(mon, "\\n");
304 monitor_printf(mon, "%c", filename[i]);
310 static int monitor_fprintf(FILE *stream, const char *fmt, ...)
314 monitor_vprintf((Monitor *)stream, fmt, ap);
319 static void monitor_user_noop(Monitor *mon, const QObject *data) { }
321 static inline int monitor_handler_ported(const mon_cmd_t *cmd)
323 return cmd->user_print != NULL;
326 static inline bool monitor_handler_is_async(const mon_cmd_t *cmd)
328 return cmd->async != 0;
331 static inline int monitor_has_error(const Monitor *mon)
333 return mon->error != NULL;
336 static void monitor_json_emitter(Monitor *mon, const QObject *data)
340 json = qobject_to_json(data);
341 assert(json != NULL);
343 qstring_append_chr(json, '\n');
344 monitor_puts(mon, qstring_get_str(json));
349 static void monitor_protocol_emitter(Monitor *mon, QObject *data)
355 if (!monitor_has_error(mon)) {
356 /* success response */
358 qobject_incref(data);
359 qdict_put_obj(qmp, "return", data);
361 /* return an empty QDict by default */
362 qdict_put(qmp, "return", qdict_new());
366 qdict_put(mon->error->error, "desc", qerror_human(mon->error));
367 qdict_put(qmp, "error", mon->error->error);
368 QINCREF(mon->error->error);
374 qdict_put_obj(qmp, "id", mon->mc->id);
378 monitor_json_emitter(mon, QOBJECT(qmp));
382 static void timestamp_put(QDict *qdict)
388 err = qemu_gettimeofday(&tv);
392 obj = qobject_from_jsonf("{ 'seconds': %" PRId64 ", "
393 "'microseconds': %" PRId64 " }",
394 (int64_t) tv.tv_sec, (int64_t) tv.tv_usec);
395 qdict_put_obj(qdict, "timestamp", obj);
399 * monitor_protocol_event(): Generate a Monitor event
401 * Event-specific data can be emitted through the (optional) 'data' parameter.
403 void monitor_protocol_event(MonitorEvent event, QObject *data)
406 const char *event_name;
409 assert(event < QEVENT_MAX);
412 case QEVENT_SHUTDOWN:
413 event_name = "SHUTDOWN";
416 event_name = "RESET";
418 case QEVENT_POWERDOWN:
419 event_name = "POWERDOWN";
424 case QEVENT_VNC_CONNECTED:
425 event_name = "VNC_CONNECTED";
427 case QEVENT_VNC_INITIALIZED:
428 event_name = "VNC_INITIALIZED";
430 case QEVENT_VNC_DISCONNECTED:
431 event_name = "VNC_DISCONNECTED";
433 case QEVENT_BLOCK_IO_ERROR:
434 event_name = "BLOCK_IO_ERROR";
436 case QEVENT_RTC_CHANGE:
437 event_name = "RTC_CHANGE";
439 case QEVENT_WATCHDOG:
440 event_name = "WATCHDOG";
449 qdict_put(qmp, "event", qstring_from_str(event_name));
451 qobject_incref(data);
452 qdict_put_obj(qmp, "data", data);
455 QLIST_FOREACH(mon, &mon_list, entry) {
456 if (monitor_ctrl_mode(mon) && qmp_cmd_mode(mon)) {
457 monitor_json_emitter(mon, QOBJECT(qmp));
463 static int do_qmp_capabilities(Monitor *mon, const QDict *params,
466 /* Will setup QMP capabilities in the future */
467 if (monitor_ctrl_mode(mon)) {
468 mon->mc->command_mode = 1;
474 static int compare_cmd(const char *name, const char *list)
476 const char *p, *pstart;
484 p = pstart + strlen(pstart);
485 if ((p - pstart) == len && !memcmp(pstart, name, len))
494 static void help_cmd_dump(Monitor *mon, const mon_cmd_t *cmds,
495 const char *prefix, const char *name)
497 const mon_cmd_t *cmd;
499 for(cmd = cmds; cmd->name != NULL; cmd++) {
500 if (!name || !strcmp(name, cmd->name))
501 monitor_printf(mon, "%s%s %s -- %s\n", prefix, cmd->name,
502 cmd->params, cmd->help);
506 static void help_cmd(Monitor *mon, const char *name)
508 if (name && !strcmp(name, "info")) {
509 help_cmd_dump(mon, info_cmds, "info ", NULL);
511 help_cmd_dump(mon, mon_cmds, "", name);
512 if (name && !strcmp(name, "log")) {
513 const CPULogItem *item;
514 monitor_printf(mon, "Log items (comma separated):\n");
515 monitor_printf(mon, "%-10s %s\n", "none", "remove all logs");
516 for(item = cpu_log_items; item->mask != 0; item++) {
517 monitor_printf(mon, "%-10s %s\n", item->name, item->help);
523 static void do_help_cmd(Monitor *mon, const QDict *qdict)
525 help_cmd(mon, qdict_get_try_str(qdict, "name"));
528 static void do_commit(Monitor *mon, const QDict *qdict)
532 const char *device = qdict_get_str(qdict, "device");
534 all_devices = !strcmp(device, "all");
535 QTAILQ_FOREACH(dinfo, &drives, next) {
537 if (strcmp(bdrv_get_device_name(dinfo->bdrv), device))
539 bdrv_commit(dinfo->bdrv);
543 static void user_monitor_complete(void *opaque, QObject *ret_data)
545 MonitorCompletionData *data = (MonitorCompletionData *)opaque;
548 data->user_print(data->mon, ret_data);
550 monitor_resume(data->mon);
554 static void qmp_monitor_complete(void *opaque, QObject *ret_data)
556 monitor_protocol_emitter(opaque, ret_data);
559 static void qmp_async_cmd_handler(Monitor *mon, const mon_cmd_t *cmd,
562 cmd->mhandler.cmd_async(mon, params, qmp_monitor_complete, mon);
565 static void qmp_async_info_handler(Monitor *mon, const mon_cmd_t *cmd)
567 cmd->mhandler.info_async(mon, qmp_monitor_complete, mon);
570 static void user_async_cmd_handler(Monitor *mon, const mon_cmd_t *cmd,
575 MonitorCompletionData *cb_data = qemu_malloc(sizeof(*cb_data));
577 cb_data->user_print = cmd->user_print;
578 monitor_suspend(mon);
579 ret = cmd->mhandler.cmd_async(mon, params,
580 user_monitor_complete, cb_data);
587 static void user_async_info_handler(Monitor *mon, const mon_cmd_t *cmd)
591 MonitorCompletionData *cb_data = qemu_malloc(sizeof(*cb_data));
593 cb_data->user_print = cmd->user_print;
594 monitor_suspend(mon);
595 ret = cmd->mhandler.info_async(mon, user_monitor_complete, cb_data);
602 static int do_info(Monitor *mon, const QDict *qdict, QObject **ret_data)
604 const mon_cmd_t *cmd;
605 const char *item = qdict_get_try_str(qdict, "item");
608 assert(monitor_ctrl_mode(mon) == 0);
612 for (cmd = info_cmds; cmd->name != NULL; cmd++) {
613 if (compare_cmd(item, cmd->name))
617 if (cmd->name == NULL) {
618 if (monitor_ctrl_mode(mon)) {
619 qerror_report(QERR_COMMAND_NOT_FOUND, item);
625 if (monitor_handler_is_async(cmd)) {
626 if (monitor_ctrl_mode(mon)) {
627 qmp_async_info_handler(mon, cmd);
629 user_async_info_handler(mon, cmd);
632 * Indicate that this command is asynchronous and will not return any
633 * data (not even empty). Instead, the data will be returned via a
634 * completion callback.
636 *ret_data = qobject_from_jsonf("{ '__mon_async': 'return' }");
637 } else if (monitor_handler_ported(cmd)) {
638 cmd->mhandler.info_new(mon, ret_data);
640 if (!monitor_ctrl_mode(mon)) {
642 * User Protocol function is called here, Monitor Protocol is
643 * handled by monitor_call_handler()
646 cmd->user_print(mon, *ret_data);
649 if (monitor_ctrl_mode(mon)) {
650 /* handler not converted yet */
651 qerror_report(QERR_COMMAND_NOT_FOUND, item);
654 cmd->mhandler.info(mon);
661 help_cmd(mon, "info");
665 static void do_info_version_print(Monitor *mon, const QObject *data)
669 qdict = qobject_to_qdict(data);
671 monitor_printf(mon, "%s%s\n", qdict_get_str(qdict, "qemu"),
672 qdict_get_str(qdict, "package"));
676 * do_info_version(): Show QEMU version
678 * Return a QDict with the following information:
680 * - "qemu": QEMU's version
681 * - "package": package's version
685 * { "qemu": "0.11.50", "package": "" }
687 static void do_info_version(Monitor *mon, QObject **ret_data)
689 *ret_data = qobject_from_jsonf("{ 'qemu': %s, 'package': %s }",
690 QEMU_VERSION, QEMU_PKGVERSION);
693 static void do_info_name_print(Monitor *mon, const QObject *data)
697 qdict = qobject_to_qdict(data);
698 if (qdict_size(qdict) == 0) {
702 monitor_printf(mon, "%s\n", qdict_get_str(qdict, "name"));
706 * do_info_name(): Show VM name
708 * Return a QDict with the following information:
710 * - "name": VM's name (optional)
714 * { "name": "qemu-name" }
716 static void do_info_name(Monitor *mon, QObject **ret_data)
718 *ret_data = qemu_name ? qobject_from_jsonf("{'name': %s }", qemu_name) :
719 qobject_from_jsonf("{}");
722 static QObject *get_cmd_dict(const char *name)
726 /* Remove '|' from some commands */
727 p = strchr(name, '|');
734 return qobject_from_jsonf("{ 'name': %s }", p);
738 * do_info_commands(): List QMP available commands
740 * Each command is represented by a QDict, the returned QObject is a QList
743 * The QDict contains:
745 * - "name": command's name
749 * { [ { "name": "query-balloon" }, { "name": "system_powerdown" } ] }
751 static void do_info_commands(Monitor *mon, QObject **ret_data)
754 const mon_cmd_t *cmd;
756 cmd_list = qlist_new();
758 for (cmd = mon_cmds; cmd->name != NULL; cmd++) {
759 if (monitor_handler_ported(cmd) && !compare_cmd(cmd->name, "info")) {
760 qlist_append_obj(cmd_list, get_cmd_dict(cmd->name));
764 for (cmd = info_cmds; cmd->name != NULL; cmd++) {
765 if (monitor_handler_ported(cmd)) {
767 snprintf(buf, sizeof(buf), "query-%s", cmd->name);
768 qlist_append_obj(cmd_list, get_cmd_dict(buf));
772 *ret_data = QOBJECT(cmd_list);
775 #if defined(TARGET_I386)
776 static void do_info_hpet_print(Monitor *mon, const QObject *data)
778 monitor_printf(mon, "HPET is %s by QEMU\n",
779 qdict_get_bool(qobject_to_qdict(data), "enabled") ?
780 "enabled" : "disabled");
784 * do_info_hpet(): Show HPET state
786 * Return a QDict with the following information:
788 * - "enabled": true if hpet if enabled, false otherwise
792 * { "enabled": true }
794 static void do_info_hpet(Monitor *mon, QObject **ret_data)
796 *ret_data = qobject_from_jsonf("{ 'enabled': %i }", !no_hpet);
800 static void do_info_uuid_print(Monitor *mon, const QObject *data)
802 monitor_printf(mon, "%s\n", qdict_get_str(qobject_to_qdict(data), "UUID"));
806 * do_info_uuid(): Show VM UUID
808 * Return a QDict with the following information:
810 * - "UUID": Universally Unique Identifier
814 * { "UUID": "550e8400-e29b-41d4-a716-446655440000" }
816 static void do_info_uuid(Monitor *mon, QObject **ret_data)
820 snprintf(uuid, sizeof(uuid), UUID_FMT, qemu_uuid[0], qemu_uuid[1],
821 qemu_uuid[2], qemu_uuid[3], qemu_uuid[4], qemu_uuid[5],
822 qemu_uuid[6], qemu_uuid[7], qemu_uuid[8], qemu_uuid[9],
823 qemu_uuid[10], qemu_uuid[11], qemu_uuid[12], qemu_uuid[13],
824 qemu_uuid[14], qemu_uuid[15]);
825 *ret_data = qobject_from_jsonf("{ 'UUID': %s }", uuid);
828 /* get the current CPU defined by the user */
829 static int mon_set_cpu(int cpu_index)
833 for(env = first_cpu; env != NULL; env = env->next_cpu) {
834 if (env->cpu_index == cpu_index) {
835 cur_mon->mon_cpu = env;
842 static CPUState *mon_get_cpu(void)
844 if (!cur_mon->mon_cpu) {
847 cpu_synchronize_state(cur_mon->mon_cpu);
848 return cur_mon->mon_cpu;
851 static void do_info_registers(Monitor *mon)
856 cpu_dump_state(env, (FILE *)mon, monitor_fprintf,
859 cpu_dump_state(env, (FILE *)mon, monitor_fprintf,
864 static void print_cpu_iter(QObject *obj, void *opaque)
868 Monitor *mon = opaque;
870 assert(qobject_type(obj) == QTYPE_QDICT);
871 cpu = qobject_to_qdict(obj);
873 if (qdict_get_bool(cpu, "current")) {
877 monitor_printf(mon, "%c CPU #%d: ", active, (int)qdict_get_int(cpu, "CPU"));
879 #if defined(TARGET_I386)
880 monitor_printf(mon, "pc=0x" TARGET_FMT_lx,
881 (target_ulong) qdict_get_int(cpu, "pc"));
882 #elif defined(TARGET_PPC)
883 monitor_printf(mon, "nip=0x" TARGET_FMT_lx,
884 (target_long) qdict_get_int(cpu, "nip"));
885 #elif defined(TARGET_SPARC)
886 monitor_printf(mon, "pc=0x " TARGET_FMT_lx,
887 (target_long) qdict_get_int(cpu, "pc"));
888 monitor_printf(mon, "npc=0x" TARGET_FMT_lx,
889 (target_long) qdict_get_int(cpu, "npc"));
890 #elif defined(TARGET_MIPS)
891 monitor_printf(mon, "PC=0x" TARGET_FMT_lx,
892 (target_long) qdict_get_int(cpu, "PC"));
895 if (qdict_get_bool(cpu, "halted")) {
896 monitor_printf(mon, " (halted)");
899 monitor_printf(mon, "\n");
902 static void monitor_print_cpus(Monitor *mon, const QObject *data)
906 assert(qobject_type(data) == QTYPE_QLIST);
907 cpu_list = qobject_to_qlist(data);
908 qlist_iter(cpu_list, print_cpu_iter, mon);
912 * do_info_cpus(): Show CPU information
914 * Return a QList. Each CPU is represented by a QDict, which contains:
917 * - "current": true if this is the current CPU, false otherwise
918 * - "halted": true if the cpu is halted, false otherwise
919 * - Current program counter. The key's name depends on the architecture:
922 * "pc" and "npc": sparc
927 * [ { "CPU": 0, "current": true, "halted": false, "pc": 3227107138 },
928 * { "CPU": 1, "current": false, "halted": true, "pc": 7108165 } ]
930 static void do_info_cpus(Monitor *mon, QObject **ret_data)
935 cpu_list = qlist_new();
937 /* just to set the default cpu if not already done */
940 for(env = first_cpu; env != NULL; env = env->next_cpu) {
944 cpu_synchronize_state(env);
946 obj = qobject_from_jsonf("{ 'CPU': %d, 'current': %i, 'halted': %i }",
947 env->cpu_index, env == mon->mon_cpu,
950 cpu = qobject_to_qdict(obj);
952 #if defined(TARGET_I386)
953 qdict_put(cpu, "pc", qint_from_int(env->eip + env->segs[R_CS].base));
954 #elif defined(TARGET_PPC)
955 qdict_put(cpu, "nip", qint_from_int(env->nip));
956 #elif defined(TARGET_SPARC)
957 qdict_put(cpu, "pc", qint_from_int(env->pc));
958 qdict_put(cpu, "npc", qint_from_int(env->npc));
959 #elif defined(TARGET_MIPS)
960 qdict_put(cpu, "PC", qint_from_int(env->active_tc.PC));
963 qlist_append(cpu_list, cpu);
966 *ret_data = QOBJECT(cpu_list);
969 static int do_cpu_set(Monitor *mon, const QDict *qdict, QObject **ret_data)
971 int index = qdict_get_int(qdict, "index");
972 if (mon_set_cpu(index) < 0) {
973 qerror_report(QERR_INVALID_PARAMETER, "index");
979 static void do_info_jit(Monitor *mon)
981 dump_exec_info((FILE *)mon, monitor_fprintf);
984 static void do_info_history(Monitor *mon)
993 str = readline_get_history(mon->rs, i);
996 monitor_printf(mon, "%d: '%s'\n", i, str);
1001 #if defined(TARGET_PPC)
1002 /* XXX: not implemented in other targets */
1003 static void do_info_cpu_stats(Monitor *mon)
1007 env = mon_get_cpu();
1008 cpu_dump_statistics(env, (FILE *)mon, &monitor_fprintf, 0);
1013 * do_quit(): Quit QEMU execution
1015 static int do_quit(Monitor *mon, const QDict *qdict, QObject **ret_data)
1021 static int eject_device(Monitor *mon, BlockDriverState *bs, int force)
1023 if (bdrv_is_inserted(bs)) {
1025 if (!bdrv_is_removable(bs)) {
1026 qerror_report(QERR_DEVICE_NOT_REMOVABLE,
1027 bdrv_get_device_name(bs));
1030 if (bdrv_is_locked(bs)) {
1031 qerror_report(QERR_DEVICE_LOCKED, bdrv_get_device_name(bs));
1040 static int do_eject(Monitor *mon, const QDict *qdict, QObject **ret_data)
1042 BlockDriverState *bs;
1043 int force = qdict_get_int(qdict, "force");
1044 const char *filename = qdict_get_str(qdict, "device");
1046 bs = bdrv_find(filename);
1048 qerror_report(QERR_DEVICE_NOT_FOUND, filename);
1051 return eject_device(mon, bs, force);
1054 static int do_block_set_passwd(Monitor *mon, const QDict *qdict,
1057 BlockDriverState *bs;
1060 bs = bdrv_find(qdict_get_str(qdict, "device"));
1062 qerror_report(QERR_DEVICE_NOT_FOUND, qdict_get_str(qdict, "device"));
1066 err = bdrv_set_key(bs, qdict_get_str(qdict, "password"));
1067 if (err == -EINVAL) {
1068 qerror_report(QERR_DEVICE_NOT_ENCRYPTED, bdrv_get_device_name(bs));
1070 } else if (err < 0) {
1071 qerror_report(QERR_INVALID_PASSWORD);
1078 static int do_change_block(Monitor *mon, const char *device,
1079 const char *filename, const char *fmt)
1081 BlockDriverState *bs;
1082 BlockDriver *drv = NULL;
1084 bs = bdrv_find(device);
1086 qerror_report(QERR_DEVICE_NOT_FOUND, device);
1090 drv = bdrv_find_whitelisted_format(fmt);
1092 qerror_report(QERR_INVALID_BLOCK_FORMAT, fmt);
1096 if (eject_device(mon, bs, 0) < 0) {
1099 if (bdrv_open2(bs, filename, BDRV_O_RDWR, drv) < 0) {
1102 return monitor_read_bdrv_key_start(mon, bs, NULL, NULL);
1105 static int change_vnc_password(const char *password)
1107 if (vnc_display_password(NULL, password) < 0) {
1108 qerror_report(QERR_SET_PASSWD_FAILED);
1115 static void change_vnc_password_cb(Monitor *mon, const char *password,
1118 change_vnc_password(password);
1119 monitor_read_command(mon, 1);
1122 static int do_change_vnc(Monitor *mon, const char *target, const char *arg)
1124 if (strcmp(target, "passwd") == 0 ||
1125 strcmp(target, "password") == 0) {
1128 strncpy(password, arg, sizeof(password));
1129 password[sizeof(password) - 1] = '\0';
1130 return change_vnc_password(password);
1132 return monitor_read_password(mon, change_vnc_password_cb, NULL);
1135 if (vnc_display_open(NULL, target) < 0) {
1136 qerror_report(QERR_VNC_SERVER_FAILED, target);
1145 * do_change(): Change a removable medium, or VNC configuration
1147 static int do_change(Monitor *mon, const QDict *qdict, QObject **ret_data)
1149 const char *device = qdict_get_str(qdict, "device");
1150 const char *target = qdict_get_str(qdict, "target");
1151 const char *arg = qdict_get_try_str(qdict, "arg");
1154 if (strcmp(device, "vnc") == 0) {
1155 ret = do_change_vnc(mon, target, arg);
1157 ret = do_change_block(mon, device, target, arg);
1163 static void do_screen_dump(Monitor *mon, const QDict *qdict)
1165 vga_hw_screen_dump(qdict_get_str(qdict, "filename"));
1168 static void do_logfile(Monitor *mon, const QDict *qdict)
1170 cpu_set_log_filename(qdict_get_str(qdict, "filename"));
1173 static void do_log(Monitor *mon, const QDict *qdict)
1176 const char *items = qdict_get_str(qdict, "items");
1178 if (!strcmp(items, "none")) {
1181 mask = cpu_str_to_log_mask(items);
1183 help_cmd(mon, "log");
1190 static void do_singlestep(Monitor *mon, const QDict *qdict)
1192 const char *option = qdict_get_try_str(qdict, "option");
1193 if (!option || !strcmp(option, "on")) {
1195 } else if (!strcmp(option, "off")) {
1198 monitor_printf(mon, "unexpected option %s\n", option);
1203 * do_stop(): Stop VM execution
1205 static int do_stop(Monitor *mon, const QDict *qdict, QObject **ret_data)
1207 vm_stop(EXCP_INTERRUPT);
1211 static void encrypted_bdrv_it(void *opaque, BlockDriverState *bs);
1213 struct bdrv_iterate_context {
1219 * do_cont(): Resume emulation.
1221 static int do_cont(Monitor *mon, const QDict *qdict, QObject **ret_data)
1223 struct bdrv_iterate_context context = { mon, 0 };
1225 bdrv_iterate(encrypted_bdrv_it, &context);
1226 /* only resume the vm if all keys are set and valid */
1235 static void bdrv_key_cb(void *opaque, int err)
1237 Monitor *mon = opaque;
1239 /* another key was set successfully, retry to continue */
1241 do_cont(mon, NULL, NULL);
1244 static void encrypted_bdrv_it(void *opaque, BlockDriverState *bs)
1246 struct bdrv_iterate_context *context = opaque;
1248 if (!context->err && bdrv_key_required(bs)) {
1249 context->err = -EBUSY;
1250 monitor_read_bdrv_key_start(context->mon, bs, bdrv_key_cb,
1255 static void do_gdbserver(Monitor *mon, const QDict *qdict)
1257 const char *device = qdict_get_try_str(qdict, "device");
1259 device = "tcp::" DEFAULT_GDBSTUB_PORT;
1260 if (gdbserver_start(device) < 0) {
1261 monitor_printf(mon, "Could not open gdbserver on device '%s'\n",
1263 } else if (strcmp(device, "none") == 0) {
1264 monitor_printf(mon, "Disabled gdbserver\n");
1266 monitor_printf(mon, "Waiting for gdb connection on device '%s'\n",
1271 static void do_watchdog_action(Monitor *mon, const QDict *qdict)
1273 const char *action = qdict_get_str(qdict, "action");
1274 if (select_watchdog_action(action) == -1) {
1275 monitor_printf(mon, "Unknown watchdog action '%s'\n", action);
1279 static void monitor_printc(Monitor *mon, int c)
1281 monitor_printf(mon, "'");
1284 monitor_printf(mon, "\\'");
1287 monitor_printf(mon, "\\\\");
1290 monitor_printf(mon, "\\n");
1293 monitor_printf(mon, "\\r");
1296 if (c >= 32 && c <= 126) {
1297 monitor_printf(mon, "%c", c);
1299 monitor_printf(mon, "\\x%02x", c);
1303 monitor_printf(mon, "'");
1306 static void memory_dump(Monitor *mon, int count, int format, int wsize,
1307 target_phys_addr_t addr, int is_physical)
1310 int l, line_size, i, max_digits, len;
1314 if (format == 'i') {
1317 env = mon_get_cpu();
1321 } else if (wsize == 4) {
1324 /* as default we use the current CS size */
1327 #ifdef TARGET_X86_64
1328 if ((env->efer & MSR_EFER_LMA) &&
1329 (env->segs[R_CS].flags & DESC_L_MASK))
1333 if (!(env->segs[R_CS].flags & DESC_B_MASK))
1338 monitor_disas(mon, env, addr, count, is_physical, flags);
1342 len = wsize * count;
1351 max_digits = (wsize * 8 + 2) / 3;
1355 max_digits = (wsize * 8) / 4;
1359 max_digits = (wsize * 8 * 10 + 32) / 33;
1368 monitor_printf(mon, TARGET_FMT_plx ":", addr);
1370 monitor_printf(mon, TARGET_FMT_lx ":", (target_ulong)addr);
1375 cpu_physical_memory_rw(addr, buf, l, 0);
1377 env = mon_get_cpu();
1378 if (cpu_memory_rw_debug(env, addr, buf, l, 0) < 0) {
1379 monitor_printf(mon, " Cannot access memory\n");
1388 v = ldub_raw(buf + i);
1391 v = lduw_raw(buf + i);
1394 v = (uint32_t)ldl_raw(buf + i);
1397 v = ldq_raw(buf + i);
1400 monitor_printf(mon, " ");
1403 monitor_printf(mon, "%#*" PRIo64, max_digits, v);
1406 monitor_printf(mon, "0x%0*" PRIx64, max_digits, v);
1409 monitor_printf(mon, "%*" PRIu64, max_digits, v);
1412 monitor_printf(mon, "%*" PRId64, max_digits, v);
1415 monitor_printc(mon, v);
1420 monitor_printf(mon, "\n");
1426 static void do_memory_dump(Monitor *mon, const QDict *qdict)
1428 int count = qdict_get_int(qdict, "count");
1429 int format = qdict_get_int(qdict, "format");
1430 int size = qdict_get_int(qdict, "size");
1431 target_long addr = qdict_get_int(qdict, "addr");
1433 memory_dump(mon, count, format, size, addr, 0);
1436 static void do_physical_memory_dump(Monitor *mon, const QDict *qdict)
1438 int count = qdict_get_int(qdict, "count");
1439 int format = qdict_get_int(qdict, "format");
1440 int size = qdict_get_int(qdict, "size");
1441 target_phys_addr_t addr = qdict_get_int(qdict, "addr");
1443 memory_dump(mon, count, format, size, addr, 1);
1446 static void do_print(Monitor *mon, const QDict *qdict)
1448 int format = qdict_get_int(qdict, "format");
1449 target_phys_addr_t val = qdict_get_int(qdict, "val");
1451 #if TARGET_PHYS_ADDR_BITS == 32
1454 monitor_printf(mon, "%#o", val);
1457 monitor_printf(mon, "%#x", val);
1460 monitor_printf(mon, "%u", val);
1464 monitor_printf(mon, "%d", val);
1467 monitor_printc(mon, val);
1473 monitor_printf(mon, "%#" PRIo64, val);
1476 monitor_printf(mon, "%#" PRIx64, val);
1479 monitor_printf(mon, "%" PRIu64, val);
1483 monitor_printf(mon, "%" PRId64, val);
1486 monitor_printc(mon, val);
1490 monitor_printf(mon, "\n");
1493 static int do_memory_save(Monitor *mon, const QDict *qdict, QObject **ret_data)
1496 uint32_t size = qdict_get_int(qdict, "size");
1497 const char *filename = qdict_get_str(qdict, "filename");
1498 target_long addr = qdict_get_int(qdict, "val");
1504 env = mon_get_cpu();
1506 f = fopen(filename, "wb");
1508 qerror_report(QERR_OPEN_FILE_FAILED, filename);
1515 cpu_memory_rw_debug(env, addr, buf, l, 0);
1516 if (fwrite(buf, 1, l, f) != l) {
1517 monitor_printf(mon, "fwrite() error in do_memory_save\n");
1531 static int do_physical_memory_save(Monitor *mon, const QDict *qdict,
1537 uint32_t size = qdict_get_int(qdict, "size");
1538 const char *filename = qdict_get_str(qdict, "filename");
1539 target_phys_addr_t addr = qdict_get_int(qdict, "val");
1542 f = fopen(filename, "wb");
1544 qerror_report(QERR_OPEN_FILE_FAILED, filename);
1551 cpu_physical_memory_rw(addr, buf, l, 0);
1552 if (fwrite(buf, 1, l, f) != l) {
1553 monitor_printf(mon, "fwrite() error in do_physical_memory_save\n");
1568 static void do_sum(Monitor *mon, const QDict *qdict)
1573 uint32_t start = qdict_get_int(qdict, "start");
1574 uint32_t size = qdict_get_int(qdict, "size");
1577 for(addr = start; addr < (start + size); addr++) {
1578 cpu_physical_memory_rw(addr, buf, 1, 0);
1579 /* BSD sum algorithm ('sum' Unix command) */
1580 sum = (sum >> 1) | (sum << 15);
1583 monitor_printf(mon, "%05d\n", sum);
1591 static const KeyDef key_defs[] = {
1593 { 0x36, "shift_r" },
1598 { 0xe4, "altgr_r" },
1618 { 0x0e, "backspace" },
1655 { 0x37, "asterisk" },
1658 { 0x3a, "caps_lock" },
1669 { 0x45, "num_lock" },
1670 { 0x46, "scroll_lock" },
1672 { 0xb5, "kp_divide" },
1673 { 0x37, "kp_multiply" },
1674 { 0x4a, "kp_subtract" },
1676 { 0x9c, "kp_enter" },
1677 { 0x53, "kp_decimal" },
1710 #if defined(TARGET_SPARC) && !defined(TARGET_SPARC64)
1725 { 0xfe, "compose" },
1730 static int get_keycode(const char *key)
1736 for(p = key_defs; p->name != NULL; p++) {
1737 if (!strcmp(key, p->name))
1740 if (strstart(key, "0x", NULL)) {
1741 ret = strtoul(key, &endp, 0);
1742 if (*endp == '\0' && ret >= 0x01 && ret <= 0xff)
1748 #define MAX_KEYCODES 16
1749 static uint8_t keycodes[MAX_KEYCODES];
1750 static int nb_pending_keycodes;
1751 static QEMUTimer *key_timer;
1753 static void release_keys(void *opaque)
1757 while (nb_pending_keycodes > 0) {
1758 nb_pending_keycodes--;
1759 keycode = keycodes[nb_pending_keycodes];
1761 kbd_put_keycode(0xe0);
1762 kbd_put_keycode(keycode | 0x80);
1766 static void do_sendkey(Monitor *mon, const QDict *qdict)
1768 char keyname_buf[16];
1770 int keyname_len, keycode, i;
1771 const char *string = qdict_get_str(qdict, "string");
1772 int has_hold_time = qdict_haskey(qdict, "hold_time");
1773 int hold_time = qdict_get_try_int(qdict, "hold_time", -1);
1775 if (nb_pending_keycodes > 0) {
1776 qemu_del_timer(key_timer);
1783 separator = strchr(string, '-');
1784 keyname_len = separator ? separator - string : strlen(string);
1785 if (keyname_len > 0) {
1786 pstrcpy(keyname_buf, sizeof(keyname_buf), string);
1787 if (keyname_len > sizeof(keyname_buf) - 1) {
1788 monitor_printf(mon, "invalid key: '%s...'\n", keyname_buf);
1791 if (i == MAX_KEYCODES) {
1792 monitor_printf(mon, "too many keys\n");
1795 keyname_buf[keyname_len] = 0;
1796 keycode = get_keycode(keyname_buf);
1798 monitor_printf(mon, "unknown key: '%s'\n", keyname_buf);
1801 keycodes[i++] = keycode;
1805 string = separator + 1;
1807 nb_pending_keycodes = i;
1808 /* key down events */
1809 for (i = 0; i < nb_pending_keycodes; i++) {
1810 keycode = keycodes[i];
1812 kbd_put_keycode(0xe0);
1813 kbd_put_keycode(keycode & 0x7f);
1815 /* delayed key up events */
1816 qemu_mod_timer(key_timer, qemu_get_clock(vm_clock) +
1817 muldiv64(get_ticks_per_sec(), hold_time, 1000));
1820 static int mouse_button_state;
1822 static void do_mouse_move(Monitor *mon, const QDict *qdict)
1825 const char *dx_str = qdict_get_str(qdict, "dx_str");
1826 const char *dy_str = qdict_get_str(qdict, "dy_str");
1827 const char *dz_str = qdict_get_try_str(qdict, "dz_str");
1828 dx = strtol(dx_str, NULL, 0);
1829 dy = strtol(dy_str, NULL, 0);
1832 dz = strtol(dz_str, NULL, 0);
1833 kbd_mouse_event(dx, dy, dz, mouse_button_state);
1836 static void do_mouse_button(Monitor *mon, const QDict *qdict)
1838 int button_state = qdict_get_int(qdict, "button_state");
1839 mouse_button_state = button_state;
1840 kbd_mouse_event(0, 0, 0, mouse_button_state);
1843 static void do_ioport_read(Monitor *mon, const QDict *qdict)
1845 int size = qdict_get_int(qdict, "size");
1846 int addr = qdict_get_int(qdict, "addr");
1847 int has_index = qdict_haskey(qdict, "index");
1852 int index = qdict_get_int(qdict, "index");
1853 cpu_outb(addr & IOPORTS_MASK, index & 0xff);
1861 val = cpu_inb(addr);
1865 val = cpu_inw(addr);
1869 val = cpu_inl(addr);
1873 monitor_printf(mon, "port%c[0x%04x] = %#0*x\n",
1874 suffix, addr, size * 2, val);
1877 static void do_ioport_write(Monitor *mon, const QDict *qdict)
1879 int size = qdict_get_int(qdict, "size");
1880 int addr = qdict_get_int(qdict, "addr");
1881 int val = qdict_get_int(qdict, "val");
1883 addr &= IOPORTS_MASK;
1888 cpu_outb(addr, val);
1891 cpu_outw(addr, val);
1894 cpu_outl(addr, val);
1899 static void do_boot_set(Monitor *mon, const QDict *qdict)
1902 const char *bootdevice = qdict_get_str(qdict, "bootdevice");
1904 res = qemu_boot_set(bootdevice);
1906 monitor_printf(mon, "boot device list now set to %s\n", bootdevice);
1907 } else if (res > 0) {
1908 monitor_printf(mon, "setting boot device list failed\n");
1910 monitor_printf(mon, "no function defined to set boot device list for "
1911 "this architecture\n");
1916 * do_system_reset(): Issue a machine reset
1918 static int do_system_reset(Monitor *mon, const QDict *qdict,
1921 qemu_system_reset_request();
1926 * do_system_powerdown(): Issue a machine powerdown
1928 static int do_system_powerdown(Monitor *mon, const QDict *qdict,
1931 qemu_system_powerdown_request();
1935 #if defined(TARGET_I386)
1936 static void print_pte(Monitor *mon, uint32_t addr, uint32_t pte, uint32_t mask)
1938 monitor_printf(mon, "%08x: %08x %c%c%c%c%c%c%c%c\n",
1941 pte & PG_GLOBAL_MASK ? 'G' : '-',
1942 pte & PG_PSE_MASK ? 'P' : '-',
1943 pte & PG_DIRTY_MASK ? 'D' : '-',
1944 pte & PG_ACCESSED_MASK ? 'A' : '-',
1945 pte & PG_PCD_MASK ? 'C' : '-',
1946 pte & PG_PWT_MASK ? 'T' : '-',
1947 pte & PG_USER_MASK ? 'U' : '-',
1948 pte & PG_RW_MASK ? 'W' : '-');
1951 static void tlb_info(Monitor *mon)
1955 uint32_t pgd, pde, pte;
1957 env = mon_get_cpu();
1959 if (!(env->cr[0] & CR0_PG_MASK)) {
1960 monitor_printf(mon, "PG disabled\n");
1963 pgd = env->cr[3] & ~0xfff;
1964 for(l1 = 0; l1 < 1024; l1++) {
1965 cpu_physical_memory_read(pgd + l1 * 4, (uint8_t *)&pde, 4);
1966 pde = le32_to_cpu(pde);
1967 if (pde & PG_PRESENT_MASK) {
1968 if ((pde & PG_PSE_MASK) && (env->cr[4] & CR4_PSE_MASK)) {
1969 print_pte(mon, (l1 << 22), pde, ~((1 << 20) - 1));
1971 for(l2 = 0; l2 < 1024; l2++) {
1972 cpu_physical_memory_read((pde & ~0xfff) + l2 * 4,
1973 (uint8_t *)&pte, 4);
1974 pte = le32_to_cpu(pte);
1975 if (pte & PG_PRESENT_MASK) {
1976 print_pte(mon, (l1 << 22) + (l2 << 12),
1986 static void mem_print(Monitor *mon, uint32_t *pstart, int *plast_prot,
1987 uint32_t end, int prot)
1990 prot1 = *plast_prot;
1991 if (prot != prot1) {
1992 if (*pstart != -1) {
1993 monitor_printf(mon, "%08x-%08x %08x %c%c%c\n",
1994 *pstart, end, end - *pstart,
1995 prot1 & PG_USER_MASK ? 'u' : '-',
1997 prot1 & PG_RW_MASK ? 'w' : '-');
2007 static void mem_info(Monitor *mon)
2010 int l1, l2, prot, last_prot;
2011 uint32_t pgd, pde, pte, start, end;
2013 env = mon_get_cpu();
2015 if (!(env->cr[0] & CR0_PG_MASK)) {
2016 monitor_printf(mon, "PG disabled\n");
2019 pgd = env->cr[3] & ~0xfff;
2022 for(l1 = 0; l1 < 1024; l1++) {
2023 cpu_physical_memory_read(pgd + l1 * 4, (uint8_t *)&pde, 4);
2024 pde = le32_to_cpu(pde);
2026 if (pde & PG_PRESENT_MASK) {
2027 if ((pde & PG_PSE_MASK) && (env->cr[4] & CR4_PSE_MASK)) {
2028 prot = pde & (PG_USER_MASK | PG_RW_MASK | PG_PRESENT_MASK);
2029 mem_print(mon, &start, &last_prot, end, prot);
2031 for(l2 = 0; l2 < 1024; l2++) {
2032 cpu_physical_memory_read((pde & ~0xfff) + l2 * 4,
2033 (uint8_t *)&pte, 4);
2034 pte = le32_to_cpu(pte);
2035 end = (l1 << 22) + (l2 << 12);
2036 if (pte & PG_PRESENT_MASK) {
2037 prot = pte & (PG_USER_MASK | PG_RW_MASK | PG_PRESENT_MASK);
2041 mem_print(mon, &start, &last_prot, end, prot);
2046 mem_print(mon, &start, &last_prot, end, prot);
2052 #if defined(TARGET_SH4)
2054 static void print_tlb(Monitor *mon, int idx, tlb_t *tlb)
2056 monitor_printf(mon, " tlb%i:\t"
2057 "asid=%hhu vpn=%x\tppn=%x\tsz=%hhu size=%u\t"
2058 "v=%hhu shared=%hhu cached=%hhu prot=%hhu "
2059 "dirty=%hhu writethrough=%hhu\n",
2061 tlb->asid, tlb->vpn, tlb->ppn, tlb->sz, tlb->size,
2062 tlb->v, tlb->sh, tlb->c, tlb->pr,
2066 static void tlb_info(Monitor *mon)
2068 CPUState *env = mon_get_cpu();
2071 monitor_printf (mon, "ITLB:\n");
2072 for (i = 0 ; i < ITLB_SIZE ; i++)
2073 print_tlb (mon, i, &env->itlb[i]);
2074 monitor_printf (mon, "UTLB:\n");
2075 for (i = 0 ; i < UTLB_SIZE ; i++)
2076 print_tlb (mon, i, &env->utlb[i]);
2081 static void do_info_kvm_print(Monitor *mon, const QObject *data)
2085 qdict = qobject_to_qdict(data);
2087 monitor_printf(mon, "kvm support: ");
2088 if (qdict_get_bool(qdict, "present")) {
2089 monitor_printf(mon, "%s\n", qdict_get_bool(qdict, "enabled") ?
2090 "enabled" : "disabled");
2092 monitor_printf(mon, "not compiled\n");
2097 * do_info_kvm(): Show KVM information
2099 * Return a QDict with the following information:
2101 * - "enabled": true if KVM support is enabled, false otherwise
2102 * - "present": true if QEMU has KVM support, false otherwise
2106 * { "enabled": true, "present": true }
2108 static void do_info_kvm(Monitor *mon, QObject **ret_data)
2111 *ret_data = qobject_from_jsonf("{ 'enabled': %i, 'present': true }",
2114 *ret_data = qobject_from_jsonf("{ 'enabled': false, 'present': false }");
2118 static void do_info_numa(Monitor *mon)
2123 monitor_printf(mon, "%d nodes\n", nb_numa_nodes);
2124 for (i = 0; i < nb_numa_nodes; i++) {
2125 monitor_printf(mon, "node %d cpus:", i);
2126 for (env = first_cpu; env != NULL; env = env->next_cpu) {
2127 if (env->numa_node == i) {
2128 monitor_printf(mon, " %d", env->cpu_index);
2131 monitor_printf(mon, "\n");
2132 monitor_printf(mon, "node %d size: %" PRId64 " MB\n", i,
2137 #ifdef CONFIG_PROFILER
2142 static void do_info_profile(Monitor *mon)
2148 monitor_printf(mon, "async time %" PRId64 " (%0.3f)\n",
2149 dev_time, dev_time / (double)get_ticks_per_sec());
2150 monitor_printf(mon, "qemu time %" PRId64 " (%0.3f)\n",
2151 qemu_time, qemu_time / (double)get_ticks_per_sec());
2156 static void do_info_profile(Monitor *mon)
2158 monitor_printf(mon, "Internal profiler not compiled\n");
2162 /* Capture support */
2163 static QLIST_HEAD (capture_list_head, CaptureState) capture_head;
2165 static void do_info_capture(Monitor *mon)
2170 for (s = capture_head.lh_first, i = 0; s; s = s->entries.le_next, ++i) {
2171 monitor_printf(mon, "[%d]: ", i);
2172 s->ops.info (s->opaque);
2177 static void do_stop_capture(Monitor *mon, const QDict *qdict)
2180 int n = qdict_get_int(qdict, "n");
2183 for (s = capture_head.lh_first, i = 0; s; s = s->entries.le_next, ++i) {
2185 s->ops.destroy (s->opaque);
2186 QLIST_REMOVE (s, entries);
2193 static void do_wav_capture(Monitor *mon, const QDict *qdict)
2195 const char *path = qdict_get_str(qdict, "path");
2196 int has_freq = qdict_haskey(qdict, "freq");
2197 int freq = qdict_get_try_int(qdict, "freq", -1);
2198 int has_bits = qdict_haskey(qdict, "bits");
2199 int bits = qdict_get_try_int(qdict, "bits", -1);
2200 int has_channels = qdict_haskey(qdict, "nchannels");
2201 int nchannels = qdict_get_try_int(qdict, "nchannels", -1);
2204 s = qemu_mallocz (sizeof (*s));
2206 freq = has_freq ? freq : 44100;
2207 bits = has_bits ? bits : 16;
2208 nchannels = has_channels ? nchannels : 2;
2210 if (wav_start_capture (s, path, freq, bits, nchannels)) {
2211 monitor_printf(mon, "Faied to add wave capture\n");
2214 QLIST_INSERT_HEAD (&capture_head, s, entries);
2218 #if defined(TARGET_I386)
2219 static void do_inject_nmi(Monitor *mon, const QDict *qdict)
2222 int cpu_index = qdict_get_int(qdict, "cpu_index");
2224 for (env = first_cpu; env != NULL; env = env->next_cpu)
2225 if (env->cpu_index == cpu_index) {
2226 cpu_interrupt(env, CPU_INTERRUPT_NMI);
2232 static void do_info_status_print(Monitor *mon, const QObject *data)
2236 qdict = qobject_to_qdict(data);
2238 monitor_printf(mon, "VM status: ");
2239 if (qdict_get_bool(qdict, "running")) {
2240 monitor_printf(mon, "running");
2241 if (qdict_get_bool(qdict, "singlestep")) {
2242 monitor_printf(mon, " (single step mode)");
2245 monitor_printf(mon, "paused");
2248 monitor_printf(mon, "\n");
2252 * do_info_status(): VM status
2254 * Return a QDict with the following information:
2256 * - "running": true if the VM is running, or false if it is paused
2257 * - "singlestep": true if the VM is in single step mode, false otherwise
2261 * { "running": true, "singlestep": false }
2263 static void do_info_status(Monitor *mon, QObject **ret_data)
2265 *ret_data = qobject_from_jsonf("{ 'running': %i, 'singlestep': %i }",
2266 vm_running, singlestep);
2269 static void print_balloon_stat(const char *key, QObject *obj, void *opaque)
2271 Monitor *mon = opaque;
2273 if (strcmp(key, "actual"))
2274 monitor_printf(mon, ",%s=%" PRId64, key,
2275 qint_get_int(qobject_to_qint(obj)));
2278 static void monitor_print_balloon(Monitor *mon, const QObject *data)
2282 qdict = qobject_to_qdict(data);
2283 if (!qdict_haskey(qdict, "actual"))
2286 monitor_printf(mon, "balloon: actual=%" PRId64,
2287 qdict_get_int(qdict, "actual") >> 20);
2288 qdict_iter(qdict, print_balloon_stat, mon);
2289 monitor_printf(mon, "\n");
2293 * do_info_balloon(): Balloon information
2295 * Make an asynchronous request for balloon info. When the request completes
2296 * a QDict will be returned according to the following specification:
2298 * - "actual": current balloon value in bytes
2299 * The following fields may or may not be present:
2300 * - "mem_swapped_in": Amount of memory swapped in (bytes)
2301 * - "mem_swapped_out": Amount of memory swapped out (bytes)
2302 * - "major_page_faults": Number of major faults
2303 * - "minor_page_faults": Number of minor faults
2304 * - "free_mem": Total amount of free and unused memory (bytes)
2305 * - "total_mem": Total amount of available memory (bytes)
2309 * { "actual": 1073741824, "mem_swapped_in": 0, "mem_swapped_out": 0,
2310 * "major_page_faults": 142, "minor_page_faults": 239245,
2311 * "free_mem": 1014185984, "total_mem": 1044668416 }
2313 static int do_info_balloon(Monitor *mon, MonitorCompletion cb, void *opaque)
2317 if (kvm_enabled() && !kvm_has_sync_mmu()) {
2318 qerror_report(QERR_KVM_MISSING_CAP, "synchronous MMU", "balloon");
2322 ret = qemu_balloon_status(cb, opaque);
2324 qerror_report(QERR_DEVICE_NOT_ACTIVE, "balloon");
2332 * do_balloon(): Request VM to change its memory allocation
2334 static int do_balloon(Monitor *mon, const QDict *params,
2335 MonitorCompletion cb, void *opaque)
2339 if (kvm_enabled() && !kvm_has_sync_mmu()) {
2340 qerror_report(QERR_KVM_MISSING_CAP, "synchronous MMU", "balloon");
2344 ret = qemu_balloon(qdict_get_int(params, "value"), cb, opaque);
2346 qerror_report(QERR_DEVICE_NOT_ACTIVE, "balloon");
2354 static qemu_acl *find_acl(Monitor *mon, const char *name)
2356 qemu_acl *acl = qemu_acl_find(name);
2359 monitor_printf(mon, "acl: unknown list '%s'\n", name);
2364 static void do_acl_show(Monitor *mon, const QDict *qdict)
2366 const char *aclname = qdict_get_str(qdict, "aclname");
2367 qemu_acl *acl = find_acl(mon, aclname);
2368 qemu_acl_entry *entry;
2372 monitor_printf(mon, "policy: %s\n",
2373 acl->defaultDeny ? "deny" : "allow");
2374 QTAILQ_FOREACH(entry, &acl->entries, next) {
2376 monitor_printf(mon, "%d: %s %s\n", i,
2377 entry->deny ? "deny" : "allow", entry->match);
2382 static void do_acl_reset(Monitor *mon, const QDict *qdict)
2384 const char *aclname = qdict_get_str(qdict, "aclname");
2385 qemu_acl *acl = find_acl(mon, aclname);
2388 qemu_acl_reset(acl);
2389 monitor_printf(mon, "acl: removed all rules\n");
2393 static void do_acl_policy(Monitor *mon, const QDict *qdict)
2395 const char *aclname = qdict_get_str(qdict, "aclname");
2396 const char *policy = qdict_get_str(qdict, "policy");
2397 qemu_acl *acl = find_acl(mon, aclname);
2400 if (strcmp(policy, "allow") == 0) {
2401 acl->defaultDeny = 0;
2402 monitor_printf(mon, "acl: policy set to 'allow'\n");
2403 } else if (strcmp(policy, "deny") == 0) {
2404 acl->defaultDeny = 1;
2405 monitor_printf(mon, "acl: policy set to 'deny'\n");
2407 monitor_printf(mon, "acl: unknown policy '%s', "
2408 "expected 'deny' or 'allow'\n", policy);
2413 static void do_acl_add(Monitor *mon, const QDict *qdict)
2415 const char *aclname = qdict_get_str(qdict, "aclname");
2416 const char *match = qdict_get_str(qdict, "match");
2417 const char *policy = qdict_get_str(qdict, "policy");
2418 int has_index = qdict_haskey(qdict, "index");
2419 int index = qdict_get_try_int(qdict, "index", -1);
2420 qemu_acl *acl = find_acl(mon, aclname);
2424 if (strcmp(policy, "allow") == 0) {
2426 } else if (strcmp(policy, "deny") == 0) {
2429 monitor_printf(mon, "acl: unknown policy '%s', "
2430 "expected 'deny' or 'allow'\n", policy);
2434 ret = qemu_acl_insert(acl, deny, match, index);
2436 ret = qemu_acl_append(acl, deny, match);
2438 monitor_printf(mon, "acl: unable to add acl entry\n");
2440 monitor_printf(mon, "acl: added rule at position %d\n", ret);
2444 static void do_acl_remove(Monitor *mon, const QDict *qdict)
2446 const char *aclname = qdict_get_str(qdict, "aclname");
2447 const char *match = qdict_get_str(qdict, "match");
2448 qemu_acl *acl = find_acl(mon, aclname);
2452 ret = qemu_acl_remove(acl, match);
2454 monitor_printf(mon, "acl: no matching acl entry\n");
2456 monitor_printf(mon, "acl: removed rule at position %d\n", ret);
2460 #if defined(TARGET_I386)
2461 static void do_inject_mce(Monitor *mon, const QDict *qdict)
2464 int cpu_index = qdict_get_int(qdict, "cpu_index");
2465 int bank = qdict_get_int(qdict, "bank");
2466 uint64_t status = qdict_get_int(qdict, "status");
2467 uint64_t mcg_status = qdict_get_int(qdict, "mcg_status");
2468 uint64_t addr = qdict_get_int(qdict, "addr");
2469 uint64_t misc = qdict_get_int(qdict, "misc");
2471 for (cenv = first_cpu; cenv != NULL; cenv = cenv->next_cpu)
2472 if (cenv->cpu_index == cpu_index && cenv->mcg_cap) {
2473 cpu_inject_x86_mce(cenv, bank, status, mcg_status, addr, misc);
2479 static int do_getfd(Monitor *mon, const QDict *qdict, QObject **ret_data)
2481 const char *fdname = qdict_get_str(qdict, "fdname");
2485 fd = qemu_chr_get_msgfd(mon->chr);
2487 qerror_report(QERR_FD_NOT_SUPPLIED);
2491 if (qemu_isdigit(fdname[0])) {
2492 qerror_report(QERR_INVALID_PARAMETER, "fdname");
2498 if (errno == EMFILE)
2499 qerror_report(QERR_TOO_MANY_FILES);
2501 qerror_report(QERR_UNDEFINED_ERROR);
2505 QLIST_FOREACH(monfd, &mon->fds, next) {
2506 if (strcmp(monfd->name, fdname) != 0) {
2515 monfd = qemu_mallocz(sizeof(mon_fd_t));
2516 monfd->name = qemu_strdup(fdname);
2519 QLIST_INSERT_HEAD(&mon->fds, monfd, next);
2523 static int do_closefd(Monitor *mon, const QDict *qdict, QObject **ret_data)
2525 const char *fdname = qdict_get_str(qdict, "fdname");
2528 QLIST_FOREACH(monfd, &mon->fds, next) {
2529 if (strcmp(monfd->name, fdname) != 0) {
2533 QLIST_REMOVE(monfd, next);
2535 qemu_free(monfd->name);
2540 qerror_report(QERR_FD_NOT_FOUND, fdname);
2544 static void do_loadvm(Monitor *mon, const QDict *qdict)
2546 int saved_vm_running = vm_running;
2547 const char *name = qdict_get_str(qdict, "name");
2551 if (load_vmstate(name) >= 0 && saved_vm_running)
2555 int monitor_get_fd(Monitor *mon, const char *fdname)
2559 QLIST_FOREACH(monfd, &mon->fds, next) {
2562 if (strcmp(monfd->name, fdname) != 0) {
2568 /* caller takes ownership of fd */
2569 QLIST_REMOVE(monfd, next);
2570 qemu_free(monfd->name);
2579 static const mon_cmd_t mon_cmds[] = {
2580 #include "qemu-monitor.h"
2584 /* Please update qemu-monitor.hx when adding or changing commands */
2585 static const mon_cmd_t info_cmds[] = {
2590 .help = "show the version of QEMU",
2591 .user_print = do_info_version_print,
2592 .mhandler.info_new = do_info_version,
2598 .help = "list QMP available commands",
2599 .user_print = monitor_user_noop,
2600 .mhandler.info_new = do_info_commands,
2606 .help = "show the network state",
2607 .mhandler.info = do_info_network,
2613 .help = "show the character devices",
2614 .user_print = qemu_chr_info_print,
2615 .mhandler.info_new = qemu_chr_info,
2621 .help = "show the block devices",
2622 .user_print = bdrv_info_print,
2623 .mhandler.info_new = bdrv_info,
2626 .name = "blockstats",
2629 .help = "show block device statistics",
2630 .user_print = bdrv_stats_print,
2631 .mhandler.info_new = bdrv_info_stats,
2634 .name = "registers",
2637 .help = "show the cpu registers",
2638 .mhandler.info = do_info_registers,
2644 .help = "show infos for each CPU",
2645 .user_print = monitor_print_cpus,
2646 .mhandler.info_new = do_info_cpus,
2652 .help = "show the command line history",
2653 .mhandler.info = do_info_history,
2659 .help = "show the interrupts statistics (if available)",
2660 .mhandler.info = irq_info,
2666 .help = "show i8259 (PIC) state",
2667 .mhandler.info = pic_info,
2673 .help = "show PCI info",
2674 .user_print = do_pci_info_print,
2675 .mhandler.info_new = do_pci_info,
2677 #if defined(TARGET_I386) || defined(TARGET_SH4)
2682 .help = "show virtual to physical memory mappings",
2683 .mhandler.info = tlb_info,
2686 #if defined(TARGET_I386)
2691 .help = "show the active virtual memory mappings",
2692 .mhandler.info = mem_info,
2698 .help = "show state of HPET",
2699 .user_print = do_info_hpet_print,
2700 .mhandler.info_new = do_info_hpet,
2707 .help = "show dynamic compiler info",
2708 .mhandler.info = do_info_jit,
2714 .help = "show KVM information",
2715 .user_print = do_info_kvm_print,
2716 .mhandler.info_new = do_info_kvm,
2722 .help = "show NUMA information",
2723 .mhandler.info = do_info_numa,
2729 .help = "show guest USB devices",
2730 .mhandler.info = usb_info,
2736 .help = "show host USB devices",
2737 .mhandler.info = usb_host_info,
2743 .help = "show profiling information",
2744 .mhandler.info = do_info_profile,
2750 .help = "show capture information",
2751 .mhandler.info = do_info_capture,
2754 .name = "snapshots",
2757 .help = "show the currently saved VM snapshots",
2758 .mhandler.info = do_info_snapshots,
2764 .help = "show the current VM status (running|paused)",
2765 .user_print = do_info_status_print,
2766 .mhandler.info_new = do_info_status,
2772 .help = "show guest PCMCIA status",
2773 .mhandler.info = pcmcia_info,
2779 .help = "show which guest mouse is receiving events",
2780 .user_print = do_info_mice_print,
2781 .mhandler.info_new = do_info_mice,
2787 .help = "show the vnc server status",
2788 .user_print = do_info_vnc_print,
2789 .mhandler.info_new = do_info_vnc,
2795 .help = "show the current VM name",
2796 .user_print = do_info_name_print,
2797 .mhandler.info_new = do_info_name,
2803 .help = "show the current VM UUID",
2804 .user_print = do_info_uuid_print,
2805 .mhandler.info_new = do_info_uuid,
2807 #if defined(TARGET_PPC)
2812 .help = "show CPU statistics",
2813 .mhandler.info = do_info_cpu_stats,
2816 #if defined(CONFIG_SLIRP)
2821 .help = "show user network stack connection states",
2822 .mhandler.info = do_info_usernet,
2829 .help = "show migration status",
2830 .user_print = do_info_migrate_print,
2831 .mhandler.info_new = do_info_migrate,
2837 .help = "show balloon information",
2838 .user_print = monitor_print_balloon,
2839 .mhandler.info_async = do_info_balloon,
2846 .help = "show device tree",
2847 .mhandler.info = do_info_qtree,
2853 .help = "show qdev device model list",
2854 .mhandler.info = do_info_qdm,
2860 .help = "show roms",
2861 .mhandler.info = do_info_roms,
2868 /*******************************************************************/
2870 static const char *pch;
2871 static jmp_buf expr_env;
2876 typedef struct MonitorDef {
2879 target_long (*get_value)(const struct MonitorDef *md, int val);
2883 #if defined(TARGET_I386)
2884 static target_long monitor_get_pc (const struct MonitorDef *md, int val)
2886 CPUState *env = mon_get_cpu();
2887 return env->eip + env->segs[R_CS].base;
2891 #if defined(TARGET_PPC)
2892 static target_long monitor_get_ccr (const struct MonitorDef *md, int val)
2894 CPUState *env = mon_get_cpu();
2899 for (i = 0; i < 8; i++)
2900 u |= env->crf[i] << (32 - (4 * i));
2905 static target_long monitor_get_msr (const struct MonitorDef *md, int val)
2907 CPUState *env = mon_get_cpu();
2911 static target_long monitor_get_xer (const struct MonitorDef *md, int val)
2913 CPUState *env = mon_get_cpu();
2917 static target_long monitor_get_decr (const struct MonitorDef *md, int val)
2919 CPUState *env = mon_get_cpu();
2920 return cpu_ppc_load_decr(env);
2923 static target_long monitor_get_tbu (const struct MonitorDef *md, int val)
2925 CPUState *env = mon_get_cpu();
2926 return cpu_ppc_load_tbu(env);
2929 static target_long monitor_get_tbl (const struct MonitorDef *md, int val)
2931 CPUState *env = mon_get_cpu();
2932 return cpu_ppc_load_tbl(env);
2936 #if defined(TARGET_SPARC)
2937 #ifndef TARGET_SPARC64
2938 static target_long monitor_get_psr (const struct MonitorDef *md, int val)
2940 CPUState *env = mon_get_cpu();
2941 return GET_PSR(env);
2945 static target_long monitor_get_reg(const struct MonitorDef *md, int val)
2947 CPUState *env = mon_get_cpu();
2948 return env->regwptr[val];
2952 static const MonitorDef monitor_defs[] = {
2955 #define SEG(name, seg) \
2956 { name, offsetof(CPUState, segs[seg].selector), NULL, MD_I32 },\
2957 { name ".base", offsetof(CPUState, segs[seg].base) },\
2958 { name ".limit", offsetof(CPUState, segs[seg].limit), NULL, MD_I32 },
2960 { "eax", offsetof(CPUState, regs[0]) },
2961 { "ecx", offsetof(CPUState, regs[1]) },
2962 { "edx", offsetof(CPUState, regs[2]) },
2963 { "ebx", offsetof(CPUState, regs[3]) },
2964 { "esp|sp", offsetof(CPUState, regs[4]) },
2965 { "ebp|fp", offsetof(CPUState, regs[5]) },
2966 { "esi", offsetof(CPUState, regs[6]) },
2967 { "edi", offsetof(CPUState, regs[7]) },
2968 #ifdef TARGET_X86_64
2969 { "r8", offsetof(CPUState, regs[8]) },
2970 { "r9", offsetof(CPUState, regs[9]) },
2971 { "r10", offsetof(CPUState, regs[10]) },
2972 { "r11", offsetof(CPUState, regs[11]) },
2973 { "r12", offsetof(CPUState, regs[12]) },
2974 { "r13", offsetof(CPUState, regs[13]) },
2975 { "r14", offsetof(CPUState, regs[14]) },
2976 { "r15", offsetof(CPUState, regs[15]) },
2978 { "eflags", offsetof(CPUState, eflags) },
2979 { "eip", offsetof(CPUState, eip) },
2986 { "pc", 0, monitor_get_pc, },
2987 #elif defined(TARGET_PPC)
2988 /* General purpose registers */
2989 { "r0", offsetof(CPUState, gpr[0]) },
2990 { "r1", offsetof(CPUState, gpr[1]) },
2991 { "r2", offsetof(CPUState, gpr[2]) },
2992 { "r3", offsetof(CPUState, gpr[3]) },
2993 { "r4", offsetof(CPUState, gpr[4]) },
2994 { "r5", offsetof(CPUState, gpr[5]) },
2995 { "r6", offsetof(CPUState, gpr[6]) },
2996 { "r7", offsetof(CPUState, gpr[7]) },
2997 { "r8", offsetof(CPUState, gpr[8]) },
2998 { "r9", offsetof(CPUState, gpr[9]) },
2999 { "r10", offsetof(CPUState, gpr[10]) },
3000 { "r11", offsetof(CPUState, gpr[11]) },
3001 { "r12", offsetof(CPUState, gpr[12]) },
3002 { "r13", offsetof(CPUState, gpr[13]) },
3003 { "r14", offsetof(CPUState, gpr[14]) },
3004 { "r15", offsetof(CPUState, gpr[15]) },
3005 { "r16", offsetof(CPUState, gpr[16]) },
3006 { "r17", offsetof(CPUState, gpr[17]) },
3007 { "r18", offsetof(CPUState, gpr[18]) },
3008 { "r19", offsetof(CPUState, gpr[19]) },
3009 { "r20", offsetof(CPUState, gpr[20]) },
3010 { "r21", offsetof(CPUState, gpr[21]) },
3011 { "r22", offsetof(CPUState, gpr[22]) },
3012 { "r23", offsetof(CPUState, gpr[23]) },
3013 { "r24", offsetof(CPUState, gpr[24]) },
3014 { "r25", offsetof(CPUState, gpr[25]) },
3015 { "r26", offsetof(CPUState, gpr[26]) },
3016 { "r27", offsetof(CPUState, gpr[27]) },
3017 { "r28", offsetof(CPUState, gpr[28]) },
3018 { "r29", offsetof(CPUState, gpr[29]) },
3019 { "r30", offsetof(CPUState, gpr[30]) },
3020 { "r31", offsetof(CPUState, gpr[31]) },
3021 /* Floating point registers */
3022 { "f0", offsetof(CPUState, fpr[0]) },
3023 { "f1", offsetof(CPUState, fpr[1]) },
3024 { "f2", offsetof(CPUState, fpr[2]) },
3025 { "f3", offsetof(CPUState, fpr[3]) },
3026 { "f4", offsetof(CPUState, fpr[4]) },
3027 { "f5", offsetof(CPUState, fpr[5]) },
3028 { "f6", offsetof(CPUState, fpr[6]) },
3029 { "f7", offsetof(CPUState, fpr[7]) },
3030 { "f8", offsetof(CPUState, fpr[8]) },
3031 { "f9", offsetof(CPUState, fpr[9]) },
3032 { "f10", offsetof(CPUState, fpr[10]) },
3033 { "f11", offsetof(CPUState, fpr[11]) },
3034 { "f12", offsetof(CPUState, fpr[12]) },
3035 { "f13", offsetof(CPUState, fpr[13]) },
3036 { "f14", offsetof(CPUState, fpr[14]) },
3037 { "f15", offsetof(CPUState, fpr[15]) },
3038 { "f16", offsetof(CPUState, fpr[16]) },
3039 { "f17", offsetof(CPUState, fpr[17]) },
3040 { "f18", offsetof(CPUState, fpr[18]) },
3041 { "f19", offsetof(CPUState, fpr[19]) },
3042 { "f20", offsetof(CPUState, fpr[20]) },
3043 { "f21", offsetof(CPUState, fpr[21]) },
3044 { "f22", offsetof(CPUState, fpr[22]) },
3045 { "f23", offsetof(CPUState, fpr[23]) },
3046 { "f24", offsetof(CPUState, fpr[24]) },
3047 { "f25", offsetof(CPUState, fpr[25]) },
3048 { "f26", offsetof(CPUState, fpr[26]) },
3049 { "f27", offsetof(CPUState, fpr[27]) },
3050 { "f28", offsetof(CPUState, fpr[28]) },
3051 { "f29", offsetof(CPUState, fpr[29]) },
3052 { "f30", offsetof(CPUState, fpr[30]) },
3053 { "f31", offsetof(CPUState, fpr[31]) },
3054 { "fpscr", offsetof(CPUState, fpscr) },
3055 /* Next instruction pointer */
3056 { "nip|pc", offsetof(CPUState, nip) },
3057 { "lr", offsetof(CPUState, lr) },
3058 { "ctr", offsetof(CPUState, ctr) },
3059 { "decr", 0, &monitor_get_decr, },
3060 { "ccr", 0, &monitor_get_ccr, },
3061 /* Machine state register */
3062 { "msr", 0, &monitor_get_msr, },
3063 { "xer", 0, &monitor_get_xer, },
3064 { "tbu", 0, &monitor_get_tbu, },
3065 { "tbl", 0, &monitor_get_tbl, },
3066 #if defined(TARGET_PPC64)
3067 /* Address space register */
3068 { "asr", offsetof(CPUState, asr) },
3070 /* Segment registers */
3071 { "sdr1", offsetof(CPUState, sdr1) },
3072 { "sr0", offsetof(CPUState, sr[0]) },
3073 { "sr1", offsetof(CPUState, sr[1]) },
3074 { "sr2", offsetof(CPUState, sr[2]) },
3075 { "sr3", offsetof(CPUState, sr[3]) },
3076 { "sr4", offsetof(CPUState, sr[4]) },
3077 { "sr5", offsetof(CPUState, sr[5]) },
3078 { "sr6", offsetof(CPUState, sr[6]) },
3079 { "sr7", offsetof(CPUState, sr[7]) },
3080 { "sr8", offsetof(CPUState, sr[8]) },
3081 { "sr9", offsetof(CPUState, sr[9]) },
3082 { "sr10", offsetof(CPUState, sr[10]) },
3083 { "sr11", offsetof(CPUState, sr[11]) },
3084 { "sr12", offsetof(CPUState, sr[12]) },
3085 { "sr13", offsetof(CPUState, sr[13]) },
3086 { "sr14", offsetof(CPUState, sr[14]) },
3087 { "sr15", offsetof(CPUState, sr[15]) },
3088 /* Too lazy to put BATs and SPRs ... */
3089 #elif defined(TARGET_SPARC)
3090 { "g0", offsetof(CPUState, gregs[0]) },
3091 { "g1", offsetof(CPUState, gregs[1]) },
3092 { "g2", offsetof(CPUState, gregs[2]) },
3093 { "g3", offsetof(CPUState, gregs[3]) },
3094 { "g4", offsetof(CPUState, gregs[4]) },
3095 { "g5", offsetof(CPUState, gregs[5]) },
3096 { "g6", offsetof(CPUState, gregs[6]) },
3097 { "g7", offsetof(CPUState, gregs[7]) },
3098 { "o0", 0, monitor_get_reg },
3099 { "o1", 1, monitor_get_reg },
3100 { "o2", 2, monitor_get_reg },
3101 { "o3", 3, monitor_get_reg },
3102 { "o4", 4, monitor_get_reg },
3103 { "o5", 5, monitor_get_reg },
3104 { "o6", 6, monitor_get_reg },
3105 { "o7", 7, monitor_get_reg },
3106 { "l0", 8, monitor_get_reg },
3107 { "l1", 9, monitor_get_reg },
3108 { "l2", 10, monitor_get_reg },
3109 { "l3", 11, monitor_get_reg },
3110 { "l4", 12, monitor_get_reg },
3111 { "l5", 13, monitor_get_reg },
3112 { "l6", 14, monitor_get_reg },
3113 { "l7", 15, monitor_get_reg },
3114 { "i0", 16, monitor_get_reg },
3115 { "i1", 17, monitor_get_reg },
3116 { "i2", 18, monitor_get_reg },
3117 { "i3", 19, monitor_get_reg },
3118 { "i4", 20, monitor_get_reg },
3119 { "i5", 21, monitor_get_reg },
3120 { "i6", 22, monitor_get_reg },
3121 { "i7", 23, monitor_get_reg },
3122 { "pc", offsetof(CPUState, pc) },
3123 { "npc", offsetof(CPUState, npc) },
3124 { "y", offsetof(CPUState, y) },
3125 #ifndef TARGET_SPARC64
3126 { "psr", 0, &monitor_get_psr, },
3127 { "wim", offsetof(CPUState, wim) },
3129 { "tbr", offsetof(CPUState, tbr) },
3130 { "fsr", offsetof(CPUState, fsr) },
3131 { "f0", offsetof(CPUState, fpr[0]) },
3132 { "f1", offsetof(CPUState, fpr[1]) },
3133 { "f2", offsetof(CPUState, fpr[2]) },
3134 { "f3", offsetof(CPUState, fpr[3]) },
3135 { "f4", offsetof(CPUState, fpr[4]) },
3136 { "f5", offsetof(CPUState, fpr[5]) },
3137 { "f6", offsetof(CPUState, fpr[6]) },
3138 { "f7", offsetof(CPUState, fpr[7]) },
3139 { "f8", offsetof(CPUState, fpr[8]) },
3140 { "f9", offsetof(CPUState, fpr[9]) },
3141 { "f10", offsetof(CPUState, fpr[10]) },
3142 { "f11", offsetof(CPUState, fpr[11]) },
3143 { "f12", offsetof(CPUState, fpr[12]) },
3144 { "f13", offsetof(CPUState, fpr[13]) },
3145 { "f14", offsetof(CPUState, fpr[14]) },
3146 { "f15", offsetof(CPUState, fpr[15]) },
3147 { "f16", offsetof(CPUState, fpr[16]) },
3148 { "f17", offsetof(CPUState, fpr[17]) },
3149 { "f18", offsetof(CPUState, fpr[18]) },
3150 { "f19", offsetof(CPUState, fpr[19]) },
3151 { "f20", offsetof(CPUState, fpr[20]) },
3152 { "f21", offsetof(CPUState, fpr[21]) },
3153 { "f22", offsetof(CPUState, fpr[22]) },
3154 { "f23", offsetof(CPUState, fpr[23]) },
3155 { "f24", offsetof(CPUState, fpr[24]) },
3156 { "f25", offsetof(CPUState, fpr[25]) },
3157 { "f26", offsetof(CPUState, fpr[26]) },
3158 { "f27", offsetof(CPUState, fpr[27]) },
3159 { "f28", offsetof(CPUState, fpr[28]) },
3160 { "f29", offsetof(CPUState, fpr[29]) },
3161 { "f30", offsetof(CPUState, fpr[30]) },
3162 { "f31", offsetof(CPUState, fpr[31]) },
3163 #ifdef TARGET_SPARC64
3164 { "f32", offsetof(CPUState, fpr[32]) },
3165 { "f34", offsetof(CPUState, fpr[34]) },
3166 { "f36", offsetof(CPUState, fpr[36]) },
3167 { "f38", offsetof(CPUState, fpr[38]) },
3168 { "f40", offsetof(CPUState, fpr[40]) },
3169 { "f42", offsetof(CPUState, fpr[42]) },
3170 { "f44", offsetof(CPUState, fpr[44]) },
3171 { "f46", offsetof(CPUState, fpr[46]) },
3172 { "f48", offsetof(CPUState, fpr[48]) },
3173 { "f50", offsetof(CPUState, fpr[50]) },
3174 { "f52", offsetof(CPUState, fpr[52]) },
3175 { "f54", offsetof(CPUState, fpr[54]) },
3176 { "f56", offsetof(CPUState, fpr[56]) },
3177 { "f58", offsetof(CPUState, fpr[58]) },
3178 { "f60", offsetof(CPUState, fpr[60]) },
3179 { "f62", offsetof(CPUState, fpr[62]) },
3180 { "asi", offsetof(CPUState, asi) },
3181 { "pstate", offsetof(CPUState, pstate) },
3182 { "cansave", offsetof(CPUState, cansave) },
3183 { "canrestore", offsetof(CPUState, canrestore) },
3184 { "otherwin", offsetof(CPUState, otherwin) },
3185 { "wstate", offsetof(CPUState, wstate) },
3186 { "cleanwin", offsetof(CPUState, cleanwin) },
3187 { "fprs", offsetof(CPUState, fprs) },
3193 static void expr_error(Monitor *mon, const char *msg)
3195 monitor_printf(mon, "%s\n", msg);
3196 longjmp(expr_env, 1);
3199 /* return 0 if OK, -1 if not found */
3200 static int get_monitor_def(target_long *pval, const char *name)
3202 const MonitorDef *md;
3205 for(md = monitor_defs; md->name != NULL; md++) {
3206 if (compare_cmd(name, md->name)) {
3207 if (md->get_value) {
3208 *pval = md->get_value(md, md->offset);
3210 CPUState *env = mon_get_cpu();
3211 ptr = (uint8_t *)env + md->offset;
3214 *pval = *(int32_t *)ptr;
3217 *pval = *(target_long *)ptr;
3230 static void next(void)
3234 while (qemu_isspace(*pch))
3239 static int64_t expr_sum(Monitor *mon);
3241 static int64_t expr_unary(Monitor *mon)
3250 n = expr_unary(mon);
3254 n = -expr_unary(mon);
3258 n = ~expr_unary(mon);
3264 expr_error(mon, "')' expected");
3271 expr_error(mon, "character constant expected");
3275 expr_error(mon, "missing terminating \' character");
3285 while ((*pch >= 'a' && *pch <= 'z') ||
3286 (*pch >= 'A' && *pch <= 'Z') ||
3287 (*pch >= '0' && *pch <= '9') ||
3288 *pch == '_' || *pch == '.') {
3289 if ((q - buf) < sizeof(buf) - 1)
3293 while (qemu_isspace(*pch))
3296 ret = get_monitor_def(®, buf);
3298 expr_error(mon, "unknown register");
3303 expr_error(mon, "unexpected end of expression");
3307 #if TARGET_PHYS_ADDR_BITS > 32
3308 n = strtoull(pch, &p, 0);
3310 n = strtoul(pch, &p, 0);
3313 expr_error(mon, "invalid char in expression");
3316 while (qemu_isspace(*pch))
3324 static int64_t expr_prod(Monitor *mon)
3329 val = expr_unary(mon);
3332 if (op != '*' && op != '/' && op != '%')
3335 val2 = expr_unary(mon);
3344 expr_error(mon, "division by zero");
3355 static int64_t expr_logic(Monitor *mon)
3360 val = expr_prod(mon);
3363 if (op != '&' && op != '|' && op != '^')
3366 val2 = expr_prod(mon);
3383 static int64_t expr_sum(Monitor *mon)
3388 val = expr_logic(mon);
3391 if (op != '+' && op != '-')
3394 val2 = expr_logic(mon);
3403 static int get_expr(Monitor *mon, int64_t *pval, const char **pp)
3406 if (setjmp(expr_env)) {
3410 while (qemu_isspace(*pch))
3412 *pval = expr_sum(mon);
3417 static int get_double(Monitor *mon, double *pval, const char **pp)
3419 const char *p = *pp;
3423 d = strtod(p, &tailp);
3425 monitor_printf(mon, "Number expected\n");
3428 if (d != d || d - d != 0) {
3429 /* NaN or infinity */
3430 monitor_printf(mon, "Bad number\n");
3438 static int get_str(char *buf, int buf_size, const char **pp)
3446 while (qemu_isspace(*p))
3456 while (*p != '\0' && *p != '\"') {
3472 qemu_printf("unsupported escape code: '\\%c'\n", c);
3475 if ((q - buf) < buf_size - 1) {
3479 if ((q - buf) < buf_size - 1) {
3486 qemu_printf("unterminated string\n");
3491 while (*p != '\0' && !qemu_isspace(*p)) {
3492 if ((q - buf) < buf_size - 1) {
3504 * Store the command-name in cmdname, and return a pointer to
3505 * the remaining of the command string.
3507 static const char *get_command_name(const char *cmdline,
3508 char *cmdname, size_t nlen)
3511 const char *p, *pstart;
3514 while (qemu_isspace(*p))
3519 while (*p != '\0' && *p != '/' && !qemu_isspace(*p))
3524 memcpy(cmdname, pstart, len);
3525 cmdname[len] = '\0';
3530 * Read key of 'type' into 'key' and return the current
3533 static char *key_get_info(const char *type, char **key)
3541 p = strchr(type, ':');
3548 str = qemu_malloc(len + 1);
3549 memcpy(str, type, len);
3556 static int default_fmt_format = 'x';
3557 static int default_fmt_size = 4;
3561 static int is_valid_option(const char *c, const char *typestr)
3569 typestr = strstr(typestr, option);
3570 return (typestr != NULL);
3573 static const mon_cmd_t *monitor_find_command(const char *cmdname)
3575 const mon_cmd_t *cmd;
3577 for (cmd = mon_cmds; cmd->name != NULL; cmd++) {
3578 if (compare_cmd(cmdname, cmd->name)) {
3586 static const mon_cmd_t *monitor_parse_command(Monitor *mon,
3587 const char *cmdline,
3590 const char *p, *typestr;
3592 const mon_cmd_t *cmd;
3598 monitor_printf(mon, "command='%s'\n", cmdline);
3601 /* extract the command name */
3602 p = get_command_name(cmdline, cmdname, sizeof(cmdname));
3606 cmd = monitor_find_command(cmdname);
3608 monitor_printf(mon, "unknown command: '%s'\n", cmdname);
3612 /* parse the parameters */
3613 typestr = cmd->args_type;
3615 typestr = key_get_info(typestr, &key);
3627 while (qemu_isspace(*p))
3629 if (*typestr == '?') {
3632 /* no optional string: NULL argument */
3636 ret = get_str(buf, sizeof(buf), &p);
3640 monitor_printf(mon, "%s: filename expected\n",
3644 monitor_printf(mon, "%s: block device name expected\n",
3648 monitor_printf(mon, "%s: string expected\n", cmdname);
3653 qdict_put(qdict, key, qstring_from_str(buf));
3658 QemuOptsList *opts_list;
3661 opts_list = qemu_find_opts(key);
3662 if (!opts_list || opts_list->desc->name) {
3665 while (qemu_isspace(*p)) {
3670 if (get_str(buf, sizeof(buf), &p) < 0) {
3673 opts = qemu_opts_parse(opts_list, buf, 1);
3677 qemu_opts_to_qdict(opts, qdict);
3678 qemu_opts_del(opts);
3683 int count, format, size;
3685 while (qemu_isspace(*p))
3691 if (qemu_isdigit(*p)) {
3693 while (qemu_isdigit(*p)) {
3694 count = count * 10 + (*p - '0');
3732 if (*p != '\0' && !qemu_isspace(*p)) {
3733 monitor_printf(mon, "invalid char in format: '%c'\n",
3738 format = default_fmt_format;
3739 if (format != 'i') {
3740 /* for 'i', not specifying a size gives -1 as size */
3742 size = default_fmt_size;
3743 default_fmt_size = size;
3745 default_fmt_format = format;
3748 format = default_fmt_format;
3749 if (format != 'i') {
3750 size = default_fmt_size;
3755 qdict_put(qdict, "count", qint_from_int(count));
3756 qdict_put(qdict, "format", qint_from_int(format));
3757 qdict_put(qdict, "size", qint_from_int(size));
3766 while (qemu_isspace(*p))
3768 if (*typestr == '?' || *typestr == '.') {
3769 if (*typestr == '?') {
3777 while (qemu_isspace(*p))
3786 if (get_expr(mon, &val, &p))
3788 /* Check if 'i' is greater than 32-bit */
3789 if ((c == 'i') && ((val >> 32) & 0xffffffff)) {
3790 monitor_printf(mon, "\'%s\' has failed: ", cmdname);
3791 monitor_printf(mon, "integer is for 32-bit values\n");
3793 } else if (c == 'M') {
3796 qdict_put(qdict, key, qint_from_int(val));
3804 while (qemu_isspace(*p))
3806 if (*typestr == '?') {
3812 if (get_double(mon, &val, &p) < 0) {
3815 if (c == 'b' && *p) {
3818 val *= 1 << 10; p++; break;
3820 val *= 1 << 20; p++; break;
3822 val *= 1 << 30; p++; break;
3825 if (c == 'T' && p[0] && p[1] == 's') {
3828 val /= 1e3; p += 2; break;
3830 val /= 1e6; p += 2; break;
3832 val /= 1e9; p += 2; break;
3835 if (*p && !qemu_isspace(*p)) {
3836 monitor_printf(mon, "Unknown unit suffix\n");
3839 qdict_put(qdict, key, qfloat_from_double(val));
3844 const char *tmp = p;
3845 int has_option, skip_key = 0;
3851 while (qemu_isspace(*p))
3857 if(!is_valid_option(p, typestr)) {
3859 monitor_printf(mon, "%s: unsupported option -%c\n",
3873 qdict_put(qdict, key, qint_from_int(has_option));
3878 monitor_printf(mon, "%s: unknown type '%c'\n", cmdname, c);
3884 /* check that all arguments were parsed */
3885 while (qemu_isspace(*p))
3888 monitor_printf(mon, "%s: extraneous characters at the end of line\n",
3900 void monitor_set_error(Monitor *mon, QError *qerror)
3902 /* report only the first error */
3904 mon->error = qerror;
3906 MON_DEBUG("Additional error report at %s:%d\n",
3907 qerror->file, qerror->linenr);
3912 static int is_async_return(const QObject *data)
3914 if (data && qobject_type(data) == QTYPE_QDICT) {
3915 return qdict_haskey(qobject_to_qdict(data), "__mon_async");
3921 static void handler_audit(Monitor *mon, const mon_cmd_t *cmd, int ret)
3923 if (monitor_ctrl_mode(mon)) {
3924 if (ret && !monitor_has_error(mon)) {
3926 * If it returns failure, it must have passed on error.
3928 * Action: Report an internal error to the client if in QMP.
3930 qerror_report(QERR_UNDEFINED_ERROR);
3931 MON_DEBUG("command '%s' returned failure but did not pass an error\n",
3935 #ifdef CONFIG_DEBUG_MONITOR
3936 if (!ret && monitor_has_error(mon)) {
3938 * If it returns success, it must not have passed an error.
3940 * Action: Report the passed error to the client.
3942 MON_DEBUG("command '%s' returned success but passed an error\n",
3946 if (mon_print_count_get(mon) > 0 && strcmp(cmd->name, "info") != 0) {
3948 * Handlers should not call Monitor print functions.
3950 * Action: Ignore them in QMP.
3952 * (XXX: we don't check any 'info' or 'query' command here
3953 * because the user print function _is_ called by do_info(), hence
3954 * we will trigger this check. This problem will go away when we
3955 * make 'query' commands real and kill do_info())
3957 MON_DEBUG("command '%s' called print functions %d time(s)\n",
3958 cmd->name, mon_print_count_get(mon));
3962 assert(!monitor_has_error(mon));
3963 QDECREF(mon->error);
3968 static void monitor_call_handler(Monitor *mon, const mon_cmd_t *cmd,
3969 const QDict *params)
3972 QObject *data = NULL;
3974 mon_print_count_init(mon);
3976 ret = cmd->mhandler.cmd_new(mon, params, &data);
3977 handler_audit(mon, cmd, ret);
3979 if (is_async_return(data)) {
3981 * Asynchronous commands have no initial return data but they can
3982 * generate errors. Data is returned via the async completion handler.
3984 if (monitor_ctrl_mode(mon) && monitor_has_error(mon)) {
3985 monitor_protocol_emitter(mon, NULL);
3987 } else if (monitor_ctrl_mode(mon)) {
3988 /* Monitor Protocol */
3989 monitor_protocol_emitter(mon, data);
3993 cmd->user_print(mon, data);
3996 qobject_decref(data);
3999 static void handle_user_command(Monitor *mon, const char *cmdline)
4002 const mon_cmd_t *cmd;
4004 qdict = qdict_new();
4006 cmd = monitor_parse_command(mon, cmdline, qdict);
4010 if (monitor_handler_is_async(cmd)) {
4011 user_async_cmd_handler(mon, cmd, qdict);
4012 } else if (monitor_handler_ported(cmd)) {
4013 monitor_call_handler(mon, cmd, qdict);
4015 cmd->mhandler.cmd(mon, qdict);
4022 static void cmd_completion(const char *name, const char *list)
4024 const char *p, *pstart;
4033 p = pstart + strlen(pstart);
4035 if (len > sizeof(cmd) - 2)
4036 len = sizeof(cmd) - 2;
4037 memcpy(cmd, pstart, len);
4039 if (name[0] == '\0' || !strncmp(name, cmd, strlen(name))) {
4040 readline_add_completion(cur_mon->rs, cmd);
4048 static void file_completion(const char *input)
4053 char file[1024], file_prefix[1024];
4057 p = strrchr(input, '/');
4060 pstrcpy(file_prefix, sizeof(file_prefix), input);
4061 pstrcpy(path, sizeof(path), ".");
4063 input_path_len = p - input + 1;
4064 memcpy(path, input, input_path_len);
4065 if (input_path_len > sizeof(path) - 1)
4066 input_path_len = sizeof(path) - 1;
4067 path[input_path_len] = '\0';
4068 pstrcpy(file_prefix, sizeof(file_prefix), p + 1);
4070 #ifdef DEBUG_COMPLETION
4071 monitor_printf(cur_mon, "input='%s' path='%s' prefix='%s'\n",
4072 input, path, file_prefix);
4074 ffs = opendir(path);
4082 if (strstart(d->d_name, file_prefix, NULL)) {
4083 memcpy(file, input, input_path_len);
4084 if (input_path_len < sizeof(file))
4085 pstrcpy(file + input_path_len, sizeof(file) - input_path_len,
4087 /* stat the file to find out if it's a directory.
4088 * In that case add a slash to speed up typing long paths
4091 if(S_ISDIR(sb.st_mode))
4092 pstrcat(file, sizeof(file), "/");
4093 readline_add_completion(cur_mon->rs, file);
4099 static void block_completion_it(void *opaque, BlockDriverState *bs)
4101 const char *name = bdrv_get_device_name(bs);
4102 const char *input = opaque;
4104 if (input[0] == '\0' ||
4105 !strncmp(name, (char *)input, strlen(input))) {
4106 readline_add_completion(cur_mon->rs, name);
4110 /* NOTE: this parser is an approximate form of the real command parser */
4111 static void parse_cmdline(const char *cmdline,
4112 int *pnb_args, char **args)
4121 while (qemu_isspace(*p))
4125 if (nb_args >= MAX_ARGS)
4127 ret = get_str(buf, sizeof(buf), &p);
4128 args[nb_args] = qemu_strdup(buf);
4133 *pnb_args = nb_args;
4136 static const char *next_arg_type(const char *typestr)
4138 const char *p = strchr(typestr, ':');
4139 return (p != NULL ? ++p : typestr);
4142 static void monitor_find_completion(const char *cmdline)
4144 const char *cmdname;
4145 char *args[MAX_ARGS];
4146 int nb_args, i, len;
4147 const char *ptype, *str;
4148 const mon_cmd_t *cmd;
4151 parse_cmdline(cmdline, &nb_args, args);
4152 #ifdef DEBUG_COMPLETION
4153 for(i = 0; i < nb_args; i++) {
4154 monitor_printf(cur_mon, "arg%d = '%s'\n", i, (char *)args[i]);
4158 /* if the line ends with a space, it means we want to complete the
4160 len = strlen(cmdline);
4161 if (len > 0 && qemu_isspace(cmdline[len - 1])) {
4162 if (nb_args >= MAX_ARGS)
4164 args[nb_args++] = qemu_strdup("");
4167 /* command completion */
4172 readline_set_completion_index(cur_mon->rs, strlen(cmdname));
4173 for(cmd = mon_cmds; cmd->name != NULL; cmd++) {
4174 cmd_completion(cmdname, cmd->name);
4177 /* find the command */
4178 for(cmd = mon_cmds; cmd->name != NULL; cmd++) {
4179 if (compare_cmd(args[0], cmd->name))
4184 ptype = next_arg_type(cmd->args_type);
4185 for(i = 0; i < nb_args - 2; i++) {
4186 if (*ptype != '\0') {
4187 ptype = next_arg_type(ptype);
4188 while (*ptype == '?')
4189 ptype = next_arg_type(ptype);
4192 str = args[nb_args - 1];
4193 if (*ptype == '-' && ptype[1] != '\0') {
4198 /* file completion */
4199 readline_set_completion_index(cur_mon->rs, strlen(str));
4200 file_completion(str);
4203 /* block device name completion */
4204 readline_set_completion_index(cur_mon->rs, strlen(str));
4205 bdrv_iterate(block_completion_it, (void *)str);
4208 /* XXX: more generic ? */
4209 if (!strcmp(cmd->name, "info")) {
4210 readline_set_completion_index(cur_mon->rs, strlen(str));
4211 for(cmd = info_cmds; cmd->name != NULL; cmd++) {
4212 cmd_completion(str, cmd->name);
4214 } else if (!strcmp(cmd->name, "sendkey")) {
4215 char *sep = strrchr(str, '-');
4218 readline_set_completion_index(cur_mon->rs, strlen(str));
4219 for(key = key_defs; key->name != NULL; key++) {
4220 cmd_completion(str, key->name);
4222 } else if (!strcmp(cmd->name, "help|?")) {
4223 readline_set_completion_index(cur_mon->rs, strlen(str));
4224 for (cmd = mon_cmds; cmd->name != NULL; cmd++) {
4225 cmd_completion(str, cmd->name);
4233 for(i = 0; i < nb_args; i++)
4237 static int monitor_can_read(void *opaque)
4239 Monitor *mon = opaque;
4241 return (mon->suspend_cnt == 0) ? 1 : 0;
4244 typedef struct CmdArgs {
4251 static int check_opt(const CmdArgs *cmd_args, const char *name, QDict *args)
4253 if (!cmd_args->optional) {
4254 qerror_report(QERR_MISSING_PARAMETER, name);
4258 if (cmd_args->type == '-') {
4259 /* handlers expect a value, they need to be changed */
4260 qdict_put(args, name, qint_from_int(0));
4266 static int check_arg(const CmdArgs *cmd_args, QDict *args)
4271 name = qstring_get_str(cmd_args->name);
4274 return check_opt(cmd_args, name, args);
4277 value = qdict_get(args, name);
4279 return check_opt(cmd_args, name, args);
4282 switch (cmd_args->type) {
4286 if (qobject_type(value) != QTYPE_QSTRING) {
4287 qerror_report(QERR_INVALID_PARAMETER_TYPE, name, "string");
4293 const char *keys[] = { "count", "format", "size", NULL };
4295 for (i = 0; keys[i]; i++) {
4296 QObject *obj = qdict_get(args, keys[i]);
4298 qerror_report(QERR_MISSING_PARAMETER, name);
4301 if (qobject_type(obj) != QTYPE_QINT) {
4302 qerror_report(QERR_INVALID_PARAMETER_TYPE, name, "int");
4311 if (qobject_type(value) != QTYPE_QINT) {
4312 qerror_report(QERR_INVALID_PARAMETER_TYPE, name, "int");
4318 if (qobject_type(value) != QTYPE_QINT && qobject_type(value) != QTYPE_QFLOAT) {
4319 qerror_report(QERR_INVALID_PARAMETER_TYPE, name, "number");
4324 if (qobject_type(value) != QTYPE_QINT &&
4325 qobject_type(value) != QTYPE_QBOOL) {
4326 qerror_report(QERR_INVALID_PARAMETER_TYPE, name, "bool");
4329 if (qobject_type(value) == QTYPE_QBOOL) {
4330 /* handlers expect a QInt, they need to be changed */
4331 qdict_put(args, name,
4332 qint_from_int(qbool_get_int(qobject_to_qbool(value))));
4344 static void cmd_args_init(CmdArgs *cmd_args)
4346 cmd_args->name = qstring_new();
4347 cmd_args->type = cmd_args->flag = cmd_args->optional = 0;
4350 static int check_opts(QemuOptsList *opts_list, QDict *args)
4352 assert(!opts_list->desc->name);
4357 * This is not trivial, we have to parse Monitor command's argument
4358 * type syntax to be able to check the arguments provided by clients.
4360 * In the near future we will be using an array for that and will be
4361 * able to drop all this parsing...
4363 static int monitor_check_qmp_args(const mon_cmd_t *cmd, QDict *args)
4368 QemuOptsList *opts_list;
4370 if (cmd->args_type == NULL) {
4371 return (qdict_size(args) == 0 ? 0 : -1);
4375 cmd_args_init(&cmd_args);
4378 for (p = cmd->args_type;; p++) {
4380 cmd_args.type = *++p;
4382 if (cmd_args.type == '-') {
4383 cmd_args.flag = *p++;
4384 cmd_args.optional = 1;
4385 } else if (cmd_args.type == 'O') {
4386 opts_list = qemu_find_opts(qstring_get_str(cmd_args.name));
4388 } else if (*p == '?') {
4389 cmd_args.optional = 1;
4393 assert(*p == ',' || *p == '\0');
4395 err = check_opts(opts_list, args);
4398 err = check_arg(&cmd_args, args);
4399 QDECREF(cmd_args.name);
4400 cmd_args_init(&cmd_args);
4407 qstring_append_chr(cmd_args.name, *p);
4415 QDECREF(cmd_args.name);
4419 static int invalid_qmp_mode(const Monitor *mon, const char *cmd_name)
4421 int is_cap = compare_cmd(cmd_name, "qmp_capabilities");
4422 return (qmp_cmd_mode(mon) ? is_cap : !is_cap);
4425 static void handle_qmp_command(JSONMessageParser *parser, QList *tokens)
4429 QDict *input, *args;
4430 const mon_cmd_t *cmd;
4431 Monitor *mon = cur_mon;
4432 const char *cmd_name, *info_item;
4436 obj = json_parser_parse(tokens, NULL);
4438 // FIXME: should be triggered in json_parser_parse()
4439 qerror_report(QERR_JSON_PARSING);
4441 } else if (qobject_type(obj) != QTYPE_QDICT) {
4442 qerror_report(QERR_QMP_BAD_INPUT_OBJECT, "object");
4443 qobject_decref(obj);
4447 input = qobject_to_qdict(obj);
4449 mon->mc->id = qdict_get(input, "id");
4450 qobject_incref(mon->mc->id);
4452 obj = qdict_get(input, "execute");
4454 qerror_report(QERR_QMP_BAD_INPUT_OBJECT, "execute");
4456 } else if (qobject_type(obj) != QTYPE_QSTRING) {
4457 qerror_report(QERR_QMP_BAD_INPUT_OBJECT, "string");
4461 cmd_name = qstring_get_str(qobject_to_qstring(obj));
4463 if (invalid_qmp_mode(mon, cmd_name)) {
4464 qerror_report(QERR_COMMAND_NOT_FOUND, cmd_name);
4469 * XXX: We need this special case until we get info handlers
4470 * converted into 'query-' commands
4472 if (compare_cmd(cmd_name, "info")) {
4473 qerror_report(QERR_COMMAND_NOT_FOUND, cmd_name);
4475 } else if (strstart(cmd_name, "query-", &info_item)) {
4476 cmd = monitor_find_command("info");
4477 qdict_put_obj(input, "arguments",
4478 qobject_from_jsonf("{ 'item': %s }", info_item));
4480 cmd = monitor_find_command(cmd_name);
4481 if (!cmd || !monitor_handler_ported(cmd)) {
4482 qerror_report(QERR_COMMAND_NOT_FOUND, cmd_name);
4487 obj = qdict_get(input, "arguments");
4491 args = qobject_to_qdict(obj);
4497 err = monitor_check_qmp_args(cmd, args);
4502 if (monitor_handler_is_async(cmd)) {
4503 qmp_async_cmd_handler(mon, cmd, args);
4505 monitor_call_handler(mon, cmd, args);
4512 monitor_protocol_emitter(mon, NULL);
4518 * monitor_control_read(): Read and handle QMP input
4520 static void monitor_control_read(void *opaque, const uint8_t *buf, int size)
4522 Monitor *old_mon = cur_mon;
4526 json_message_parser_feed(&cur_mon->mc->parser, (const char *) buf, size);
4531 static void monitor_read(void *opaque, const uint8_t *buf, int size)
4533 Monitor *old_mon = cur_mon;
4539 for (i = 0; i < size; i++)
4540 readline_handle_byte(cur_mon->rs, buf[i]);
4542 if (size == 0 || buf[size - 1] != 0)
4543 monitor_printf(cur_mon, "corrupted command\n");
4545 handle_user_command(cur_mon, (char *)buf);
4551 static void monitor_command_cb(Monitor *mon, const char *cmdline, void *opaque)
4553 monitor_suspend(mon);
4554 handle_user_command(mon, cmdline);
4555 monitor_resume(mon);
4558 int monitor_suspend(Monitor *mon)
4566 void monitor_resume(Monitor *mon)
4570 if (--mon->suspend_cnt == 0)
4571 readline_show_prompt(mon->rs);
4574 static QObject *get_qmp_greeting(void)
4578 do_info_version(NULL, &ver);
4579 return qobject_from_jsonf("{'QMP':{'version': %p,'capabilities': []}}",ver);
4583 * monitor_control_event(): Print QMP gretting
4585 static void monitor_control_event(void *opaque, int event)
4588 Monitor *mon = opaque;
4591 case CHR_EVENT_OPENED:
4592 mon->mc->command_mode = 0;
4593 json_message_parser_init(&mon->mc->parser, handle_qmp_command);
4594 data = get_qmp_greeting();
4595 monitor_json_emitter(mon, data);
4596 qobject_decref(data);
4598 case CHR_EVENT_CLOSED:
4599 json_message_parser_destroy(&mon->mc->parser);
4604 static void monitor_event(void *opaque, int event)
4606 Monitor *mon = opaque;
4609 case CHR_EVENT_MUX_IN:
4611 if (mon->reset_seen) {
4612 readline_restart(mon->rs);
4613 monitor_resume(mon);
4616 mon->suspend_cnt = 0;
4620 case CHR_EVENT_MUX_OUT:
4621 if (mon->reset_seen) {
4622 if (mon->suspend_cnt == 0) {
4623 monitor_printf(mon, "\n");
4626 monitor_suspend(mon);
4633 case CHR_EVENT_OPENED:
4634 monitor_printf(mon, "QEMU %s monitor - type 'help' for more "
4635 "information\n", QEMU_VERSION);
4636 if (!mon->mux_out) {
4637 readline_show_prompt(mon->rs);
4639 mon->reset_seen = 1;
4653 void monitor_init(CharDriverState *chr, int flags)
4655 static int is_first_init = 1;
4658 if (is_first_init) {
4659 key_timer = qemu_new_timer(vm_clock, release_keys, NULL);
4663 mon = qemu_mallocz(sizeof(*mon));
4667 if (flags & MONITOR_USE_READLINE) {
4668 mon->rs = readline_init(mon, monitor_find_completion);
4669 monitor_read_command(mon, 0);
4672 if (monitor_ctrl_mode(mon)) {
4673 mon->mc = qemu_mallocz(sizeof(MonitorControl));
4674 /* Control mode requires special handlers */
4675 qemu_chr_add_handlers(chr, monitor_can_read, monitor_control_read,
4676 monitor_control_event, mon);
4678 qemu_chr_add_handlers(chr, monitor_can_read, monitor_read,
4679 monitor_event, mon);
4682 QLIST_INSERT_HEAD(&mon_list, mon, entry);
4683 if (!default_mon || (flags & MONITOR_IS_DEFAULT))
4687 static void bdrv_password_cb(Monitor *mon, const char *password, void *opaque)
4689 BlockDriverState *bs = opaque;
4692 if (bdrv_set_key(bs, password) != 0) {
4693 monitor_printf(mon, "invalid password\n");
4696 if (mon->password_completion_cb)
4697 mon->password_completion_cb(mon->password_opaque, ret);
4699 monitor_read_command(mon, 1);
4702 int monitor_read_bdrv_key_start(Monitor *mon, BlockDriverState *bs,
4703 BlockDriverCompletionFunc *completion_cb,
4708 if (!bdrv_key_required(bs)) {
4710 completion_cb(opaque, 0);
4714 if (monitor_ctrl_mode(mon)) {
4715 qerror_report(QERR_DEVICE_ENCRYPTED, bdrv_get_device_name(bs));
4719 monitor_printf(mon, "%s (%s) is encrypted.\n", bdrv_get_device_name(bs),
4720 bdrv_get_encrypted_filename(bs));
4722 mon->password_completion_cb = completion_cb;
4723 mon->password_opaque = opaque;
4725 err = monitor_read_password(mon, bdrv_password_cb, bs);
4727 if (err && completion_cb)
4728 completion_cb(opaque, err);