tools/tools/shlib-compat/README

   1 ABI compatibility checker for shared libraries with symbol versioning.
   2
   3 shlib-compat uses dwarf debugging symbols to recreate definitions of
   4 exported symbols, including function arguments and structural types.
   5
   6 The shlib-compat.py script requires devel/dwarfdump port to be
   7 installed.
   8
   9
  10 Syscalls in libc are implemented as assembly stubs and thus have no
  11 debugging symbols attached. To enable sysfake stubs rebuild libc
  12 adding the following to /etc/make.conf:
  13
  14 .if ${.CURDIR:M/usr/src/lib/libc}
  15 .include "../../tools/tools/shlib-compat/Makefile.sysfake"
  16 .endif
  17
  18 To compare libc.so versions compiled with sysfake stubs:
  19 ./shlib-compat.py -v --alias-prefix __sysfake_ \
  20         --alias-prefix __sysfake_freebsd8_ \
  21         --exclude-ver FBSDprivate \
  22         --out-orig out-orig.c --out-new out-new.c libc.so.7.orig libc.so.7.new