xref: /qemu/monitor/qmp-cmds-control.c (revision abff1abf)
1 /*
2  * QMP commands related to the monitor (common to sysemu and tools)
3  *
4  * Copyright (c) 2003-2004 Fabrice Bellard
5  *
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:
12  *
13  * The above copyright notice and this permission notice shall be included in
14  * all copies or substantial portions of the Software.
15  *
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
22  * THE SOFTWARE.
23  */
24 
25 #include "qemu/osdep.h"
26 
27 #include "monitor-internal.h"
28 #include "qemu-version.h"
29 #include "qapi/error.h"
30 #include "qapi/qapi-commands-control.h"
31 #include "qapi/qapi-emit-events.h"
32 #include "qapi/qapi-introspect.h"
33 
34 /*
35  * Accept QMP capabilities in @list for @mon.
36  * On success, set mon->qmp.capab[], and return true.
37  * On error, set @errp, and return false.
38  */
39 static bool qmp_caps_accept(MonitorQMP *mon, QMPCapabilityList *list,
40                             Error **errp)
41 {
42     GString *unavailable = NULL;
43     bool capab[QMP_CAPABILITY__MAX];
44 
45     memset(capab, 0, sizeof(capab));
46 
47     for (; list; list = list->next) {
48         if (!mon->capab_offered[list->value]) {
49             if (!unavailable) {
50                 unavailable = g_string_new(QMPCapability_str(list->value));
51             } else {
52                 g_string_append_printf(unavailable, ", %s",
53                                       QMPCapability_str(list->value));
54             }
55         }
56         capab[list->value] = true;
57     }
58 
59     if (unavailable) {
60         error_setg(errp, "Capability %s not available", unavailable->str);
61         g_string_free(unavailable, true);
62         return false;
63     }
64 
65     memcpy(mon->capab, capab, sizeof(capab));
66     return true;
67 }
68 
69 void qmp_qmp_capabilities(bool has_enable, QMPCapabilityList *enable,
70                           Error **errp)
71 {
72     MonitorQMP *mon;
73 
74     assert(monitor_is_qmp(cur_mon));
75     mon = container_of(cur_mon, MonitorQMP, common);
76 
77     if (mon->commands == &qmp_commands) {
78         error_set(errp, ERROR_CLASS_COMMAND_NOT_FOUND,
79                   "Capabilities negotiation is already complete, command "
80                   "ignored");
81         return;
82     }
83 
84     if (!qmp_caps_accept(mon, enable, errp)) {
85         return;
86     }
87 
88     mon->commands = &qmp_commands;
89 }
90 
91 VersionInfo *qmp_query_version(Error **errp)
92 {
93     VersionInfo *info = g_new0(VersionInfo, 1);
94 
95     info->qemu = g_new0(VersionTriple, 1);
96     info->qemu->major = QEMU_VERSION_MAJOR;
97     info->qemu->minor = QEMU_VERSION_MINOR;
98     info->qemu->micro = QEMU_VERSION_MICRO;
99     info->package = g_strdup(QEMU_PKGVERSION);
100 
101     return info;
102 }
103 
104 static void query_commands_cb(const QmpCommand *cmd, void *opaque)
105 {
106     CommandInfoList *info, **list = opaque;
107 
108     if (!cmd->enabled) {
109         return;
110     }
111 
112     info = g_malloc0(sizeof(*info));
113     info->value = g_malloc0(sizeof(*info->value));
114     info->value->name = g_strdup(cmd->name);
115     info->next = *list;
116     *list = info;
117 }
118 
119 CommandInfoList *qmp_query_commands(Error **errp)
120 {
121     CommandInfoList *list = NULL;
122     MonitorQMP *mon;
123 
124     assert(monitor_is_qmp(cur_mon));
125     mon = container_of(cur_mon, MonitorQMP, common);
126 
127     qmp_for_each_command(mon->commands, query_commands_cb, &list);
128 
129     return list;
130 }
131 
132 EventInfoList *qmp_query_events(Error **errp)
133 {
134     /*
135      * TODO This deprecated command is the only user of
136      * QAPIEvent_str() and QAPIEvent_lookup[].  When the command goes,
137      * they should go, too.
138      */
139     EventInfoList *info, *ev_list = NULL;
140     QAPIEvent e;
141 
142     for (e = 0 ; e < QAPI_EVENT__MAX ; e++) {
143         const char *event_name = QAPIEvent_str(e);
144         assert(event_name != NULL);
145         info = g_malloc0(sizeof(*info));
146         info->value = g_malloc0(sizeof(*info->value));
147         info->value->name = g_strdup(event_name);
148 
149         info->next = ev_list;
150         ev_list = info;
151     }
152 
153     return ev_list;
154 }
155 
156 /*
157  * Minor hack: generated marshalling suppressed for this command
158  * ('gen': false in the schema) so we can parse the JSON string
159  * directly into QObject instead of first parsing it with
160  * visit_type_SchemaInfoList() into a SchemaInfoList, then marshal it
161  * to QObject with generated output marshallers, every time.  Instead,
162  * we do it in test-qobject-input-visitor.c, just to make sure
163  * qapi-gen.py's output actually conforms to the schema.
164  */
165 void qmp_query_qmp_schema(QDict *qdict, QObject **ret_data,
166                                  Error **errp)
167 {
168     *ret_data = qobject_from_qlit(&qmp_schema_qlit);
169 }
170