gronod/lfs
1
0
Fork 0
mirror of https://git.linuxfromscratch.org/lfs.git synced 2025-07-21 03:35:20 +01:00
Code Issues Packages Projects Releases Wiki Activity

Indenting chapter 05, part 3

Browse Source 
git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@7286 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
This commit is contained in:
Manuel Canales Esparcia 2006-01-20 21:02:23 +00:00
parent 11cbbb0452
commit 1f7ca93564
6 changed files with 577 additions and 433 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

102
chapter05/gcc-pass1.xml
View File

@ -1,26 +1,40 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-gcc-pass1" role="wrap"> <sect1 id="ch-tools-gcc-pass1" role="wrap">
<title>GCC-&gcc-version; - Pass 1</title>
<?dbhtml filename="gcc-pass1.html"?> <?dbhtml filename="gcc-pass1.html"?>
<title>GCC-&gcc-version; - Pass 1</title>
<indexterm zone="ch-tools-gcc-pass1"> <indexterm zone="ch-tools-gcc-pass1">
<primary sortas="a-GCC">GCC</primary> <primary sortas="a-GCC">GCC</primary>
<secondary>tools, pass 1</secondary></indexterm> <secondary>tools, pass 1</secondary>
</indexterm>
<sect2 role="package"><title/> <sect2 role="package">
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/gcc.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/> <title/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
href="../chapter06/gcc.xml"
xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
<segmentedlist> <segmentedlist>
<segtitle>&buildtime;</segtitle> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle> <segtitle>&diskspace;</segtitle>
<seglistitem><seg>4.4 SBU</seg><seg>219 MB</seg></seglistitem>
<seglistitem>
<seg>4.4 SBU</seg>
<seg>219 MB</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/gcc.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
href="../chapter06/gcc.xml"
xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
</sect2> </sect2>
@ -39,51 +53,60 @@ cd ../gcc-build</userinput></screen>
--with-local-prefix=/tools --disable-nls --enable-shared \ --with-local-prefix=/tools --disable-nls --enable-shared \
--enable-languages=c</userinput></screen> --enable-languages=c</userinput></screen>
<para>The meaning of the configure options:</para>
<variablelist> <variablelist>
<title>The meaning of the configure options:</title>
<varlistentry> <varlistentry>
<term><parameter>--with-local-prefix=/tools</parameter></term> <term><parameter>--with-local-prefix=/tools</parameter></term>
<listitem><para>The purpose of this switch is to remove <filename class="directory">/usr/local/include</filename> <listitem>
from <command>gcc</command>'s include search path. This is not absolutely <para>The purpose of this switch is to remove <filename
essential, however, it helps to minimize the influence of the host class="directory">/usr/local/include</filename> from
system.</para> <command>gcc</command>'s include search path. This is not
absolutely essential, however, it helps to minimize the
influence of the host system.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><parameter>--enable-shared</parameter></term> <term><parameter>--enable-shared</parameter></term>
<listitem><para>This switch allows the building of <listitem>
<filename class="libraryfile">libgcc_s.so.1</filename> and <para>This switch allows the building of <filename
<filename class="libraryfile">libgcc_eh.a</filename>. Having class="libraryfile">libgcc_s.so.1</filename> and
<filename class="libraryfile">libgcc_eh.a</filename> available ensures that the <filename class="libraryfile">libgcc_eh.a</filename>.
configure script for Glibc (the next package we compile) produces the proper Having <filename class="libraryfile">libgcc_eh.a</filename>
results.</para></listitem> available ensures that the configure script for Glibc (the
next package we compile) produces the proper results.</para>
</listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><parameter>--enable-languages=c</parameter></term> <term><parameter>--enable-languages=c</parameter></term>
<listitem><para>This option ensures that only the C compiler is built. <listitem>
</para></listitem> <para>This option ensures that only the C compiler is built.</para>
</listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
<para>Continue with compiling the package:</para> <para>Continue with compiling the package:</para>
<screen><userinput>make bootstrap</userinput></screen> <screen><userinput>make bootstrap</userinput></screen>
<para>The meaning of the make parameters:</para>
<variablelist> <variablelist>
<title>The meaning of the make parameters:</title>
<varlistentry> <varlistentry>
<term><parameter>bootstrap</parameter></term> <term><parameter>bootstrap</parameter></term>
<listitem><para>This target does not just compile GCC, but compiles it <listitem>
several times. It uses the programs compiled in a first round to <para>This target does not just compile GCC, but compiles it
compile itself a second time, and then again a third time. It then several times. It uses the programs compiled in a first round
compares these second and third compiles to make sure it can reproduce to compile itself a second time, and then again a third time.
itself flawlessly. This also implies that it was compiled It then compares these second and third compiles to make sure
correctly.</para></listitem> it can reproduce itself flawlessly. This also implies that it
was compiled correctly.</para>
</listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
<para>Compilation is now complete. At this point, the test suite would <para>Compilation is now complete. At this point, the test suite would
@ -96,20 +119,23 @@ replaced.</para>
<screen><userinput>make install</userinput></screen> <screen><userinput>make install</userinput></screen>
<para>As a finishing touch, create a symlink. Many programs and <para>As a finishing touch, create a symlink. Many programs and scripts
scripts run <command>cc</command> instead of <command>gcc</command>, which is used to keep programs generic run <command>cc</command> instead of <command>gcc</command>, which is
and therefore usable on all kinds of UNIX systems where the GNU C compiler used to keep programs generic and therefore usable on all kinds of UNIX
is not always installed. Running <command>cc</command> leaves the system administrator systems where the GNU C compiler is not always installed. Running
free to decide which C compiler to install.</para> <command>cc</command> leaves the system administrator free to decide
which C compiler to install.</para>
<screen><userinput>ln -vs gcc /tools/bin/cc</userinput></screen> <screen><userinput>ln -vs gcc /tools/bin/cc</userinput></screen>
</sect2> </sect2>
<sect2 role="content"><title/> <sect2 role="content">
<para>Details on this package are located in <xref <title/>
linkend="contents-gcc" role="."/></para>
<para>Details on this package are located in
<xref linkend="contents-gcc" role="."/></para>
</sect2> </sect2>
</sect1> </sect1>

192
chapter05/gcc-pass2.xml
View File

@ -1,25 +1,40 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-gcc-pass2" role="wrap"> <sect1 id="ch-tools-gcc-pass2" role="wrap">
<title>GCC-&gcc-version; - Pass 2</title>
<?dbhtml filename="gcc-pass2.html"?> <?dbhtml filename="gcc-pass2.html"?>
<title>GCC-&gcc-version; - Pass 2</title>
<indexterm zone="ch-tools-gcc-pass2"> <indexterm zone="ch-tools-gcc-pass2">
<primary sortas="a-GCC">GCC</primary> <primary sortas="a-GCC">GCC</primary>
<secondary>tools, pass 2</secondary></indexterm> <secondary>tools, pass 2</secondary>
</indexterm>
<sect2 role="package"><title/> <sect2 role="package">
<title/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
href="../chapter06/gcc.xml"
xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
<segmentedlist> <segmentedlist>
<segtitle>&buildtime;</segtitle> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle> <segtitle>&diskspace;</segtitle>
<seglistitem><seg>11.0 SBU</seg><seg>292 MB</seg></seglistitem>
<seglistitem>
<seg>11.0 SBU</seg>
<seg>292 MB</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/gcc.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
href="../chapter06/gcc.xml"
xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
</sect2> </sect2>
@ -43,22 +58,22 @@ performing a quick test:</para>
<screen><computeroutput>The system has no more ptys. <screen><computeroutput>The system has no more ptys.
Ask your system administrator to create more.</computeroutput></screen> Ask your system administrator to create more.</computeroutput></screen>
<para>If the above message is received, the host does not have its PTYs set up <para>If the above message is received, the host does not have its PTYs
properly. In this case, there is no point in running the test suites for GCC and set up properly. In this case, there is no point in running the test
Binutils until this issue is resolved. Please consult the LFS FAQ at <ulink suites for GCC and Binutils until this issue is resolved. Please consult
url="&lfs-root;/lfs/faq.html#no-ptys"/> for more information on how to get PTYs the LFS FAQ at <ulink url="&lfs-root;/lfs/faq.html#no-ptys"/> for more
working.</para> information on how to get PTYs working.</para>
<para>As previously explained in <xref linkend="ch-tools-adjusting"/>, under <para>As previously explained in <xref linkend="ch-tools-adjusting"/>,
normal circumstances the GCC <command>fixincludes</command> script is run in under normal circumstances the GCC <command>fixincludes</command> script
order to fix potentially broken header files. As GCC-&gcc-version; and is run in order to fix potentially broken header files. As GCC-&gcc-version;
Glibc-&glibc-version; have already been installed at this point, and their and Glibc-&glibc-version; have already been installed at this point, and
respective header files are known to not require fixing, the their respective header files are known to not require fixing, the
<command>fixincludes</command> script is not required. As mentioned previously, <command>fixincludes</command> script is not required. As mentioned
the script may in fact pollute the build environment by installing fixed headers previously, the script may in fact pollute the build environment by
from the host system into GCC's private include directory. The running of the installing fixed headers from the host system into GCC's private include
<command>fixincludes</command> script can be suppressed by issuing the following directory. The running of the <command>fixincludes</command> script can
commands:</para> be suppressed by issuing the following commands:</para>
<screen><userinput>cp -v gcc/Makefile.in{,.orig} &amp;&amp; <screen><userinput>cp -v gcc/Makefile.in{,.orig} &amp;&amp;
sed 's@\./fixinc\.sh@-c true@' gcc/Makefile.in.orig &gt; gcc/Makefile.in</userinput></screen> sed 's@\./fixinc\.sh@-c true@' gcc/Makefile.in.orig &gt; gcc/Makefile.in</userinput></screen>
@ -66,28 +81,30 @@ sed 's@\./fixinc\.sh@-c true@' gcc/Makefile.in.orig &gt; gcc/Makefile.in</userin
<para>The bootstrap build performed in <xref linkend="ch-tools-gcc-pass1"/> <para>The bootstrap build performed in <xref linkend="ch-tools-gcc-pass1"/>
built GCC with the <option>-fomit-frame-pointer</option> compiler flag. built GCC with the <option>-fomit-frame-pointer</option> compiler flag.
Non-bootstrap builds omit this flag by default, so apply the following Non-bootstrap builds omit this flag by default, so apply the following
<command>sed</command> to use it in order to ensure consistent compiler builds. <command>sed</command> to use it in order to ensure consistent compiler
</para> builds.</para>
<screen><userinput>cp -v gcc/Makefile.in{,.tmp} &amp;&amp; <screen><userinput>cp -v gcc/Makefile.in{,.tmp} &amp;&amp;
sed 's/^XCFLAGS =$/&amp; -fomit-frame-pointer/' gcc/Makefile.in.tmp \ sed 's/^XCFLAGS =$/&amp; -fomit-frame-pointer/' gcc/Makefile.in.tmp \
&gt; gcc/Makefile.in</userinput></screen> &gt; gcc/Makefile.in</userinput></screen>
<para>Apply the following patch to change the location of GCC's default dynamic <para>Apply the following patch to change the location of GCC's default
linker (typically <filename class="libraryfile">ld-linux.so.2</filename>):</para> dynamiclinker (typically <filename
class="libraryfile">ld-linux.so.2</filename>):</para>
<screen><userinput>patch -Np1 -i ../&gcc-specs-patch;</userinput></screen> <screen><userinput>patch -Np1 -i ../&gcc-specs-patch;</userinput></screen>
<para>The above patch also removes <para>The above patch also removes <filename
<filename class="directory">/usr/include</filename> from GCC's include search class="directory">/usr/include</filename> from GCC's include search path.
path. Patching now rather than adjusting the specs file after installation Patching now rather than adjusting the specs file after installation
ensures that the new dynamic linker is used during the actual build of GCC. That ensures that the new dynamic linker is used during the actual build of
is, all of the binaries created during the build will link against the new GCC. That is, all of the binaries created during the build will link
Glibc.</para> against the new Glibc.</para>
<important><para>The above patch is critical in ensuring a <important>
successful overall build. Do not forget to apply <para>The above patch is critical in ensuring a successful overall
it.</para></important> build. Do not forget to apply it.</para>
</important>
<para>Create a separate build directory again:</para> <para>Create a separate build directory again:</para>
@ -105,65 +122,72 @@ variables that override the default optimization flags.</para>
--enable-__cxa_atexit --enable-languages=c,c++ \ --enable-__cxa_atexit --enable-languages=c,c++ \
--disable-libstdcxx-pch</userinput></screen> --disable-libstdcxx-pch</userinput></screen>
<para>The meaning of the new configure options:</para>
<variablelist> <variablelist>
<title>The meaning of the new configure options:</title>
<varlistentry> <varlistentry>
<term><parameter>--enable-clocale=gnu</parameter></term> <term><parameter>--enable-clocale=gnu</parameter></term>
<listitem><para>This option ensures the correct locale model is <listitem>
selected for the C++ libraries under all circumstances. If the <para>This option ensures the correct locale model is selected
configure script finds the <emphasis>de_DE</emphasis> locale installed, it will select the for the C++ libraries under all circumstances. If the configure
correct gnu locale model. However, if the <emphasis>de_DE</emphasis> locale is not script finds the <emphasis>de_DE</emphasis> locale installed,
installed, there is the risk of building Application Binary Interface it will select the correct gnu locale model. However, if the
(ABI)-incompatible C++ libraries because the incorrect generic locale <emphasis>de_DE</emphasis> locale is not installed, there is the
model may be selected.</para></listitem> risk of building Application Binary Interface (ABI)-incompatible
C++ libraries because the incorrect generic locale model may be
selected.</para>
</listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><parameter>--enable-threads=posix</parameter></term> <term><parameter>--enable-threads=posix</parameter></term>
<listitem><para>This enables C++ exception handling for multi-threaded <listitem>
code.</para></listitem> <para>This enables C++ exception handling for multi-threaded code.</para>
</listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><parameter>--enable-__cxa_atexit</parameter></term> <term><parameter>--enable-__cxa_atexit</parameter></term>
<listitem><para>This option allows use of <listitem>
<emphasis>__cxa_atexit</emphasis>, rather than <para>This option allows use of <function>__cxa_atexit</function>,
<emphasis>atexit</emphasis>, to register C++ destructors for local rather than <function>atexit</function>, to register C++ destructors
statics and global objects. This option is essential for fully for local statics and global objects. This option is essential for
standards-compliant handling of destructors. It also affects the C++ fully standards-compliant handling of destructors. It also affects
ABI, and therefore results in C++ shared libraries and C++ programs the C++ ABI, and therefore results in C++ shared libraries and C++
that are interoperable with other Linux programs that are interoperable with other Linux distributions.</para>
distributions.</para></listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><parameter>--enable-languages=c,c++</parameter></term> <term><parameter>--enable-languages=c,c++</parameter></term>
<listitem><para>This option <listitem>
ensures that both the C and C++ compilers are built.</para></listitem> <para>This option ensures that both the C and C++ compilers are
built.</para>
</listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><parameter>--disable-libstdcxx-pch</parameter></term> <term><parameter>--disable-libstdcxx-pch</parameter></term>
<listitem><para>Do not build the pre-compiled header (PCH) for <listitem>
<filename class="libraryfile">libstdc++</filename>. It takes up a lot of space, <para>Do not build the pre-compiled header (PCH) for
and we have no use for it.</para></listitem> <filename class="libraryfile">libstdc++</filename>. It takes up a
lot of space, and we have no use for it.</para>
</listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
<para>Compile the package:</para> <para>Compile the package:</para>
<screen><userinput>make</userinput></screen> <screen><userinput>make</userinput></screen>
<para>There is no need to use the <parameter>bootstrap</parameter> <para>There is no need to use the <parameter>bootstrap</parameter> target
target now because the compiler being used to compile this GCC was now because the compiler being used to compile this GCC was built from
built from the exact same version of the GCC sources used the exact same version of the GCC sources used earlier.</para>
earlier.</para>
<para>Compilation is now complete. As previously mentioned, running <para>Compilation is now complete. As previously mentioned, running the test
the test suites for the temporary tools compiled in this chapter is suites for the temporary tools compiled in this chapter is not mandatory.
not mandatory. To run the GCC test suite anyway, use the following To run the GCC test suite anyway, use the following command:</para>
command:</para>
<screen><userinput>make -k check</userinput></screen> <screen><userinput>make -k check</userinput></screen>
@ -180,30 +204,34 @@ failures. To receive a summary of the test suite results, run:</para>
<para>Results can be compared with those located at <ulink <para>Results can be compared with those located at <ulink
url="&test-results;"/>.</para> url="&test-results;"/>.</para>
<para>A few unexpected failures cannot always be avoided. The GCC developers are <para>A few unexpected failures cannot always be avoided. The GCC developers
usually aware of these issues, but have not resolved them yet. In particular, are usually aware of these issues, but have not resolved them yet. In
the <filename class="libraryfile">libmudflap</filename> tests are known be particular, the <filename class="libraryfile">libmudflap</filename> tests
particularly problematic as a result of a bug in GCC (<ulink are known be particularly problematic as a result of a bug in GCC
url="http://gcc.gnu.org/bugzilla/show_bug.cgi?id=20003"/>). Unless the test (<ulink url="http://gcc.gnu.org/bugzilla/show_bug.cgi?id=20003"/>).
results are vastly different from those at the above URL, it is safe to Unless the test results are vastly different from those at the above URL,
continue.</para> it is safe to continue.</para>
<para>Install the package:</para> <para>Install the package:</para>
<screen><userinput>make install</userinput></screen> <screen><userinput>make install</userinput></screen>
<note><para>At this point it is strongly recommended to repeat the <note>
sanity check we performed earlier in this chapter. Refer back to <xref <para>At this point it is strongly recommended to repeat the sanity
linkend="ch-tools-adjusting" role=","/> and repeat the test compilation. If check we performed earlier in this chapter. Refer back to <xref
the result is wrong, the most likely reason is that the GCC Specs linkend="ch-tools-adjusting" role=","/> and repeat the test compilation.
patch was not properly applied.</para></note> If the result is wrong, the most likely reason is that the GCC Specs
patch was not properly applied.</para>
</note>
</sect2> </sect2>
<sect2 role="content"><title/> <sect2 role="content">
<para>Details on this package are located in <xref <title/>
linkend="contents-gcc" role="."/></para>
<para>Details on this package are located in
<xref linkend="contents-gcc" role="."/></para>
</sect2> </sect2>
</sect1> </sect1>

51
chapter05/gettext.xml
View File

@ -1,47 +1,65 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-gettext" role="wrap"> <sect1 id="ch-tools-gettext" role="wrap">
<title>Gettext-&gettext-version;</title>
<?dbhtml filename="gettext.html"?> <?dbhtml filename="gettext.html"?>
<title>Gettext-&gettext-version;</title>
<indexterm zone="ch-tools-gettext"> <indexterm zone="ch-tools-gettext">
<primary sortas="a-Gettext">Gettext</primary> <primary sortas="a-Gettext">Gettext</primary>
<secondary>tools</secondary></indexterm> <secondary>tools</secondary>
</indexterm>
<sect2 role="package"><title/> <sect2 role="package">
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/gettext.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/> <title/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
href="../chapter06/gettext.xml"
xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
<segmentedlist> <segmentedlist>
<segtitle>&buildtime;</segtitle> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle> <segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.5 SBU</seg><seg>63.0 MB</seg></seglistitem>
<seglistitem>
<seg>0.5 SBU</seg>
<seg>63.0 MB</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/gettext.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
href="../chapter06/gettext.xml"
xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
</sect2> </sect2>
<sect2 role="installation"> <sect2 role="installation">
<title>Installation of Gettext</title> <title>Installation of Gettext</title>
<para>For our temporary set of tools, we only need to build and install one binary from Gettext.</para> <para>For our temporary set of tools, we only need to build and install
one binary from Gettext.</para>
<para>Prepare Gettext for compilation:</para> <para>Prepare Gettext for compilation:</para>
<screen><userinput>cd gettext-tools <screen><userinput>cd gettext-tools
./configure --prefix=/tools --disable-shared</userinput></screen> ./configure --prefix=/tools --disable-shared</userinput></screen>
<para>The meaning of the configure options:</para>
<variablelist> <variablelist>
<title>The meaning of the configure options:</title>
<varlistentry> <varlistentry>
<term><parameter>--disable-shared</parameter></term> <term><parameter>--disable-shared</parameter></term>
<listitem><para>We do not need to install any of the shared gettext libraries at <listitem>
this time, therefore there is no need to build them.</para></listitem> <para>We do not need to install any of the shared Gettext libraries at
this time, therefore there is no need to build them.</para>
</listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
<para>Compile the package:</para> <para>Compile the package:</para>
@ -60,9 +78,12 @@ this stage.</para>
</sect2> </sect2>
<sect2 role="content"><title/> <sect2 role="content">
<para>Details on this package are located in <xref linkend="contents-gettext" role="."/></para> <title/>
<para>Details on this package are located in
<xref linkend="contents-gettext" role="."/></para>
</sect2> </sect2>
</sect1> </sect1>

123
chapter05/glibc.xml
View File

@ -1,26 +1,40 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-glibc" role="wrap"> <sect1 id="ch-tools-glibc" role="wrap">
<title>Glibc-&glibc-version;</title>
<?dbhtml filename="glibc.html"?> <?dbhtml filename="glibc.html"?>
<title>Glibc-&glibc-version;</title>
<indexterm zone="ch-tools-glibc"> <indexterm zone="ch-tools-glibc">
<primary sortas="a-Glibc">Glibc</primary> <primary sortas="a-Glibc">Glibc</primary>
<secondary>tools</secondary></indexterm> <secondary>tools</secondary>
</indexterm>
<sect2 role="package"><title/> <sect2 role="package">
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/glibc.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/> <title/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
href="../chapter06/glibc.xml"
xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
<segmentedlist> <segmentedlist>
<segtitle>&buildtime;</segtitle> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle> <segtitle>&diskspace;</segtitle>
<seglistitem><seg>11.8 SBU</seg><seg>454 MB</seg></seglistitem>
<seglistitem>
<seg>11.8 SBU</seg>
<seg>454 MB</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/glibc.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
href="../chapter06/glibc.xml"
xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
</sect2> </sect2>
@ -41,66 +55,81 @@ cd ../glibc-build</userinput></screen>
--without-gd --with-headers=/tools/include \ --without-gd --with-headers=/tools/include \
--without-selinux</userinput></screen> --without-selinux</userinput></screen>
<para>The meaning of the configure options:</para>
<variablelist> <variablelist>
<title>The meaning of the configure options:</title>
<varlistentry> <varlistentry>
<term><parameter>--disable-profile</parameter></term> <term><parameter>--disable-profile</parameter></term>
<listitem><para>This builds the libraries without profiling <listitem>
information. Omit this option if profiling on the temporary tools is <para>This builds the libraries without profiling information. Omit
necessary.</para></listitem> this option if profiling on the temporary tools is necessary.</para>
</listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><parameter>--enable-add-ons</parameter></term> <term><parameter>--enable-add-ons</parameter></term>
<listitem><para>This tells Glibc to use the NPTL add-on as its threading <listitem>
library.</para></listitem> <para>This tells Glibc to use the NPTL add-on as its threading
library.</para>
</listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><parameter>--enable-kernel=2.6.0</parameter></term> <term><parameter>--enable-kernel=2.6.0</parameter></term>
<listitem><para>This tells Glibc to compile the library with support <listitem>
for 2.6.x Linux kernels.</para></listitem> <para>This tells Glibc to compile the library with support
for 2.6.x Linux kernels.</para>
</listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><parameter>--with-binutils=/tools/bin</parameter></term> <term><parameter>--with-binutils=/tools/bin</parameter></term>
<listitem><para>While not required, this switch ensures that there are <listitem>
<para>While not required, this switch ensures that there are
no errors pertaining to which Binutils programs get used during the no errors pertaining to which Binutils programs get used during the
Glibc build.</para></listitem> Glibc build.</para>
</listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><parameter>--without-gd</parameter></term> <term><parameter>--without-gd</parameter></term>
<listitem><para>This prevents the build of the <listitem>
<command>memusagestat</command> program, which insists on linking <para>This prevents the build of the <command>memusagestat</command>
against the host's libraries (libgd, libpng, libz, program, which insists on linking against the host's libraries
etc.).</para></listitem> (libgd, libpng, libz, etc.).</para>
</listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><parameter>--with-headers=/tools/include</parameter></term> <term><parameter>--with-headers=/tools/include</parameter></term>
<listitem><para>This tells Glibc to compile itself against the headers recently <listitem>
installed to the tools directory, so that it knows exactly what features the <para>This tells Glibc to compile itself against the headers recently
kernel has and can optimize itself accordingly.</para></listitem> installed to the tools directory, so that it knows exactly what
features the kernel has and can optimize itself accordingly.</para>
</listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><parameter>--without-selinux</parameter></term> <term><parameter>--without-selinux</parameter></term>
<listitem><para>When building from hosts that include SELinux functionality <listitem>
(e.g., Fedora Core 3), Glibc will build with support for SELinux. As the LFS <para>When building from hosts that include SELinux functionality
tools environment does not contain support for SELinux, a Glibc compiled with (e.g., Fedora Core 3), Glibc will build with support for SELinux.
such support will fail to operate correctly.</para></listitem> As the LFS tools environment does not contain support for SELinux, a
Glibc compiled with such support will fail to operate correctly.</para>
</listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
<para>During this stage the following warning might appear:</para> <para>During this stage the following warning might appear:</para>
<blockquote><screen><computeroutput>configure: WARNING: <blockquote>
<screen><computeroutput>configure: WARNING:
*** These auxiliary programs are missing or *** These auxiliary programs are missing or
*** incompatible versions: msgfmt *** incompatible versions: msgfmt
*** some features will be disabled. *** some features will be disabled.
*** Check the INSTALL file for required versions.</computeroutput></screen></blockquote> *** Check the INSTALL file for required versions.</computeroutput></screen>
</blockquote>
<para>The missing or incompatible <command>msgfmt</command> program is <para>The missing or incompatible <command>msgfmt</command> program is
generally harmless, but it can sometimes cause issues when running the generally harmless, but it can sometimes cause issues when running the
@ -133,10 +162,11 @@ most tests (even in <xref linkend="chapter-building-system"/>, some
failures could still occur, for example, with the math tests).</para> failures could still occur, for example, with the math tests).</para>
<para>When experiencing a failure, make a note of it, then continue by <para>When experiencing a failure, make a note of it, then continue by
reissuing the <command>make check</command> command. The test suite should pick up where it left reissuing the <command>make check</command> command. The test suite
off and continue. This stop-start sequence can be circumvented by should pick up where it left off and continue. This stop-start sequence
issuing a <command>make -k check</command> command. If using this option, be sure to log the can be circumvented by issuing a <command>make -k check</command> command.
output so that the log file can be examined for failures later.</para> If using this option, be sure to log the output so that the log file can
be examined for failures later.</para>
<para>The install stage of Glibc will issue a harmless warning at the <para>The install stage of Glibc will issue a harmless warning at the
end about the absence of <filename>/tools/etc/ld.so.conf</filename>. end about the absence of <filename>/tools/etc/ld.so.conf</filename>.
@ -155,19 +185,22 @@ representing dates and times to more complex issues, such as the
language spoken. The <quote>internationalization</quote> of GNU language spoken. The <quote>internationalization</quote> of GNU
programs works by locale.</para> programs works by locale.</para>
<note><para>If the test suites are not being run in this chapter (as <note>
per the recommendation), there is no need to install the locales now. <para>If the test suites are not being run in this chapter (as per
The appropriate locales will be installed in the next the recommendation), there is no need to install the locales now.
chapter. To install the Glibc locales anyway, use instructions from The appropriate locales will be installed in the next chapter.
<xref linkend="ch-system-glibc" role="."/> To install the Glibc locales anyway, use instructions from
</para></note> <xref linkend="ch-system-glibc" role="."/></para>
</note>
</sect2> </sect2>
<sect2 role="content"><title/> <sect2 role="content">
<para>Details on this package are located in <xref <title/>
linkend="contents-glibc" role="."/></para>
<para>Details on this package are located in
<xref linkend="contents-glibc" role="."/></para>
</sect2> </sect2>
</sect1> </sect1>

56
chapter05/grep.xml
View File

@ -1,26 +1,40 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-grep" role="wrap"> <sect1 id="ch-tools-grep" role="wrap">
<title>Grep-&grep-version;</title>
<?dbhtml filename="grep.html"?> <?dbhtml filename="grep.html"?>
<title>Grep-&grep-version;</title>
<indexterm zone="ch-tools-grep"> <indexterm zone="ch-tools-grep">
<primary sortas="a-Grep">Grep</primary> <primary sortas="a-Grep">Grep</primary>
<secondary>tools</secondary></indexterm> <secondary>tools</secondary>
</indexterm>
<sect2 role="package"><title/> <sect2 role="package">
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/grep.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/> <title/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
href="../chapter06/grep.xml"
xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
<segmentedlist> <segmentedlist>
<segtitle>&buildtime;</segtitle> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle> <segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>4.5 MB</seg></seglistitem>
<seglistitem>
<seg>0.1 SBU</seg>
<seg>4.5 MB</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/grep.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
href="../chapter06/grep.xml"
xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
</sect2> </sect2>
@ -32,23 +46,27 @@
<screen><userinput>./configure --prefix=/tools \ <screen><userinput>./configure --prefix=/tools \
--disable-perl-regexp</userinput></screen> --disable-perl-regexp</userinput></screen>
<para>The meaning of the configure options:</para>
<variablelist> <variablelist>
<title>The meaning of the configure options:</title>
<varlistentry> <varlistentry>
<term><parameter>--disable-perl-regexp</parameter></term> <term><parameter>--disable-perl-regexp</parameter></term>
<listitem><para>This ensures that the <command>grep</command> program does not <listitem>
get linked against a Perl Compatible Regular Expression (PCRE) library that may <para>This ensures that the <command>grep</command> program does
be present on the host but will not be available once we enter the not get linked against a Perl Compatible Regular Expression (PCRE)
<command>chroot</command> environment.</para></listitem> library that may be present on the host but will not be available
once we enter the <command>chroot</command> environment.</para>
</listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
<para>Compile the package:</para> <para>Compile the package:</para>
<screen><userinput>make</userinput></screen> <screen><userinput>make</userinput></screen>
<para>To test the results, issue: <userinput>make check</userinput>.</para> <para>To test the results, issue:
<userinput>make check</userinput>.</para>
<para>Install the package:</para> <para>Install the package:</para>
@ -56,10 +74,12 @@ be present on the host but will not be available once we enter the
</sect2> </sect2>
<sect2 role="content"><title/> <sect2 role="content">
<para>Details on this package are located in <xref <title/>
linkend="contents-grep" role="."/></para>
<para>Details on this package are located in
<xref linkend="contents-grep" role="."/></para>
</sect2> </sect2>
</sect1> </sect1>

38
chapter05/gzip.xml
View File

@ -1,26 +1,40 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-tools-gzip" role="wrap"> <sect1 id="ch-tools-gzip" role="wrap">
<title>Gzip-&gzip-version;</title>
<?dbhtml filename="gzip.html"?> <?dbhtml filename="gzip.html"?>
<title>Gzip-&gzip-version;</title>
<indexterm zone="ch-tools-gzip"> <indexterm zone="ch-tools-gzip">
<primary sortas="a-Gzip">Gzip</primary> <primary sortas="a-Gzip">Gzip</primary>
<secondary>tools</secondary></indexterm> <secondary>tools</secondary>
</indexterm>
<sect2 role="package"><title/> <sect2 role="package">
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/gzip.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/> <title/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
href="../chapter06/gzip.xml"
xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
<segmentedlist> <segmentedlist>
<segtitle>&buildtime;</segtitle> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle> <segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>2.2 MB</seg></seglistitem>
<seglistitem>
<seg>0.1 SBU</seg>
<seg>2.2 MB</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/gzip.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
href="../chapter06/gzip.xml"
xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
</sect2> </sect2>
@ -43,10 +57,12 @@
</sect2> </sect2>
<sect2 role="content"><title/> <sect2 role="content">
<para>Details on this package are located in <xref <title/>
linkend="contents-gzip" role="."/></para>
<para>Details on this package are located in
<xref linkend="contents-gzip" role="."/></para>
</sect2> </sect2>
</sect1> </sect1>