Changeset 24244831 for chapter05


Ignore:
Timestamp:
12/20/2004 05:49:20 PM (19 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
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.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, 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:
e0a04e8
Parents:
fba1478
Message:

Removed text in chapter 05 - last round.

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

Location:
chapter05
Files:
12 edited

Legend:

Unmodified
Added
Removed

  • chapter05/make.xml

    rfba1478 r24244831  
    1313
    1414<sect2 role="package"><title/>
    15 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/make.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
    1615
    1716<segmentedlist>
    … …  
    2019<seglistitem><seg>0.2 SBU</seg><seg>8.8 MB</seg></seglistitem>
    2120</segmentedlist>
    22 
    23 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/make.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
    2421
    2522</sect2>
    … …  
    3229<screen><userinput>./configure --prefix=/tools</userinput></screen>
    3330
    34 <para>Compile the program:</para>
     31<para>Compile the package:</para>
    3532
    3633<screen><userinput>make</userinput></screen>
    3734
    38 <para>(If you want to test the results, then issue:
    39 <userinput>make check</userinput>.)</para>
     35<para>To test the results, issue:
     36<userinput>make check</userinput></para>
    4037
    41 <para>Then install it and its documentation:</para>
     38<para>Install the package:</para>
    4239
    4340<screen><userinput>make install</userinput></screen>
    … …  
    4542</sect2>
    4643
    47 <sect2 role="content"><title/>
    48 <para>The details on this package are found in <xref linkend="contents-make"/>.</para>
    49 </sect2>
    50 
    5144</sect1>

  • chapter05/ncurses.xml

    rfba1478 r24244831  
    1313
    1414<sect2 role="package"><title/>
    15 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/ncurses.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
    1615
    1716<segmentedlist>
    … …  
    2019<seglistitem><seg>0.7 SBU</seg><seg>26 MB</seg></seglistitem>
    2120</segmentedlist>
    22 
    23 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/ncurses.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
    2421
    2522</sect2>
    … …  
    3330    --without-debug --without-ada --enable-overwrite</userinput></screen>
    3431
    35 <para>The meaning of the configure options:</para>
    36 
    37 <variablelist>
    38 <varlistentry>
    39 <term><parameter>--without-ada</parameter></term>
    40 <listitem><para>This tells Ncurses not
    41 to build its Ada bindings, even if an Ada compiler is installed on the host.
    42 This must be done because once we enter the chroot environment, Ada will no
    43 longer be available.</para></listitem>
    44 </varlistentry>
    45 
    46 <varlistentry>
    47 <term><parameter>--enable-overwrite</parameter></term>
    48 <listitem><para>This tells Ncurses to install its header files into
    49 <filename class="directory">/tools/include</filename> instead of
    50 <filename class="directory">/tools/include/ncurses</filename> to ensure that
    51 other packages can find the Ncurses headers successfully.</para></listitem>
    52 </varlistentry>
    53 </variablelist>
    54 
    55 <para>Compile the programs and libraries:</para>
     32<para>Compile the package:</para>
    5633
    5734<screen><userinput>make</userinput></screen>
    5835
    59 <para>Then install them and their documentation:</para>
     36<para>Install the package:</para>
    6037
    6138<screen><userinput>make install</userinput></screen>
    … …  
    6340</sect2>
    6441
    65 <sect2 role="content"><title/>
    66 <para>The details on this package are found in <xref linkend="contents-ncurses"/>.</para>
    67 </sect2>
    68 
    6942</sect1>

  • chapter05/patch.xml

    rfba1478 r24244831  
    1313
    1414<sect2 role="package"><title/>
    15 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/patch.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
    1615
    1716<segmentedlist>
    … …  
    2120</segmentedlist>
    2221
    23 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/patch.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
    24 
    2522</sect2>
    2623
    … …  
    2825<title>Installation of Patch</title>
    2926
    30 <para>Prepare Patch for compilation (the preprocessor flag
    31 <parameter>-D_GNU_SOURCE</parameter> is only needed on the PowerPC platform, on
    32 other architectures you can leave it out):</para>
     27<para>Prepare Patch for compilation:</para>
    3328
    3429<screen><userinput>CPPFLAGS=-D_GNU_SOURCE ./configure --prefix=/tools</userinput></screen>
    3530
    36 <para>Compile the program:</para>
     31<para>Compile the package:</para>
    3732
    3833<screen><userinput>make</userinput></screen>
    3934
    40 <para>Then install it and its documentation:</para>
     35<para>Install the package:</para>
    4136
    4237<screen><userinput>make install</userinput></screen>
    … …  
    4439</sect2>
    4540
    46 <sect2 role="content"><title/>
    47 <para>The details on this package are found in <xref linkend="contents-patch"/>.</para>
    48 </sect2>
    49 
    5041</sect1>

  • chapter05/perl.xml

    rfba1478 r24244831  
    1313
    1414<sect2 role="package"><title/>
    15 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/perl.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
    1615
    1716<segmentedlist>
    … …  
    2019<seglistitem><seg>0.8 SBU</seg><seg>74 MB</seg></seglistitem>
    2120</segmentedlist>
    22 
    23 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/perl.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
    2421
    2522</sect2>
    … …  
    3229<screen><userinput>patch -Np1 -i ../perl-&perl-version;-libc-1.patch</userinput></screen>
    3330
    34 <para>Now prepare Perl for compilation (make sure you get the 'IO Fcntl POSIX'
    35 right, they are all letters):</para>
     31<para>Now prepare Perl for compilation:</para>
    3632
    3733<screen><userinput>./configure.gnu --prefix=/tools -Dstatic_ext='IO Fcntl POSIX'</userinput></screen>
    38 
    39 <para>The meaning of the configure option:</para>
    40 
    41 <variablelist>
    42 <varlistentry>
    43 <term><parameter>-Dstatic_ext='IO Fcntl POSIX'</parameter></term>
    44 <listitem><para>This tells
    45 Perl to build the minimum set of static extensions needed for installing and
    46 testing the Coreutils package in the next chapter.</para></listitem>
    47 </varlistentry>
    48 </variablelist>
    4934
    5035<para>Compile only the required tools:</para>
    … …  
    6045</sect2>
    6146
    62 <sect2 role="content"><title/>
    63 <para>The details on this package are found in <xref linkend="contents-perl"/>.</para>
    64 </sect2>
    65 
    6647</sect1>

  • chapter05/sed.xml

    rfba1478 r24244831  
    1313
    1414<sect2 role="package"><title/>
    15 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/sed.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
    1615
    1716<segmentedlist>
    … …  
    2019<seglistitem><seg>0.2 SBU</seg><seg>5.2 MB</seg></seglistitem>
    2120</segmentedlist>
    22 
    23 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/sed.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
    2421
    2522</sect2>
    … …  
    3229<screen><userinput>./configure --prefix=/tools</userinput></screen>
    3330
    34 <para>Compile the program:</para>
     31<para>Compile the package:</para>
    3532
    3633<screen><userinput>make</userinput></screen>
    3734
    38 <para>(If you want to test the results, then issue:
    39 <userinput>make check</userinput>.)</para>
     35<para>To test the results, issue:
     36<userinput>make check</userinput></para>
    4037
    41 <para>Then install it and its documentation:</para>
     38<para>Install the package:</para>
    4239
    4340<screen><userinput>make install</userinput></screen>
    … …  
    4542</sect2>
    4643
    47 <sect2 role="content"><title/>
    48 <para>The details on this package are found in <xref linkend="contents-sed"/>.</para>
    49 </sect2>
    50 
    5144</sect1>

  • chapter05/stripping.xml

    rfba1478 r24244831  
    88<?dbhtml filename="stripping.html"?>
    99
    10 <para>The steps in this section are optional, but if your LFS partition is
    11 rather small, you will be glad to learn that you can remove some unnecessary
    12 things. The executables and libraries you have built so far contain about 130
    13 MB of unneeded debugging symbols. Remove those symbols with:</para>
    14 
    1510<screen><userinput>strip --strip-debug /tools/lib/*
    1611strip --strip-unneeded /tools/{,s}bin/*</userinput></screen>
    1712
    18 <para>The last of the above commands will skip some twenty files, reporting
    19 that it doesn't recognize their file format. Most of them are scripts instead
    20 of binaries.</para>
    21 
    22 <para>Take care <emphasis>not</emphasis> to use
    23 <parameter>--strip-unneeded</parameter> on the libraries -- the static ones
    24 would be destroyed and you would have to build the three toolchain packages
    25 all over again.</para>
    26 
    27 <para>To save another 30 MB, you can remove all the documentation:</para>
    28 
    2913<screen><userinput>rm -rf /tools/{doc,info,man}</userinput></screen>
    3014
    31 <para>You will now need to have at least 850 MB of free space on your LFS
    32 file system to be able to build and install Glibc in the next phase. If you can
    33 build and install Glibc, you can build and install the rest too.</para>
    34 
    3515</sect1>

  • chapter05/tar.xml

    rfba1478 r24244831  
    1313
    1414<sect2 role="package"><title/>
    15 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/tar.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
    1615
    1716<segmentedlist>
    … …  
    2019<seglistitem><seg>0.2 SBU</seg><seg>10 MB</seg></seglistitem>
    2120</segmentedlist>
    22 
    23 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/tar.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
    2421
    2522</sect2>
    … …  
    3229<screen><userinput>./configure --prefix=/tools</userinput></screen>
    3330
    34 <para>Compile the programs:</para>
     31<para>Compile the package:</para>
    3532
    3633<screen><userinput>make</userinput></screen>
    3734
    38 <para>(If you want to test the results, then issue:
    39 <userinput>make check</userinput>.)</para>
     35<para>To test the results, issue:
     36<userinput>make check</userinput></para>
    4037
    41 <para>Then install them and their documentation:</para>
     38<para>Install the package:</para>
    4239
    4340<screen><userinput>make install</userinput></screen>
    … …  
    4542</sect2>
    4643
    47 <sect2 role="content"><title/>
    48 <para>The details on this package are found in <xref linkend="contents-tar"/>.</para>
    49 </sect2>
    50 
    5144</sect1>

  • chapter05/tcl.xml

    rfba1478 r24244831  
    1111
    1212<sect2 role="package"><title/>
    13 <para>The Tcl package contains the Tool Command Language.</para>
    1413
    1514<segmentedlist>
    … …  
    1918</segmentedlist>
    2019
    21 <segmentedlist>
    22 <segtitle>Tcl installation depends on</segtitle>
    23 <seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
    24 GCC, Glibc, Grep, Make, Sed</seg></seglistitem>
    25 </segmentedlist>
    26 
    2720</sect2>
    2821
    2922<sect2 role="installation">
    3023<title>Installation of Tcl</title>
    31 
    32 <para>This package and the next two are only installed to support running the
    33 test suites for GCC and Binutils. Installing three packages just for testing
    34 purposes may seem like overkill, but it is very reassuring, if not essential,
    35 to know that our most important tools are working properly. Even if the
    36 the test suites are not run in this chapter (we recommend not running them),
    37 these packages are still required to run the test suites in the next
    38 chapter.</para>
    3924
    4025<para>Prepare Tcl for compilation:</para>
    … …  
    4732<screen><userinput>make</userinput></screen>
    4833
    49 <para>If you want to test the results, then issue:
    50 <userinput>TZ=UTC make test</userinput>. However, the Tcl test suite is known
    51 to experience failures under certain host conditions that are not fully
    52 understood. Therefore, test suite failures here are not surprising, and are not
    53 considered critical. The <parameter>TZ=UTC</parameter> parameter sets the time
    54 zone to Coordinated Universal Time (UTC) also known as Greenwich Mean Time
    55 (GMT), but only for the duration of the test suite run. This ensures the clock
    56 tests are exercised correctly. More information on the TZ environment variable
    57 will be given later on in <xref linkend="chapter-bootscripts"/>.</para>
     34<para>To test the results,  issue:
     35<userinput>TZ=UTC make test</userinput>.</para>
    5836
    5937<para>Install the package:</para>
    … …  
    7351<sect2 id="contents-tcl" role="content"><title>Contents of Tcl</title>
    7452
    75 <segmentedlist>
    76 <segtitle>Installed programs</segtitle>
    77 <segtitle>Installed library</segtitle>
    78 <seglistitem><seg>tclsh (link to tclsh8.4), tclsh8.4</seg><seg>libtcl8.4.so</seg></seglistitem>
    79 </segmentedlist>
    80 
    81 <variablelist><title>Short descriptions</title>
    82 
    83 <varlistentry id="tclsh8.4">
    84 <term><command>tclsh8.4</command></term>
    85 <listitem>
    86 <indexterm zone="ch-tools-tcl tclsh8.4"><primary sortas="b-tclsh8.4">tclsh8.4</primary></indexterm>
    87 <para>is the Tcl command shell.</para>
    88 </listitem>
    89 </varlistentry>
    90 
    91 <varlistentry id="libtcl8.4.so">
    92 <term><filename class="libraryfile">libtcl8.4.so</filename></term>
    93 <listitem>
    94 <indexterm zone="ch-tools-tcl libtcl8.4.so"><primary sortas="c-libtcl8.4.so">libtcl8.4.so</primary></indexterm>
    95 <para>is the Tcl library.</para>
    96 </listitem>
    97 </varlistentry>
    98 </variablelist>
     53<para>See testing</para>
    9954
    10055</sect2>

  • chapter05/texinfo.xml

    rfba1478 r24244831  
    1313
    1414<sect2 role="package"><title/>
    15 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/texinfo.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
    1615
    1716<segmentedlist>
    … …  
    2019<seglistitem><seg>0.2 SBU</seg><seg>16 MB</seg></seglistitem>
    2120</segmentedlist>
    22 
    23 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/texinfo.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
    2421
    2522</sect2>
    … …  
    3229<screen><userinput>./configure --prefix=/tools</userinput></screen>
    3330
    34 <para>Compile the programs:</para>
     31<para>Compile the package:</para>
    3532
    3633<screen><userinput>make</userinput></screen>
    3734
    38 <para>(If you want to test the results, then issue:
    39 <userinput>make check</userinput>.)</para>
     35<para>To test the results, issue:
     36<userinput>make check</userinput></para>
    4037
    41 <para>Then install them and their documentation:</para>
     38<para>Install the package:</para>
    4239
    4340<screen><userinput>make install</userinput></screen>
    … …  
    4542</sect2>
    4643
    47 <sect2 role="content"><title/>
    48 <para>The details on this package are found in <xref linkend="contents-texinfo"/>.</para>
    49 </sect2>
    50 
    5144</sect1>

  • chapter05/toolchaintechnotes.xml

    rfba1478 r24244831  
    88<?dbhtml filename="toolchaintechnotes.html"?>
    99
    10 <para>This section attempts to explain some of the rationale and technical
    11 details behind the overall build method. It's not essential that you understand
    12 everything here immediately. Most of it will make sense once you have performed
    13 an actual build. Feel free to refer back here at any time.</para>
    14 
    15 <para>The overall goal of <xref linkend="chapter-temporary-tools"/> is to provide a sane,
    16 temporary environment that we can chroot into, and from which we can produce a
    17 clean, trouble-free build of the target LFS system in
    18 <xref linkend="chapter-building-system"/>. Along the way, we attempt to divorce ourselves
    19 from the host system as much as possible, and in so doing build a
    20 self-contained and self-hosted toolchain. It should be noted that the
    21 build process has been designed to minimize the risks for
    22 new readers and provide maximum educational value at the same time. In other
    23 words, more advanced techniques could be used to build the system.</para>
    24 
    25 <important>
    26 <para>Before continuing, you really should be aware of the name of your working
    27 platform, often also referred to as the <emphasis>target triplet</emphasis>. For
    28 many folks the target triplet will probably be
    29 <emphasis>i686-pc-linux-gnu</emphasis>. A simple way to determine your target
    30 triplet is to run the <command>config.guess</command> script that comes with
    31 the source for many packages. Unpack the Binutils sources and run the script:
    32 <userinput>./config.guess</userinput> and note the output.</para>
    33 
    34 <para>You'll also need to be aware of the name of your platform's
    35 <emphasis>dynamic linker</emphasis>, often also referred to as the
    36 <emphasis>dynamic loader</emphasis>, not to be confused with the standard linker
    37 <command>ld</command> that is part of Binutils. The dynamic linker is provided
    38 by Glibc and has the job of finding and loading the shared libraries needed by a
    39 program, preparing the program to run and then running it. For most folks the
    40 name of the dynamic linker will be <filename>ld-linux.so.2</filename>. On
    41 platforms that are less prevalent, the name might be
    42 <filename>ld.so.1</filename> and newer 64 bit platforms might even have
    43 something completely different. You should be able to determine the name
    44 of your platform's dynamic linker by looking in the
    45 <filename class="directory">/lib</filename> directory on your host system. A
    46 sure-fire way is to inspect a random binary from your host system by running:
    47 <userinput>readelf -l &lt;name of binary&gt; | grep interpreter</userinput>
    48 and noting the output. The authoritative reference covering all platforms is in
    49 the <filename>shlib-versions</filename> file in the root of the Glibc source
    50 tree.</para>
    51 </important>
    52 
    53 <para>Some key technical points of how the <xref linkend="chapter-temporary-tools"/> build
    54 method works:</para>
    55 
    56 <itemizedlist>
    57 <listitem><para>Similar in principle to cross compiling whereby tools installed
    58 into the same prefix work in cooperation and thus utilize a little GNU
    59 <quote>magic</quote>.</para></listitem>
    60 
    61 <listitem><para>Careful manipulation of the standard linker's library search
    62 path to ensure programs are linked only against libraries we
    63 choose.</para></listitem>
    64 
    65 <listitem><para>Careful manipulation of <command>gcc</command>'s
    66 <filename>specs</filename> file to tell the compiler which target dynamic
    67 linker will be used.</para></listitem>
    68 </itemizedlist>
    69 
    70 <para>Binutils is installed first because the <command>./configure</command> runs of both GCC and Glibc perform various
    71 feature tests on the assembler and linker
    72 to determine which software features to enable
    73 or disable. This is more important than one might first realize. An incorrectly
    74 configured GCC or Glibc can result in a subtly broken toolchain where the impact
    75 of such breakage might not show up until near the end of the build of a whole
    76 distribution. Thankfully, a test suite failure will usually alert us before too
    77 much time is wasted.</para>
    78 
    79 <para>Binutils installs its assembler and linker into two locations,
    80 <filename class="directory">/tools/bin</filename> and
    81 <filename class="directory">/tools/$TARGET_TRIPLET/bin</filename>. In reality,
    82 the tools in one location are hard linked to the other. An important facet of
    83 the linker is its library search order. Detailed information can be obtained
    84 from <command>ld</command> by passing it the <parameter>--verbose</parameter>
    85 flag. For example: <command>ld --verbose | grep SEARCH</command> will
    86 show you the current search paths and their order. You can see what files are
    87 actually linked by <command>ld</command> by compiling a dummy program and
    88 passing the <parameter>--verbose</parameter> switch to the linker. For example:
    89 <userinput>gcc dummy.c -Wl,--verbose 2&gt;&amp;1 | grep succeeded</userinput>
    90 will show you all the files successfully opened during the linking.</para>
    91 
    92 <para>The next package installed is GCC and during its run of
    93 <command>./configure</command> you'll see, for example:</para>
    94 
    95 <blockquote><screen><computeroutput>checking what assembler to use... /tools/i686-pc-linux-gnu/bin/as
    96 checking what linker to use... /tools/i686-pc-linux-gnu/bin/ld</computeroutput></screen></blockquote>
    97 
    98 <para>This is important for the reasons mentioned above. It also demonstrates
    99 that GCC's configure script does not search the PATH directories to find which
    100 tools to use. However, during the actual operation of <command>gcc</command>
    101 itself, the same search paths are not necessarily used. You can find out which
    102 standard linker <command>gcc</command> will use by running:
    103 <userinput>gcc -print-prog-name=ld</userinput>.
    104 Detailed information can be obtained from <command>gcc</command> by passing
    105 it the <parameter>-v</parameter> flag while compiling a dummy program. For
    106 example: <userinput>gcc -v dummy.c</userinput> will show you detailed
    107 information about the preprocessor, compilation and assembly stages, including
    108 <command>gcc</command>'s include search paths and their order.</para>
    109  
    110 <para>The next package installed is Glibc. The most important considerations for
    111 building Glibc are the compiler, binary tools and kernel headers. The compiler
    112 is generally no problem as Glibc will always use the <command>gcc</command>
    113 found in a PATH directory. The binary tools and kernel headers can be a little
    114 more troublesome. Therefore we take no risks and use the available configure
    115 switches to enforce the correct selections. After the run of
    116 <command>./configure</command> you can check the contents of the
    117 <filename>config.make</filename> file in the
    118 <filename class="directory">glibc-build</filename> directory for all the
    119 important details. You'll note some interesting items like the use of
    120 <parameter>CC="gcc -B/tools/bin/"</parameter> to control which binary tools are
    121 used, and also the use of the <parameter>-nostdinc</parameter> and
    122 <parameter>-isystem</parameter> flags to control the compiler's include search
    123 path. These items help to highlight an important aspect of the Glibc package:
    124 it is very self-sufficient in terms of its build machinery and generally does
    125 not rely on toolchain defaults.</para>
    126 
    127 <para>After the Glibc installation, we make some adjustments to ensure that
    128 searching and linking take place only within our <filename class="directory">/tools</filename>
    129 prefix. We install an adjusted <command>ld</command>, which has a hard-wired
    130 search path limited to <filename class="directory">/tools/lib</filename>. Then
    131 we amend <command>gcc</command>'s specs file to point to our new dynamic
    132 linker in <filename class="directory">/tools/lib</filename>. This last step is
    133 <emphasis>vital</emphasis> to the whole process. As mentioned above, a
    134 hard-wired path to a dynamic linker is embedded into every ELF shared
    135 executable. You can inspect this by running:
    136 <userinput>readelf -l &lt;name of binary&gt; | grep interpreter</userinput>.
    137 By amending <command>gcc</command>'s specs file, we are ensuring that every
    138 program compiled from here through the end of this chapter will use our new
    139 dynamic linker in <filename class="directory">/tools/lib</filename>.</para>
    140 
    141 <para>The need to use the new dynamic linker is also the reason why we apply the
    142 Specs patch for the second pass of GCC. Failure to do so will result in the GCC
    143 programs themselves having the name of the dynamic linker from the host system's
    144 <filename class="directory">/lib</filename> directory embedded into them, which
    145 would defeat our goal of getting away from the host.</para>
    146 
    147 <para>During the second pass of Binutils, we are able to utilize the
    148 <parameter>--with-lib-path</parameter> configure switch to control
    149 <command>ld</command>'s library search path. From this point onwards, the
    150 core toolchain is self-contained and self-hosted. The remainder of the
    151 <xref linkend="chapter-temporary-tools"/> packages all build against the new Glibc in
    152 <filename class="directory">/tools</filename> and all is well.</para>
    153 
    154 <para>Upon entering the chroot environment in <xref linkend="chapter-building-system"/>, the
    155 first major package we install is Glibc, due to its self-sufficient nature that
    156 we mentioned above. Once this Glibc is installed into
    157 <filename class="directory">/usr</filename>, we perform a quick changeover of
    158 the toolchain defaults, then proceed for real in building the rest of the
    159 target LFS system.</para>
    160 
    161 <sect2>
    162 <title>Notes on static linking</title>
    163 
    164 <para>Most programs have to perform, beside their specific task, many rather
    165 common and sometimes trivial operations. These include allocating memory,
    166 searching directories, reading and writing files, string handling, pattern
    167 matching, arithmetic and many other tasks. Instead of obliging each program to
    168 reinvent the wheel, the GNU system provides all these basic functions in
    169 ready-made libraries. The major library on any Linux system is
    170 <emphasis>Glibc</emphasis>.</para>
    171 
    172 <para>There are two primary ways of linking the functions from a library to a
    173 program that uses them: statically or dynamically. When a program is linked
    174 statically, the code of the used functions is included in the executable,
    175 resulting in a rather bulky program. When a program is dynamically linked, what
    176 is included is a reference to the dynamic linker, the name of the library, and
    177 the name of the function, resulting in a much smaller executable. (A third way
    178 is to use the programming interface of the dynamic linker. See the
    179 <emphasis>dlopen</emphasis> man page for more information.)</para>
    180 
    181 <para>Dynamic linking is the default on Linux and has three major advantages
    182 over static linking. First, you need only one copy of the executable library
    183 code on your hard disk, instead of having many copies of the same code included
    184 into a whole bunch of programs -- thus saving disk space. Second, when several
    185 programs use the same library function at the same time, only one copy of the
    186 function's code is required in core -- thus saving memory space. Third, when a
    187 library function gets a bug fixed or is otherwise improved, you only need to
    188 recompile this one library, instead of having to recompile all the programs that
    189 make use of the improved function.</para>
    190 
    191 <para>If dynamic linking has several advantages, why then do we statically link
    192 the first two packages in this chapter? The reasons are threefold: historical,
    193 educational, and technical. Historical, because earlier versions of LFS
    194 statically linked every program in this chapter. Educational, because knowing
    195 the difference is useful. Technical, because we gain an element of independence
    196 from the host in doing so, meaning that those programs can be used
    197 independently of the host system. However, it's worth noting that an overall
    198 successful LFS build can still be achieved when the first two packages are
    199 built dynamically.</para>
    200 
    201 </sect2>
     10<para>See testing</para>
    20211
    20312</sect1>

  • chapter05/udev.xml

    rfba1478 r24244831  
    1313
    1414<sect2 role="package"><title/>
    15 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/udev.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
    1615
    1716<segmentedlist>
    … …  
    2019<seglistitem><seg>0.2 SBU</seg><seg>5.2 MB</seg></seglistitem>
    2120</segmentedlist>
    22 
    23 <!--
    24 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/udev.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
    25  -->
    2621
    2722</sect2>
    … …  
    3833<screen><userinput>make prefix=/tools udevdir=/dev</userinput></screen>
    3934
    40 <para>Install it:</para>
     35<para>Install the package:</para>
    4136
    4237<screen><userinput>make DESTDIR=/tools udevdir=/dev install</userinput></screen>
    43 
    44 <para>Udev's configuration is far from ideal by default, so we install our own
    45 configuration files here:</para>
    4638
    4739<screen><userinput>cp ../udev-config-2.permissions /tools/etc/udev/permissions.d/00-lfs.permissions
    … …  
    5042</sect2>
    5143
    52 <sect2 role="content"><title/>
    53 <para>The details on this package are found in <xref linkend="contents-udev"/>.</para>
    54 </sect2>
    55 
    5644</sect1>

  • chapter05/util-linux.xml

    rfba1478 r24244831  
    1313
    1414<sect2 role="package"><title/>
    15 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/util-linux.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
    1615
    1716<segmentedlist>
    … …  
    2120</segmentedlist>
    2221
    23 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/util-linux.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>
    24 
    2522</sect2>
    2623
    2724<sect2 role="installation">
    2825<title>Installation of Util-linux</title>
    29 
    30 <para>Util-linux doesn't use the freshly installed headers and libraries
    31 from the <filename class="directory">/tools</filename> directory.  This is fixed by altering the configure
    32 script:</para>
    3326
    3427<screen><userinput>sed -i 's@/usr/include@/tools/include@g' configure</userinput></screen>
    … …  
    4235<screen><userinput>make -C lib</userinput></screen>
    4336
    44 <para>Since you'll only need a couple of the utilities contained in
    45 this package, build just those:</para>
     37<para>Build the needed utilities:</para>
    4638
    4739<screen><userinput>make -C mount mount umount
    … …  
    5345
    5446</sect2>
    55 
    56 <sect2 role="content"><title/>
    57 <para>The details on this package are found in <xref linkend="contents-utillinux"/>.</para>
    58 </sect2>
    5947</sect1>
Note: See TracChangeset for help on using the changeset viewer.