Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
use raw strings for regexp
[simgrid.git] / src / simix / simcalls.py
index 1d57171..9d51800 100755 (executable)
 #!/usr/bin/env python
 # -*- coding: utf-8 -*-
 
-# Copyright (c) 2014. The SimGrid Team.
-# All rights reserved.
+# Copyright (c) 2014-2016. The SimGrid Team. All rights reserved.
 
 # This program is free software; you can redistribute it and/or modify it
 # under the terms of the license (GNU LGPL) which comes with this package.
 
-import re, glob
-
-types = [('TCHAR', 'char', 'c')
-        ,('TSTRING', 'const char*', 'cc')
-        ,('TINT', 'int', 'i')
-        ,('TLONG', 'long', 'l')
-        ,('TUCHAR', 'unsigned char', 'uc')
-        ,('TUSHORT', 'unsigned short', 'us')
-        ,('TUINT', 'unsigned int', 'ui')
-        ,('TULONG', 'unsigned long', 'ul')
-        ,('TFLOAT', 'float', 'f')
-        ,('TDOUBLE', 'double', 'd')
-        ,('TDPTR', 'void*', 'dp')
-        ,('TFPTR', 'FPtr', 'fp')
-        ,('TCPTR', 'const void*', 'cp')
-        ,('TSIZE', 'size_t', 'sz')
-        ,('TSGSIZE', 'sg_size_t', 'sgsz')
-        ,('TSGOFF', 'sg_offset_t', 'sgoff')
-        ,('TVOID', 'void', '')
-        ,('TDSPEC', 'void*', 'dp')
-        ,('TFSPEC', 'FPtr', 'fp')]
+import re
+import glob
 
 class Arg(object):
-  simcall_types = {k:v for _,k,v in types}
-  def __init__(self, name, type, casted=None):
-    self.name = name 
-    self.type = type
-    self.casted = casted
-    assert type in self.simcall_types, '%s not in (%s)'%(type, ', '.join(self.simcall_types.keys()))
 
-  def field(self):
-    return self.simcall_types[self.type]
+    def __init__(self, name, type):
+        self.name = name
+        self.type = type
 
-  def ret(self):
-    return '%s'%self.casted if self.casted else self.type
+    def field(self):
+        return self.simcall_types[self.type]
 
-  def cast(self):
-    return '(%s)'%self.casted if self.casted else '' 
+    def rettype(self):
+        return self.type
 
 class Simcall(object):
-  simcalls_BODY = None
-  simcalls_PRE = None
-  def __init__(self, name, res, args, has_answer=True):
-    self.name = name
-    self.res = res
-    self.args = args
-    self.has_answer = has_answer
-
-  def check(self):
-    # smx_user.c  simcall_BODY_
-    # smx_*.c void SIMIX_pre_host_on(smx_simcall_t simcall, smx_host_t h)
-    self.check_body()
-    self.check_pre()
-
-  def check_body(self):
-    if self.simcalls_BODY is None:
-      f = open('smx_user.c')
-      self.simcalls_BODY = set(re.findall('simcall_BODY_(.*?)\(', f.read()))
-      f.close()
-    if self.name not in self.simcalls_BODY:
-      print '# ERROR: No function calling simcall_BODY_%s'%self.name
-      print '# Add something like this to smx_user.c:'
-      print '''%s simcall_%s(%s)
-{
-  return simcall_BODY_%s(%s);
-}\n'''%(self.res.ret()
-     ,self.name
-     ,', '.join('%s %s'%(arg.ret(), arg.name)
-                  for arg in self.args)
-     ,self.name
-     ,', '.join(arg.name for arg in self.args))
-      return False
-    return True
-
-  def check_pre(self):
-    if self.simcalls_PRE is None:
-      self.simcalls_PRE = set()
-      for fn in glob.glob('smx_*') + glob.glob('../mc/*'):
-        f = open(fn)
-        self.simcalls_PRE |= set(re.findall('SIMIX_pre_(.*?)\(', f.read()))
-        f.close()
-    if self.name not in self.simcalls_PRE:
-      print '# ERROR: No function called SIMIX_pre_%s'%self.name
-      print '# Add something like this to smx_.*.c:'
-      print '''%s SIMIX_pre_%s(smx_simcall_t simcall%s)
-{
-  // Your code handling the simcall
-}\n'''%(self.res.ret()
-       ,self.name
-       ,''.join(', %s %s'%(arg.ret(), arg.name)
-                  for arg in self.args))
-      return False
-    return True
-
-  def enum(self):
-    return 'SIMCALL_%s,'%(self.name.upper())
-
-  def string(self):
-    return '[SIMCALL_%s] = "SIMCALL_%s",'%(self.name.upper(), self.name.upper())       
-  
-  def result_getter_setter(self):
-    return '%s\n%s'%(self.result_getter(), self.result_setter())
-  
-  def result_getter(self):
-    return '' if self.res.type == 'void' else '''static inline %s simcall_%s__get__result(smx_simcall_t simcall){
-  return %s simcall->result.%s;
-}'''%(self.res.ret(), self.name, self.res.cast(), self.res.field())
-
-  def result_setter(self):
-    return '' if self.res.type == 'void' else '''static inline void simcall_%s__set__result(smx_simcall_t simcall, %s result){
-    simcall->result.%s = result;
-}'''%(self.name, self.res.type, self.res.field())
-
-  def args_getter_setter(self):
-    res = []
-    for i in range(len(self.args)):
-      res.append(self.arg_getter(i))
-      res.append(self.arg_setter(i))
-    return '\n'.join(res)
-
-  def arg_getter(self, i):
-    arg = self.args[i]
-    return '''static inline %s simcall_%s__get__%s(smx_simcall_t simcall){
-  return %s simcall->args[%i].%s;
-}'''%(arg.ret(), self.name, arg.name, arg.cast(), i, arg.field())
-
-  def arg_setter(self, i):
-    arg = self.args[i]
-    return '''static inline void simcall_%s__set__%s(smx_simcall_t simcall, %s arg){
-    simcall->args[%i].%s = arg;
-}'''%(self.name, arg.name, arg.type, i, arg.field())
-
-  def case(self):
-    return '''case SIMCALL_%s:
-      %sSIMIX_pre_%s(simcall %s);
-      %sbreak;  
-'''%(self.name.upper(), 
-     'simcall->result.%s = '%self.res.field() if self.res.type != 'void' and self.has_answer else ' ',
-     self.name,
-     ''.join(', %s simcall->args[%d].%s'%(arg.cast(), i, arg.field()) 
-             for i, arg in enumerate(self.args)),
-     'SIMIX_simcall_answer(simcall);\n      ' if self.has_answer else ' ')
-
-  def body(self):
-    return '''  inline static %s simcall_BODY_%s(%s) {
-    smx_process_t self = SIMIX_process_self();
-
-    /* Go to that function to follow the code flow through the simcall barrier */
-    if (0) SIMIX_pre_%s(%s);
-    /* end of the guide intended to the poor programmer wanting to go from MSG to Surf */
-
-    self->simcall.call = SIMCALL_%s;
-    memset(&self->simcall.result, 0, sizeof(self->simcall.result));
-    memset(self->simcall.args, 0, sizeof(self->simcall.args));
-%s
-    if (self != simix_global->maestro_process) {
-      XBT_DEBUG("Yield process '%%s' on simcall %%s (%%d)", self->name,
-                SIMIX_simcall_name(self->simcall.call), (int)self->simcall.call);
-      SIMIX_process_yield(self);
-    } else {
-      SIMIX_simcall_pre(&self->simcall, 0);
-    }    
-    %s
-  }'''%(self.res.ret()
-       ,self.name
-       ,', '.join('%s %s'%(arg.ret(), arg.name)
-                  for arg in self.args)
-       ,self.name
-       ,', '.join(["&self->simcall"]+ [arg.name for arg in self.args])
-       ,self.name.upper()
-       ,'\n'.join('    self->simcall.args[%d].%s = (%s) %s;'%(i, arg.field(), arg.type, arg.name)
-                  for i, arg in enumerate(self.args))
-       ,'' if self.res.type == 'void' else 'return self->simcall.result.%s;'%self.res.field())
+    simcalls_BODY = None
+    simcalls_PRE = None
+
+    def __init__(self, name, handler, res, args, call_kind):
+        self.name = name
+        self.res = res
+        self.args = args
+        self.need_handler = handler
+        self.call_kind = call_kind
+
+    def check(self):
+        # libsmx.c  simcall_BODY_
+        if self.simcalls_BODY is None:
+            f = open('libsmx.cpp')
+            self.simcalls_BODY = set(re.findall(r'simcall_BODY_(.*?)\(', f.read()))
+            f.close()
+        if self.name not in self.simcalls_BODY:
+            print ('# ERROR: No function calling simcall_BODY_%s' % self.name)
+            print ('# Add something like this to libsmx.c:')
+            print ('%s simcall_%s(%s) {' % (self.res.rettype(), self.name, ', '.
+                   join('%s %s' % (arg.rettype(), arg.name) for arg in self.args)))
+            print ('  return simcall_BODY_%s(%s);' % (self.name, "..."))
+            print ('}')
+            return False
+
+        # smx_*.c void simcall_HANDLER_host_on(smx_simcall_t simcall,
+        # smx_host_t h)
+        if self.simcalls_PRE is None:
+            self.simcalls_PRE = set()
+            for fn in glob.glob('smx_*') + glob.glob('../mc/*'):
+                f = open(fn)
+                self.simcalls_PRE |= set(re.findall(r'simcall_HANDLER_(.*?)\(', f.read()))
+                f.close()
+        if self.need_handler:
+            if self.name not in self.simcalls_PRE:
+                print ('# ERROR: No function called simcall_HANDLER_%s' % self.name)
+                print ('# Add something like this to the relevant C file (like smx_io.c if it\'s an IO call):')
+                print ('%s simcall_HANDLER_%s(smx_simcall_t simcall%s) {' % (self.res.rettype(), self.name, ''.
+                       join(', %s %s' % (arg.rettype(), arg.name)for arg in self.args)))
+                print ('  // Your code handling the simcall')
+                print ('}')
+                return False
+        else:
+            if self.name in self.simcalls_PRE:
+                print ('# ERROR: You have a function called simcall_HANDLER_%s, but that simcall is not using any handler' % self.name)
+                print ('# Either change your simcall definition, or kill that function')
+                return False
+        return True
+
+    def enum(self):
+        return '  SIMCALL_%s,' % (self.name.upper())
+
+    def string(self):
+        return '  "SIMCALL_%s",' % self.name.upper()
+
+    def accessors(self):
+        res = []
+        res.append('')
+        # Arguments getter/setters
+        for i in range(len(self.args)):
+            arg = self.args[i]
+            res.append('static inline %s simcall_%s__get__%s(smx_simcall_t simcall) {' % (
+                arg.rettype(), self.name, arg.name))
+            res.append(
+                '  return simgrid::simix::unmarshal<%s>(simcall->args[%i]);' % (arg.rettype(), i))
+            res.append('}')
+            res.append('static inline void simcall_%s__set__%s(smx_simcall_t simcall, %s arg) {' % (
+                self.name, arg.name, arg.rettype()))
+            res.append('    simgrid::simix::marshal<%s>(simcall->args[%i], arg);' % (arg.rettype(), i))
+            res.append('}')
+
+        # Return value getter/setters
+        if self.res.type != 'void':
+            res.append(
+                'static inline %s simcall_%s__get__result(smx_simcall_t simcall){' % (self.res.rettype(), self.name))
+            res.append('    return simgrid::simix::unmarshal<%s>(simcall->result);' % self.res.rettype())
+            res.append('}')
+            res.append(
+                'static inline void simcall_%s__set__result(smx_simcall_t simcall, %s result){' % (self.name, self.res.rettype()))
+            res.append('    simgrid::simix::marshal<%s>(simcall->result, result);' % (self.res.rettype()))
+            res.append('}')
+        return '\n'.join(res)
+
+    def case(self):
+        res = []
+        args = [ "simgrid::simix::unmarshal<%s>(simcall->args[%d])" % (arg.rettype(), i)
+            for i, arg in enumerate(self.args) ]
+        res.append('case SIMCALL_%s:' % (self.name.upper()))
+        if self.need_handler:
+            call = "simcall_HANDLER_%s(simcall%s%s)" % (self.name,
+                ", " if len(args) > 0 else "",
+                ', '.join(args))
+        else:
+            call = "SIMIX_%s(%s)" % (self.name, ', '.join(args))
+        if self.call_kind == 'Func':
+            res.append("      simgrid::simix::marshal<%s>(simcall->result, %s);" % (self.res.rettype(), call))
+        else:
+            res.append("      " + call + ";");
+        if self.call_kind != 'Blck':
+            res.append('      SIMIX_simcall_answer(simcall);')
+        res.append('      break;')
+        res.append('')
+        return '\n'.join(res)
+
+    def body(self):
+        res = ['  ']
+        res.append(
+            'inline static %s simcall_BODY_%s(%s) {' % (self.res.rettype(),
+                                                        self.name,
+                                                        ', '.join('%s %s' % (arg.rettype(), arg.name) for arg in self.args)))
+        res.append(
+            '    /* Go to that function to follow the code flow through the simcall barrier */')
+        if self.need_handler:
+            res.append('    if (0) simcall_HANDLER_%s(%s);' % (self.name,
+                                                               ', '.join(["&SIMIX_process_self()->simcall"] + [arg.name for arg in self.args])))
+        else:
+            res.append('    if (0) SIMIX_%s(%s);' % (self.name,
+                                                     ', '.join(arg.name for arg in self.args)))
+        res.append('    return simcall<%s%s>(SIMCALL_%s%s);' % (
+            self.res.rettype(),
+            "".join([ ", " + arg.rettype() for i, arg in enumerate(self.args) ]),
+            self.name.upper(),
+            "".join([ ", " + arg.name for i, arg in enumerate(self.args) ])
+            ));
+        res.append('  }')
+        return '\n'.join(res)
+
+    def handler_prototype(self):
+        if self.need_handler:
+            return "XBT_PRIVATE %s simcall_HANDLER_%s(smx_simcall_t simcall%s);" % (self.res.rettype() if self.call_kind == 'Func' else 'void',
+                                                                                    self.name,
+                                                                                    ''.join(', %s %s' % (arg.rettype(), arg.name)
+                                                                                            for i, arg in enumerate(self.args)))
+        else:
+            return ""
+
 
 def parse(fn):
-  res = []
-  resdi = None
-  resd = {}
-  for line in open(fn).read().split('\n'):
-    if line.startswith('##'):
-      resdi = []
-      resd[re.search(r'## *(.*)', line).group(1)] = resdi
-    if line.startswith('#') or not line:
-      continue
-    match = re.match(r'(\S*?) *(\S*?) *\((.*?)(?:, *(.*?))?\) *(.*)', line)
-    assert match, line
-    name, ans, rest, resc, args = match.groups()
-    sargs = []
-    for n,t,c in re.findall(r'\((.*?), *(.*?)(?:, *(.*?))?\)', args):
-      sargs.append(Arg(n,t,c))
-    sim = Simcall(name, Arg('result', rest, resc), sargs, ans == 'True')
-    if resdi is None:
-      res.append(sim)
-    else:
-      resdi.append(sim)
-  return res, resd
-
-def write(fn, func, scs, scd,pre="",post=""):
-  f = open(fn, 'w')
-  f.write('/*********************************************\n')
-  f.write(' * File Generated by src/simix/simcalls.py   *\n')
-  f.write(' *                from src/simix/simcalls.in *\n')
-  f.write(' * Do not modify this file, add new simcalls *\n')
-  f.write(' * in src/simix/simcalls.in                  *\n')  
-  f.write(' *********************************************/\n\n')
-  f.write(pre)
-  f.write('\n'.join(func(sc) for sc in scs))
-  for k, v in scd.items():
-    f.write('\n#ifdef %s\n%s\n#endif\n'%(k, '\n'.join(func(sc) for sc in v)))
-  f.write(post)
-  f.close()
-
-if __name__=='__main__':
-  import sys
-  simcalls, simcalls_dict = parse('simcalls.in')
-  
-  ok = True
-  ok &= all(map(Simcall.check, simcalls))
-  for k,v in simcalls_dict.items():
-    ok &= all(map(Simcall.check, v))
-  #if not ok:
-  #  sys.exit(1)
-
-  write('simcalls_generated_enum.h', Simcall.enum, simcalls, simcalls_dict,"""
-/**
- * @brief All possible simcalls.
- */
-typedef enum {
-SIMCALL_NONE,
-  ""","""
-SIMCALL_NEW_API_INIT,
-NUM_SIMCALLS
-} e_smx_simcall_t;
-  """)
-  
-  write('simcalls_generated_string.c', Simcall.string, simcalls, simcalls_dict)
-  write('simcalls_generated_res_getter_setter.h', Simcall.result_getter_setter, simcalls, simcalls_dict)
-  write('simcalls_generated_args_getter_setter.h', Simcall.args_getter_setter, simcalls, simcalls_dict)
-  write('simcalls_generated_case.c', Simcall.case, simcalls, simcalls_dict)
-  write('simcalls_generated_body.c', Simcall.body, simcalls, simcalls_dict)
+    simcalls = []
+    resdi = None
+    simcalls_guarded = {}
+    for line in open(fn).read().split('\n'):
+        if line.startswith('##'):
+            resdi = []
+            simcalls_guarded[re.search(r'## *(.*)', line).group(1)] = resdi
+        if line.startswith('#') or not line:
+            continue
+        match = re.match(
+            r'^(\S+)\s+([^\)\(\s]+)\s*\(*(.*)\)\s*(\[\[.*\]\])?\s*;\s*?$', line)
+        assert match, line
+        ret, name, args, attrs = match.groups()
+        sargs = []
+        if not re.match(r"^\s*$", args):
+            for arg in re.split(",", args):
+                args = args.strip()
+                match = re.match(r"^(.*?)\s*?(\S+)$", arg)
+                t, n = match.groups()
+                t = t.strip()
+                n = n.strip()
+                sargs.append(Arg(n, t))
+        if ret == "void":
+            ans = "Proc"
+        else:
+            ans = "Func"
+        handler = True
+        if attrs:
+            attrs = attrs[2:-2]
+            for attr in re.split(",", attrs):
+                if attr == "block":
+                    ans = "Blck"
+                elif attr == "nohandler":
+                    handler = False
+                else:
+                    assert False, "Unknown attribute %s in: %s" % (attr, line)
+        sim = Simcall(name, handler, Arg('result', ret), sargs, ans)
+        if resdi is None:
+            simcalls.append(sim)
+        else:
+            resdi.append(sim)
+    return simcalls, simcalls_guarded
+
+
+def header(name):
+    fd = open(name, 'w')
+    fd.write(
+        '/**********************************************************************/\n')
+    fd.write(
+        '/* File generated by src/simix/simcalls.py from src/simix/simcalls.in */\n')
+    fd.write(
+        '/*                                                                    */\n')
+    fd.write(
+        '/*                    DO NOT EVER CHANGE THIS FILE                    */\n')
+    fd.write(
+        '/*                                                                    */\n')
+    fd.write(
+        '/* change simcalls specification in src/simix/simcalls.in             */\n')
+    fd.write(
+        '/**********************************************************************/\n\n')
+    fd.write('/*\n')
+    fd.write(
+        ' * Note that the name comes from http://en.wikipedia.org/wiki/Popping\n')
+    fd.write(
+        ' * Indeed, the control flow is doing a strange dance in there.\n')
+    fd.write(' *\n')
+    fd.write(
+        ' * That\'s not about http://en.wikipedia.org/wiki/Poop, despite the odor :)\n')
+    fd.write(' */\n\n')
+    return fd
+
+
+def handle(fd, func, simcalls, guarded_simcalls):
+    def nonempty(e): return e != ''
+    fd.write(
+        '\n'.join(filter(nonempty, (func(simcall) for simcall in simcalls))))
+
+    for guard, list in guarded_simcalls.items():
+        fd.write('\n#if %s\n' % (guard))
+        fd.write('\n'.join(func(simcall) for simcall in list))
+        fd.write('\n#endif\n')
+
+if __name__ == '__main__':
+    import sys
+    simcalls, simcalls_dict = parse('simcalls.in')
+
+    ok = True
+    ok &= all(map(Simcall.check, simcalls))
+    for k, v in simcalls_dict.items():
+        ok &= all(map(Simcall.check, v))
+    # FIXME: we should not hide it
+    # if not ok:
+    #  print ("Some checks fail!")
+    #  sys.exit(1)
+
+    #
+    # smx_popping_accessors.c
+    #
+    fd = header('popping_accessors.h')
+    fd.write('#include "src/simix/popping_private.h"');
+    handle(fd, Simcall.accessors, simcalls, simcalls_dict)
+    fd.write(
+        "\n\n/* The prototype of all simcall handlers, automatically generated for you */\n\n")
+    handle(fd, Simcall.handler_prototype, simcalls, simcalls_dict)
+    fd.close()
+
+    #
+    # smx_popping_enum.c
+    #
+    fd = header("popping_enum.h")
+    fd.write('/**\n')
+    fd.write(' * @brief All possible simcalls.\n')
+    fd.write(' */\n')
+    fd.write('typedef enum {\n')
+    fd.write('  SIMCALL_NONE,\n')
+
+    handle(fd, Simcall.enum, simcalls, simcalls_dict)
+
+    fd.write('  NUM_SIMCALLS\n')
+    fd.write('} e_smx_simcall_t;\n')
+    fd.close()
+
+    #
+    # smx_popping_generated.cpp
+    #
+
+    fd = header("popping_generated.cpp")
+
+    fd.write('#include <xbt/base.h>\n')
+    fd.write('#include "smx_private.h"\n')
+    fd.write('#if HAVE_MC\n')
+    fd.write('#include "src/mc/mc_forward.hpp"\n')
+    fd.write('#endif\n')
+    fd.write('\n')
+    fd.write('XBT_LOG_EXTERNAL_DEFAULT_CATEGORY(simix_popping);\n\n')
+
+    fd.write(
+        '/** @brief Simcalls\' names (generated from src/simix/simcalls.in) */\n')
+    fd.write('const char* simcall_names[] = {\n')
+
+    fd.write('   "SIMCALL_NONE",')
+    handle(fd, Simcall.string, simcalls, simcalls_dict)
+
+    fd.write('};\n\n')
+
+    fd.write('/** @private\n')
+    fd.write(
+        ' * @brief (in kernel mode) unpack the simcall and activate the handler\n')
+    fd.write(' * \n')
+    fd.write(' * This function is generated from src/simix/simcalls.in\n')
+    fd.write(' */\n')
+    fd.write(
+        'void SIMIX_simcall_handle(smx_simcall_t simcall, int value) {\n')
+    fd.write(
+        '  XBT_DEBUG("Handling simcall %p: %s", simcall, SIMIX_simcall_name(simcall->call));\n')
+    fd.write('  SIMCALL_SET_MC_VALUE(simcall, value);\n')
+    fd.write(
+        '  if (simcall->issuer->context->iwannadie && simcall->call != SIMCALL_PROCESS_CLEANUP)\n')
+    fd.write('    return;\n')
+    fd.write('  switch (simcall->call) {\n')
+
+    handle(fd, Simcall.case, simcalls, simcalls_dict)
+
+    fd.write('    case NUM_SIMCALLS:\n')
+    fd.write('      break;\n')
+    fd.write('    case SIMCALL_NONE:\n')
+    fd.write(
+        '      THROWF(arg_error,0,"Asked to do the noop syscall on %s@%s",\n')
+    fd.write('          SIMIX_process_get_name(simcall->issuer),\n')
+    fd.write(
+        '          sg_host_get_name(SIMIX_process_get_host(simcall->issuer))\n')
+    fd.write('          );\n')
+    fd.write('      break;\n')
+    fd.write('\n')
+    fd.write('  }\n')
+    fd.write('}\n')
+
+    fd.close()
+
+    #
+    # smx_popping_bodies.cpp
+    #
+    fd = header('popping_bodies.cpp')
+    fd.write('#include <functional>\n')
+    fd.write('#include "smx_private.h"\n')
+    fd.write('#include "src/mc/mc_forward.hpp"\n')
+    fd.write('#include "xbt/ex.h"\n')
+    fd.write('#include <simgrid/simix.hpp>\n')
+    fd.write("/** @cond */ // Please Doxygen, don't look at this\n")
+    fd.write('''
+template<class R, class... T>
+inline static R simcall(e_smx_simcall_t call, T const&... t)
+{
+  smx_process_t self = SIMIX_process_self();
+  simgrid::simix::marshal(&self->simcall, call, t...);
+  if (self != simix_global->maestro_process) {
+    XBT_DEBUG("Yield process '%s' on simcall %s (%d)", self->name.c_str(),
+              SIMIX_simcall_name(self->simcall.call), (int)self->simcall.call);
+    SIMIX_process_yield(self);
+  } else {
+    SIMIX_simcall_handle(&self->simcall, 0);
+  }
+  return simgrid::simix::unmarshal<R>(self->simcall.result);
+}
+''')
+    handle(fd, Simcall.body, simcalls, simcalls_dict)
+    fd.write("/** @endcond */\n");
+    fd.close()