3 # Copyright (c) 2005-2007 Niels Provos <provos@citi.umich.edu>
4 # Copyright (c) 2007-2012 Niels Provos and Nick Mathewson
7 # Generates marshaling code based on libevent.
10 # 1) use optparse to allow the strategy shell to parse options, and
11 # to allow the instantiated factory (for the specific output language)
12 # to parse remaining options
13 # 2) move the globals into a class that manages execution (including the
14 # progress outputs that space stderr at the moment)
15 # 3) emit other languages
20 _NAME = "event_rpcgen.py"
26 white = re.compile(r'\s+')
27 cppcomment = re.compile(r'\/\/.*$')
28 nonident = re.compile(r'[^a-zA-Z0-9_]')
29 structref = re.compile(r'^struct\[([a-zA-Z_][a-zA-Z0-9_]*)\]$')
30 structdef = re.compile(r'^struct +[a-zA-Z_][a-zA-Z0-9_]* *{$')
41 def TranslateList(mylist, mydict):
42 return [x % mydict for x in mylist]
44 # Exception class for parse errors
45 class RpcGenError(Exception):
46 def __init__(self, why):
51 # Holds everything that makes a struct
53 def __init__(self, name):
57 declare(' Created struct: %s' % name)
59 def AddEntry(self, entry):
60 if entry.Tag() in self._tags:
62 'Entry "%s" duplicates tag number %d from "%s" '
63 'around line %d' % (entry.Name(), entry.Tag(),
64 self._tags[entry.Tag()], line_count))
65 self._entries.append(entry)
66 self._tags[entry.Tag()] = entry.Name()
67 declare(' Added entry: %s' % entry.Name())
72 def EntryTagName(self, entry):
73 """Creates the name inside an enumeration for distinguishing data
75 name = "%s_%s" % (self._name, entry.Name())
78 def PrintIndented(self, file, ident, code):
79 """Takes an array, add indentation to each entry and prints it."""
81 file.write('%s%s\n' % (ident, entry))
83 class StructCCode(Struct):
84 """ Knows how to generate C code for a struct """
86 def __init__(self, name):
87 Struct.__init__(self, name)
89 def PrintTags(self, file):
90 """Prints the tag definitions for a structure."""
91 file.write('/* Tag definition for %s */\n' % self._name)
92 file.write('enum %s_ {\n' % self._name.lower())
93 for entry in self._entries:
94 file.write(' %s=%d,\n' % (self.EntryTagName(entry), entry.Tag()))
95 file.write(' %s_MAX_TAGS\n' % (self._name.upper()))
98 def PrintForwardDeclaration(self, file):
99 file.write('struct %s;\n' % self._name)
101 def PrintDeclaration(self, file):
102 file.write('/* Structure declaration for %s */\n' % self._name)
103 file.write('struct %s_access_ {\n' % self._name)
104 for entry in self._entries:
105 dcl = entry.AssignDeclaration('(*%s_assign)' % entry.Name())
107 entry.GetDeclaration('(*%s_get)' % entry.Name()))
110 entry.AddDeclaration('(*%s_add)' % entry.Name()))
111 self.PrintIndented(file, ' ', dcl)
114 file.write('struct %s {\n' % self._name)
115 file.write(' struct %s_access_ *base;\n\n' % self._name)
116 for entry in self._entries:
117 dcl = entry.Declaration()
118 self.PrintIndented(file, ' ', dcl)
120 for entry in self._entries:
121 file.write(' ev_uint8_t %s_set;\n' % entry.Name())
124 file.write("""struct %(name)s *%(name)s_new(void);
125 struct %(name)s *%(name)s_new_with_arg(void *);
126 void %(name)s_free(struct %(name)s *);
127 void %(name)s_clear(struct %(name)s *);
128 void %(name)s_marshal(struct evbuffer *, const struct %(name)s *);
129 int %(name)s_unmarshal(struct %(name)s *, struct evbuffer *);
130 int %(name)s_complete(struct %(name)s *);
131 void evtag_marshal_%(name)s(struct evbuffer *, ev_uint32_t,
132 const struct %(name)s *);
133 int evtag_unmarshal_%(name)s(struct evbuffer *, ev_uint32_t,
134 struct %(name)s *);\n""" % { 'name' : self._name })
137 # Write a setting function of every variable
138 for entry in self._entries:
139 self.PrintIndented(file, '', entry.AssignDeclaration(
140 entry.AssignFuncName()))
141 self.PrintIndented(file, '', entry.GetDeclaration(
142 entry.GetFuncName()))
144 self.PrintIndented(file, '', entry.AddDeclaration(
145 entry.AddFuncName()))
147 file.write('/* --- %s done --- */\n\n' % self._name)
149 def PrintCode(self, file):
151 ' * Implementation of %s\n'
152 ' */\n\n') % self._name)
154 file.write('static struct %(name)s_access_ %(name)s_base__ = {\n' % \
155 { 'name' : self._name })
156 for entry in self._entries:
157 self.PrintIndented(file, ' ', entry.CodeBase())
162 'struct %(name)s *\n'
163 '%(name)s_new(void)\n'
165 ' return %(name)s_new_with_arg(NULL);\n'
168 'struct %(name)s *\n'
169 '%(name)s_new_with_arg(void *unused)\n'
171 ' struct %(name)s *tmp;\n'
172 ' if ((tmp = malloc(sizeof(struct %(name)s))) == NULL) {\n'
173 ' event_warn("%%s: malloc", __func__);\n'
176 ' tmp->base = &%(name)s_base__;\n\n') % { 'name' : self._name })
178 for entry in self._entries:
179 self.PrintIndented(file, ' ', entry.CodeInitialize('tmp'))
180 file.write(' tmp->%s_set = 0;\n\n' % entry.Name())
187 for entry in self._entries:
189 self.PrintIndented(file, '', entry.CodeAdd())
193 for entry in self._entries:
194 self.PrintIndented(file, '', entry.CodeAssign())
198 for entry in self._entries:
199 self.PrintIndented(file, '', entry.CodeGet())
203 file.write(( 'void\n'
204 '%(name)s_clear(struct %(name)s *tmp)\n'
206 '\n') % { 'name' : self._name })
207 for entry in self._entries:
208 self.PrintIndented(file, ' ', entry.CodeClear('tmp'))
213 file.write(( 'void\n'
214 '%(name)s_free(struct %(name)s *tmp)\n'
216 '\n') % { 'name' : self._name })
218 for entry in self._entries:
219 self.PrintIndented(file, ' ', entry.CodeFree('tmp'))
221 file.write((' free(tmp);\n'
226 '%(name)s_marshal(struct evbuffer *evbuf, '
227 'const struct %(name)s *tmp)'
228 '{\n') % { 'name' : self._name })
229 for entry in self._entries:
231 # Optional entries do not have to be set
234 file.write(' if (tmp->%s_set) {\n' % entry.Name())
237 entry.CodeMarshal('evbuf', self.EntryTagName(entry),
238 entry.GetVarName('tmp'),
239 entry.GetVarLen('tmp')))
247 '%(name)s_unmarshal(struct %(name)s *tmp, '
248 ' struct evbuffer *evbuf)\n'
250 ' ev_uint32_t tag;\n'
251 ' while (evbuffer_get_length(evbuf) > 0) {\n'
252 ' if (evtag_peek(evbuf, &tag) == -1)\n'
255 '\n') % { 'name' : self._name })
256 for entry in self._entries:
257 file.write(' case %s:\n' % self.EntryTagName(entry))
258 if not entry.Array():
260 ' if (tmp->%s_set)\n'
262 '\n') % (entry.Name()))
266 entry.CodeUnmarshal('evbuf',
267 self.EntryTagName(entry),
268 entry.GetVarName('tmp'),
269 entry.GetVarLen('tmp')))
271 file.write(( ' tmp->%s_set = 1;\n' % entry.Name() +
273 file.write(( ' default:\n'
277 # Check if it was decoded completely
278 file.write(( ' if (%(name)s_complete(tmp) == -1)\n'
280 '\n') % { 'name' : self._name })
282 # Successfully decoded
283 file.write(( ' return (0);\n'
286 # Checking if a structure has all the required data
289 '%(name)s_complete(struct %(name)s *msg)\n'
290 '{\n' ) % { 'name' : self._name })
291 for entry in self._entries:
292 if not entry.Optional():
294 'if (!msg->%(name)s_set)',
296 code = TranslateList(code, entry.GetTranslation())
302 entry.CodeComplete('msg', entry.GetVarName('msg')))
307 # Complete message unmarshaling
310 'evtag_unmarshal_%(name)s(struct evbuffer *evbuf, '
311 'ev_uint32_t need_tag, struct %(name)s *msg)\n'
313 ' ev_uint32_t tag;\n'
316 ' struct evbuffer *tmp = evbuffer_new();\n'
318 ' if (evtag_unmarshal(evbuf, &tag, tmp) == -1'
319 ' || tag != need_tag)\n'
322 ' if (%(name)s_unmarshal(msg, tmp) == -1)\n'
328 ' evbuffer_free(tmp);\n'
330 '}\n\n' ) % { 'name' : self._name })
332 # Complete message marshaling
335 'evtag_marshal_%(name)s(struct evbuffer *evbuf, ev_uint32_t tag, '
336 'const struct %(name)s *msg)\n'
338 ' struct evbuffer *buf_ = evbuffer_new();\n'
339 ' assert(buf_ != NULL);\n'
340 ' %(name)s_marshal(buf_, msg);\n'
341 ' evtag_marshal_buffer(evbuf, tag, buf_);\n '
342 ' evbuffer_free(buf_);\n'
343 '}\n\n' ) % { 'name' : self._name })
346 def __init__(self, type, name, tag):
352 self._can_be_array = 0
354 self._line_count = -1
358 self._optpointer = True
359 self._optaddarg = True
361 def GetInitializer(self):
362 assert 0, "Entry does not provide initializer"
364 def SetStruct(self, struct):
365 self._struct = struct
368 assert self._line_count != -1
369 return self._line_count
371 def SetLineCount(self, number):
372 self._line_count = number
378 return self._optional
389 def MakeArray(self, yes=1):
392 def MakeOptional(self):
396 if self.Array() and not self._can_be_array:
398 'Entry "%s" cannot be created as an array '
399 'around line %d' % (self._name, self.LineCount()))
402 'Entry "%s" does not know which struct it belongs to '
403 'around line %d' % (self._name, self.LineCount()))
404 if self._optional and self._array:
406 'Entry "%s" has illegal combination of optional and array '
407 'around line %d' % (self._name, self.LineCount()))
409 def GetTranslation(self, extradict = {}):
411 "parent_name" : self._struct.Name(),
413 "ctype" : self._ctype,
414 "refname" : self._refname,
415 "optpointer" : self._optpointer and "*" or "",
416 "optreference" : self._optpointer and "&" or "",
418 self._optaddarg and ", const %s value" % self._ctype or ""
420 for (k, v) in list(extradict.items()):
425 def GetVarName(self, var):
426 return '%(var)s->%(name)s_data' % self.GetTranslation({ 'var' : var })
428 def GetVarLen(self, var):
429 return 'sizeof(%s)' % self._ctype
431 def GetFuncName(self):
432 return '%s_%s_get' % (self._struct.Name(), self._name)
434 def GetDeclaration(self, funcname):
435 code = [ 'int %s(struct %s *, %s *);' % (
436 funcname, self._struct.Name(), self._ctype ) ]
442 '%(parent_name)s_%(name)s_get(struct %(parent_name)s *msg, '
445 ' if (msg->%(name)s_set != 1)',
447 ' *value = msg->%(name)s_data;',
450 code = '\n'.join(code)
451 code = code % self.GetTranslation()
452 return code.split('\n')
454 def AssignFuncName(self):
455 return '%s_%s_assign' % (self._struct.Name(), self._name)
457 def AddFuncName(self):
458 return '%s_%s_add' % (self._struct.Name(), self._name)
460 def AssignDeclaration(self, funcname):
461 code = [ 'int %s(struct %s *, const %s);' % (
462 funcname, self._struct.Name(), self._ctype ) ]
465 def CodeAssign(self):
467 '%(parent_name)s_%(name)s_assign(struct %(parent_name)s *msg,'
468 ' const %(ctype)s value)',
470 ' msg->%(name)s_set = 1;',
471 ' msg->%(name)s_data = value;',
474 code = '\n'.join(code)
475 code = code % self.GetTranslation()
476 return code.split('\n')
478 def CodeClear(self, structname):
479 code = [ '%s->%s_set = 0;' % (structname, self.Name()) ]
483 def CodeComplete(self, structname, var_name):
486 def CodeFree(self, name):
491 '%(parent_name)s_%(name)s_assign,',
492 '%(parent_name)s_%(name)s_get,'
495 code.append('%(parent_name)s_%(name)s_add,')
497 code = '\n'.join(code)
498 code = code % self.GetTranslation()
499 return code.split('\n')
501 class EntryBytes(Entry):
502 def __init__(self, type, name, tag, length):
504 Entry.__init__(self, type, name, tag)
506 self._length = length
507 self._ctype = 'ev_uint8_t'
509 def GetInitializer(self):
512 def GetVarLen(self, var):
513 return '(%s)' % self._length
515 def CodeArrayAdd(self, varname, value):
517 return [ '%(varname)s = NULL;' % { 'varname' : varname } ]
519 def GetDeclaration(self, funcname):
520 code = [ 'int %s(struct %s *, %s **);' % (
521 funcname, self._struct.Name(), self._ctype ) ]
524 def AssignDeclaration(self, funcname):
525 code = [ 'int %s(struct %s *, const %s *);' % (
526 funcname, self._struct.Name(), self._ctype ) ]
529 def Declaration(self):
530 dcl = ['ev_uint8_t %s_data[%s];' % (self._name, self._length)]
537 '%s_%s_get(struct %s *msg, %s **value)' % (
538 self._struct.Name(), name,
539 self._struct.Name(), self._ctype),
541 ' if (msg->%s_set != 1)' % name,
543 ' *value = msg->%s_data;' % name,
548 def CodeAssign(self):
551 '%s_%s_assign(struct %s *msg, const %s *value)' % (
552 self._struct.Name(), name,
553 self._struct.Name(), self._ctype),
555 ' msg->%s_set = 1;' % name,
556 ' memcpy(msg->%s_data, value, %s);' % (
562 def CodeUnmarshal(self, buf, tag_name, var_name, var_len):
563 code = [ 'if (evtag_unmarshal_fixed(%(buf)s, %(tag)s, '
564 '%(var)s, %(varlen)s) == -1) {',
565 ' event_warnx("%%s: failed to unmarshal %(name)s", __func__);',
569 return TranslateList(code,
570 self.GetTranslation({
576 def CodeMarshal(self, buf, tag_name, var_name, var_len):
577 code = ['evtag_marshal(%s, %s, %s, %s);' % (
578 buf, tag_name, var_name, var_len)]
581 def CodeClear(self, structname):
582 code = [ '%s->%s_set = 0;' % (structname, self.Name()),
583 'memset(%s->%s_data, 0, sizeof(%s->%s_data));' % (
584 structname, self._name, structname, self._name)]
588 def CodeInitialize(self, name):
589 code = ['memset(%s->%s_data, 0, sizeof(%s->%s_data));' % (
590 name, self._name, name, self._name)]
596 'Entry "%s" needs a length '
597 'around line %d' % (self._name, self.LineCount()))
601 class EntryInt(Entry):
602 def __init__(self, type, name, tag, bits=32):
604 Entry.__init__(self, type, name, tag)
606 self._can_be_array = 1
608 self._ctype = 'ev_uint32_t'
609 self._marshal_type = 'int'
611 self._ctype = 'ev_uint64_t'
612 self._marshal_type = 'int64'
614 def GetInitializer(self):
617 def CodeArrayFree(self, var):
620 def CodeArrayAssign(self, varname, srcvar):
621 return [ '%(varname)s = %(srcvar)s;' % { 'varname' : varname,
622 'srcvar' : srcvar } ]
624 def CodeArrayAdd(self, varname, value):
625 """Returns a new entry of this type."""
626 return [ '%(varname)s = %(value)s;' % { 'varname' : varname,
629 def CodeUnmarshal(self, buf, tag_name, var_name, var_len):
631 'if (evtag_unmarshal_%(ma)s(%(buf)s, %(tag)s, &%(var)s) == -1) {',
632 ' event_warnx("%%s: failed to unmarshal %(name)s", __func__);',
635 code = '\n'.join(code) % self.GetTranslation({
636 'ma' : self._marshal_type,
640 return code.split('\n')
642 def CodeMarshal(self, buf, tag_name, var_name, var_len):
644 'evtag_marshal_%s(%s, %s, %s);' % (
645 self._marshal_type, buf, tag_name, var_name)]
648 def Declaration(self):
649 dcl = ['%s %s_data;' % (self._ctype, self._name)]
653 def CodeInitialize(self, name):
654 code = ['%s->%s_data = 0;' % (name, self._name)]
657 class EntryString(Entry):
658 def __init__(self, type, name, tag):
660 Entry.__init__(self, type, name, tag)
662 self._can_be_array = 1
663 self._ctype = 'char *'
665 def GetInitializer(self):
668 def CodeArrayFree(self, varname):
670 'if (%(var)s != NULL) free(%(var)s);' ]
672 return TranslateList(code, { 'var' : varname })
674 def CodeArrayAssign(self, varname, srcvar):
676 'if (%(var)s != NULL)',
678 '%(var)s = strdup(%(srcvar)s);',
679 'if (%(var)s == NULL) {',
680 ' event_warnx("%%s: strdup", __func__);',
684 return TranslateList(code, { 'var' : varname,
687 def CodeArrayAdd(self, varname, value):
689 'if (%(value)s != NULL) {',
690 ' %(var)s = strdup(%(value)s);',
691 ' if (%(var)s == NULL) {',
698 return TranslateList(code, { 'var' : varname,
701 def GetVarLen(self, var):
702 return 'strlen(%s)' % self.GetVarName(var)
704 def CodeMakeInitalize(self, varname):
705 return '%(varname)s = NULL;' % { 'varname' : varname }
707 def CodeAssign(self):
710 %(parent_name)s_%(name)s_assign(struct %(parent_name)s *msg,
711 const %(ctype)s value)
713 if (msg->%(name)s_data != NULL)
714 free(msg->%(name)s_data);
715 if ((msg->%(name)s_data = strdup(value)) == NULL)
717 msg->%(name)s_set = 1;
719 }""" % self.GetTranslation()
721 return code.split('\n')
723 def CodeUnmarshal(self, buf, tag_name, var_name, var_len):
724 code = ['if (evtag_unmarshal_string(%(buf)s, %(tag)s, &%(var)s) == -1) {',
725 ' event_warnx("%%s: failed to unmarshal %(name)s", __func__);',
729 code = '\n'.join(code) % self.GetTranslation({
733 return code.split('\n')
735 def CodeMarshal(self, buf, tag_name, var_name, var_len):
736 code = ['evtag_marshal_string(%s, %s, %s);' % (
737 buf, tag_name, var_name)]
740 def CodeClear(self, structname):
741 code = [ 'if (%s->%s_set == 1) {' % (structname, self.Name()),
742 ' free(%s->%s_data);' % (structname, self.Name()),
743 ' %s->%s_data = NULL;' % (structname, self.Name()),
744 ' %s->%s_set = 0;' % (structname, self.Name()),
750 def CodeInitialize(self, name):
751 code = ['%s->%s_data = NULL;' % (name, self._name)]
754 def CodeFree(self, name):
755 code = ['if (%s->%s_data != NULL)' % (name, self._name),
756 ' free (%s->%s_data);' % (name, self._name)]
760 def Declaration(self):
761 dcl = ['char *%s_data;' % self._name]
765 class EntryStruct(Entry):
766 def __init__(self, type, name, tag, refname):
768 Entry.__init__(self, type, name, tag)
770 self._optpointer = False
771 self._can_be_array = 1
772 self._refname = refname
773 self._ctype = 'struct %s*' % refname
774 self._optaddarg = False
776 def GetInitializer(self):
779 def GetVarLen(self, var):
782 def CodeArrayAdd(self, varname, value):
784 '%(varname)s = %(refname)s_new();',
785 'if (%(varname)s == NULL)',
788 return TranslateList(code, self.GetTranslation({ 'varname' : varname }))
790 def CodeArrayFree(self, var):
791 code = [ '%(refname)s_free(%(var)s);' % self.GetTranslation(
795 def CodeArrayAssign(self, var, srcvar):
797 'int had_error = 0;',
798 'struct evbuffer *tmp = NULL;',
799 '%(refname)s_clear(%(var)s);',
800 'if ((tmp = evbuffer_new()) == NULL) {',
801 ' event_warn("%%s: evbuffer_new()", __func__);',
805 '%(refname)s_marshal(tmp, %(srcvar)s);',
806 'if (%(refname)s_unmarshal(%(var)s, tmp) == -1) {',
807 ' event_warnx("%%s: %(refname)s_unmarshal", __func__);',
813 ' evbuffer_free(tmp);',
815 ' %(refname)s_clear(%(var)s);',
819 return TranslateList(code, self.GetTranslation({
826 '%s_%s_get(struct %s *msg, %s *value)' % (
827 self._struct.Name(), name,
828 self._struct.Name(), self._ctype),
830 ' if (msg->%s_set != 1) {' % name,
831 ' msg->%s_data = %s_new();' % (name, self._refname),
832 ' if (msg->%s_data == NULL)' % name,
834 ' msg->%s_set = 1;' % name,
836 ' *value = msg->%s_data;' % name,
841 def CodeAssign(self):
844 %(parent_name)s_%(name)s_assign(struct %(parent_name)s *msg,
845 const %(ctype)s value)
847 struct evbuffer *tmp = NULL;
848 if (msg->%(name)s_set) {
849 %(refname)s_clear(msg->%(name)s_data);
850 msg->%(name)s_set = 0;
852 msg->%(name)s_data = %(refname)s_new();
853 if (msg->%(name)s_data == NULL) {
854 event_warn("%%s: %(refname)s_new()", __func__);
858 if ((tmp = evbuffer_new()) == NULL) {
859 event_warn("%%s: evbuffer_new()", __func__);
862 %(refname)s_marshal(tmp, value);
863 if (%(refname)s_unmarshal(msg->%(name)s_data, tmp) == -1) {
864 event_warnx("%%s: %(refname)s_unmarshal", __func__);
867 msg->%(name)s_set = 1;
873 if (msg->%(name)s_data != NULL) {
874 %(refname)s_free(msg->%(name)s_data);
875 msg->%(name)s_data = NULL;
878 }""" % self.GetTranslation()
879 return code.split('\n')
881 def CodeComplete(self, structname, var_name):
882 code = [ 'if (%(structname)s->%(name)s_set && '
883 '%(refname)s_complete(%(var)s) == -1)',
886 return TranslateList(code, self.GetTranslation({
887 'structname' : structname,
890 def CodeUnmarshal(self, buf, tag_name, var_name, var_len):
891 code = ['%(var)s = %(refname)s_new();',
892 'if (%(var)s == NULL)',
894 'if (evtag_unmarshal_%(refname)s(%(buf)s, %(tag)s, '
896 ' event_warnx("%%s: failed to unmarshal %(name)s", __func__);',
900 code = '\n'.join(code) % self.GetTranslation({
904 return code.split('\n')
906 def CodeMarshal(self, buf, tag_name, var_name, var_len):
907 code = ['evtag_marshal_%s(%s, %s, %s);' % (
908 self._refname, buf, tag_name, var_name)]
911 def CodeClear(self, structname):
912 code = [ 'if (%s->%s_set == 1) {' % (structname, self.Name()),
913 ' %s_free(%s->%s_data);' % (
914 self._refname, structname, self.Name()),
915 ' %s->%s_data = NULL;' % (structname, self.Name()),
916 ' %s->%s_set = 0;' % (structname, self.Name()),
922 def CodeInitialize(self, name):
923 code = ['%s->%s_data = NULL;' % (name, self._name)]
926 def CodeFree(self, name):
927 code = ['if (%s->%s_data != NULL)' % (name, self._name),
928 ' %s_free(%s->%s_data);' % (
929 self._refname, name, self._name)]
933 def Declaration(self):
934 dcl = ['%s %s_data;' % (self._ctype, self._name)]
938 class EntryVarBytes(Entry):
939 def __init__(self, type, name, tag):
941 Entry.__init__(self, type, name, tag)
943 self._ctype = 'ev_uint8_t *'
945 def GetInitializer(self):
948 def GetVarLen(self, var):
949 return '%(var)s->%(name)s_length' % self.GetTranslation({ 'var' : var })
951 def CodeArrayAdd(self, varname, value):
953 return [ '%(varname)s = NULL;' % { 'varname' : varname } ]
955 def GetDeclaration(self, funcname):
956 code = [ 'int %s(struct %s *, %s *, ev_uint32_t *);' % (
957 funcname, self._struct.Name(), self._ctype ) ]
960 def AssignDeclaration(self, funcname):
961 code = [ 'int %s(struct %s *, const %s, ev_uint32_t);' % (
962 funcname, self._struct.Name(), self._ctype ) ]
965 def CodeAssign(self):
968 '%s_%s_assign(struct %s *msg, '
969 'const %s value, ev_uint32_t len)' % (
970 self._struct.Name(), name,
971 self._struct.Name(), self._ctype),
973 ' if (msg->%s_data != NULL)' % name,
974 ' free (msg->%s_data);' % name,
975 ' msg->%s_data = malloc(len);' % name,
976 ' if (msg->%s_data == NULL)' % name,
978 ' msg->%s_set = 1;' % name,
979 ' msg->%s_length = len;' % name,
980 ' memcpy(msg->%s_data, value, len);' % name,
988 '%s_%s_get(struct %s *msg, %s *value, ev_uint32_t *plen)' % (
989 self._struct.Name(), name,
990 self._struct.Name(), self._ctype),
992 ' if (msg->%s_set != 1)' % name,
994 ' *value = msg->%s_data;' % name,
995 ' *plen = msg->%s_length;' % name,
1000 def CodeUnmarshal(self, buf, tag_name, var_name, var_len):
1001 code = ['if (evtag_payload_length(%(buf)s, &%(varlen)s) == -1)',
1003 # We do not want DoS opportunities
1004 'if (%(varlen)s > evbuffer_get_length(%(buf)s))',
1006 'if ((%(var)s = malloc(%(varlen)s)) == NULL)',
1008 'if (evtag_unmarshal_fixed(%(buf)s, %(tag)s, %(var)s, '
1009 '%(varlen)s) == -1) {',
1010 ' event_warnx("%%s: failed to unmarshal %(name)s", __func__);',
1014 code = '\n'.join(code) % self.GetTranslation({
1018 'varlen' : var_len })
1019 return code.split('\n')
1021 def CodeMarshal(self, buf, tag_name, var_name, var_len):
1022 code = ['evtag_marshal(%s, %s, %s, %s);' % (
1023 buf, tag_name, var_name, var_len)]
1026 def CodeClear(self, structname):
1027 code = [ 'if (%s->%s_set == 1) {' % (structname, self.Name()),
1028 ' free (%s->%s_data);' % (structname, self.Name()),
1029 ' %s->%s_data = NULL;' % (structname, self.Name()),
1030 ' %s->%s_length = 0;' % (structname, self.Name()),
1031 ' %s->%s_set = 0;' % (structname, self.Name()),
1037 def CodeInitialize(self, name):
1038 code = ['%s->%s_data = NULL;' % (name, self._name),
1039 '%s->%s_length = 0;' % (name, self._name) ]
1042 def CodeFree(self, name):
1043 code = ['if (%s->%s_data != NULL)' % (name, self._name),
1044 ' free(%s->%s_data);' % (name, self._name)]
1048 def Declaration(self):
1049 dcl = ['ev_uint8_t *%s_data;' % self._name,
1050 'ev_uint32_t %s_length;' % self._name]
1054 class EntryArray(Entry):
1055 def __init__(self, entry):
1057 Entry.__init__(self, entry._type, entry._name, entry._tag)
1060 self._refname = entry._refname
1061 self._ctype = self._entry._ctype
1062 self._optional = True
1063 self._optpointer = self._entry._optpointer
1064 self._optaddarg = self._entry._optaddarg
1066 # provide a new function for accessing the variable name
1067 def GetVarName(var_name):
1068 return '%(var)s->%(name)s_data[%(index)s]' % \
1069 self._entry.GetTranslation({'var' : var_name,
1070 'index' : self._index})
1071 self._entry.GetVarName = GetVarName
1073 def GetInitializer(self):
1076 def GetVarName(self, var_name):
1079 def GetVarLen(self, var_name):
1082 def GetDeclaration(self, funcname):
1083 """Allows direct access to elements of the array."""
1085 'int %(funcname)s(struct %(parent_name)s *, int, %(ctype)s *);' %
1086 self.GetTranslation({ 'funcname' : funcname }) ]
1089 def AssignDeclaration(self, funcname):
1090 code = [ 'int %s(struct %s *, int, const %s);' % (
1091 funcname, self._struct.Name(), self._ctype ) ]
1094 def AddDeclaration(self, funcname):
1096 '%(ctype)s %(optpointer)s '
1097 '%(funcname)s(struct %(parent_name)s *msg%(optaddarg)s);' % \
1098 self.GetTranslation({ 'funcname' : funcname }) ]
1103 %(parent_name)s_%(name)s_get(struct %(parent_name)s *msg, int offset,
1106 if (!msg->%(name)s_set || offset < 0 || offset >= msg->%(name)s_length)
1108 *value = msg->%(name)s_data[offset];
1110 }""" % self.GetTranslation()
1112 return code.split('\n')
1114 def CodeAssign(self):
1117 '%(parent_name)s_%(name)s_assign(struct %(parent_name)s *msg, int off,',
1118 ' const %(ctype)s value)',
1120 ' if (!msg->%(name)s_set || off < 0 || off >= msg->%(name)s_length)',
1123 code = TranslateList(code, self.GetTranslation())
1125 codearrayassign = self._entry.CodeArrayAssign(
1126 'msg->%(name)s_data[off]' % self.GetTranslation(), 'value')
1127 code += [' ' + x for x in codearrayassign]
1129 code += TranslateList([
1132 '}' ], self.GetTranslation())
1137 codearrayadd = self._entry.CodeArrayAdd(
1138 'msg->%(name)s_data[msg->%(name)s_length - 1]' % self.GetTranslation(),
1142 '%(parent_name)s_%(name)s_expand_to_hold_more('
1143 'struct %(parent_name)s *msg)',
1145 ' int tobe_allocated = msg->%(name)s_num_allocated;',
1146 ' %(ctype)s* new_data = NULL;',
1147 ' tobe_allocated = !tobe_allocated ? 1 : tobe_allocated << 1;',
1148 ' new_data = (%(ctype)s*) realloc(msg->%(name)s_data,',
1149 ' tobe_allocated * sizeof(%(ctype)s));',
1150 ' if (new_data == NULL)',
1152 ' msg->%(name)s_data = new_data;',
1153 ' msg->%(name)s_num_allocated = tobe_allocated;',
1157 '%(ctype)s %(optpointer)s',
1158 '%(parent_name)s_%(name)s_add('
1159 'struct %(parent_name)s *msg%(optaddarg)s)',
1161 ' if (++msg->%(name)s_length >= msg->%(name)s_num_allocated) {',
1162 ' if (%(parent_name)s_%(name)s_expand_to_hold_more(msg)<0)',
1166 code = TranslateList(code, self.GetTranslation())
1168 code += [' ' + x for x in codearrayadd]
1170 code += TranslateList([
1171 ' msg->%(name)s_set = 1;',
1172 ' return %(optreference)s(msg->%(name)s_data['
1173 'msg->%(name)s_length - 1]);',
1175 ' --msg->%(name)s_length;',
1177 '}' ], self.GetTranslation())
1181 def CodeComplete(self, structname, var_name):
1183 tmp = self._entry.CodeComplete(structname, self._entry.GetVarName(var_name))
1184 # skip the whole loop if there is nothing to check
1188 translate = self.GetTranslation({ 'structname' : structname })
1192 ' for (i = 0; i < %(structname)s->%(name)s_length; ++i) {' ]
1194 code = TranslateList(code, translate)
1196 code += [' ' + x for x in tmp]
1204 def CodeUnmarshal(self, buf, tag_name, var_name, var_len):
1205 translate = self.GetTranslation({ 'var' : var_name,
1208 'init' : self._entry.GetInitializer()})
1210 'if (%(var)s->%(name)s_length >= %(var)s->%(name)s_num_allocated &&',
1211 ' %(parent_name)s_%(name)s_expand_to_hold_more(%(var)s) < 0) {',
1212 ' puts("HEY NOW");',
1216 # the unmarshal code directly returns
1217 code = TranslateList(code, translate)
1219 self._index = '%(var)s->%(name)s_length' % translate
1220 code += self._entry.CodeUnmarshal(buf, tag_name,
1221 self._entry.GetVarName(var_name),
1222 self._entry.GetVarLen(var_name))
1224 code += [ '++%(var)s->%(name)s_length;' % translate ]
1228 def CodeMarshal(self, buf, tag_name, var_name, var_len):
1231 ' for (i = 0; i < %(var)s->%(name)s_length; ++i) {' ]
1234 code += self._entry.CodeMarshal(buf, tag_name,
1235 self._entry.GetVarName(var_name),
1236 self._entry.GetVarLen(var_name))
1241 code = "\n".join(code) % self.GetTranslation({ 'var' : var_name })
1243 return code.split('\n')
1245 def CodeClear(self, structname):
1246 translate = self.GetTranslation({ 'structname' : structname })
1247 codearrayfree = self._entry.CodeArrayFree(
1248 '%(structname)s->%(name)s_data[i]' % self.GetTranslation(
1249 { 'structname' : structname } ))
1251 code = [ 'if (%(structname)s->%(name)s_set == 1) {' ]
1256 ' for (i = 0; i < %(structname)s->%(name)s_length; ++i) {' ]
1258 code = TranslateList(code, translate)
1261 code += [' ' + x for x in codearrayfree]
1265 code += TranslateList([
1266 ' free(%(structname)s->%(name)s_data);',
1267 ' %(structname)s->%(name)s_data = NULL;',
1268 ' %(structname)s->%(name)s_set = 0;',
1269 ' %(structname)s->%(name)s_length = 0;',
1270 ' %(structname)s->%(name)s_num_allocated = 0;',
1276 def CodeInitialize(self, name):
1277 code = ['%s->%s_data = NULL;' % (name, self._name),
1278 '%s->%s_length = 0;' % (name, self._name),
1279 '%s->%s_num_allocated = 0;' % (name, self._name)]
1282 def CodeFree(self, structname):
1283 code = self.CodeClear(structname);
1285 code += TranslateList([
1286 'free(%(structname)s->%(name)s_data);' ],
1287 self.GetTranslation({'structname' : structname }))
1291 def Declaration(self):
1292 dcl = ['%s *%s_data;' % (self._ctype, self._name),
1293 'int %s_length;' % self._name,
1294 'int %s_num_allocated;' % self._name ]
1298 def NormalizeLine(line):
1302 line = cppcomment.sub('', line)
1304 line = white.sub(' ', line)
1308 def ProcessOneEntry(factory, newstruct, entry):
1318 tokens = entry.split(' ')
1324 if not optional and token == 'optional':
1328 if not array and token == 'array':
1337 res = re.match(r'^([^\[\]]+)(\[.*\])?$', token)
1340 'Cannot parse name: \"%s\" '
1341 'around line %d' % (entry, line_count))
1343 fixed_length = res.group(2)
1345 fixed_length = fixed_length[1:-1]
1350 if separator != '=':
1351 raise RpcGenError('Expected "=" after name \"%s\" got %s'
1357 if not re.match(r'^(0x)?[0-9]+$', token):
1358 raise RpcGenError('Expected tag number: \"%s\"' % entry)
1362 raise RpcGenError('Cannot parse \"%s\"' % entry)
1365 raise RpcGenError('Need tag number: \"%s\"' % entry)
1367 # Create the right entry
1368 if entry_type == 'bytes':
1370 newentry = factory.EntryBytes(entry_type, name, tag, fixed_length)
1372 newentry = factory.EntryVarBytes(entry_type, name, tag)
1373 elif entry_type == 'int' and not fixed_length:
1374 newentry = factory.EntryInt(entry_type, name, tag)
1375 elif entry_type == 'int64' and not fixed_length:
1376 newentry = factory.EntryInt(entry_type, name, tag, bits=64)
1377 elif entry_type == 'string' and not fixed_length:
1378 newentry = factory.EntryString(entry_type, name, tag)
1380 res = structref.match(entry_type)
1382 # References another struct defined in our file
1383 newentry = factory.EntryStruct(entry_type, name, tag, res.group(1))
1385 raise RpcGenError('Bad type: "%s" in "%s"' % (entry_type, entry))
1390 newentry.MakeOptional()
1392 newentry.MakeArray()
1394 newentry.SetStruct(newstruct)
1395 newentry.SetLineCount(line_count)
1399 # We need to encapsulate this entry into a struct
1400 newname = newentry.Name()+ '_array'
1402 # Now borgify the new entry.
1403 newentry = factory.EntryArray(newentry)
1404 newentry.SetStruct(newstruct)
1405 newentry.SetLineCount(line_count)
1406 newentry.MakeArray()
1408 newstruct.AddEntry(newentry)
1412 def ProcessStruct(factory, data):
1413 tokens = data.split(' ')
1415 # First three tokens are: 'struct' 'name' '{'
1416 newstruct = factory.Struct(tokens[1])
1418 inside = ' '.join(tokens[3:-1])
1420 tokens = inside.split(';')
1424 for entry in tokens:
1425 entry = NormalizeLine(entry)
1429 # It's possible that new structs get defined in here
1430 structs.extend(ProcessOneEntry(factory, newstruct, entry))
1432 structs.append(newstruct)
1435 def GetNextStruct(file):
1441 processed_lines = []
1446 line = file.readline()
1453 if not have_c_comment and re.search(r'/\*', line):
1454 if re.search(r'/\*.*?\*/', line):
1455 line = re.sub(r'/\*.*?\*/', '', line)
1457 line = re.sub(r'/\*.*$', '', line)
1461 if not re.search(r'\*/', line):
1464 line = re.sub(r'^.*\*/', '', line)
1466 line = NormalizeLine(line)
1472 if re.match(r'#include ["<].*[>"]', line):
1473 cppdirect.append(line)
1476 if re.match(r'^#(if( |def)|endif)', line):
1477 cppdirect.append(line)
1480 if re.match(r'^#define', line):
1481 headerdirect.append(line)
1484 if not structdef.match(line):
1485 raise RpcGenError('Missing struct on line %d: %s'
1486 % (line_count, line))
1492 # We are inside the struct
1493 tokens = line.split('}')
1494 if len(tokens) == 1:
1499 raise RpcGenError('Trailing garbage after struct on line %d'
1502 # We found the end of the struct
1503 data += ' %s}' % tokens[0]
1506 # Remove any comments, that might be in there
1507 data = re.sub(r'/\*.*\*/', '', data)
1512 def Parse(factory, file):
1514 Parses the input file and returns C code and corresponding header file.
1520 # Just gets the whole struct nicely formatted
1521 data = GetNextStruct(file)
1526 entities.extend(ProcessStruct(factory, data))
1530 class CCodeGenerator:
1534 def GuardName(self, name):
1535 # Use the complete provided path to the input file, with all
1536 # non-identifier characters replaced with underscores, to
1537 # reduce the chance of a collision between guard macros.
1538 return 'EVENT_RPCOUT_' + nonident.sub('_', name).upper() + '_'
1540 def HeaderPreamble(self, name):
1541 guard = self.GuardName(name)
1544 ' * Automatically generated from %s\n'
1547 '#define %s\n\n' ) % (
1550 for statement in headerdirect:
1551 pre += '%s\n' % statement
1556 '#include <event2/util.h> /* for ev_uint*_t */\n'
1557 '#include <event2/rpc.h>\n'
1562 def HeaderPostamble(self, name):
1563 guard = self.GuardName(name)
1564 return '#endif /* %s */' % guard
1566 def BodyPreamble(self, name, header_file):
1570 slash = header_file.rfind('/')
1572 header_file = header_file[slash+1:]
1575 ' * Automatically generated from %s\n'
1576 ' * by %s/%s. DO NOT EDIT THIS FILE.\n'
1577 ' */\n\n' ) % (name, _NAME, _VERSION)
1578 pre += ( '#include <stdlib.h>\n'
1579 '#include <string.h>\n'
1580 '#include <assert.h>\n'
1581 '#include <event2/event-config.h>\n'
1582 '#include <event2/event.h>\n'
1583 '#include <event2/buffer.h>\n'
1584 '#include <event2/tag.h>\n\n'
1585 '#if defined(EVENT__HAVE___func__)\n'
1586 '# ifndef __func__\n'
1587 '# define __func__ __func__\n'
1589 '#elif defined(EVENT__HAVE___FUNCTION__)\n'
1590 '# define __func__ __FUNCTION__\n'
1592 '# define __func__ __FILE__\n'
1596 for statement in cppdirect:
1597 pre += '%s\n' % statement
1599 pre += '\n#include "%s"\n\n' % header_file
1601 pre += 'void event_warn(const char *fmt, ...);\n'
1602 pre += 'void event_warnx(const char *fmt, ...);\n\n'
1606 def HeaderFilename(self, filename):
1607 return '.'.join(filename.split('.')[:-1]) + '.h'
1609 def CodeFilename(self, filename):
1610 return '.'.join(filename.split('.')[:-1]) + '.gen.c'
1612 def Struct(self, name):
1613 return StructCCode(name)
1615 def EntryBytes(self, entry_type, name, tag, fixed_length):
1616 return EntryBytes(entry_type, name, tag, fixed_length)
1618 def EntryVarBytes(self, entry_type, name, tag):
1619 return EntryVarBytes(entry_type, name, tag)
1621 def EntryInt(self, entry_type, name, tag, bits=32):
1622 return EntryInt(entry_type, name, tag, bits)
1624 def EntryString(self, entry_type, name, tag):
1625 return EntryString(entry_type, name, tag)
1627 def EntryStruct(self, entry_type, name, tag, struct_name):
1628 return EntryStruct(entry_type, name, tag, struct_name)
1630 def EntryArray(self, entry):
1631 return EntryArray(entry)
1633 class Usage(RpcGenError):
1634 def __init__(self, argv0):
1635 RpcGenError.__init__("usage: %s input.rpc [[output.h] output.c]"
1639 def __init__(self, argv):
1640 """Initialize a command-line to launch event_rpcgen, as if
1641 from a command-line with CommandLine(sys.argv). If you're
1642 calling this directly, remember to provide a dummy value
1645 self.filename = None
1646 self.header_file = None
1647 self.impl_file = None
1648 self.factory = CCodeGenerator()
1650 if len(argv) >= 2 and argv[1] == '--quiet':
1655 if len(argv) < 2 or len(argv) > 4:
1656 raise Usage(argv[0])
1658 self.filename = argv[1].replace('\\', '/')
1660 self.impl_file = argv[2].replace('\\', '/')
1662 self.header_file = argv[2].replace('\\', '/')
1663 self.impl_file = argv[3].replace('\\', '/')
1665 if not self.filename:
1666 raise Usage(argv[0])
1668 if not self.impl_file:
1669 self.impl_file = self.factory.CodeFilename(self.filename)
1671 if not self.header_file:
1672 self.header_file = self.factory.HeaderFilename(self.impl_file)
1674 if not self.impl_file.endswith('.c'):
1675 raise RpcGenError("can only generate C implementation files")
1676 if not self.header_file.endswith('.h'):
1677 raise RpcGenError("can only generate C header files")
1680 filename = self.filename
1681 header_file = self.header_file
1682 impl_file = self.impl_file
1683 factory = self.factory
1685 declare('Reading \"%s\"' % filename)
1687 fp = open(filename, 'r')
1688 entities = Parse(factory, fp)
1691 declare('... creating "%s"' % header_file)
1692 header_fp = open(header_file, 'w')
1693 header_fp.write(factory.HeaderPreamble(filename))
1695 # Create forward declarations: allows other structs to reference
1697 for entry in entities:
1698 entry.PrintForwardDeclaration(header_fp)
1699 header_fp.write('\n')
1701 for entry in entities:
1702 entry.PrintTags(header_fp)
1703 entry.PrintDeclaration(header_fp)
1704 header_fp.write(factory.HeaderPostamble(filename))
1707 declare('... creating "%s"' % impl_file)
1708 impl_fp = open(impl_file, 'w')
1709 impl_fp.write(factory.BodyPreamble(filename, header_file))
1710 for entry in entities:
1711 entry.PrintCode(impl_fp)
1714 if __name__ == '__main__':
1716 CommandLine(sys.argv).run()
1719 except RpcGenError as e:
1723 except EnvironmentError as e:
1724 if e.filename and e.strerror:
1725 sys.stderr.write("%s: %s" % (e.filename, e.strerror))
1728 sys.stderr.write(e.strerror)