From: Mukund Sivaraman <muks@isc.org>
Date: Tue, 20 Nov 2012 12:51:13 +0000 (+0530)
Subject: [2450] Document in the guide that ldconfig has to be run sometimes
X-Git-Tag: bind10-1.0.0-beta-release~52^2~6
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=d9c0f5f2d9294d8eb026bf92fd8fda103e9fc747;p=thirdparty%2Fkea.git

[2450] Document in the guide that ldconfig has to be run sometimes
---

diff --git a/doc/guide/bind10-guide.xml b/doc/guide/bind10-guide.xml
index d585b63095..840d01f10f 100644
--- a/doc/guide/bind10-guide.xml
+++ b/doc/guide/bind10-guide.xml
@@ -418,6 +418,14 @@ var/
           </para>
         </listitem>
 
+        <listitem>
+          <para>If required, run <command>ldconfig</command> as root
+          (with <filename>/usr/local</filename> in
+          <filename>/etc/ld.so.conf</filename>):
+            <screen>$ <userinput>ldconfig</userinput></screen>
+          </para>
+        </listitem>
+
         <listitem>
           <para>Start the server (as root):
             <screen>$ <userinput>/usr/local/sbin/bind10</userinput></screen>
@@ -783,7 +791,22 @@ as a dependency earlier -->
         <note>
           <para>The install step may require superuser privileges.</para>
         </note>
-
+        <para>
+	  If required, run <command>ldconfig</command> as root (with
+	  <filename>/usr/local</filename> in
+	  <filename>/etc/ld.so.conf</filename>):
+	  <screen>$ <userinput>ldconfig</userinput></screen>
+        </para>
+        <note>
+          <para>
+	    If you do not run <command>ldconfig</command> where it is
+	    required, you may see errors like the following:
+            <screen>
+	      program: error while loading shared libraries: libb10-something.so.1:
+	      cannot open shared object file: No such file or directory
+	    </screen>
+	  </para>
+        </note>
       </section>
 
   <!-- TODO: tests -->