src/system/libroot/stubbed/libroot_stubs.c.readme

   1 The source file libroot_stubs.c contains empty stubs for all symbols exported by
   2 libroot.so, including definitions of all versioned symbols.
   3
   4 From libroot_stubs.c, <stubbed>libroot.so can be built, which is a stubbed
   5 version of libroot.so (i.e. without any code). This stubbed library is used
   6 during stage 0 of the bootstrap process, in order to build the gcc-syslibs
   7 (libgcc, libsupc++ and libstdc++).
   8
   9 The python script generate_stubs.py can be used to regenerate libroot_stubs.c
  10 from a built version of (the real) libroot.so. This may be necessary when new
  11 symbols have been added to libroot.so.
  12
  13 The command for regenerating libroot_stubs.c is this:
  14
  15         nm <path-to-libroot.so> | generate_stubs.py >libroot.stubs.c
  16
  17 There is a separate version of the stubs file for the legacy compiler (gcc2),
  18 which uses a different symbol mangling format and contains the symbols for
  19 libgcc, too.