scripts/qapi-event.py

   1 """
   2 QAPI event generator
   3
   4 Copyright (c) 2014 Wenchao Xia
   5 Copyright (c) 2015-2018 Red Hat Inc.
   6
   7 Authors:
   8  Wenchao Xia <[email protected]>
   9  Markus Armbruster <[email protected]>
  10
  11 This work is licensed under the terms of the GNU GPL, version 2.
  12 See the COPYING file in the top-level directory.
  13 """
  14
  15 from qapi import *
  16
  17
  18 def build_event_send_proto(name, arg_type, boxed):
  19     return 'void qapi_event_send_%(c_name)s(%(param)s)' % {
  20         'c_name': c_name(name.lower()),
  21         'param': build_params(arg_type, boxed, 'Error **errp')}
  22
  23
  24 def gen_event_send_decl(name, arg_type, boxed):
  25     return mcgen('''
  26
  27 %(proto)s;
  28 ''',
  29                  proto=build_event_send_proto(name, arg_type, boxed))
  30
  31
  32 # Declare and initialize an object 'qapi' using parameters from build_params()
  33 def gen_param_var(typ):
  34     assert not typ.variants
  35     ret = mcgen('''
  36     %(c_name)s param = {
  37 ''',
  38                 c_name=typ.c_name())
  39     sep = '        '
  40     for memb in typ.members:
  41         ret += sep
  42         sep = ', '
  43         if memb.optional:
  44             ret += 'has_' + c_name(memb.name) + sep
  45         if memb.type.name == 'str':
  46             # Cast away const added in build_params()
  47             ret += '(char *)'
  48         ret += c_name(memb.name)
  49     ret += mcgen('''
  50
  51     };
  52 ''')
  53     if not typ.is_implicit():
  54         ret += mcgen('''
  55     %(c_name)s *arg = &param;
  56 ''',
  57                      c_name=typ.c_name())
  58     return ret
  59
  60
  61 def gen_event_send(name, arg_type, boxed, event_enum_name):
  62     # FIXME: Our declaration of local variables (and of 'errp' in the
  63     # parameter list) can collide with exploded members of the event's
  64     # data type passed in as parameters.  If this collision ever hits in
  65     # practice, we can rename our local variables with a leading _ prefix,
  66     # or split the code into a wrapper function that creates a boxed
  67     # 'param' object then calls another to do the real work.
  68     ret = mcgen('''
  69
  70 %(proto)s
  71 {
  72     QDict *qmp;
  73     Error *err = NULL;
  74     QMPEventFuncEmit emit;
  75 ''',
  76                 proto=build_event_send_proto(name, arg_type, boxed))
  77
  78     if arg_type and not arg_type.is_empty():
  79         ret += mcgen('''
  80     QObject *obj;
  81     Visitor *v;
  82 ''')
  83         if not boxed:
  84             ret += gen_param_var(arg_type)
  85     else:
  86         assert not boxed
  87
  88     ret += mcgen('''
  89
  90     emit = qmp_event_get_func_emit();
  91     if (!emit) {
  92         return;
  93     }
  94
  95     qmp = qmp_event_build_dict("%(name)s");
  96
  97 ''',
  98                  name=name)
  99
 100     if arg_type and not arg_type.is_empty():
 101         ret += mcgen('''
 102     v = qobject_output_visitor_new(&obj);
 103 ''')
 104         if not arg_type.is_implicit():
 105             ret += mcgen('''
 106     visit_type_%(c_name)s(v, "%(name)s", &arg, &err);
 107 ''',
 108                          name=name, c_name=arg_type.c_name())
 109         else:
 110             ret += mcgen('''
 111
 112     visit_start_struct(v, "%(name)s", NULL, 0, &err);
 113     if (err) {
 114         goto out;
 115     }
 116     visit_type_%(c_name)s_members(v, &param, &err);
 117     if (!err) {
 118         visit_check_struct(v, &err);
 119     }
 120     visit_end_struct(v, NULL);
 121 ''',
 122                          name=name, c_name=arg_type.c_name())
 123         ret += mcgen('''
 124     if (err) {
 125         goto out;
 126     }
 127
 128     visit_complete(v, &obj);
 129     qdict_put_obj(qmp, "data", obj);
 130 ''')
 131
 132     ret += mcgen('''
 133     emit(%(c_enum)s, qmp, &err);
 134
 135 ''',
 136                  c_enum=c_enum_const(event_enum_name, name))
 137
 138     if arg_type and not arg_type.is_empty():
 139         ret += mcgen('''
 140 out:
 141     visit_free(v);
 142 ''')
 143     ret += mcgen('''
 144     error_propagate(errp, err);
 145     QDECREF(qmp);
 146 }
 147 ''')
 148     return ret
 149
 150
 151 class QAPISchemaGenEventVisitor(QAPISchemaVisitor):
 152     def __init__(self, prefix):
 153         self._enum_name = c_name(prefix + 'QAPIEvent', protect=False)
 154         self.decl = None
 155         self.defn = None
 156         self._event_names = None
 157
 158     def visit_begin(self, schema):
 159         self.decl = ''
 160         self.defn = ''
 161         self._event_names = []
 162
 163     def visit_end(self):
 164         self.decl += gen_enum(self._enum_name, self._event_names)
 165         self.defn += gen_enum_lookup(self._enum_name, self._event_names)
 166         self._event_names = None
 167
 168     def visit_event(self, name, info, arg_type, boxed):
 169         self.decl += gen_event_send_decl(name, arg_type, boxed)
 170         self.defn += gen_event_send(name, arg_type, boxed, self._enum_name)
 171         self._event_names.append(name)
 172
 173
 174 def main(argv):
 175     (input_file, output_dir, do_c, do_h, prefix, dummy) = parse_command_line()
 176
 177     blurb = ' * Schema-defined QAPI/QMP events'
 178
 179     genc = QAPIGenC(blurb, __doc__)
 180     genh = QAPIGenH(blurb, __doc__)
 181
 182     genc.add(mcgen('''
 183 #include "qemu/osdep.h"
 184 #include "qemu-common.h"
 185 #include "%(prefix)sqapi-event.h"
 186 #include "%(prefix)sqapi-visit.h"
 187 #include "qapi/error.h"
 188 #include "qapi/qmp/qdict.h"
 189 #include "qapi/qobject-output-visitor.h"
 190 #include "qapi/qmp-event.h"
 191
 192 ''',
 193                    prefix=prefix))
 194
 195     genh.add(mcgen('''
 196 #include "qapi/util.h"
 197 #include "%(prefix)sqapi-types.h"
 198
 199 ''',
 200                    prefix=prefix))
 201
 202     schema = QAPISchema(input_file)
 203     vis = QAPISchemaGenEventVisitor(prefix)
 204     schema.visit(vis)
 205     genc.add(vis.defn)
 206     genh.add(vis.decl)
 207
 208     if do_c:
 209         genc.write(output_dir, prefix + 'qapi-event.c')
 210     if do_h:
 211         genh.write(output_dir, prefix + 'qapi-event.h')
 212
 213
 214 if __name__ == '__main__':
 215     main(sys.argv)