Changeset 7bfad05 for chapter06/glibc-inst.xml

Timestamp:

01/27/2003 10:10:07 PM (21 years ago)

Author:

Gerard Beekmans <gerard@…>

Branches:

10.0, 10.0-rc1, 10.1, 10.1-rc1, 11.0, 11.0-rc1, 11.0-rc2, 11.0-rc3, 11.1, 11.1-rc1, 11.2, 11.2-rc1, 11.3, 11.3-rc1, 12.0, 12.0-rc1, 12.1, 12.1-rc1, 6.0, 6.1, 6.1.1, 6.3, 6.4, 6.5, 6.6, 6.7, 6.8, 7.0, 7.1, 7.2, 7.3, 7.4, 7.5, 7.5-systemd, 7.6, 7.6-systemd, 7.7, 7.7-systemd, 7.8, 7.8-systemd, 7.9, 7.9-systemd, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, arm, bdubbs/gcc13, ml-11.0, multilib, renodr/libudev-from-systemd, s6-init, trunk, v4_1, v5_0, v5_1, v5_1_1, xry111/arm64, xry111/arm64-12.0, xry111/clfs-ng, xry111/lfs-next, xry111/loongarch, xry111/loongarch-12.0, xry111/loongarch-12.1, xry111/mips64el, xry111/pip3, xry111/rust-wip-20221008, xry111/update-glibc

Children:

4f8a3af9

Parents:

8f8e328c

Message:

QA Part #1

git-svn-id: ​http://svn.linuxfromscratch.org/LFS/trunk/BOOK@2403 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

File:

• chapter06/glibc-inst.xml (modified) (8 diffs)

chapter06/glibc-inst.xml

@@ -13 +13 @@
 is best left alone. Therefore, if you have defined any environment variables
 that override default optimizations, such as CFLAGS and CXXFLAGS, we
-recommend unsetting or modifying them when building Glibc. You have
-been warned.</para>
+recommend unsetting or modifying them when building Glibc.</para>
 
 <para>Basically, compiling Glibc in any other way than the book suggests
-is putting your system at very high risk.</para>
+is putting your system at a very high risk.</para>
 
 <para>We'll start by applying a patch to Glibc that fixes the following:</para>
@@ -26 +25 @@
 <filename>malloc/Makefile</filename> file. This is done because Glibc
 can't autodetect the location of perl because the Perl package hasn't been
-installed yet.</para></listitem>
+installed yet. And if Glibc thinks Perl isn't installed, the
+<userinput>mtrace</userinput> perl program won't be installed
+either.</para></listitem>
 
 <listitem><para>It replaces all occurrences of <emphasis>root</emphasis>
@@ -43 +44 @@
 to crash that were linked against Glibc-2.2 or older libraries. Even though
 static binaries have all the necessary parts of Glibc built-in, they still
-rely on one external library: Glibc's NSS libraries. These libraries, among
-other things, tell programs where the system's password database is
+rely on one external library set: Glibc's NSS libraries. These libraries,
+among other things, tell programs where the system's password database is
 (/etc/password, or NIS, or whatever other scheme has been
 configured).</para>
@@ -51 +52 @@
 code is incompatible with the old one. So when Glibc is installed, it will
 install its new NSS libraries and static programs will load these new NSS
-libraries and start to abort with <emphasis>segmentation faults</emphasis>.
-This patch undoes a few of the changes to overcome the problem.</para>
+libraries and start to abort with <emphasis>segmentation fault</emphasis>
+error. This patch undoes a few of the changes to overcome the problem.</para>
 
-<para>So, if you started chapter 5 with a host system that uses Glibc-2.2.x
+<para>If you started chapter 5 with a host system that uses Glibc-2.2.x
 or older, you must apply the following patch. We will install Glibc again at
 the end of this chapter to remove this patch so you'll have a pristine Glibc
@@ -62 +63 @@
 
 <para>Glibc will check for the <filename>/etc/ld.so.conf</filename> file
-and abort with an error if the file is missing, so we must create it.</para>
+and abort with an error if the file is missing, so we must create it:</para>
 
 <para><screen><userinput>touch /etc/ld.so.conf</userinput></screen></para>
 
 <para>It is recommended by the Glibc installation documentation to build
-Glibc outside of the source directory in a dedicated directory.</para>
+Glibc outside of the source directory in a dedicated directory:</para>
 
 <para><screen><userinput>mkdir ../glibc-build &amp;&amp;
 cd ../glibc-build</userinput></screen></para>
 
-<para>Next, prepare Glibc to be compiled.</para>
+<para>Next, prepare Glibc to be compiled:</para>
 
 <para><screen><userinput>../glibc-&glibc-version;/configure --prefix=/usr \
 &nbsp;&nbsp;&nbsp;&nbsp;--disable-profile --enable-add-ons \
 &nbsp;&nbsp;&nbsp;&nbsp;--libexecdir=/usr/bin</userinput></screen></para>
+
+<para>The meaning of the configure options are:</para>
+
+<itemizedlist>
+<listitem><para><userinput>--disable-profile:</userinput> This disables the
+building of libraries with profiling information. This command may be
+omitted if you plan to do profiling.</para></listitem>
+
+<listitem><para><userinput>--enable-add-ons:</userinput> This enables the
+add-on that we install with Glibc, linuxthreads</para></listitem>
+
+<listitem><para><userinput>--libexecdir=/usr/bin:</userinput> This will
+cause the pt_chown program to be installed in the /usr/bin
+directory.</para></listitem>
+</itemizedlist>
 
 <para>During this stage you will see the following warning:</para>
@@ -94 +110 @@
 would require you to re-generate the binary files.</para>
 
-<para>The meaning of the configure options are:</para>
-
-<itemizedlist>
-<listitem><para><userinput>--disable-profile:</userinput> This disables the
-building of libraries with profiling information. This command may be
-omitted if you plan to do profiling.</para></listitem>
-
-<listitem><para><userinput>--enable-add-ons:</userinput> This enables the
-add-on that we install with Glibc, linuxthreads</para></listitem>
-
-<listitem><para><userinput>--libexecdir=/usr/bin:</userinput> This will
-cause the pt_chown program to be installed in the /usr/bin
-directory.</para></listitem>
-</itemizedlist>
-
 <para>Because Glibc hasn't been installed yet, one of the tests that was
 run by the configure script failed. This test is supposed to test gcc to
 determine whether or not a cross-compiler is installed. However, Glibc
 needs to be installed already to run this test. Since the test failed, the
-configure script automatically assumed we do have a cross-compiler. So,
-we have to override that assumption by explicitly telling Glibc we're not
-cross-compiling.</para>
+configure script automatically assumed we do have a cross-compiler. We have
+to override that assumption by explicitly telling Glibc we're not
+cross-compiling. Not doing this has a couple of unintended side effects,
+such as the timezone files not being installed.</para>
 
 <para><screen><userinput>echo "cross-compiling = no" &gt; configparms</userinput></screen></para>
 
-<para>We'll continue with compiling and installing Glibc. The Linuxthreads man
+<para>Continue with compiling the package:</para>
+
+<para><screen><userinput>make</userinput></screen></para>
+
+<para>We'll continue with installing the package. The Linuxthreads man
 pages are not going to be installed at this point because it requires a
 working Perl installation. We'll install Perl later on in this chapter,
@@ -125 +131 @@
 time at the end of this chapter.</para>
 
-<para><screen><userinput>make &amp;&amp;
-make install</userinput></screen></para>
+<para><screen><userinput>make install</userinput></screen></para>
 
 <para>Locales aren't installed when you ran
 <userinput>make install</userinput>, so we have to do that ourselves now.
 Locales are used by Glibc to make your Linux system talk in a different
-language.</para>
+language:</para>
 
 <para><screen><userinput>make localedata/install-locales</userinput></screen></para>
@@ -143 +148 @@
 <para>To finish off the installation we'll reload Bash so it uses the
 libnss files. This will also get rid of the
-<emphasis>I have no name!</emphasis> message in the command prompt.</para>
+<emphasis>I have no name!</emphasis> message in the command prompt:</para>
 
 <para><screen><userinput>exec /static/bin/bash --login</userinput></screen></para>