Patchwork [wwwdocs] Simplify FAQ around rpath

login
register
mail settings
Submitter Gerald Pfeifer
Date Oct. 30, 2011, 7:15 p.m.
Message ID <alpine.LNX.2.00.1110302010120.3250@gerinyyl.fvgr>
Download mbox | patch
Permalink /patch/122661/
State New
Headers show

Comments

Gerald Pfeifer - Oct. 30, 2011, 7:15 p.m.
While looking into Axel Freyn's suggestion, I noticed how that
answer really is too long winded.  This cuts down things quite
a bit, making this more digestable hopefully.

Applied.

Gerald

Patch

Index: faq.html
===================================================================
RCS file: /cvs/gcc/wwwdocs/htdocs/faq.html,v
retrieving revision 1.213
diff -u -r1.213 faq.html
--- faq.html	30 Oct 2011 19:00:34 -0000	1.213
+++ faq.html	30 Oct 2011 19:12:50 -0000
@@ -176,25 +176,20 @@ 
 <h2><a name="rpath">Dynamic linker is unable to find GCC libraries</a></h2>
 
 <p>This problem manifests itself by programs not finding shared
-libraries they depend on when the programs are started.  Note this
-problem often manifests itself with failures in the libio/libstdc++
-tests after configuring with <code>--enable-shared</code> and building GCC.</p>
+libraries they depend on when the programs are started.  (This
+often shows around libstdc++.)</p>
 
 <p>GCC does not specify a runpath so that the dynamic linker can find
 dynamic libraries at runtime.</p>
 
 <p>The short explanation is that if you always pass a -R option to the
-linker, then your programs become dependent on directories which
-may be NFS mounted, and programs may hang unnecessarily when an
-NFS server goes down.</p>
-
-<p>The problem is not programs that do require the directories; those
-programs are going to hang no matter what you do.  The problem is
-programs that do not require the directories.</p>
-
-<p>SunOS effectively always passed a <code>-R</code> option for every
-<code>-L</code> option; this was a bad idea, and so it was removed for
-Solaris.  We should not recreate it.</p>
+linker, your programs become dependent on directories which
+may be NFS mounted, and programs &mdash; even those which do not
+require these directories &mdash; may hang unnecessarily when an
+NFS server goes down.
+(SunOS effectively always passed a <code>-R</code> option for every
+<code>-L</code> option; this was a bad idea, and it was removed for
+Solaris.)</p>
 
 <p>However, if you feel you really need such an option to be passed
 automatically to the linker, you may add it to a GCC specs file.
@@ -212,12 +207,6 @@ 
 <code>LD_RUN_PATH</code> or equivalent (again, it's
 platform-dependent).</p>
 
-<p>Yet another option, that works on a few platforms, is to hard-code
-the full pathname of the library into its soname.  This can only be
-accomplished by modifying the appropriate <tt>.ml</tt> file within
-<tt>libstdc++/config</tt> (and also <tt>libg++/config</tt>, if you are
-building libg++), so that <code>$(libdir)/</code> appears just before
-the library name in <code>-soname</code> or <code>-h</code> options.</p>
 
 <hr />
 <h2><a name="gas">GCC can not find GNU as/GNU ld</a></h2>