From owner-svn-soc-all@FreeBSD.ORG  Tue Aug  2 14:51:25 2011
Return-Path: <owner-svn-soc-all@FreeBSD.ORG>
Delivered-To: svn-soc-all@FreeBSD.org
Received: from socsvn.FreeBSD.org (unknown [IPv6:2001:4f8:fff6::2f])
	by hub.freebsd.org (Postfix) with SMTP id ECACC1065688
	for <svn-soc-all@FreeBSD.org>; Tue,  2 Aug 2011 14:51:22 +0000 (UTC)
	(envelope-from gk@FreeBSD.org)
Received: by socsvn.FreeBSD.org (sSMTP sendmail emulation);
	Tue, 02 Aug 2011 14:51:22 +0000
Date: Tue, 02 Aug 2011 14:51:22 +0000
From: gk@FreeBSD.org
To: svn-soc-all@FreeBSD.org
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Message-Id: <20110802145122.ECACC1065688@hub.freebsd.org>
Cc: 
Subject: socsvn commit: r224844 -
	soc2011/gk/ino64-head/tools/tools/shlib-compat
X-BeenThere: svn-soc-all@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: SVN commit messages for the entire Summer of Code repository
	<svn-soc-all.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/svn-soc-all>,
	<mailto:svn-soc-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-soc-all>
List-Post: <mailto:svn-soc-all@freebsd.org>
List-Help: <mailto:svn-soc-all-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-soc-all>,
	<mailto:svn-soc-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Tue, 02 Aug 2011 14:51:25 -0000

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