docs/internals/m_syswrap.txt

   1
   2 This module handles the complex business of handing system calls off
   3 to the host and then fixing up the guest state accordingly.  It
   4 interacts complicatedly with signals and to a less extent threads.
   5
   6 There are some important caveats regarding how to write the PRE and
   7 POST wrappers for syscalls.  It is important to observe these, else
   8 you will have to track down almost impossibly obscure bugs.  These
   9 caveats are described in comments at the top of syswrap-main.c.
  10
  11 The main file is syswrap-main.c.  It contains all the driver logic
  12 and a great deal of commentary.  The wrappers themselves live in
  13 syswrap-generic.c, syswrap-${OS}.c and syswrap-${PLATFORM}.c.
  14