]>
Commit | Line | Data |
---|---|---|
ab02ab2a MR |
1 | /* |
2 | * Core Definitions for QAPI/QMP Dispatch | |
3 | * | |
4 | * Copyright IBM, Corp. 2011 | |
5 | * | |
6 | * Authors: | |
7 | * Anthony Liguori <[email protected]> | |
8 | * | |
9 | * This work is licensed under the terms of the GNU LGPL, version 2.1 or later. | |
10 | * See the COPYING.LIB file in the top-level directory. | |
11 | * | |
12 | */ | |
13 | ||
cbf21151 | 14 | #include "qemu/osdep.h" |
da34e65c | 15 | #include "qapi/error.h" |
7b1b5d19 | 16 | #include "qapi/qmp/dispatch.h" |
452fcdbc | 17 | #include "qapi/qmp/qdict.h" |
c7eb39cb | 18 | #include "qapi/qmp/qjson.h" |
cf869d53 | 19 | #include "qapi/qmp/qbool.h" |
047f7038 | 20 | #include "sysemu/sysemu.h" |
ab02ab2a | 21 | |
69240fe6 MA |
22 | static QDict *qmp_dispatch_check_obj(const QObject *request, bool allow_oob, |
23 | Error **errp) | |
ab02ab2a | 24 | { |
00ecec15 | 25 | const char *exec_key = NULL; |
ab02ab2a MR |
26 | const QDictEntry *ent; |
27 | const char *arg_name; | |
28 | const QObject *arg_obj; | |
00ecec15 | 29 | QDict *dict; |
ab02ab2a | 30 | |
7dc847eb | 31 | dict = qobject_to(QDict, request); |
ca6b6e1e | 32 | if (!dict) { |
10e37839 | 33 | error_setg(errp, "QMP input must be a JSON object"); |
ab02ab2a MR |
34 | return NULL; |
35 | } | |
36 | ||
ab02ab2a MR |
37 | for (ent = qdict_first(dict); ent; |
38 | ent = qdict_next(dict, ent)) { | |
39 | arg_name = qdict_entry_key(ent); | |
40 | arg_obj = qdict_entry_value(ent); | |
41 | ||
00ecec15 MA |
42 | if (!strcmp(arg_name, "execute") |
43 | || (!strcmp(arg_name, "exec-oob") && allow_oob)) { | |
ab02ab2a | 44 | if (qobject_type(arg_obj) != QTYPE_QSTRING) { |
00ecec15 MA |
45 | error_setg(errp, "QMP input member '%s' must be a string", |
46 | arg_name); | |
ab02ab2a MR |
47 | return NULL; |
48 | } | |
00ecec15 MA |
49 | if (exec_key) { |
50 | error_setg(errp, "QMP input member '%s' clashes with '%s'", | |
51 | arg_name, exec_key); | |
74d8c9d9 MA |
52 | return NULL; |
53 | } | |
00ecec15 MA |
54 | exec_key = arg_name; |
55 | } else if (!strcmp(arg_name, "arguments")) { | |
cf869d53 PX |
56 | if (qobject_type(arg_obj) != QTYPE_QDICT) { |
57 | error_setg(errp, | |
00ecec15 | 58 | "QMP input member 'arguments' must be an object"); |
cf869d53 PX |
59 | return NULL; |
60 | } | |
74d8c9d9 | 61 | } else { |
10e37839 | 62 | error_setg(errp, "QMP input member '%s' is unexpected", |
99fb0c53 | 63 | arg_name); |
ab02ab2a MR |
64 | return NULL; |
65 | } | |
66 | } | |
67 | ||
00ecec15 | 68 | if (!exec_key) { |
10e37839 | 69 | error_setg(errp, "QMP input lacks member 'execute'"); |
ab02ab2a MR |
70 | return NULL; |
71 | } | |
72 | ||
73 | return dict; | |
74 | } | |
75 | ||
1527badb | 76 | static QObject *do_qmp_dispatch(QmpCommandList *cmds, QObject *request, |
674ed722 | 77 | bool allow_oob, Error **errp) |
ab02ab2a | 78 | { |
ee16ce93 | 79 | Error *local_err = NULL; |
69240fe6 | 80 | bool oob; |
ab02ab2a MR |
81 | const char *command; |
82 | QDict *args, *dict; | |
83 | QmpCommand *cmd; | |
84 | QObject *ret = NULL; | |
85 | ||
674ed722 | 86 | dict = qmp_dispatch_check_obj(request, allow_oob, errp); |
4af8be1f | 87 | if (!dict) { |
ab02ab2a MR |
88 | return NULL; |
89 | } | |
90 | ||
00ecec15 | 91 | command = qdict_get_try_str(dict, "execute"); |
69240fe6 | 92 | oob = false; |
00ecec15 MA |
93 | if (!command) { |
94 | assert(allow_oob); | |
95 | command = qdict_get_str(dict, "exec-oob"); | |
69240fe6 | 96 | oob = true; |
00ecec15 | 97 | } |
1527badb | 98 | cmd = qmp_find_command(cmds, command); |
ab02ab2a | 99 | if (cmd == NULL) { |
a6c90cbc MA |
100 | error_set(errp, ERROR_CLASS_COMMAND_NOT_FOUND, |
101 | "The command %s has not been found", command); | |
ab02ab2a MR |
102 | return NULL; |
103 | } | |
abd6cf6d | 104 | if (!cmd->enabled) { |
f231b88d CR |
105 | error_setg(errp, "The command %s has been disabled for this instance", |
106 | command); | |
abd6cf6d MR |
107 | return NULL; |
108 | } | |
69240fe6 MA |
109 | if (oob && !(cmd->options & QCO_ALLOW_OOB)) { |
110 | error_setg(errp, "The command %s does not support OOB", | |
111 | command); | |
112 | return false; | |
113 | } | |
ab02ab2a | 114 | |
047f7038 IM |
115 | if (runstate_check(RUN_STATE_PRECONFIG) && |
116 | !(cmd->options & QCO_ALLOW_PRECONFIG)) { | |
117 | error_setg(errp, "The command '%s' isn't permitted in '%s' state", | |
118 | cmd->name, RunState_str(RUN_STATE_PRECONFIG)); | |
119 | return NULL; | |
120 | } | |
121 | ||
ab02ab2a MR |
122 | if (!qdict_haskey(dict, "arguments")) { |
123 | args = qdict_new(); | |
124 | } else { | |
125 | args = qdict_get_qdict(dict, "arguments"); | |
cb3e7f08 | 126 | qobject_ref(args); |
ab02ab2a MR |
127 | } |
128 | ||
42a502a7 EB |
129 | cmd->fn(args, &ret, &local_err); |
130 | if (local_err) { | |
131 | error_propagate(errp, local_err); | |
132 | } else if (cmd->options & QCO_NO_SUCCESS_RESP) { | |
133 | g_assert(!ret); | |
134 | } else if (!ret) { | |
62e93be2 | 135 | /* TODO turn into assertion */ |
42a502a7 | 136 | ret = QOBJECT(qdict_new()); |
ab02ab2a MR |
137 | } |
138 | ||
cb3e7f08 | 139 | qobject_unref(args); |
ab02ab2a MR |
140 | |
141 | return ret; | |
142 | } | |
143 | ||
cee32796 | 144 | QDict *qmp_error_response(Error *err) |
93b91c59 | 145 | { |
cee32796 MA |
146 | QDict *rsp; |
147 | ||
148 | rsp = qdict_from_jsonf_nofail("{ 'error': { 'class': %s, 'desc': %s } }", | |
149 | QapiErrorClass_str(error_get_class(err)), | |
150 | error_get_pretty(err)); | |
151 | error_free(err); | |
152 | return rsp; | |
93b91c59 LC |
153 | } |
154 | ||
cf869d53 | 155 | /* |
00ecec15 | 156 | * Does @qdict look like a command to be run out-of-band? |
cf869d53 | 157 | */ |
2aa788f5 | 158 | bool qmp_is_oob(const QDict *dict) |
cf869d53 | 159 | { |
00ecec15 MA |
160 | return qdict_haskey(dict, "exec-oob") |
161 | && !qdict_haskey(dict, "execute"); | |
cf869d53 PX |
162 | } |
163 | ||
d43b1694 MA |
164 | QDict *qmp_dispatch(QmpCommandList *cmds, QObject *request, |
165 | bool allow_oob) | |
ab02ab2a MR |
166 | { |
167 | Error *err = NULL; | |
168 | QObject *ret; | |
169 | QDict *rsp; | |
170 | ||
674ed722 | 171 | ret = do_qmp_dispatch(cmds, request, allow_oob, &err); |
ab02ab2a | 172 | |
ab02ab2a | 173 | if (err) { |
cee32796 | 174 | rsp = qmp_error_response(err); |
ab02ab2a | 175 | } else if (ret) { |
cee32796 | 176 | rsp = qdict_new(); |
ab02ab2a MR |
177 | qdict_put_obj(rsp, "return", ret); |
178 | } else { | |
62e93be2 | 179 | /* Can only happen for commands with QCO_NO_SUCCESS_RESP */ |
cee32796 | 180 | rsp = NULL; |
ab02ab2a MR |
181 | } |
182 | ||
d43b1694 | 183 | return rsp; |
ab02ab2a | 184 | } |