socsvn commit: r224844 - soc2011/gk/ino64-head/tools/tools/shlib-compat

[gk at FreeBSD.org]

Author: gk
Date: Tue Aug  2 14:51:22 2011
New Revision: 224844
URL: http://svnweb.FreeBSD.org/socsvn/?view=rev&rev=224844

Log:
  shlib-compat: Document the way to compare libc.so with sysfake stubs

Modified:
  soc2011/gk/ino64-head/tools/tools/shlib-compat/README

Modified: soc2011/gk/ino64-head/tools/tools/shlib-compat/README
==============================================================================
--- soc2011/gk/ino64-head/tools/tools/shlib-compat/README	Tue Aug  2 14:51:12 2011	(r224843)
+++ soc2011/gk/ino64-head/tools/tools/shlib-compat/README	Tue Aug  2 14:51:22 2011	(r224844)
@@ -3,3 +3,13 @@
 shlib-compat uses dwarf debugging symbols to recreate definitions of exported
 symbols, including function arguments and structural types.
 
+
+Syscalls in libc are implemented as assembly stubs and thus have no debugging
+symbols attached. To enable sysfake stubs rebuild libc adding the following to
+/etc/make.conf:
+LIBC_EXTRAMK=/usr/src/tools/tools/shlib-compat/Makefile.sysfake
+
+To compare libc.so versions compiled with sysfake stubs:
+./shlib-compat -v --alias-prefix __sysfake_ --alias-prefix __sysfake_freebsd8_ \
+	--exclude-ver FBSDprivate \
+	--out-orig out-orig.c --out-new out-new.c libc.so.7.orig libc.so.7.new