From 5897639a63b476759f18df9496b5d8d8844372fc Mon Sep 17 00:00:00 2001
From: Bruce Dubbs <bdubbs@linuxfromscratch.org>
Date: Wed, 3 May 2017 21:28:38 +0000
Subject: Fix a problem with glibc tests and add some explanations to i the
 configure options.

Add a command to touch /root/.vimrc so that the default vim
options don't override those in /etc/vimrc.



git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@11240 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
---
 chapter06/glibc.xml | 51 +++++++++++++++++++++++++++++++++++++++++++++------
 1 file changed, 45 insertions(+), 6 deletions(-)

(limited to 'chapter06/glibc.xml')

diff --git a/chapter06/glibc.xml b/chapter06/glibc.xml
index 49775184a..5d2afcd81 100644
--- a/chapter06/glibc.xml
+++ b/chapter06/glibc.xml
@@ -78,11 +78,51 @@ cd       build</userinput></screen>
     <para>Prepare Glibc for compilation:</para>
 
 <screen><userinput remap="configure">../configure --prefix=/usr                   \
+             --disable-werror                \
              --enable-kernel=&min-kernel;          \
              --enable-obsolete-rpc           \
              --enable-stack-protector=strong \
              libc_cv_slibdir=/lib</userinput></screen>
 
+   <variablelist>
+      <title>The meaning of the new configure options:</title>
+
+      <varlistentry>
+        <term><parameter>--disable-werror</parameter></term>
+        <listitem>
+          <para>This option disables the -Werror option passed to 
+          GCC.  This is necessary for running the test suite.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><parameter>--enable-obsolete-rpc</parameter></term>
+        <listitem>
+          <para>This option builds older RPC code for use with
+          network file system utilities (nfs).</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><parameter>--enable-stack-protector=strong</parameter></term>
+        <listitem>
+          <para>This option increases system security by adding  a known canary
+          (a random integer) to the stack during a function preamble, and checks
+          it when the function returns. If it changed, there was a stack
+          overflow, and the program aborts.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><parameter>libc_cv_slibdir=/lib</parameter></term>
+        <listitem>
+          <para>This variable sets the correct library for all
+          systems.  We do not want lib64 to be used.</para>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
     <para>Compile the package:</para>
 
 <screen><userinput remap="make">make</userinput></screen>
@@ -97,17 +137,16 @@ cd       build</userinput></screen>
 
 <screen><userinput remap="test">make check</userinput></screen>
 
-    <para>You will probably see some test failures.  The Glibc test suite is
+    <para>You may see some test failures.  The Glibc test suite is
     somewhat dependent on the host system.  This is a list of the most common
-    issues seen for this version of LFS:</para>
+    issues seen for some versions of LFS:</para>
 
     <itemizedlist>
 
       <listitem>
-        <para><emphasis>posix/tst-getaddrinfo4</emphasis> will always fail due
-        to not having the necessary networking applications when the tests are
-        run.  <emphasis>posix/tst-getaddrinfo5</emphasis> is also known
-        to fail on some architectures.</para>
+        <para><emphasis>posix/tst-getaddrinfo4</emphasis> and
+        <emphasis>posix/tst-getaddrinfo5</emphasis>
+        may fail on some architectures.</para>
       </listitem>
 
       <listitem>
-- 
cgit v1.2.3-54-g00ecf