]> git.proxmox.com Git - mirror_qemu.git/blame - scripts/qapi-commands.py
qtest/ahci: halted ncq migration test
[mirror_qemu.git] / scripts / qapi-commands.py
CommitLineData
c17d9908
MR
1#
2# QAPI command marshaller generator
3#
4# Copyright IBM, Corp. 2011
d708cdbe 5# Copyright (C) 2014-2015 Red Hat, Inc.
c17d9908
MR
6#
7# Authors:
8# Anthony Liguori <aliguori@us.ibm.com>
9# Michael Roth <mdroth@linux.vnet.ibm.com>
297a3646 10# Markus Armbruster <armbru@redhat.com>
c17d9908 11#
678e48a2
MA
12# This work is licensed under the terms of the GNU GPL, version 2.
13# See the COPYING file in the top-level directory.
c17d9908
MR
14
15from ordereddict import OrderedDict
16from qapi import *
297a3646 17import re
c17d9908 18
c17d9908
MR
19def generate_command_decl(name, args, ret_type):
20 arglist=""
6b5abc7d 21 for argname, argtype, optional in parse_args(args):
0d14eeb2 22 argtype = c_type(argtype, is_param=True)
c17d9908 23 if optional:
18df515e
EB
24 arglist += "bool has_%s, " % c_name(argname)
25 arglist += "%s %s, " % (argtype, c_name(argname))
c17d9908
MR
26 return mcgen('''
27%(ret_type)s qmp_%(name)s(%(args)sError **errp);
28''',
18df515e
EB
29 ret_type=c_type(ret_type), name=c_name(name),
30 args=arglist).strip()
c17d9908 31
297a3646
MA
32def gen_err_check(errvar):
33 if errvar:
34 return mcgen('''
35if (local_err) {
36 goto out;
37}
38''')
39 return ''
40
c17d9908
MR
41def gen_sync_call(name, args, ret_type, indent=0):
42 ret = ""
43 arglist=""
44 retval=""
45 if ret_type:
46 retval = "retval = "
6b5abc7d 47 for argname, argtype, optional in parse_args(args):
c17d9908 48 if optional:
18df515e
EB
49 arglist += "has_%s, " % c_name(argname)
50 arglist += "%s, " % (c_name(argname))
c17d9908
MR
51 push_indent(indent)
52 ret = mcgen('''
297a3646 53%(retval)sqmp_%(name)s(%(args)s&local_err);
c17d9908
MR
54
55''',
18df515e 56 name=c_name(name), args=arglist, retval=retval).rstrip()
c17d9908 57 if ret_type:
297a3646 58 ret += "\n" + gen_err_check('local_err')
c17d9908 59 ret += "\n" + mcgen(''''
297a3646 60%(marshal_output_call)s
c17d9908
MR
61''',
62 marshal_output_call=gen_marshal_output_call(name, ret_type)).rstrip()
63 pop_indent(indent)
64 return ret.rstrip()
65
66
67def gen_marshal_output_call(name, ret_type):
68 if not ret_type:
69 return ""
18df515e 70 return "qmp_marshal_output_%s(retval, ret, &local_err);" % c_name(name)
c17d9908 71
f9bee751 72def gen_visitor_input_containers_decl(args, obj):
c17d9908
MR
73 ret = ""
74
75 push_indent()
76 if len(args) > 0:
77 ret += mcgen('''
f9bee751 78QmpInputVisitor *mi = qmp_input_visitor_new_strict(%(obj)s);
c17d9908
MR
79QapiDeallocVisitor *md;
80Visitor *v;
f9bee751
MA
81''',
82 obj=obj)
c17d9908
MR
83 pop_indent()
84
85 return ret.rstrip()
86
87def gen_visitor_input_vars_decl(args):
88 ret = ""
89 push_indent()
6b5abc7d 90 for argname, argtype, optional in parse_args(args):
c17d9908
MR
91 if optional:
92 ret += mcgen('''
93bool has_%(argname)s = false;
94''',
18df515e 95 argname=c_name(argname))
05dfb26c 96 if is_c_ptr(argtype):
c17d9908
MR
97 ret += mcgen('''
98%(argtype)s %(argname)s = NULL;
99''',
18df515e 100 argname=c_name(argname), argtype=c_type(argtype))
c17d9908
MR
101 else:
102 ret += mcgen('''
fc13d937 103%(argtype)s %(argname)s = {0};
c17d9908 104''',
18df515e 105 argname=c_name(argname), argtype=c_type(argtype))
c17d9908
MR
106
107 pop_indent()
108 return ret.rstrip()
109
f9bee751 110def gen_visitor_input_block(args, dealloc=False):
c17d9908 111 ret = ""
297a3646
MA
112 errparg = '&local_err'
113 errarg = 'local_err'
8f91ad8a 114
c17d9908
MR
115 if len(args) == 0:
116 return ret
117
118 push_indent()
119
120 if dealloc:
8f91ad8a 121 errparg = 'NULL'
297a3646 122 errarg = None;
c17d9908 123 ret += mcgen('''
f9bee751 124qmp_input_visitor_cleanup(mi);
c17d9908
MR
125md = qapi_dealloc_visitor_new();
126v = qapi_dealloc_get_visitor(md);
127''')
128 else:
129 ret += mcgen('''
c17d9908 130v = qmp_input_get_visitor(mi);
f9bee751 131''')
c17d9908 132
6b5abc7d 133 for argname, argtype, optional in parse_args(args):
c17d9908
MR
134 if optional:
135 ret += mcgen('''
e2cd0f4f 136visit_optional(v, &has_%(c_name)s, "%(name)s", %(errp)s);
c17d9908 137''',
18df515e 138 c_name=c_name(argname), name=argname, errp=errparg)
297a3646
MA
139 ret += gen_err_check(errarg)
140 ret += mcgen('''
141if (has_%(c_name)s) {
142''',
18df515e 143 c_name=c_name(argname))
c17d9908
MR
144 push_indent()
145 ret += mcgen('''
e3c4c3d7 146visit_type_%(visitor)s(v, &%(c_name)s, "%(name)s", %(errp)s);
c17d9908 147''',
18df515e 148 c_name=c_name(argname), name=argname, argtype=argtype,
e3c4c3d7 149 visitor=type_name(argtype), errp=errparg)
297a3646 150 ret += gen_err_check(errarg)
c17d9908
MR
151 if optional:
152 pop_indent()
153 ret += mcgen('''
154}
e2cd0f4f 155''')
c17d9908
MR
156
157 if dealloc:
158 ret += mcgen('''
159qapi_dealloc_visitor_cleanup(md);
c17d9908
MR
160''')
161 pop_indent()
162 return ret.rstrip()
163
776574d6 164def gen_marshal_output(name, args, ret_type, middle_mode):
c17d9908
MR
165 if not ret_type:
166 return ""
776574d6 167
c17d9908
MR
168 ret = mcgen('''
169static void qmp_marshal_output_%(c_name)s(%(c_ret_type)s ret_in, QObject **ret_out, Error **errp)
170{
297a3646 171 Error *local_err = NULL;
c17d9908 172 QmpOutputVisitor *mo = qmp_output_visitor_new();
f9bee751 173 QapiDeallocVisitor *md;
c17d9908
MR
174 Visitor *v;
175
176 v = qmp_output_get_visitor(mo);
e3c4c3d7 177 visit_type_%(visitor)s(v, &ret_in, "unused", &local_err);
297a3646
MA
178 if (local_err) {
179 goto out;
c17d9908 180 }
297a3646
MA
181 *ret_out = qmp_output_get_qobject(mo);
182
183out:
184 error_propagate(errp, local_err);
c17d9908 185 qmp_output_visitor_cleanup(mo);
f9bee751 186 md = qapi_dealloc_visitor_new();
c17d9908 187 v = qapi_dealloc_get_visitor(md);
e3c4c3d7 188 visit_type_%(visitor)s(v, &ret_in, "unused", NULL);
c17d9908
MR
189 qapi_dealloc_visitor_cleanup(md);
190}
191''',
18df515e 192 c_ret_type=c_type(ret_type), c_name=c_name(name),
e3c4c3d7 193 visitor=type_name(ret_type))
c17d9908
MR
194
195 return ret
196
776574d6 197def gen_marshal_input_decl(name, args, ret_type, middle_mode):
485febc6
MA
198 ret = 'void qmp_marshal_input_%s(QDict *args, QObject **ret, Error **errp)' % c_name(name)
199 if not middle_mode:
200 ret = "static " + ret
201 return ret
776574d6
AL
202
203def gen_marshal_input(name, args, ret_type, middle_mode):
204 hdr = gen_marshal_input_decl(name, args, ret_type, middle_mode)
205
c17d9908 206 ret = mcgen('''
776574d6 207%(header)s
c17d9908 208{
297a3646 209 Error *local_err = NULL;
c17d9908 210''',
776574d6
AL
211 header=hdr)
212
c17d9908 213 if ret_type:
05dfb26c 214 if is_c_ptr(ret_type):
c17d9908
MR
215 retval = " %s retval = NULL;" % c_type(ret_type)
216 else:
217 retval = " %s retval;" % c_type(ret_type)
218 ret += mcgen('''
219%(retval)s
220''',
221 retval=retval)
222
223 if len(args) > 0:
224 ret += mcgen('''
225%(visitor_input_containers_decl)s
226%(visitor_input_vars_decl)s
227
228%(visitor_input_block)s
229
230''',
f9bee751 231 visitor_input_containers_decl=gen_visitor_input_containers_decl(args, "QOBJECT(args)"),
c17d9908 232 visitor_input_vars_decl=gen_visitor_input_vars_decl(args),
f9bee751 233 visitor_input_block=gen_visitor_input_block(args))
776574d6
AL
234 else:
235 ret += mcgen('''
297a3646 236
776574d6
AL
237 (void)args;
238''')
c17d9908
MR
239
240 ret += mcgen('''
c17d9908
MR
241%(sync_call)s
242''',
243 sync_call=gen_sync_call(name, args, ret_type, indent=4))
297a3646
MA
244 if re.search('^ *goto out\\;', ret, re.MULTILINE):
245 ret += mcgen('''
c17d9908
MR
246
247out:
248''')
249 ret += mcgen('''
485febc6 250 error_propagate(errp, local_err);
c17d9908 251%(visitor_input_block_cleanup)s
485febc6 252}
776574d6 253''',
f9bee751 254 visitor_input_block_cleanup=gen_visitor_input_block(args,
776574d6 255 dealloc=True))
c17d9908
MR
256 return ret
257
258def gen_registry(commands):
259 registry=""
260 push_indent()
261 for cmd in commands:
d34b867d 262 options = 'QCO_NO_OPTIONS'
d708cdbe 263 if not cmd.get('success-response', True):
d34b867d
LC
264 options = 'QCO_NO_SUCCESS_RESP'
265
c17d9908 266 registry += mcgen('''
d34b867d 267qmp_register_command("%(name)s", qmp_marshal_input_%(c_name)s, %(opts)s);
c17d9908 268''',
18df515e 269 name=cmd['command'], c_name=c_name(cmd['command']),
d34b867d 270 opts=options)
c17d9908
MR
271 pop_indent()
272 ret = mcgen('''
273static void qmp_init_marshal(void)
274{
275%(registry)s
276}
277
278qapi_init(qmp_init_marshal);
279''',
280 registry=registry.rstrip())
281 return ret
282
776574d6 283middle_mode = False
c17d9908 284
2114f5a9
MA
285(input_file, output_dir, do_c, do_h, prefix, opts) = \
286 parse_command_line("m", ["middle"])
8d3bc517 287
c17d9908 288for o, a in opts:
2114f5a9 289 if o in ("-m", "--middle"):
776574d6 290 middle_mode = True
c17d9908 291
33aaad52 292exprs = parse_schema(input_file)
c17d9908 293commands = filter(lambda expr: expr.has_key('command'), exprs)
5dbee474 294commands = filter(lambda expr: not expr.has_key('gen'), commands)
c17d9908 295
12f8e1b9
MA
296c_comment = '''
297/*
298 * schema-defined QMP->QAPI command dispatch
299 *
300 * Copyright IBM, Corp. 2011
301 *
302 * Authors:
303 * Anthony Liguori <aliguori@us.ibm.com>
304 *
305 * This work is licensed under the terms of the GNU LGPL, version 2.1 or later.
306 * See the COPYING.LIB file in the top-level directory.
307 *
308 */
309'''
310h_comment = '''
311/*
312 * schema-defined QAPI function prototypes
313 *
314 * Copyright IBM, Corp. 2011
315 *
316 * Authors:
317 * Anthony Liguori <aliguori@us.ibm.com>
318 *
319 * This work is licensed under the terms of the GNU LGPL, version 2.1 or later.
320 * See the COPYING.LIB file in the top-level directory.
321 *
322 */
323'''
324
325(fdef, fdecl) = open_output(output_dir, do_c, do_h, prefix,
326 'qmp-marshal.c', 'qmp-commands.h',
327 c_comment, h_comment)
328
4180978c
MA
329fdef.write(mcgen('''
330#include "qemu-common.h"
331#include "qemu/module.h"
4180978c
MA
332#include "qapi/qmp/types.h"
333#include "qapi/qmp/dispatch.h"
334#include "qapi/visitor.h"
335#include "qapi/qmp-output-visitor.h"
336#include "qapi/qmp-input-visitor.h"
337#include "qapi/dealloc-visitor.h"
338#include "%(prefix)sqapi-types.h"
339#include "%(prefix)sqapi-visit.h"
340#include "%(prefix)sqmp-commands.h"
341
342''',
343 prefix=prefix))
344
345fdecl.write(mcgen('''
346#include "%(prefix)sqapi-types.h"
347#include "qapi/qmp/qdict.h"
348#include "qapi/error.h"
349
350''',
351 prefix=prefix))
72aaa73a
MA
352
353for cmd in commands:
354 arglist = []
355 ret_type = None
356 if cmd.has_key('data'):
357 arglist = cmd['data']
358 if cmd.has_key('returns'):
359 ret_type = cmd['returns']
360 ret = generate_command_decl(cmd['command'], arglist, ret_type) + "\n"
c17d9908 361 fdecl.write(ret)
72aaa73a
MA
362 if ret_type:
363 ret = gen_marshal_output(cmd['command'], arglist, ret_type, middle_mode) + "\n"
c17d9908
MR
364 fdef.write(ret)
365
72aaa73a
MA
366 if middle_mode:
367 fdecl.write('%s;\n' % gen_marshal_input_decl(cmd['command'], arglist, ret_type, middle_mode))
776574d6 368
72aaa73a
MA
369 ret = gen_marshal_input(cmd['command'], arglist, ret_type, middle_mode) + "\n"
370 fdef.write(ret)
371
72aaa73a
MA
372if not middle_mode:
373 ret = gen_registry(commands)
374 fdef.write(ret)
c17d9908 375
12f8e1b9 376close_output(fdef, fdecl)