From owner-svn-doc-all@FreeBSD.ORG  Fri Feb  8 13:20:52 2013
Return-Path: <owner-svn-doc-all@FreeBSD.ORG>
Delivered-To: svn-doc-all@freebsd.org
Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115])
 by hub.freebsd.org (Postfix) with ESMTP id 20AD76B5;
 Fri,  8 Feb 2013 13:20:52 +0000 (UTC)
 (envelope-from eadler@FreeBSD.org)
Received: from svn.freebsd.org (svn.freebsd.org
 [IPv6:2001:1900:2254:2068::e6a:0])
 by mx1.freebsd.org (Postfix) with ESMTP id 1355062E;
 Fri,  8 Feb 2013 13:20:52 +0000 (UTC)
Received: from svn.freebsd.org ([127.0.1.70])
 by svn.freebsd.org (8.14.5/8.14.5) with ESMTP id r18DKpbt004007;
 Fri, 8 Feb 2013 13:20:51 GMT (envelope-from eadler@svn.freebsd.org)
Received: (from eadler@localhost)
 by svn.freebsd.org (8.14.5/8.14.5/Submit) id r18DKpnW004006;
 Fri, 8 Feb 2013 13:20:51 GMT (envelope-from eadler@svn.freebsd.org)
Message-Id: <201302081320.r18DKpnW004006@svn.freebsd.org>
From: Eitan Adler <eadler@FreeBSD.org>
Date: Fri, 8 Feb 2013 13:20:51 +0000 (UTC)
To: doc-committers@freebsd.org, svn-doc-all@freebsd.org,
 svn-doc-head@freebsd.org
Subject: svn commit: r40914 - head/en_US.ISO8859-1/books/faq
X-SVN-Group: doc-head
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-BeenThere: svn-doc-all@freebsd.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: "SVN commit messages for the entire doc trees \(except for &quot;
 user&quot; , &quot; projects&quot; , and &quot; translations&quot;
 \)" <svn-doc-all.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/svn-doc-all>,
 <mailto:svn-doc-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-doc-all>
List-Post: <mailto:svn-doc-all@freebsd.org>
List-Help: <mailto:svn-doc-all-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-doc-all>,
 <mailto:svn-doc-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Fri, 08 Feb 2013 13:20:52 -0000

Author: eadler
Date: Fri Feb  8 13:20:51 2013
New Revision: 40914
URL: http://svnweb.freebsd.org/changeset/doc/40914

Log:
  Restore dlsym-failure as this question appears to still be an FAQ.
  
  Requested by:	kib
  Approved by:	bcr (mentor, implicit)

Modified:
  head/en_US.ISO8859-1/books/faq/book.xml

Modified: head/en_US.ISO8859-1/books/faq/book.xml
==============================================================================
--- head/en_US.ISO8859-1/books/faq/book.xml	Fri Feb  8 10:23:03 2013	(r40913)
+++ head/en_US.ISO8859-1/books/faq/book.xml	Fri Feb  8 13:20:51 2013	(r40914)
@@ -8325,6 +8325,27 @@ panic: page fault</programlisting>
       </qandaentry>
 
       <qandaentry>
+	<question id="dlsym-failure">
+	  <para>Why has <function>dlsym()</function> stopped working for
+	    ELF executables?</para>
+	</question>
+
+	<answer>
+	  <para>The ELF toolchain does not, by default, make the symbols
+	    defined in an executable visible to the dynamic linker.
+	    Consequently <function>dlsym()</function> searches on
+	    handles obtained from calls to <function>dlopen(NULL,
+	      flags)</function> will fail to find such symbols.</para>
+
+	  <para>If you want to search, using
+	    <function>dlsym()</function>, for symbols present in the
+	    main executable of a process, you need to link the
+	    executable using the <option>--export-dynamic</option>
+	    option to the ELF linker (&man.ld.1;).</para>
+	</answer>
+      </qandaentry>
+
+      <qandaentry>
 	<question id="change-kernel-address-space">
 	  <para>How can I increase or reduce the kernel address space on
 	    i386?</para>