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)
1027 static int eject_device(Monitor *mon, BlockDriverState *bs, int force)
1029 if (bdrv_is_inserted(bs)) {
1031 if (!bdrv_is_removable(bs)) {
1032 qerror_report(QERR_DEVICE_NOT_REMOVABLE,
1033 bdrv_get_device_name(bs));
1036 if (bdrv_is_locked(bs)) {
1037 qerror_report(QERR_DEVICE_LOCKED, bdrv_get_device_name(bs));
1046 static int do_eject(Monitor *mon, const QDict *qdict, QObject **ret_data)
1048 BlockDriverState *bs;
1049 int force = qdict_get_int(qdict, "force");
1050 const char *filename = qdict_get_str(qdict, "device");
1052 bs = bdrv_find(filename);
1054 qerror_report(QERR_DEVICE_NOT_FOUND, filename);
1057 return eject_device(mon, bs, force);
1060 static int do_block_set_passwd(Monitor *mon, const QDict *qdict,
1063 BlockDriverState *bs;
1066 bs = bdrv_find(qdict_get_str(qdict, "device"));
1068 qerror_report(QERR_DEVICE_NOT_FOUND, qdict_get_str(qdict, "device"));
1072 err = bdrv_set_key(bs, qdict_get_str(qdict, "password"));
1073 if (err == -EINVAL) {
1074 qerror_report(QERR_DEVICE_NOT_ENCRYPTED, bdrv_get_device_name(bs));
1076 } else if (err < 0) {
1077 qerror_report(QERR_INVALID_PASSWORD);
1084 static int do_change_block(Monitor *mon, const char *device,
1085 const char *filename, const char *fmt)
1087 BlockDriverState *bs;
1088 BlockDriver *drv = NULL;
1091 bs = bdrv_find(device);
1093 qerror_report(QERR_DEVICE_NOT_FOUND, device);
1097 drv = bdrv_find_whitelisted_format(fmt);
1099 qerror_report(QERR_INVALID_BLOCK_FORMAT, fmt);
1103 if (eject_device(mon, bs, 0) < 0) {
1106 bdrv_flags = bdrv_get_type_hint(bs) == BDRV_TYPE_CDROM ? 0 : BDRV_O_RDWR;
1107 if (bdrv_open(bs, filename, bdrv_flags, drv) < 0) {
1108 qerror_report(QERR_OPEN_FILE_FAILED, filename);
1111 return monitor_read_bdrv_key_start(mon, bs, NULL, NULL);
1114 static int change_vnc_password(const char *password)
1116 if (vnc_display_password(NULL, password) < 0) {
1117 qerror_report(QERR_SET_PASSWD_FAILED);
1124 static void change_vnc_password_cb(Monitor *mon, const char *password,
1127 change_vnc_password(password);
1128 monitor_read_command(mon, 1);
1131 static int do_change_vnc(Monitor *mon, const char *target, const char *arg)
1133 if (strcmp(target, "passwd") == 0 ||
1134 strcmp(target, "password") == 0) {
1137 strncpy(password, arg, sizeof(password));
1138 password[sizeof(password) - 1] = '\0';
1139 return change_vnc_password(password);
1141 return monitor_read_password(mon, change_vnc_password_cb, NULL);
1144 if (vnc_display_open(NULL, target) < 0) {
1145 qerror_report(QERR_VNC_SERVER_FAILED, target);
1154 * do_change(): Change a removable medium, or VNC configuration
1156 static int do_change(Monitor *mon, const QDict *qdict, QObject **ret_data)
1158 const char *device = qdict_get_str(qdict, "device");
1159 const char *target = qdict_get_str(qdict, "target");
1160 const char *arg = qdict_get_try_str(qdict, "arg");
1163 if (strcmp(device, "vnc") == 0) {
1164 ret = do_change_vnc(mon, target, arg);
1166 ret = do_change_block(mon, device, target, arg);
1172 static int do_screen_dump(Monitor *mon, const QDict *qdict, QObject **ret_data)
1174 vga_hw_screen_dump(qdict_get_str(qdict, "filename"));
1178 static void do_logfile(Monitor *mon, const QDict *qdict)
1180 cpu_set_log_filename(qdict_get_str(qdict, "filename"));
1183 static void do_log(Monitor *mon, const QDict *qdict)
1186 const char *items = qdict_get_str(qdict, "items");
1188 if (!strcmp(items, "none")) {
1191 mask = cpu_str_to_log_mask(items);
1193 help_cmd(mon, "log");
1200 static void do_singlestep(Monitor *mon, const QDict *qdict)
1202 const char *option = qdict_get_try_str(qdict, "option");
1203 if (!option || !strcmp(option, "on")) {
1205 } else if (!strcmp(option, "off")) {
1208 monitor_printf(mon, "unexpected option %s\n", option);
1213 * do_stop(): Stop VM execution
1215 static int do_stop(Monitor *mon, const QDict *qdict, QObject **ret_data)
1217 vm_stop(EXCP_INTERRUPT);
1221 static void encrypted_bdrv_it(void *opaque, BlockDriverState *bs);
1223 struct bdrv_iterate_context {
1229 * do_cont(): Resume emulation.
1231 static int do_cont(Monitor *mon, const QDict *qdict, QObject **ret_data)
1233 struct bdrv_iterate_context context = { mon, 0 };
1235 bdrv_iterate(encrypted_bdrv_it, &context);
1236 /* only resume the vm if all keys are set and valid */
1245 static void bdrv_key_cb(void *opaque, int err)
1247 Monitor *mon = opaque;
1249 /* another key was set successfully, retry to continue */
1251 do_cont(mon, NULL, NULL);
1254 static void encrypted_bdrv_it(void *opaque, BlockDriverState *bs)
1256 struct bdrv_iterate_context *context = opaque;
1258 if (!context->err && bdrv_key_required(bs)) {
1259 context->err = -EBUSY;
1260 monitor_read_bdrv_key_start(context->mon, bs, bdrv_key_cb,
1265 static void do_gdbserver(Monitor *mon, const QDict *qdict)
1267 const char *device = qdict_get_try_str(qdict, "device");
1269 device = "tcp::" DEFAULT_GDBSTUB_PORT;
1270 if (gdbserver_start(device) < 0) {
1271 monitor_printf(mon, "Could not open gdbserver on device '%s'\n",
1273 } else if (strcmp(device, "none") == 0) {
1274 monitor_printf(mon, "Disabled gdbserver\n");
1276 monitor_printf(mon, "Waiting for gdb connection on device '%s'\n",
1281 static void do_watchdog_action(Monitor *mon, const QDict *qdict)
1283 const char *action = qdict_get_str(qdict, "action");
1284 if (select_watchdog_action(action) == -1) {
1285 monitor_printf(mon, "Unknown watchdog action '%s'\n", action);
1289 static void monitor_printc(Monitor *mon, int c)
1291 monitor_printf(mon, "'");
1294 monitor_printf(mon, "\\'");
1297 monitor_printf(mon, "\\\\");
1300 monitor_printf(mon, "\\n");
1303 monitor_printf(mon, "\\r");
1306 if (c >= 32 && c <= 126) {
1307 monitor_printf(mon, "%c", c);
1309 monitor_printf(mon, "\\x%02x", c);
1313 monitor_printf(mon, "'");
1316 static void memory_dump(Monitor *mon, int count, int format, int wsize,
1317 target_phys_addr_t addr, int is_physical)
1320 int l, line_size, i, max_digits, len;
1324 if (format == 'i') {
1327 env = mon_get_cpu();
1331 } else if (wsize == 4) {
1334 /* as default we use the current CS size */
1337 #ifdef TARGET_X86_64
1338 if ((env->efer & MSR_EFER_LMA) &&
1339 (env->segs[R_CS].flags & DESC_L_MASK))
1343 if (!(env->segs[R_CS].flags & DESC_B_MASK))
1348 monitor_disas(mon, env, addr, count, is_physical, flags);
1352 len = wsize * count;
1361 max_digits = (wsize * 8 + 2) / 3;
1365 max_digits = (wsize * 8) / 4;
1369 max_digits = (wsize * 8 * 10 + 32) / 33;
1378 monitor_printf(mon, TARGET_FMT_plx ":", addr);
1380 monitor_printf(mon, TARGET_FMT_lx ":", (target_ulong)addr);
1385 cpu_physical_memory_rw(addr, buf, l, 0);
1387 env = mon_get_cpu();
1388 if (cpu_memory_rw_debug(env, addr, buf, l, 0) < 0) {
1389 monitor_printf(mon, " Cannot access memory\n");
1398 v = ldub_raw(buf + i);
1401 v = lduw_raw(buf + i);
1404 v = (uint32_t)ldl_raw(buf + i);
1407 v = ldq_raw(buf + i);
1410 monitor_printf(mon, " ");
1413 monitor_printf(mon, "%#*" PRIo64, max_digits, v);
1416 monitor_printf(mon, "0x%0*" PRIx64, max_digits, v);
1419 monitor_printf(mon, "%*" PRIu64, max_digits, v);
1422 monitor_printf(mon, "%*" PRId64, max_digits, v);
1425 monitor_printc(mon, v);
1430 monitor_printf(mon, "\n");
1436 static void do_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_long addr = qdict_get_int(qdict, "addr");
1443 memory_dump(mon, count, format, size, addr, 0);
1446 static void do_physical_memory_dump(Monitor *mon, const QDict *qdict)
1448 int count = qdict_get_int(qdict, "count");
1449 int format = qdict_get_int(qdict, "format");
1450 int size = qdict_get_int(qdict, "size");
1451 target_phys_addr_t addr = qdict_get_int(qdict, "addr");
1453 memory_dump(mon, count, format, size, addr, 1);
1456 static void do_print(Monitor *mon, const QDict *qdict)
1458 int format = qdict_get_int(qdict, "format");
1459 target_phys_addr_t val = qdict_get_int(qdict, "val");
1461 #if TARGET_PHYS_ADDR_BITS == 32
1464 monitor_printf(mon, "%#o", val);
1467 monitor_printf(mon, "%#x", val);
1470 monitor_printf(mon, "%u", val);
1474 monitor_printf(mon, "%d", val);
1477 monitor_printc(mon, val);
1483 monitor_printf(mon, "%#" PRIo64, val);
1486 monitor_printf(mon, "%#" PRIx64, val);
1489 monitor_printf(mon, "%" PRIu64, val);
1493 monitor_printf(mon, "%" PRId64, val);
1496 monitor_printc(mon, val);
1500 monitor_printf(mon, "\n");
1503 static int do_memory_save(Monitor *mon, const QDict *qdict, QObject **ret_data)
1506 uint32_t size = qdict_get_int(qdict, "size");
1507 const char *filename = qdict_get_str(qdict, "filename");
1508 target_long addr = qdict_get_int(qdict, "val");
1514 env = mon_get_cpu();
1516 f = fopen(filename, "wb");
1518 qerror_report(QERR_OPEN_FILE_FAILED, filename);
1525 cpu_memory_rw_debug(env, addr, buf, l, 0);
1526 if (fwrite(buf, 1, l, f) != l) {
1527 monitor_printf(mon, "fwrite() error in do_memory_save\n");
1541 static int do_physical_memory_save(Monitor *mon, const QDict *qdict,
1547 uint32_t size = qdict_get_int(qdict, "size");
1548 const char *filename = qdict_get_str(qdict, "filename");
1549 target_phys_addr_t addr = qdict_get_int(qdict, "val");
1552 f = fopen(filename, "wb");
1554 qerror_report(QERR_OPEN_FILE_FAILED, filename);
1561 cpu_physical_memory_rw(addr, buf, l, 0);
1562 if (fwrite(buf, 1, l, f) != l) {
1563 monitor_printf(mon, "fwrite() error in do_physical_memory_save\n");
1578 static void do_sum(Monitor *mon, const QDict *qdict)
1583 uint32_t start = qdict_get_int(qdict, "start");
1584 uint32_t size = qdict_get_int(qdict, "size");
1587 for(addr = start; addr < (start + size); addr++) {
1588 cpu_physical_memory_rw(addr, buf, 1, 0);
1589 /* BSD sum algorithm ('sum' Unix command) */
1590 sum = (sum >> 1) | (sum << 15);
1593 monitor_printf(mon, "%05d\n", sum);
1601 static const KeyDef key_defs[] = {
1603 { 0x36, "shift_r" },
1608 { 0xe4, "altgr_r" },
1628 { 0x0e, "backspace" },
1665 { 0x37, "asterisk" },
1668 { 0x3a, "caps_lock" },
1679 { 0x45, "num_lock" },
1680 { 0x46, "scroll_lock" },
1682 { 0xb5, "kp_divide" },
1683 { 0x37, "kp_multiply" },
1684 { 0x4a, "kp_subtract" },
1686 { 0x9c, "kp_enter" },
1687 { 0x53, "kp_decimal" },
1720 #if defined(TARGET_SPARC) && !defined(TARGET_SPARC64)
1735 { 0xfe, "compose" },
1740 static int get_keycode(const char *key)
1746 for(p = key_defs; p->name != NULL; p++) {
1747 if (!strcmp(key, p->name))
1750 if (strstart(key, "0x", NULL)) {
1751 ret = strtoul(key, &endp, 0);
1752 if (*endp == '\0' && ret >= 0x01 && ret <= 0xff)
1758 #define MAX_KEYCODES 16
1759 static uint8_t keycodes[MAX_KEYCODES];
1760 static int nb_pending_keycodes;
1761 static QEMUTimer *key_timer;
1763 static void release_keys(void *opaque)
1767 while (nb_pending_keycodes > 0) {
1768 nb_pending_keycodes--;
1769 keycode = keycodes[nb_pending_keycodes];
1771 kbd_put_keycode(0xe0);
1772 kbd_put_keycode(keycode | 0x80);
1776 static void do_sendkey(Monitor *mon, const QDict *qdict)
1778 char keyname_buf[16];
1780 int keyname_len, keycode, i;
1781 const char *string = qdict_get_str(qdict, "string");
1782 int has_hold_time = qdict_haskey(qdict, "hold_time");
1783 int hold_time = qdict_get_try_int(qdict, "hold_time", -1);
1785 if (nb_pending_keycodes > 0) {
1786 qemu_del_timer(key_timer);
1793 separator = strchr(string, '-');
1794 keyname_len = separator ? separator - string : strlen(string);
1795 if (keyname_len > 0) {
1796 pstrcpy(keyname_buf, sizeof(keyname_buf), string);
1797 if (keyname_len > sizeof(keyname_buf) - 1) {
1798 monitor_printf(mon, "invalid key: '%s...'\n", keyname_buf);
1801 if (i == MAX_KEYCODES) {
1802 monitor_printf(mon, "too many keys\n");
1805 keyname_buf[keyname_len] = 0;
1806 keycode = get_keycode(keyname_buf);
1808 monitor_printf(mon, "unknown key: '%s'\n", keyname_buf);
1811 keycodes[i++] = keycode;
1815 string = separator + 1;
1817 nb_pending_keycodes = i;
1818 /* key down events */
1819 for (i = 0; i < nb_pending_keycodes; i++) {
1820 keycode = keycodes[i];
1822 kbd_put_keycode(0xe0);
1823 kbd_put_keycode(keycode & 0x7f);
1825 /* delayed key up events */
1826 qemu_mod_timer(key_timer, qemu_get_clock(vm_clock) +
1827 muldiv64(get_ticks_per_sec(), hold_time, 1000));
1830 static int mouse_button_state;
1832 static void do_mouse_move(Monitor *mon, const QDict *qdict)
1835 const char *dx_str = qdict_get_str(qdict, "dx_str");
1836 const char *dy_str = qdict_get_str(qdict, "dy_str");
1837 const char *dz_str = qdict_get_try_str(qdict, "dz_str");
1838 dx = strtol(dx_str, NULL, 0);
1839 dy = strtol(dy_str, NULL, 0);
1842 dz = strtol(dz_str, NULL, 0);
1843 kbd_mouse_event(dx, dy, dz, mouse_button_state);
1846 static void do_mouse_button(Monitor *mon, const QDict *qdict)
1848 int button_state = qdict_get_int(qdict, "button_state");
1849 mouse_button_state = button_state;
1850 kbd_mouse_event(0, 0, 0, mouse_button_state);
1853 static void do_ioport_read(Monitor *mon, const QDict *qdict)
1855 int size = qdict_get_int(qdict, "size");
1856 int addr = qdict_get_int(qdict, "addr");
1857 int has_index = qdict_haskey(qdict, "index");
1862 int index = qdict_get_int(qdict, "index");
1863 cpu_outb(addr & IOPORTS_MASK, index & 0xff);
1871 val = cpu_inb(addr);
1875 val = cpu_inw(addr);
1879 val = cpu_inl(addr);
1883 monitor_printf(mon, "port%c[0x%04x] = %#0*x\n",
1884 suffix, addr, size * 2, val);
1887 static void do_ioport_write(Monitor *mon, const QDict *qdict)
1889 int size = qdict_get_int(qdict, "size");
1890 int addr = qdict_get_int(qdict, "addr");
1891 int val = qdict_get_int(qdict, "val");
1893 addr &= IOPORTS_MASK;
1898 cpu_outb(addr, val);
1901 cpu_outw(addr, val);
1904 cpu_outl(addr, val);
1909 static void do_boot_set(Monitor *mon, const QDict *qdict)
1912 const char *bootdevice = qdict_get_str(qdict, "bootdevice");
1914 res = qemu_boot_set(bootdevice);
1916 monitor_printf(mon, "boot device list now set to %s\n", bootdevice);
1917 } else if (res > 0) {
1918 monitor_printf(mon, "setting boot device list failed\n");
1920 monitor_printf(mon, "no function defined to set boot device list for "
1921 "this architecture\n");
1926 * do_system_reset(): Issue a machine reset
1928 static int do_system_reset(Monitor *mon, const QDict *qdict,
1931 qemu_system_reset_request();
1936 * do_system_powerdown(): Issue a machine powerdown
1938 static int do_system_powerdown(Monitor *mon, const QDict *qdict,
1941 qemu_system_powerdown_request();
1945 #if defined(TARGET_I386)
1946 static void print_pte(Monitor *mon, uint32_t addr, uint32_t pte, uint32_t mask)
1948 monitor_printf(mon, "%08x: %08x %c%c%c%c%c%c%c%c\n",
1951 pte & PG_GLOBAL_MASK ? 'G' : '-',
1952 pte & PG_PSE_MASK ? 'P' : '-',
1953 pte & PG_DIRTY_MASK ? 'D' : '-',
1954 pte & PG_ACCESSED_MASK ? 'A' : '-',
1955 pte & PG_PCD_MASK ? 'C' : '-',
1956 pte & PG_PWT_MASK ? 'T' : '-',
1957 pte & PG_USER_MASK ? 'U' : '-',
1958 pte & PG_RW_MASK ? 'W' : '-');
1961 static void tlb_info(Monitor *mon)
1965 uint32_t pgd, pde, pte;
1967 env = mon_get_cpu();
1969 if (!(env->cr[0] & CR0_PG_MASK)) {
1970 monitor_printf(mon, "PG disabled\n");
1973 pgd = env->cr[3] & ~0xfff;
1974 for(l1 = 0; l1 < 1024; l1++) {
1975 cpu_physical_memory_read(pgd + l1 * 4, (uint8_t *)&pde, 4);
1976 pde = le32_to_cpu(pde);
1977 if (pde & PG_PRESENT_MASK) {
1978 if ((pde & PG_PSE_MASK) && (env->cr[4] & CR4_PSE_MASK)) {
1979 print_pte(mon, (l1 << 22), pde, ~((1 << 20) - 1));
1981 for(l2 = 0; l2 < 1024; l2++) {
1982 cpu_physical_memory_read((pde & ~0xfff) + l2 * 4,
1983 (uint8_t *)&pte, 4);
1984 pte = le32_to_cpu(pte);
1985 if (pte & PG_PRESENT_MASK) {
1986 print_pte(mon, (l1 << 22) + (l2 << 12),
1996 static void mem_print(Monitor *mon, uint32_t *pstart, int *plast_prot,
1997 uint32_t end, int prot)
2000 prot1 = *plast_prot;
2001 if (prot != prot1) {
2002 if (*pstart != -1) {
2003 monitor_printf(mon, "%08x-%08x %08x %c%c%c\n",
2004 *pstart, end, end - *pstart,
2005 prot1 & PG_USER_MASK ? 'u' : '-',
2007 prot1 & PG_RW_MASK ? 'w' : '-');
2017 static void mem_info(Monitor *mon)
2020 int l1, l2, prot, last_prot;
2021 uint32_t pgd, pde, pte, start, end;
2023 env = mon_get_cpu();
2025 if (!(env->cr[0] & CR0_PG_MASK)) {
2026 monitor_printf(mon, "PG disabled\n");
2029 pgd = env->cr[3] & ~0xfff;
2032 for(l1 = 0; l1 < 1024; l1++) {
2033 cpu_physical_memory_read(pgd + l1 * 4, (uint8_t *)&pde, 4);
2034 pde = le32_to_cpu(pde);
2036 if (pde & PG_PRESENT_MASK) {
2037 if ((pde & PG_PSE_MASK) && (env->cr[4] & CR4_PSE_MASK)) {
2038 prot = pde & (PG_USER_MASK | PG_RW_MASK | PG_PRESENT_MASK);
2039 mem_print(mon, &start, &last_prot, end, prot);
2041 for(l2 = 0; l2 < 1024; l2++) {
2042 cpu_physical_memory_read((pde & ~0xfff) + l2 * 4,
2043 (uint8_t *)&pte, 4);
2044 pte = le32_to_cpu(pte);
2045 end = (l1 << 22) + (l2 << 12);
2046 if (pte & PG_PRESENT_MASK) {
2047 prot = pte & (PG_USER_MASK | PG_RW_MASK | PG_PRESENT_MASK);
2051 mem_print(mon, &start, &last_prot, end, prot);
2056 mem_print(mon, &start, &last_prot, end, prot);
2062 #if defined(TARGET_SH4)
2064 static void print_tlb(Monitor *mon, int idx, tlb_t *tlb)
2066 monitor_printf(mon, " tlb%i:\t"
2067 "asid=%hhu vpn=%x\tppn=%x\tsz=%hhu size=%u\t"
2068 "v=%hhu shared=%hhu cached=%hhu prot=%hhu "
2069 "dirty=%hhu writethrough=%hhu\n",
2071 tlb->asid, tlb->vpn, tlb->ppn, tlb->sz, tlb->size,
2072 tlb->v, tlb->sh, tlb->c, tlb->pr,
2076 static void tlb_info(Monitor *mon)
2078 CPUState *env = mon_get_cpu();
2081 monitor_printf (mon, "ITLB:\n");
2082 for (i = 0 ; i < ITLB_SIZE ; i++)
2083 print_tlb (mon, i, &env->itlb[i]);
2084 monitor_printf (mon, "UTLB:\n");
2085 for (i = 0 ; i < UTLB_SIZE ; i++)
2086 print_tlb (mon, i, &env->utlb[i]);
2091 static void do_info_kvm_print(Monitor *mon, const QObject *data)
2095 qdict = qobject_to_qdict(data);
2097 monitor_printf(mon, "kvm support: ");
2098 if (qdict_get_bool(qdict, "present")) {
2099 monitor_printf(mon, "%s\n", qdict_get_bool(qdict, "enabled") ?
2100 "enabled" : "disabled");
2102 monitor_printf(mon, "not compiled\n");
2107 * do_info_kvm(): Show KVM information
2109 * Return a QDict with the following information:
2111 * - "enabled": true if KVM support is enabled, false otherwise
2112 * - "present": true if QEMU has KVM support, false otherwise
2116 * { "enabled": true, "present": true }
2118 static void do_info_kvm(Monitor *mon, QObject **ret_data)
2121 *ret_data = qobject_from_jsonf("{ 'enabled': %i, 'present': true }",
2124 *ret_data = qobject_from_jsonf("{ 'enabled': false, 'present': false }");
2128 static void do_info_numa(Monitor *mon)
2133 monitor_printf(mon, "%d nodes\n", nb_numa_nodes);
2134 for (i = 0; i < nb_numa_nodes; i++) {
2135 monitor_printf(mon, "node %d cpus:", i);
2136 for (env = first_cpu; env != NULL; env = env->next_cpu) {
2137 if (env->numa_node == i) {
2138 monitor_printf(mon, " %d", env->cpu_index);
2141 monitor_printf(mon, "\n");
2142 monitor_printf(mon, "node %d size: %" PRId64 " MB\n", i,
2147 #ifdef CONFIG_PROFILER
2152 static void do_info_profile(Monitor *mon)
2158 monitor_printf(mon, "async time %" PRId64 " (%0.3f)\n",
2159 dev_time, dev_time / (double)get_ticks_per_sec());
2160 monitor_printf(mon, "qemu time %" PRId64 " (%0.3f)\n",
2161 qemu_time, qemu_time / (double)get_ticks_per_sec());
2166 static void do_info_profile(Monitor *mon)
2168 monitor_printf(mon, "Internal profiler not compiled\n");
2172 /* Capture support */
2173 static QLIST_HEAD (capture_list_head, CaptureState) capture_head;
2175 static void do_info_capture(Monitor *mon)
2180 for (s = capture_head.lh_first, i = 0; s; s = s->entries.le_next, ++i) {
2181 monitor_printf(mon, "[%d]: ", i);
2182 s->ops.info (s->opaque);
2187 static void do_stop_capture(Monitor *mon, const QDict *qdict)
2190 int n = qdict_get_int(qdict, "n");
2193 for (s = capture_head.lh_first, i = 0; s; s = s->entries.le_next, ++i) {
2195 s->ops.destroy (s->opaque);
2196 QLIST_REMOVE (s, entries);
2203 static void do_wav_capture(Monitor *mon, const QDict *qdict)
2205 const char *path = qdict_get_str(qdict, "path");
2206 int has_freq = qdict_haskey(qdict, "freq");
2207 int freq = qdict_get_try_int(qdict, "freq", -1);
2208 int has_bits = qdict_haskey(qdict, "bits");
2209 int bits = qdict_get_try_int(qdict, "bits", -1);
2210 int has_channels = qdict_haskey(qdict, "nchannels");
2211 int nchannels = qdict_get_try_int(qdict, "nchannels", -1);
2214 s = qemu_mallocz (sizeof (*s));
2216 freq = has_freq ? freq : 44100;
2217 bits = has_bits ? bits : 16;
2218 nchannels = has_channels ? nchannels : 2;
2220 if (wav_start_capture (s, path, freq, bits, nchannels)) {
2221 monitor_printf(mon, "Faied to add wave capture\n");
2224 QLIST_INSERT_HEAD (&capture_head, s, entries);
2228 #if defined(TARGET_I386)
2229 static void do_inject_nmi(Monitor *mon, const QDict *qdict)
2232 int cpu_index = qdict_get_int(qdict, "cpu_index");
2234 for (env = first_cpu; env != NULL; env = env->next_cpu)
2235 if (env->cpu_index == cpu_index) {
2236 cpu_interrupt(env, CPU_INTERRUPT_NMI);
2242 static void do_info_status_print(Monitor *mon, const QObject *data)
2246 qdict = qobject_to_qdict(data);
2248 monitor_printf(mon, "VM status: ");
2249 if (qdict_get_bool(qdict, "running")) {
2250 monitor_printf(mon, "running");
2251 if (qdict_get_bool(qdict, "singlestep")) {
2252 monitor_printf(mon, " (single step mode)");
2255 monitor_printf(mon, "paused");
2258 monitor_printf(mon, "\n");
2262 * do_info_status(): VM status
2264 * Return a QDict with the following information:
2266 * - "running": true if the VM is running, or false if it is paused
2267 * - "singlestep": true if the VM is in single step mode, false otherwise
2271 * { "running": true, "singlestep": false }
2273 static void do_info_status(Monitor *mon, QObject **ret_data)
2275 *ret_data = qobject_from_jsonf("{ 'running': %i, 'singlestep': %i }",
2276 vm_running, singlestep);
2279 static qemu_acl *find_acl(Monitor *mon, const char *name)
2281 qemu_acl *acl = qemu_acl_find(name);
2284 monitor_printf(mon, "acl: unknown list '%s'\n", name);
2289 static void do_acl_show(Monitor *mon, const QDict *qdict)
2291 const char *aclname = qdict_get_str(qdict, "aclname");
2292 qemu_acl *acl = find_acl(mon, aclname);
2293 qemu_acl_entry *entry;
2297 monitor_printf(mon, "policy: %s\n",
2298 acl->defaultDeny ? "deny" : "allow");
2299 QTAILQ_FOREACH(entry, &acl->entries, next) {
2301 monitor_printf(mon, "%d: %s %s\n", i,
2302 entry->deny ? "deny" : "allow", entry->match);
2307 static void do_acl_reset(Monitor *mon, const QDict *qdict)
2309 const char *aclname = qdict_get_str(qdict, "aclname");
2310 qemu_acl *acl = find_acl(mon, aclname);
2313 qemu_acl_reset(acl);
2314 monitor_printf(mon, "acl: removed all rules\n");
2318 static void do_acl_policy(Monitor *mon, const QDict *qdict)
2320 const char *aclname = qdict_get_str(qdict, "aclname");
2321 const char *policy = qdict_get_str(qdict, "policy");
2322 qemu_acl *acl = find_acl(mon, aclname);
2325 if (strcmp(policy, "allow") == 0) {
2326 acl->defaultDeny = 0;
2327 monitor_printf(mon, "acl: policy set to 'allow'\n");
2328 } else if (strcmp(policy, "deny") == 0) {
2329 acl->defaultDeny = 1;
2330 monitor_printf(mon, "acl: policy set to 'deny'\n");
2332 monitor_printf(mon, "acl: unknown policy '%s', "
2333 "expected 'deny' or 'allow'\n", policy);
2338 static void do_acl_add(Monitor *mon, const QDict *qdict)
2340 const char *aclname = qdict_get_str(qdict, "aclname");
2341 const char *match = qdict_get_str(qdict, "match");
2342 const char *policy = qdict_get_str(qdict, "policy");
2343 int has_index = qdict_haskey(qdict, "index");
2344 int index = qdict_get_try_int(qdict, "index", -1);
2345 qemu_acl *acl = find_acl(mon, aclname);
2349 if (strcmp(policy, "allow") == 0) {
2351 } else if (strcmp(policy, "deny") == 0) {
2354 monitor_printf(mon, "acl: unknown policy '%s', "
2355 "expected 'deny' or 'allow'\n", policy);
2359 ret = qemu_acl_insert(acl, deny, match, index);
2361 ret = qemu_acl_append(acl, deny, match);
2363 monitor_printf(mon, "acl: unable to add acl entry\n");
2365 monitor_printf(mon, "acl: added rule at position %d\n", ret);
2369 static void do_acl_remove(Monitor *mon, const QDict *qdict)
2371 const char *aclname = qdict_get_str(qdict, "aclname");
2372 const char *match = qdict_get_str(qdict, "match");
2373 qemu_acl *acl = find_acl(mon, aclname);
2377 ret = qemu_acl_remove(acl, match);
2379 monitor_printf(mon, "acl: no matching acl entry\n");
2381 monitor_printf(mon, "acl: removed rule at position %d\n", ret);
2385 #if defined(TARGET_I386)
2386 static void do_inject_mce(Monitor *mon, const QDict *qdict)
2389 int cpu_index = qdict_get_int(qdict, "cpu_index");
2390 int bank = qdict_get_int(qdict, "bank");
2391 uint64_t status = qdict_get_int(qdict, "status");
2392 uint64_t mcg_status = qdict_get_int(qdict, "mcg_status");
2393 uint64_t addr = qdict_get_int(qdict, "addr");
2394 uint64_t misc = qdict_get_int(qdict, "misc");
2396 for (cenv = first_cpu; cenv != NULL; cenv = cenv->next_cpu)
2397 if (cenv->cpu_index == cpu_index && cenv->mcg_cap) {
2398 cpu_inject_x86_mce(cenv, bank, status, mcg_status, addr, misc);
2404 static int do_getfd(Monitor *mon, const QDict *qdict, QObject **ret_data)
2406 const char *fdname = qdict_get_str(qdict, "fdname");
2410 fd = qemu_chr_get_msgfd(mon->chr);
2412 qerror_report(QERR_FD_NOT_SUPPLIED);
2416 if (qemu_isdigit(fdname[0])) {
2417 qerror_report(QERR_INVALID_PARAMETER_VALUE, "fdname",
2418 "a name not starting with a digit");
2422 QLIST_FOREACH(monfd, &mon->fds, next) {
2423 if (strcmp(monfd->name, fdname) != 0) {
2432 monfd = qemu_mallocz(sizeof(mon_fd_t));
2433 monfd->name = qemu_strdup(fdname);
2436 QLIST_INSERT_HEAD(&mon->fds, monfd, next);
2440 static int do_closefd(Monitor *mon, const QDict *qdict, QObject **ret_data)
2442 const char *fdname = qdict_get_str(qdict, "fdname");
2445 QLIST_FOREACH(monfd, &mon->fds, next) {
2446 if (strcmp(monfd->name, fdname) != 0) {
2450 QLIST_REMOVE(monfd, next);
2452 qemu_free(monfd->name);
2457 qerror_report(QERR_FD_NOT_FOUND, fdname);
2461 static void do_loadvm(Monitor *mon, const QDict *qdict)
2463 int saved_vm_running = vm_running;
2464 const char *name = qdict_get_str(qdict, "name");
2468 if (load_vmstate(name) >= 0 && saved_vm_running)
2472 int monitor_get_fd(Monitor *mon, const char *fdname)
2476 QLIST_FOREACH(monfd, &mon->fds, next) {
2479 if (strcmp(monfd->name, fdname) != 0) {
2485 /* caller takes ownership of fd */
2486 QLIST_REMOVE(monfd, next);
2487 qemu_free(monfd->name);
2496 static const mon_cmd_t mon_cmds[] = {
2497 #include "qemu-monitor.h"
2501 /* Please update qemu-monitor.hx when adding or changing commands */
2502 static const mon_cmd_t info_cmds[] = {
2507 .help = "show the version of QEMU",
2508 .user_print = do_info_version_print,
2509 .mhandler.info_new = do_info_version,
2515 .help = "list QMP available commands",
2516 .user_print = monitor_user_noop,
2517 .mhandler.info_new = do_info_commands,
2523 .help = "show the network state",
2524 .mhandler.info = do_info_network,
2530 .help = "show the character devices",
2531 .user_print = qemu_chr_info_print,
2532 .mhandler.info_new = qemu_chr_info,
2538 .help = "show the block devices",
2539 .user_print = bdrv_info_print,
2540 .mhandler.info_new = bdrv_info,
2543 .name = "blockstats",
2546 .help = "show block device statistics",
2547 .user_print = bdrv_stats_print,
2548 .mhandler.info_new = bdrv_info_stats,
2551 .name = "registers",
2554 .help = "show the cpu registers",
2555 .mhandler.info = do_info_registers,
2561 .help = "show infos for each CPU",
2562 .user_print = monitor_print_cpus,
2563 .mhandler.info_new = do_info_cpus,
2569 .help = "show the command line history",
2570 .mhandler.info = do_info_history,
2576 .help = "show the interrupts statistics (if available)",
2577 .mhandler.info = irq_info,
2583 .help = "show i8259 (PIC) state",
2584 .mhandler.info = pic_info,
2590 .help = "show PCI info",
2591 .user_print = do_pci_info_print,
2592 .mhandler.info_new = do_pci_info,
2594 #if defined(TARGET_I386) || defined(TARGET_SH4)
2599 .help = "show virtual to physical memory mappings",
2600 .mhandler.info = tlb_info,
2603 #if defined(TARGET_I386)
2608 .help = "show the active virtual memory mappings",
2609 .mhandler.info = mem_info,
2615 .help = "show state of HPET",
2616 .user_print = do_info_hpet_print,
2617 .mhandler.info_new = do_info_hpet,
2624 .help = "show dynamic compiler info",
2625 .mhandler.info = do_info_jit,
2631 .help = "show KVM information",
2632 .user_print = do_info_kvm_print,
2633 .mhandler.info_new = do_info_kvm,
2639 .help = "show NUMA information",
2640 .mhandler.info = do_info_numa,
2646 .help = "show guest USB devices",
2647 .mhandler.info = usb_info,
2653 .help = "show host USB devices",
2654 .mhandler.info = usb_host_info,
2660 .help = "show profiling information",
2661 .mhandler.info = do_info_profile,
2667 .help = "show capture information",
2668 .mhandler.info = do_info_capture,
2671 .name = "snapshots",
2674 .help = "show the currently saved VM snapshots",
2675 .mhandler.info = do_info_snapshots,
2681 .help = "show the current VM status (running|paused)",
2682 .user_print = do_info_status_print,
2683 .mhandler.info_new = do_info_status,
2689 .help = "show guest PCMCIA status",
2690 .mhandler.info = pcmcia_info,
2696 .help = "show which guest mouse is receiving events",
2697 .user_print = do_info_mice_print,
2698 .mhandler.info_new = do_info_mice,
2704 .help = "show the vnc server status",
2705 .user_print = do_info_vnc_print,
2706 .mhandler.info_new = do_info_vnc,
2712 .help = "show the current VM name",
2713 .user_print = do_info_name_print,
2714 .mhandler.info_new = do_info_name,
2720 .help = "show the current VM UUID",
2721 .user_print = do_info_uuid_print,
2722 .mhandler.info_new = do_info_uuid,
2724 #if defined(TARGET_PPC)
2729 .help = "show CPU statistics",
2730 .mhandler.info = do_info_cpu_stats,
2733 #if defined(CONFIG_SLIRP)
2738 .help = "show user network stack connection states",
2739 .mhandler.info = do_info_usernet,
2746 .help = "show migration status",
2747 .user_print = do_info_migrate_print,
2748 .mhandler.info_new = do_info_migrate,
2754 .help = "show balloon information",
2755 .user_print = monitor_print_balloon,
2756 .mhandler.info_async = do_info_balloon,
2763 .help = "show device tree",
2764 .mhandler.info = do_info_qtree,
2770 .help = "show qdev device model list",
2771 .mhandler.info = do_info_qdm,
2777 .help = "show roms",
2778 .mhandler.info = do_info_roms,
2785 /*******************************************************************/
2787 static const char *pch;
2788 static jmp_buf expr_env;
2793 typedef struct MonitorDef {
2796 target_long (*get_value)(const struct MonitorDef *md, int val);
2800 #if defined(TARGET_I386)
2801 static target_long monitor_get_pc (const struct MonitorDef *md, int val)
2803 CPUState *env = mon_get_cpu();
2804 return env->eip + env->segs[R_CS].base;
2808 #if defined(TARGET_PPC)
2809 static target_long monitor_get_ccr (const struct MonitorDef *md, int val)
2811 CPUState *env = mon_get_cpu();
2816 for (i = 0; i < 8; i++)
2817 u |= env->crf[i] << (32 - (4 * i));
2822 static target_long monitor_get_msr (const struct MonitorDef *md, int val)
2824 CPUState *env = mon_get_cpu();
2828 static target_long monitor_get_xer (const struct MonitorDef *md, int val)
2830 CPUState *env = mon_get_cpu();
2834 static target_long monitor_get_decr (const struct MonitorDef *md, int val)
2836 CPUState *env = mon_get_cpu();
2837 return cpu_ppc_load_decr(env);
2840 static target_long monitor_get_tbu (const struct MonitorDef *md, int val)
2842 CPUState *env = mon_get_cpu();
2843 return cpu_ppc_load_tbu(env);
2846 static target_long monitor_get_tbl (const struct MonitorDef *md, int val)
2848 CPUState *env = mon_get_cpu();
2849 return cpu_ppc_load_tbl(env);
2853 #if defined(TARGET_SPARC)
2854 #ifndef TARGET_SPARC64
2855 static target_long monitor_get_psr (const struct MonitorDef *md, int val)
2857 CPUState *env = mon_get_cpu();
2859 return cpu_get_psr(env);
2863 static target_long monitor_get_reg(const struct MonitorDef *md, int val)
2865 CPUState *env = mon_get_cpu();
2866 return env->regwptr[val];
2870 static const MonitorDef monitor_defs[] = {
2873 #define SEG(name, seg) \
2874 { name, offsetof(CPUState, segs[seg].selector), NULL, MD_I32 },\
2875 { name ".base", offsetof(CPUState, segs[seg].base) },\
2876 { name ".limit", offsetof(CPUState, segs[seg].limit), NULL, MD_I32 },
2878 { "eax", offsetof(CPUState, regs[0]) },
2879 { "ecx", offsetof(CPUState, regs[1]) },
2880 { "edx", offsetof(CPUState, regs[2]) },
2881 { "ebx", offsetof(CPUState, regs[3]) },
2882 { "esp|sp", offsetof(CPUState, regs[4]) },
2883 { "ebp|fp", offsetof(CPUState, regs[5]) },
2884 { "esi", offsetof(CPUState, regs[6]) },
2885 { "edi", offsetof(CPUState, regs[7]) },
2886 #ifdef TARGET_X86_64
2887 { "r8", offsetof(CPUState, regs[8]) },
2888 { "r9", offsetof(CPUState, regs[9]) },
2889 { "r10", offsetof(CPUState, regs[10]) },
2890 { "r11", offsetof(CPUState, regs[11]) },
2891 { "r12", offsetof(CPUState, regs[12]) },
2892 { "r13", offsetof(CPUState, regs[13]) },
2893 { "r14", offsetof(CPUState, regs[14]) },
2894 { "r15", offsetof(CPUState, regs[15]) },
2896 { "eflags", offsetof(CPUState, eflags) },
2897 { "eip", offsetof(CPUState, eip) },
2904 { "pc", 0, monitor_get_pc, },
2905 #elif defined(TARGET_PPC)
2906 /* General purpose registers */
2907 { "r0", offsetof(CPUState, gpr[0]) },
2908 { "r1", offsetof(CPUState, gpr[1]) },
2909 { "r2", offsetof(CPUState, gpr[2]) },
2910 { "r3", offsetof(CPUState, gpr[3]) },
2911 { "r4", offsetof(CPUState, gpr[4]) },
2912 { "r5", offsetof(CPUState, gpr[5]) },
2913 { "r6", offsetof(CPUState, gpr[6]) },
2914 { "r7", offsetof(CPUState, gpr[7]) },
2915 { "r8", offsetof(CPUState, gpr[8]) },
2916 { "r9", offsetof(CPUState, gpr[9]) },
2917 { "r10", offsetof(CPUState, gpr[10]) },
2918 { "r11", offsetof(CPUState, gpr[11]) },
2919 { "r12", offsetof(CPUState, gpr[12]) },
2920 { "r13", offsetof(CPUState, gpr[13]) },
2921 { "r14", offsetof(CPUState, gpr[14]) },
2922 { "r15", offsetof(CPUState, gpr[15]) },
2923 { "r16", offsetof(CPUState, gpr[16]) },
2924 { "r17", offsetof(CPUState, gpr[17]) },
2925 { "r18", offsetof(CPUState, gpr[18]) },
2926 { "r19", offsetof(CPUState, gpr[19]) },
2927 { "r20", offsetof(CPUState, gpr[20]) },
2928 { "r21", offsetof(CPUState, gpr[21]) },
2929 { "r22", offsetof(CPUState, gpr[22]) },
2930 { "r23", offsetof(CPUState, gpr[23]) },
2931 { "r24", offsetof(CPUState, gpr[24]) },
2932 { "r25", offsetof(CPUState, gpr[25]) },
2933 { "r26", offsetof(CPUState, gpr[26]) },
2934 { "r27", offsetof(CPUState, gpr[27]) },
2935 { "r28", offsetof(CPUState, gpr[28]) },
2936 { "r29", offsetof(CPUState, gpr[29]) },
2937 { "r30", offsetof(CPUState, gpr[30]) },
2938 { "r31", offsetof(CPUState, gpr[31]) },
2939 /* Floating point registers */
2940 { "f0", offsetof(CPUState, fpr[0]) },
2941 { "f1", offsetof(CPUState, fpr[1]) },
2942 { "f2", offsetof(CPUState, fpr[2]) },
2943 { "f3", offsetof(CPUState, fpr[3]) },
2944 { "f4", offsetof(CPUState, fpr[4]) },
2945 { "f5", offsetof(CPUState, fpr[5]) },
2946 { "f6", offsetof(CPUState, fpr[6]) },
2947 { "f7", offsetof(CPUState, fpr[7]) },
2948 { "f8", offsetof(CPUState, fpr[8]) },
2949 { "f9", offsetof(CPUState, fpr[9]) },
2950 { "f10", offsetof(CPUState, fpr[10]) },
2951 { "f11", offsetof(CPUState, fpr[11]) },
2952 { "f12", offsetof(CPUState, fpr[12]) },
2953 { "f13", offsetof(CPUState, fpr[13]) },
2954 { "f14", offsetof(CPUState, fpr[14]) },
2955 { "f15", offsetof(CPUState, fpr[15]) },
2956 { "f16", offsetof(CPUState, fpr[16]) },
2957 { "f17", offsetof(CPUState, fpr[17]) },
2958 { "f18", offsetof(CPUState, fpr[18]) },
2959 { "f19", offsetof(CPUState, fpr[19]) },
2960 { "f20", offsetof(CPUState, fpr[20]) },
2961 { "f21", offsetof(CPUState, fpr[21]) },
2962 { "f22", offsetof(CPUState, fpr[22]) },
2963 { "f23", offsetof(CPUState, fpr[23]) },
2964 { "f24", offsetof(CPUState, fpr[24]) },
2965 { "f25", offsetof(CPUState, fpr[25]) },
2966 { "f26", offsetof(CPUState, fpr[26]) },
2967 { "f27", offsetof(CPUState, fpr[27]) },
2968 { "f28", offsetof(CPUState, fpr[28]) },
2969 { "f29", offsetof(CPUState, fpr[29]) },
2970 { "f30", offsetof(CPUState, fpr[30]) },
2971 { "f31", offsetof(CPUState, fpr[31]) },
2972 { "fpscr", offsetof(CPUState, fpscr) },
2973 /* Next instruction pointer */
2974 { "nip|pc", offsetof(CPUState, nip) },
2975 { "lr", offsetof(CPUState, lr) },
2976 { "ctr", offsetof(CPUState, ctr) },
2977 { "decr", 0, &monitor_get_decr, },
2978 { "ccr", 0, &monitor_get_ccr, },
2979 /* Machine state register */
2980 { "msr", 0, &monitor_get_msr, },
2981 { "xer", 0, &monitor_get_xer, },
2982 { "tbu", 0, &monitor_get_tbu, },
2983 { "tbl", 0, &monitor_get_tbl, },
2984 #if defined(TARGET_PPC64)
2985 /* Address space register */
2986 { "asr", offsetof(CPUState, asr) },
2988 /* Segment registers */
2989 { "sdr1", offsetof(CPUState, sdr1) },
2990 { "sr0", offsetof(CPUState, sr[0]) },
2991 { "sr1", offsetof(CPUState, sr[1]) },
2992 { "sr2", offsetof(CPUState, sr[2]) },
2993 { "sr3", offsetof(CPUState, sr[3]) },
2994 { "sr4", offsetof(CPUState, sr[4]) },
2995 { "sr5", offsetof(CPUState, sr[5]) },
2996 { "sr6", offsetof(CPUState, sr[6]) },
2997 { "sr7", offsetof(CPUState, sr[7]) },
2998 { "sr8", offsetof(CPUState, sr[8]) },
2999 { "sr9", offsetof(CPUState, sr[9]) },
3000 { "sr10", offsetof(CPUState, sr[10]) },
3001 { "sr11", offsetof(CPUState, sr[11]) },
3002 { "sr12", offsetof(CPUState, sr[12]) },
3003 { "sr13", offsetof(CPUState, sr[13]) },
3004 { "sr14", offsetof(CPUState, sr[14]) },
3005 { "sr15", offsetof(CPUState, sr[15]) },
3006 /* Too lazy to put BATs and SPRs ... */
3007 #elif defined(TARGET_SPARC)
3008 { "g0", offsetof(CPUState, gregs[0]) },
3009 { "g1", offsetof(CPUState, gregs[1]) },
3010 { "g2", offsetof(CPUState, gregs[2]) },
3011 { "g3", offsetof(CPUState, gregs[3]) },
3012 { "g4", offsetof(CPUState, gregs[4]) },
3013 { "g5", offsetof(CPUState, gregs[5]) },
3014 { "g6", offsetof(CPUState, gregs[6]) },
3015 { "g7", offsetof(CPUState, gregs[7]) },
3016 { "o0", 0, monitor_get_reg },
3017 { "o1", 1, monitor_get_reg },
3018 { "o2", 2, monitor_get_reg },
3019 { "o3", 3, monitor_get_reg },
3020 { "o4", 4, monitor_get_reg },
3021 { "o5", 5, monitor_get_reg },
3022 { "o6", 6, monitor_get_reg },
3023 { "o7", 7, monitor_get_reg },
3024 { "l0", 8, monitor_get_reg },
3025 { "l1", 9, monitor_get_reg },
3026 { "l2", 10, monitor_get_reg },
3027 { "l3", 11, monitor_get_reg },
3028 { "l4", 12, monitor_get_reg },
3029 { "l5", 13, monitor_get_reg },
3030 { "l6", 14, monitor_get_reg },
3031 { "l7", 15, monitor_get_reg },
3032 { "i0", 16, monitor_get_reg },
3033 { "i1", 17, monitor_get_reg },
3034 { "i2", 18, monitor_get_reg },
3035 { "i3", 19, monitor_get_reg },
3036 { "i4", 20, monitor_get_reg },
3037 { "i5", 21, monitor_get_reg },
3038 { "i6", 22, monitor_get_reg },
3039 { "i7", 23, monitor_get_reg },
3040 { "pc", offsetof(CPUState, pc) },
3041 { "npc", offsetof(CPUState, npc) },
3042 { "y", offsetof(CPUState, y) },
3043 #ifndef TARGET_SPARC64
3044 { "psr", 0, &monitor_get_psr, },
3045 { "wim", offsetof(CPUState, wim) },
3047 { "tbr", offsetof(CPUState, tbr) },
3048 { "fsr", offsetof(CPUState, fsr) },
3049 { "f0", offsetof(CPUState, fpr[0]) },
3050 { "f1", offsetof(CPUState, fpr[1]) },
3051 { "f2", offsetof(CPUState, fpr[2]) },
3052 { "f3", offsetof(CPUState, fpr[3]) },
3053 { "f4", offsetof(CPUState, fpr[4]) },
3054 { "f5", offsetof(CPUState, fpr[5]) },
3055 { "f6", offsetof(CPUState, fpr[6]) },
3056 { "f7", offsetof(CPUState, fpr[7]) },
3057 { "f8", offsetof(CPUState, fpr[8]) },
3058 { "f9", offsetof(CPUState, fpr[9]) },
3059 { "f10", offsetof(CPUState, fpr[10]) },
3060 { "f11", offsetof(CPUState, fpr[11]) },
3061 { "f12", offsetof(CPUState, fpr[12]) },
3062 { "f13", offsetof(CPUState, fpr[13]) },
3063 { "f14", offsetof(CPUState, fpr[14]) },
3064 { "f15", offsetof(CPUState, fpr[15]) },
3065 { "f16", offsetof(CPUState, fpr[16]) },
3066 { "f17", offsetof(CPUState, fpr[17]) },
3067 { "f18", offsetof(CPUState, fpr[18]) },
3068 { "f19", offsetof(CPUState, fpr[19]) },
3069 { "f20", offsetof(CPUState, fpr[20]) },
3070 { "f21", offsetof(CPUState, fpr[21]) },
3071 { "f22", offsetof(CPUState, fpr[22]) },
3072 { "f23", offsetof(CPUState, fpr[23]) },
3073 { "f24", offsetof(CPUState, fpr[24]) },
3074 { "f25", offsetof(CPUState, fpr[25]) },
3075 { "f26", offsetof(CPUState, fpr[26]) },
3076 { "f27", offsetof(CPUState, fpr[27]) },
3077 { "f28", offsetof(CPUState, fpr[28]) },
3078 { "f29", offsetof(CPUState, fpr[29]) },
3079 { "f30", offsetof(CPUState, fpr[30]) },
3080 { "f31", offsetof(CPUState, fpr[31]) },
3081 #ifdef TARGET_SPARC64
3082 { "f32", offsetof(CPUState, fpr[32]) },
3083 { "f34", offsetof(CPUState, fpr[34]) },
3084 { "f36", offsetof(CPUState, fpr[36]) },
3085 { "f38", offsetof(CPUState, fpr[38]) },
3086 { "f40", offsetof(CPUState, fpr[40]) },
3087 { "f42", offsetof(CPUState, fpr[42]) },
3088 { "f44", offsetof(CPUState, fpr[44]) },
3089 { "f46", offsetof(CPUState, fpr[46]) },
3090 { "f48", offsetof(CPUState, fpr[48]) },
3091 { "f50", offsetof(CPUState, fpr[50]) },
3092 { "f52", offsetof(CPUState, fpr[52]) },
3093 { "f54", offsetof(CPUState, fpr[54]) },
3094 { "f56", offsetof(CPUState, fpr[56]) },
3095 { "f58", offsetof(CPUState, fpr[58]) },
3096 { "f60", offsetof(CPUState, fpr[60]) },
3097 { "f62", offsetof(CPUState, fpr[62]) },
3098 { "asi", offsetof(CPUState, asi) },
3099 { "pstate", offsetof(CPUState, pstate) },
3100 { "cansave", offsetof(CPUState, cansave) },
3101 { "canrestore", offsetof(CPUState, canrestore) },
3102 { "otherwin", offsetof(CPUState, otherwin) },
3103 { "wstate", offsetof(CPUState, wstate) },
3104 { "cleanwin", offsetof(CPUState, cleanwin) },
3105 { "fprs", offsetof(CPUState, fprs) },
3111 static void expr_error(Monitor *mon, const char *msg)
3113 monitor_printf(mon, "%s\n", msg);
3114 longjmp(expr_env, 1);
3117 /* return 0 if OK, -1 if not found */
3118 static int get_monitor_def(target_long *pval, const char *name)
3120 const MonitorDef *md;
3123 for(md = monitor_defs; md->name != NULL; md++) {
3124 if (compare_cmd(name, md->name)) {
3125 if (md->get_value) {
3126 *pval = md->get_value(md, md->offset);
3128 CPUState *env = mon_get_cpu();
3129 ptr = (uint8_t *)env + md->offset;
3132 *pval = *(int32_t *)ptr;
3135 *pval = *(target_long *)ptr;
3148 static void next(void)
3152 while (qemu_isspace(*pch))
3157 static int64_t expr_sum(Monitor *mon);
3159 static int64_t expr_unary(Monitor *mon)
3168 n = expr_unary(mon);
3172 n = -expr_unary(mon);
3176 n = ~expr_unary(mon);
3182 expr_error(mon, "')' expected");
3189 expr_error(mon, "character constant expected");
3193 expr_error(mon, "missing terminating \' character");
3203 while ((*pch >= 'a' && *pch <= 'z') ||
3204 (*pch >= 'A' && *pch <= 'Z') ||
3205 (*pch >= '0' && *pch <= '9') ||
3206 *pch == '_' || *pch == '.') {
3207 if ((q - buf) < sizeof(buf) - 1)
3211 while (qemu_isspace(*pch))
3214 ret = get_monitor_def(®, buf);
3216 expr_error(mon, "unknown register");
3221 expr_error(mon, "unexpected end of expression");
3225 #if TARGET_PHYS_ADDR_BITS > 32
3226 n = strtoull(pch, &p, 0);
3228 n = strtoul(pch, &p, 0);
3231 expr_error(mon, "invalid char in expression");
3234 while (qemu_isspace(*pch))
3242 static int64_t expr_prod(Monitor *mon)
3247 val = expr_unary(mon);
3250 if (op != '*' && op != '/' && op != '%')
3253 val2 = expr_unary(mon);
3262 expr_error(mon, "division by zero");
3273 static int64_t expr_logic(Monitor *mon)
3278 val = expr_prod(mon);
3281 if (op != '&' && op != '|' && op != '^')
3284 val2 = expr_prod(mon);
3301 static int64_t expr_sum(Monitor *mon)
3306 val = expr_logic(mon);
3309 if (op != '+' && op != '-')
3312 val2 = expr_logic(mon);
3321 static int get_expr(Monitor *mon, int64_t *pval, const char **pp)
3324 if (setjmp(expr_env)) {
3328 while (qemu_isspace(*pch))
3330 *pval = expr_sum(mon);
3335 static int get_double(Monitor *mon, double *pval, const char **pp)
3337 const char *p = *pp;
3341 d = strtod(p, &tailp);
3343 monitor_printf(mon, "Number expected\n");
3346 if (d != d || d - d != 0) {
3347 /* NaN or infinity */
3348 monitor_printf(mon, "Bad number\n");
3356 static int get_str(char *buf, int buf_size, const char **pp)
3364 while (qemu_isspace(*p))
3374 while (*p != '\0' && *p != '\"') {
3390 qemu_printf("unsupported escape code: '\\%c'\n", c);
3393 if ((q - buf) < buf_size - 1) {
3397 if ((q - buf) < buf_size - 1) {
3404 qemu_printf("unterminated string\n");
3409 while (*p != '\0' && !qemu_isspace(*p)) {
3410 if ((q - buf) < buf_size - 1) {
3422 * Store the command-name in cmdname, and return a pointer to
3423 * the remaining of the command string.
3425 static const char *get_command_name(const char *cmdline,
3426 char *cmdname, size_t nlen)
3429 const char *p, *pstart;
3432 while (qemu_isspace(*p))
3437 while (*p != '\0' && *p != '/' && !qemu_isspace(*p))
3442 memcpy(cmdname, pstart, len);
3443 cmdname[len] = '\0';
3448 * Read key of 'type' into 'key' and return the current
3451 static char *key_get_info(const char *type, char **key)
3459 p = strchr(type, ':');
3466 str = qemu_malloc(len + 1);
3467 memcpy(str, type, len);
3474 static int default_fmt_format = 'x';
3475 static int default_fmt_size = 4;
3479 static int is_valid_option(const char *c, const char *typestr)
3487 typestr = strstr(typestr, option);
3488 return (typestr != NULL);
3491 static const mon_cmd_t *monitor_find_command(const char *cmdname)
3493 const mon_cmd_t *cmd;
3495 for (cmd = mon_cmds; cmd->name != NULL; cmd++) {
3496 if (compare_cmd(cmdname, cmd->name)) {
3504 static const mon_cmd_t *monitor_parse_command(Monitor *mon,
3505 const char *cmdline,
3508 const char *p, *typestr;
3510 const mon_cmd_t *cmd;
3516 monitor_printf(mon, "command='%s'\n", cmdline);
3519 /* extract the command name */
3520 p = get_command_name(cmdline, cmdname, sizeof(cmdname));
3524 cmd = monitor_find_command(cmdname);
3526 monitor_printf(mon, "unknown command: '%s'\n", cmdname);
3530 /* parse the parameters */
3531 typestr = cmd->args_type;
3533 typestr = key_get_info(typestr, &key);
3545 while (qemu_isspace(*p))
3547 if (*typestr == '?') {
3550 /* no optional string: NULL argument */
3554 ret = get_str(buf, sizeof(buf), &p);
3558 monitor_printf(mon, "%s: filename expected\n",
3562 monitor_printf(mon, "%s: block device name expected\n",
3566 monitor_printf(mon, "%s: string expected\n", cmdname);
3571 qdict_put(qdict, key, qstring_from_str(buf));
3576 QemuOptsList *opts_list;
3579 opts_list = qemu_find_opts(key);
3580 if (!opts_list || opts_list->desc->name) {
3583 while (qemu_isspace(*p)) {
3588 if (get_str(buf, sizeof(buf), &p) < 0) {
3591 opts = qemu_opts_parse(opts_list, buf, 1);
3595 qemu_opts_to_qdict(opts, qdict);
3596 qemu_opts_del(opts);
3601 int count, format, size;
3603 while (qemu_isspace(*p))
3609 if (qemu_isdigit(*p)) {
3611 while (qemu_isdigit(*p)) {
3612 count = count * 10 + (*p - '0');
3650 if (*p != '\0' && !qemu_isspace(*p)) {
3651 monitor_printf(mon, "invalid char in format: '%c'\n",
3656 format = default_fmt_format;
3657 if (format != 'i') {
3658 /* for 'i', not specifying a size gives -1 as size */
3660 size = default_fmt_size;
3661 default_fmt_size = size;
3663 default_fmt_format = format;
3666 format = default_fmt_format;
3667 if (format != 'i') {
3668 size = default_fmt_size;
3673 qdict_put(qdict, "count", qint_from_int(count));
3674 qdict_put(qdict, "format", qint_from_int(format));
3675 qdict_put(qdict, "size", qint_from_int(size));
3684 while (qemu_isspace(*p))
3686 if (*typestr == '?' || *typestr == '.') {
3687 if (*typestr == '?') {
3695 while (qemu_isspace(*p))
3704 if (get_expr(mon, &val, &p))
3706 /* Check if 'i' is greater than 32-bit */
3707 if ((c == 'i') && ((val >> 32) & 0xffffffff)) {
3708 monitor_printf(mon, "\'%s\' has failed: ", cmdname);
3709 monitor_printf(mon, "integer is for 32-bit values\n");
3711 } else if (c == 'M') {
3714 qdict_put(qdict, key, qint_from_int(val));
3722 while (qemu_isspace(*p))
3724 if (*typestr == '?') {
3730 if (get_double(mon, &val, &p) < 0) {
3733 if (c == 'f' && *p) {
3736 val *= 1 << 10; p++; break;
3738 val *= 1 << 20; p++; break;
3740 val *= 1 << 30; p++; break;
3743 if (c == 'T' && p[0] && p[1] == 's') {
3746 val /= 1e3; p += 2; break;
3748 val /= 1e6; p += 2; break;
3750 val /= 1e9; p += 2; break;
3753 if (*p && !qemu_isspace(*p)) {
3754 monitor_printf(mon, "Unknown unit suffix\n");
3757 qdict_put(qdict, key, qfloat_from_double(val));
3765 while (qemu_isspace(*p)) {
3769 while (qemu_isgraph(*p)) {
3772 if (p - beg == 2 && !memcmp(beg, "on", p - beg)) {
3774 } else if (p - beg == 3 && !memcmp(beg, "off", p - beg)) {
3777 monitor_printf(mon, "Expected 'on' or 'off'\n");
3780 qdict_put(qdict, key, qbool_from_int(val));
3785 const char *tmp = p;
3786 int has_option, skip_key = 0;
3792 while (qemu_isspace(*p))
3798 if(!is_valid_option(p, typestr)) {
3800 monitor_printf(mon, "%s: unsupported option -%c\n",
3814 qdict_put(qdict, key, qint_from_int(has_option));
3819 monitor_printf(mon, "%s: unknown type '%c'\n", cmdname, c);
3825 /* check that all arguments were parsed */
3826 while (qemu_isspace(*p))
3829 monitor_printf(mon, "%s: extraneous characters at the end of line\n",
3841 void monitor_set_error(Monitor *mon, QError *qerror)
3843 /* report only the first error */
3845 mon->error = qerror;
3847 MON_DEBUG("Additional error report at %s:%d\n",
3848 qerror->file, qerror->linenr);
3853 static int is_async_return(const QObject *data)
3855 if (data && qobject_type(data) == QTYPE_QDICT) {
3856 return qdict_haskey(qobject_to_qdict(data), "__mon_async");
3862 static void handler_audit(Monitor *mon, const mon_cmd_t *cmd, int ret)
3864 if (monitor_ctrl_mode(mon)) {
3865 if (ret && !monitor_has_error(mon)) {
3867 * If it returns failure, it must have passed on error.
3869 * Action: Report an internal error to the client if in QMP.
3871 qerror_report(QERR_UNDEFINED_ERROR);
3872 MON_DEBUG("command '%s' returned failure but did not pass an error\n",
3876 #ifdef CONFIG_DEBUG_MONITOR
3877 if (!ret && monitor_has_error(mon)) {
3879 * If it returns success, it must not have passed an error.
3881 * Action: Report the passed error to the client.
3883 MON_DEBUG("command '%s' returned success but passed an error\n",
3887 if (mon_print_count_get(mon) > 0 && strcmp(cmd->name, "info") != 0) {
3889 * Handlers should not call Monitor print functions.
3891 * Action: Ignore them in QMP.
3893 * (XXX: we don't check any 'info' or 'query' command here
3894 * because the user print function _is_ called by do_info(), hence
3895 * we will trigger this check. This problem will go away when we
3896 * make 'query' commands real and kill do_info())
3898 MON_DEBUG("command '%s' called print functions %d time(s)\n",
3899 cmd->name, mon_print_count_get(mon));
3903 assert(!monitor_has_error(mon));
3904 QDECREF(mon->error);
3909 static void monitor_call_handler(Monitor *mon, const mon_cmd_t *cmd,
3910 const QDict *params)
3913 QObject *data = NULL;
3915 mon_print_count_init(mon);
3917 ret = cmd->mhandler.cmd_new(mon, params, &data);
3918 handler_audit(mon, cmd, ret);
3920 if (is_async_return(data)) {
3922 * Asynchronous commands have no initial return data but they can
3923 * generate errors. Data is returned via the async completion handler.
3925 if (monitor_ctrl_mode(mon) && monitor_has_error(mon)) {
3926 monitor_protocol_emitter(mon, NULL);
3928 } else if (monitor_ctrl_mode(mon)) {
3929 /* Monitor Protocol */
3930 monitor_protocol_emitter(mon, data);
3934 cmd->user_print(mon, data);
3937 qobject_decref(data);
3940 static void handle_user_command(Monitor *mon, const char *cmdline)
3943 const mon_cmd_t *cmd;
3945 qdict = qdict_new();
3947 cmd = monitor_parse_command(mon, cmdline, qdict);
3951 if (monitor_handler_is_async(cmd)) {
3952 user_async_cmd_handler(mon, cmd, qdict);
3953 } else if (monitor_handler_ported(cmd)) {
3954 monitor_call_handler(mon, cmd, qdict);
3956 cmd->mhandler.cmd(mon, qdict);
3963 static void cmd_completion(const char *name, const char *list)
3965 const char *p, *pstart;
3974 p = pstart + strlen(pstart);
3976 if (len > sizeof(cmd) - 2)
3977 len = sizeof(cmd) - 2;
3978 memcpy(cmd, pstart, len);
3980 if (name[0] == '\0' || !strncmp(name, cmd, strlen(name))) {
3981 readline_add_completion(cur_mon->rs, cmd);
3989 static void file_completion(const char *input)
3994 char file[1024], file_prefix[1024];
3998 p = strrchr(input, '/');
4001 pstrcpy(file_prefix, sizeof(file_prefix), input);
4002 pstrcpy(path, sizeof(path), ".");
4004 input_path_len = p - input + 1;
4005 memcpy(path, input, input_path_len);
4006 if (input_path_len > sizeof(path) - 1)
4007 input_path_len = sizeof(path) - 1;
4008 path[input_path_len] = '\0';
4009 pstrcpy(file_prefix, sizeof(file_prefix), p + 1);
4011 #ifdef DEBUG_COMPLETION
4012 monitor_printf(cur_mon, "input='%s' path='%s' prefix='%s'\n",
4013 input, path, file_prefix);
4015 ffs = opendir(path);
4023 if (strstart(d->d_name, file_prefix, NULL)) {
4024 memcpy(file, input, input_path_len);
4025 if (input_path_len < sizeof(file))
4026 pstrcpy(file + input_path_len, sizeof(file) - input_path_len,
4028 /* stat the file to find out if it's a directory.
4029 * In that case add a slash to speed up typing long paths
4032 if(S_ISDIR(sb.st_mode))
4033 pstrcat(file, sizeof(file), "/");
4034 readline_add_completion(cur_mon->rs, file);
4040 static void block_completion_it(void *opaque, BlockDriverState *bs)
4042 const char *name = bdrv_get_device_name(bs);
4043 const char *input = opaque;
4045 if (input[0] == '\0' ||
4046 !strncmp(name, (char *)input, strlen(input))) {
4047 readline_add_completion(cur_mon->rs, name);
4051 /* NOTE: this parser is an approximate form of the real command parser */
4052 static void parse_cmdline(const char *cmdline,
4053 int *pnb_args, char **args)
4062 while (qemu_isspace(*p))
4066 if (nb_args >= MAX_ARGS)
4068 ret = get_str(buf, sizeof(buf), &p);
4069 args[nb_args] = qemu_strdup(buf);
4074 *pnb_args = nb_args;
4077 static const char *next_arg_type(const char *typestr)
4079 const char *p = strchr(typestr, ':');
4080 return (p != NULL ? ++p : typestr);
4083 static void monitor_find_completion(const char *cmdline)
4085 const char *cmdname;
4086 char *args[MAX_ARGS];
4087 int nb_args, i, len;
4088 const char *ptype, *str;
4089 const mon_cmd_t *cmd;
4092 parse_cmdline(cmdline, &nb_args, args);
4093 #ifdef DEBUG_COMPLETION
4094 for(i = 0; i < nb_args; i++) {
4095 monitor_printf(cur_mon, "arg%d = '%s'\n", i, (char *)args[i]);
4099 /* if the line ends with a space, it means we want to complete the
4101 len = strlen(cmdline);
4102 if (len > 0 && qemu_isspace(cmdline[len - 1])) {
4103 if (nb_args >= MAX_ARGS)
4105 args[nb_args++] = qemu_strdup("");
4108 /* command completion */
4113 readline_set_completion_index(cur_mon->rs, strlen(cmdname));
4114 for(cmd = mon_cmds; cmd->name != NULL; cmd++) {
4115 cmd_completion(cmdname, cmd->name);
4118 /* find the command */
4119 for(cmd = mon_cmds; cmd->name != NULL; cmd++) {
4120 if (compare_cmd(args[0], cmd->name))
4125 ptype = next_arg_type(cmd->args_type);
4126 for(i = 0; i < nb_args - 2; i++) {
4127 if (*ptype != '\0') {
4128 ptype = next_arg_type(ptype);
4129 while (*ptype == '?')
4130 ptype = next_arg_type(ptype);
4133 str = args[nb_args - 1];
4134 if (*ptype == '-' && ptype[1] != '\0') {
4139 /* file completion */
4140 readline_set_completion_index(cur_mon->rs, strlen(str));
4141 file_completion(str);
4144 /* block device name completion */
4145 readline_set_completion_index(cur_mon->rs, strlen(str));
4146 bdrv_iterate(block_completion_it, (void *)str);
4149 /* XXX: more generic ? */
4150 if (!strcmp(cmd->name, "info")) {
4151 readline_set_completion_index(cur_mon->rs, strlen(str));
4152 for(cmd = info_cmds; cmd->name != NULL; cmd++) {
4153 cmd_completion(str, cmd->name);
4155 } else if (!strcmp(cmd->name, "sendkey")) {
4156 char *sep = strrchr(str, '-');
4159 readline_set_completion_index(cur_mon->rs, strlen(str));
4160 for(key = key_defs; key->name != NULL; key++) {
4161 cmd_completion(str, key->name);
4163 } else if (!strcmp(cmd->name, "help|?")) {
4164 readline_set_completion_index(cur_mon->rs, strlen(str));
4165 for (cmd = mon_cmds; cmd->name != NULL; cmd++) {
4166 cmd_completion(str, cmd->name);
4174 for(i = 0; i < nb_args; i++)
4178 static int monitor_can_read(void *opaque)
4180 Monitor *mon = opaque;
4182 return (mon->suspend_cnt == 0) ? 1 : 0;
4185 typedef struct CmdArgs {
4192 static int check_opt(const CmdArgs *cmd_args, const char *name, QDict *args)
4194 if (!cmd_args->optional) {
4195 qerror_report(QERR_MISSING_PARAMETER, name);
4199 if (cmd_args->type == '-') {
4200 /* handlers expect a value, they need to be changed */
4201 qdict_put(args, name, qint_from_int(0));
4207 static int check_arg(const CmdArgs *cmd_args, QDict *args)
4212 name = qstring_get_str(cmd_args->name);
4215 return check_opt(cmd_args, name, args);
4218 value = qdict_get(args, name);
4220 return check_opt(cmd_args, name, args);
4223 switch (cmd_args->type) {
4227 if (qobject_type(value) != QTYPE_QSTRING) {
4228 qerror_report(QERR_INVALID_PARAMETER_TYPE, name, "string");
4234 const char *keys[] = { "count", "format", "size", NULL };
4236 for (i = 0; keys[i]; i++) {
4237 QObject *obj = qdict_get(args, keys[i]);
4239 qerror_report(QERR_MISSING_PARAMETER, name);
4242 if (qobject_type(obj) != QTYPE_QINT) {
4243 qerror_report(QERR_INVALID_PARAMETER_TYPE, name, "int");
4252 if (qobject_type(value) != QTYPE_QINT) {
4253 qerror_report(QERR_INVALID_PARAMETER_TYPE, name, "int");
4259 if (qobject_type(value) != QTYPE_QINT && qobject_type(value) != QTYPE_QFLOAT) {
4260 qerror_report(QERR_INVALID_PARAMETER_TYPE, name, "number");
4265 if (qobject_type(value) != QTYPE_QBOOL) {
4266 qerror_report(QERR_INVALID_PARAMETER_TYPE, name, "bool");
4271 if (qobject_type(value) != QTYPE_QINT &&
4272 qobject_type(value) != QTYPE_QBOOL) {
4273 qerror_report(QERR_INVALID_PARAMETER_TYPE, name, "bool");
4276 if (qobject_type(value) == QTYPE_QBOOL) {
4277 /* handlers expect a QInt, they need to be changed */
4278 qdict_put(args, name,
4279 qint_from_int(qbool_get_int(qobject_to_qbool(value))));
4291 static void cmd_args_init(CmdArgs *cmd_args)
4293 cmd_args->name = qstring_new();
4294 cmd_args->type = cmd_args->flag = cmd_args->optional = 0;
4297 static int check_opts(QemuOptsList *opts_list, QDict *args)
4299 assert(!opts_list->desc->name);
4304 * This is not trivial, we have to parse Monitor command's argument
4305 * type syntax to be able to check the arguments provided by clients.
4307 * In the near future we will be using an array for that and will be
4308 * able to drop all this parsing...
4310 static int monitor_check_qmp_args(const mon_cmd_t *cmd, QDict *args)
4315 QemuOptsList *opts_list;
4317 if (cmd->args_type == NULL) {
4318 return (qdict_size(args) == 0 ? 0 : -1);
4322 cmd_args_init(&cmd_args);
4325 for (p = cmd->args_type;; p++) {
4327 cmd_args.type = *++p;
4329 if (cmd_args.type == '-') {
4330 cmd_args.flag = *p++;
4331 cmd_args.optional = 1;
4332 } else if (cmd_args.type == 'O') {
4333 opts_list = qemu_find_opts(qstring_get_str(cmd_args.name));
4335 } else if (*p == '?') {
4336 cmd_args.optional = 1;
4340 assert(*p == ',' || *p == '\0');
4342 err = check_opts(opts_list, args);
4345 err = check_arg(&cmd_args, args);
4346 QDECREF(cmd_args.name);
4347 cmd_args_init(&cmd_args);
4354 qstring_append_chr(cmd_args.name, *p);
4362 QDECREF(cmd_args.name);
4366 static int invalid_qmp_mode(const Monitor *mon, const char *cmd_name)
4368 int is_cap = compare_cmd(cmd_name, "qmp_capabilities");
4369 return (qmp_cmd_mode(mon) ? is_cap : !is_cap);
4372 static void handle_qmp_command(JSONMessageParser *parser, QList *tokens)
4376 QDict *input, *args;
4377 const mon_cmd_t *cmd;
4378 Monitor *mon = cur_mon;
4379 const char *cmd_name, *info_item;
4383 obj = json_parser_parse(tokens, NULL);
4385 // FIXME: should be triggered in json_parser_parse()
4386 qerror_report(QERR_JSON_PARSING);
4388 } else if (qobject_type(obj) != QTYPE_QDICT) {
4389 qerror_report(QERR_QMP_BAD_INPUT_OBJECT, "object");
4390 qobject_decref(obj);
4394 input = qobject_to_qdict(obj);
4396 mon->mc->id = qdict_get(input, "id");
4397 qobject_incref(mon->mc->id);
4399 obj = qdict_get(input, "execute");
4401 qerror_report(QERR_QMP_BAD_INPUT_OBJECT, "execute");
4403 } else if (qobject_type(obj) != QTYPE_QSTRING) {
4404 qerror_report(QERR_QMP_BAD_INPUT_OBJECT_MEMBER, "execute", "string");
4408 cmd_name = qstring_get_str(qobject_to_qstring(obj));
4410 if (invalid_qmp_mode(mon, cmd_name)) {
4411 qerror_report(QERR_COMMAND_NOT_FOUND, cmd_name);
4416 * XXX: We need this special case until we get info handlers
4417 * converted into 'query-' commands
4419 if (compare_cmd(cmd_name, "info")) {
4420 qerror_report(QERR_COMMAND_NOT_FOUND, cmd_name);
4422 } else if (strstart(cmd_name, "query-", &info_item)) {
4423 cmd = monitor_find_command("info");
4424 qdict_put_obj(input, "arguments",
4425 qobject_from_jsonf("{ 'item': %s }", info_item));
4427 cmd = monitor_find_command(cmd_name);
4428 if (!cmd || !monitor_handler_ported(cmd)) {
4429 qerror_report(QERR_COMMAND_NOT_FOUND, cmd_name);
4434 obj = qdict_get(input, "arguments");
4437 } else if (qobject_type(obj) != QTYPE_QDICT) {
4438 qerror_report(QERR_QMP_BAD_INPUT_OBJECT_MEMBER, "arguments", "object");
4441 args = qobject_to_qdict(obj);
4447 err = monitor_check_qmp_args(cmd, args);
4452 if (monitor_handler_is_async(cmd)) {
4453 qmp_async_cmd_handler(mon, cmd, args);
4455 monitor_call_handler(mon, cmd, args);
4462 monitor_protocol_emitter(mon, NULL);
4468 * monitor_control_read(): Read and handle QMP input
4470 static void monitor_control_read(void *opaque, const uint8_t *buf, int size)
4472 Monitor *old_mon = cur_mon;
4476 json_message_parser_feed(&cur_mon->mc->parser, (const char *) buf, size);
4481 static void monitor_read(void *opaque, const uint8_t *buf, int size)
4483 Monitor *old_mon = cur_mon;
4489 for (i = 0; i < size; i++)
4490 readline_handle_byte(cur_mon->rs, buf[i]);
4492 if (size == 0 || buf[size - 1] != 0)
4493 monitor_printf(cur_mon, "corrupted command\n");
4495 handle_user_command(cur_mon, (char *)buf);
4501 static void monitor_command_cb(Monitor *mon, const char *cmdline, void *opaque)
4503 monitor_suspend(mon);
4504 handle_user_command(mon, cmdline);
4505 monitor_resume(mon);
4508 int monitor_suspend(Monitor *mon)
4516 void monitor_resume(Monitor *mon)
4520 if (--mon->suspend_cnt == 0)
4521 readline_show_prompt(mon->rs);
4524 static QObject *get_qmp_greeting(void)
4528 do_info_version(NULL, &ver);
4529 return qobject_from_jsonf("{'QMP':{'version': %p,'capabilities': []}}",ver);
4533 * monitor_control_event(): Print QMP gretting
4535 static void monitor_control_event(void *opaque, int event)
4538 Monitor *mon = opaque;
4541 case CHR_EVENT_OPENED:
4542 mon->mc->command_mode = 0;
4543 json_message_parser_init(&mon->mc->parser, handle_qmp_command);
4544 data = get_qmp_greeting();
4545 monitor_json_emitter(mon, data);
4546 qobject_decref(data);
4548 case CHR_EVENT_CLOSED:
4549 json_message_parser_destroy(&mon->mc->parser);
4554 static void monitor_event(void *opaque, int event)
4556 Monitor *mon = opaque;
4559 case CHR_EVENT_MUX_IN:
4561 if (mon->reset_seen) {
4562 readline_restart(mon->rs);
4563 monitor_resume(mon);
4566 mon->suspend_cnt = 0;
4570 case CHR_EVENT_MUX_OUT:
4571 if (mon->reset_seen) {
4572 if (mon->suspend_cnt == 0) {
4573 monitor_printf(mon, "\n");
4576 monitor_suspend(mon);
4583 case CHR_EVENT_OPENED:
4584 monitor_printf(mon, "QEMU %s monitor - type 'help' for more "
4585 "information\n", QEMU_VERSION);
4586 if (!mon->mux_out) {
4587 readline_show_prompt(mon->rs);
4589 mon->reset_seen = 1;
4603 void monitor_init(CharDriverState *chr, int flags)
4605 static int is_first_init = 1;
4608 if (is_first_init) {
4609 key_timer = qemu_new_timer(vm_clock, release_keys, NULL);
4613 mon = qemu_mallocz(sizeof(*mon));
4617 if (flags & MONITOR_USE_READLINE) {
4618 mon->rs = readline_init(mon, monitor_find_completion);
4619 monitor_read_command(mon, 0);
4622 if (monitor_ctrl_mode(mon)) {
4623 mon->mc = qemu_mallocz(sizeof(MonitorControl));
4624 /* Control mode requires special handlers */
4625 qemu_chr_add_handlers(chr, monitor_can_read, monitor_control_read,
4626 monitor_control_event, mon);
4628 qemu_chr_add_handlers(chr, monitor_can_read, monitor_read,
4629 monitor_event, mon);
4632 QLIST_INSERT_HEAD(&mon_list, mon, entry);
4633 if (!default_mon || (flags & MONITOR_IS_DEFAULT))
4637 static void bdrv_password_cb(Monitor *mon, const char *password, void *opaque)
4639 BlockDriverState *bs = opaque;
4642 if (bdrv_set_key(bs, password) != 0) {
4643 monitor_printf(mon, "invalid password\n");
4646 if (mon->password_completion_cb)
4647 mon->password_completion_cb(mon->password_opaque, ret);
4649 monitor_read_command(mon, 1);
4652 int monitor_read_bdrv_key_start(Monitor *mon, BlockDriverState *bs,
4653 BlockDriverCompletionFunc *completion_cb,
4658 if (!bdrv_key_required(bs)) {
4660 completion_cb(opaque, 0);
4664 if (monitor_ctrl_mode(mon)) {
4665 qerror_report(QERR_DEVICE_ENCRYPTED, bdrv_get_device_name(bs));
4669 monitor_printf(mon, "%s (%s) is encrypted.\n", bdrv_get_device_name(bs),
4670 bdrv_get_encrypted_filename(bs));
4672 mon->password_completion_cb = completion_cb;
4673 mon->password_opaque = opaque;
4675 err = monitor_read_password(mon, bdrv_password_cb, bs);
4677 if (err && completion_cb)
4678 completion_cb(opaque, err);