Changeset dcff046


Ignore:
Timestamp:
02/04/2004 10:23:18 PM (20 years ago)
Author:
Alex Gronenwoud <alex@…>
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, 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:
91e8861
Parents:
fe5b13b
Message:

Changing chapter IDs in anticipation.

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

Files:
20 edited

Legend:

Unmodified
Added
Removed

  • chapter01/how.xml

    rfe5b13b rdcff046  
    1010as one of the options when you installed your distribution.</para>
    1111
    12 <para>In <xref linkend="chapter03"/> you will first create a new Linux native
     12<para>In <xref linkend="chapter-making-space"/> you will first create a new Linux native
    1313partition and file system, the place where your new LFS system will be compiled
    14 and installed. Then in <xref linkend="chapter04"/> you download all the
     14and installed. Then in <xref linkend="chapter-getting-materials"/> you download all the
    1515packages and patches required to build an LFS system, and store them on the new
    1616file system.</para>
    1717
    18 <para><xref linkend="chapter05"/> then discusses the installation of a number
     18<para><xref linkend="chapter-temporary-tools"/> then discusses the installation of a number
    1919of packages that will form the basic development suite (or toolchain) which is
    20 used to build the actual system in <xref linkend="chapter06"/>. Some of these
     20used to build the actual system in <xref linkend="chapter-building-system"/>. Some of these
    2121packages are needed to resolve circular dependencies -- for example, to compile
    2222a compiler you need a compiler.</para>
    2323
    24 <para>The first thing to be done in <xref linkend="chapter05"/> is build a
     24<para>The first thing to be done in <xref linkend="chapter-temporary-tools"/> is build a
    2525first pass of the toolchain, made up of Binutils and GCC. The programs from
    2626these packages will be linked statically in order for them to be usable
    … …  
    2929the first pass. The third thing to do is build a second pass of the toolchain.
    3030This time the toolchain will be dynamically linked against the newly built
    31 Glibc. The remaining <xref linkend="chapter05"/> packages are all built using
     31Glibc. The remaining <xref linkend="chapter-temporary-tools"/> packages are all built using
    3232this second pass toolchain and dynamically linked against the new
    3333host-independent Glibc. When this is done, the LFS installation process will no
    … …  
    3737<para>You may be thinking that <quote>this seems like a lot of work, just to
    3838get away from my host distribution</quote>. Well, a full technical explanation
    39 is provided at the start of <xref linkend="chapter05"/>, including some notes
     39is provided at the start of <xref linkend="chapter-temporary-tools"/>, including some notes
    4040on the differences between statically and dynamically linked programs.</para>
    4141
    42 <para>In <xref linkend="chapter06"/> your real LFS system will be built. The
     42<para>In <xref linkend="chapter-building-system"/> your real LFS system will be built. The
    4343chroot (change root) program is used to enter a virtual environment and start
    4444a new shell whose root directory will be set to the LFS partition. This is very
    … …  
    5353
    5454<para>To finish the installation, the bootscripts are set up in
    55 <xref linkend="chapter07"/>, the kernel and bootloader are set up in
    56 <xref linkend="chapter08"/>, and <xref linkend="chapter09"/> contains some
     55<xref linkend="chapter-bootscripts"/>, the kernel and bootloader are set up in
     56<xref linkend="chapter-mixture"/>, and <xref linkend="chapter-finalizing"/> contains some
    5757pointers to help you after you finish the book. Then, finally, you're ready to
    5858reboot your computer into your new LFS system.</para>
    … …  
    6363everything will fall into place soon.</para>
    6464
    65 <para>Please read <xref linkend="chapter02"/> carefully as it explains a few
     65<para>Please read <xref linkend="chapter-preparation"/> carefully as it explains a few
    6666important things you should be aware of before you begin to work through
    67 <xref linkend="chapter05"/> and beyond.</para>
     67<xref linkend="chapter-temporary-tools"/> and beyond.</para>
    6868
    6969</sect1>

  • chapter02/aboutlfs.xml

    rfe5b13b rdcff046  
    77the directory where the partition that contains the LFS system is mounted. How
    88to create and where to mount the partition will be explained in full detail in
    9 <xref linkend="chapter03"/>. For the moment let's assume that the LFS partition
     9<xref linkend="chapter-making-space"/>. For the moment let's assume that the LFS partition
    1010is mounted on <filename>/mnt/lfs</filename>.</para>
    1111

  • chapter02/aboutsbus.xml

    rfe5b13b rdcff046  
    1313
    1414<para>It works like this: the first package you compile in this book is the
    15 statically linked Binutils in <xref linkend="chapter05"/>, and the time it
     15statically linked Binutils in <xref linkend="chapter-temporary-tools"/>, and the time it
    1616takes to compile this package is what we call the "Static Binutils Unit" or
    1717"SBU". All other compile times will be expressed relative to this time.</para>

  • chapter02/abouttestsuites.xml

    rfe5b13b rdcff046  
    1717
    1818<para>Experience has shown us that there is little to be gained from running
    19 the test suites in <xref linkend="chapter05"/>. There can be no escaping the
     19the test suites in <xref linkend="chapter-temporary-tools"/>. There can be no escaping the
    2020fact that the host system always exerts influence on the tests in that chapter,
    2121often causing weird and inexplicable failures. Not only that, the tools built
    22 in <xref linkend="chapter05"/> are temporary and eventually discarded. For the
     22in <xref linkend="chapter-temporary-tools"/> are temporary and eventually discarded. For the
    2323average reader of this book we recommend <emphasis>not</emphasis> to run the
    24 test suites in <xref linkend="chapter05"/>. The instructions for running those
     24test suites in <xref linkend="chapter-temporary-tools"/>. The instructions for running those
    2525test suites are still provided for the benefit of testers and developers, but
    2626they are strictly optional for everyone else.</para>
    … …  
    3636reasons. Most likely is that the host system doesn't have the
    3737<emphasis>devpts</emphasis> file system set up correctly. We'll discuss this in
    38 more detail later on in <xref linkend="chapter05"/>.</para></note>
     38more detail later on in <xref linkend="chapter-temporary-tools"/>.</para></note>
    3939
    4040</sect1>

  • chapter02/chapter02.xml

    rfe5b13b rdcff046  
    1 <chapter id="chapter02" xreflabel="Chapter 2">
     1<chapter id="chapter-preparation" xreflabel="Chapter 2">
    22<title>Important information</title>
    33<?dbhtml filename="chapter02.html" dir="chapter02"?>

  • chapter03/chapter03.xml

    rfe5b13b rdcff046  
    1 <chapter id="chapter03" xreflabel="Chapter 3">
     1<chapter id="chapter-making-space" xreflabel="Chapter 3">
    22<title>Preparing a new partition</title>
    33<?dbhtml filename="chapter03.html" dir="chapter03"?>

  • chapter04/chapter04.xml

    rfe5b13b rdcff046  
    1 <chapter id="chapter04" xreflabel="Chapter 4">
     1<chapter id="chapter-getting-materials" xreflabel="Chapter 4">
    22<title>The materials: packages and patches</title>
    33<?dbhtml filename="chapter04.html" dir="chapter04"?>

  • chapter05/chapter05.xml

    rfe5b13b rdcff046  
    1 <chapter id="chapter05" xreflabel="Chapter 5">
     1<chapter id="chapter-temporary-tools" xreflabel="Chapter 5">
    22<title>Constructing a temporary system</title>
    33<?dbhtml filename="chapter05.html" dir="chapter05"?>
    … …  
    7272an actual build. Feel free to refer back here at any time.</para>
    7373
    74 <para>The overall goal of <xref linkend="chapter05"/> is to provide a sane,
     74<para>The overall goal of <xref linkend="chapter-temporary-tools"/> is to provide a sane,
    7575temporary environment that we can chroot into, and from which we can produce a
    7676clean, trouble-free build of the target LFS system in
    77 <xref linkend="chapter06"/>. Along the way, we attempt to divorce ourselves
     77<xref linkend="chapter-building-system"/>. Along the way, we attempt to divorce ourselves
    7878from the host system as much as possible, and in so doing build a
    7979self-contained and self-hosted toolchain. It should be noted that the
    … …  
    110110</important>
    111111
    112 <para>Some key technical points of how the <xref linkend="chapter05"/> build
     112<para>Some key technical points of how the <xref linkend="chapter-temporary-tools"/> build
    113113method works:</para>
    114114
    … …  
    208208<command>ld</command>'s library search path. From this point onwards, the
    209209core toolchain is self-contained and self-hosted. The remainder of the
    210 <xref linkend="chapter05"/> packages all build against the new Glibc in
     210<xref linkend="chapter-temporary-tools"/> packages all build against the new Glibc in
    211211<filename class="directory">/tools</filename> and all is well.</para>
    212212
    213 <para>Upon entering the chroot environment in <xref linkend="chapter06"/>, the
     213<para>Upon entering the chroot environment in <xref linkend="chapter-building-system"/>, the
    214214first major package we install is Glibc, due to its self-sufficient nature that
    215215we mentioned above. Once this Glibc is installed into

  • chapter05/gcc-pass2.xml

    rfe5b13b rdcff046  
    5151that some Glibc header files on your host system need to be fixed, fix them and
    5252put them in the GCC private include directory. Then, later on in
    53 <xref linkend="chapter06"/>, after we've installed the newer Glibc, this
     53<xref linkend="chapter-building-system"/>, after we've installed the newer Glibc, this
    5454private include directory would be searched before the system include
    5555directory, resulting in GCC finding the fixed headers from the host system,

  • chapter05/glibc.xml

    rfe5b13b rdcff046  
    9191can be adversely affected by existing tools or environmental issues on the host
    9292system. Of course, these won't be a problem when we run the Glibc test suite
    93 inside the chroot environment of <xref linkend="chapter06"/>. In general, the
     93inside the chroot environment of <xref linkend="chapter-building-system"/>. In general, the
    9494Glibc test suite is always expected to pass. However, as mentioned above, some
    9595failures are unavoidable in certain circumstances. Here is a list of the most
    … …  
    118118
    119119<para>In summary, don't worry too much if you see Glibc test suite failures
    120 here in this chapter. The Glibc in <xref linkend="chapter06"/> is the one we'll
     120here in this chapter. The Glibc in <xref linkend="chapter-building-system"/> is the one we'll
    121121ultimately end up using so that is the one we would really like to see pass.
    122 But please keep in mind, even in <xref linkend="chapter06"/> some failures
     122But please keep in mind, even in <xref linkend="chapter-building-system"/> some failures
    123123could still occur -- the <emphasis>math</emphasis>
    124124tests for example. When experiencing a failure, make a note of it, then

  • chapter05/tcl.xml

    rfe5b13b rdcff046  
    4949only for the duration of the test suite run. This ensures the clock tests are
    5050exercised correctly. More information on the TZ environment variable will be
    51 given later on in <xref linkend="chapter07"/>.</para></listitem>
     51given later on in <xref linkend="chapter-bootscripts"/>.</para></listitem>
    5252</itemizedlist>
    5353

  • chapter06/aboutdebug.xml

    rfe5b13b rdcff046  
    4242<userinput>strip --strip-debug $LFS/tools/bin/*</userinput>).</para>
    4343
    44 <para>For your convenience, <xref linkend="chapter09"/> includes one simple
     44<para>For your convenience, <xref linkend="chapter-finalizing"/> includes one simple
    4545command to strip all debugging symbols from all programs and libraries on your
    4646system. Additional information on optimization can be found in the hint at

  • chapter06/bootscripts.xml

    rfe5b13b rdcff046  
    2424<para>If you decide to use BSD style, or some other style scripts, you can
    2525skip the next chapter when you arrive at it and move on to
    26 <xref linkend="chapter08"/>.</para>
     26<xref linkend="chapter-mixture"/>.</para>
    2727
    2828<para>Install the boot scripts:</para>

  • chapter06/chapter06.xml

    rfe5b13b rdcff046  
    1 <chapter id="chapter06" xreflabel="Chapter 6">
     1<chapter id="chapter-building-system" xreflabel="Chapter 6">
    22<title>Installing basic system software</title>
    33<?dbhtml filename="chapter06.html" dir="chapter06"?>
    … …  
    270270
    271271<para>To get rid of the "I have no name!" prompt, we will start a new shell.
    272 Since we installed a full Glibc in <xref linkend="chapter05"/>, and have just
     272Since we installed a full Glibc in <xref linkend="chapter-temporary-tools"/>, and have just
    273273created the <filename>/etc/passwd</filename> and
    274274<filename>/etc/group</filename> files, user name and group name resolution
    … …  
    326326<note><para>If you somehow missed the earlier warning to retain the Binutils
    327327source and build directories from the second pass in
    328 <xref linkend="chapter05"/>, or otherwise accidentally deleted them or just
     328<xref linkend="chapter-temporary-tools"/>, or otherwise accidentally deleted them or just
    329329don't have access to them, don't worry, all is not lost. Just ignore the above
    330330command. The result will be that the next package, Binutils, will link against

  • chapter06/gcc-2953.xml

    rfe5b13b rdcff046  
    2929
    3030<para>This is an older release of GCC which we are going to install for the
    31 purpose of compiling the Linux kernel in <xref linkend="chapter08"/>. This
     31purpose of compiling the Linux kernel in <xref linkend="chapter-mixture"/>. This
    3232version is recommended
    3333by the kernel developers when you need absolute stability. Later versions of

  • chapter06/gcc.xml

    rfe5b13b rdcff046  
    9393<xref linkend="ch-system-adjustingtoolchain"/> and repeat the check. If the results
    9494are wrong, then most likely you erroneously applied the GCC Specs patch from
    95 <xref linkend="chapter05"/>.</para></note>
     95<xref linkend="chapter-temporary-tools"/>.</para></note>
    9696
    9797</sect2>

  • chapter07/chapter07.xml

    rfe5b13b rdcff046  
    1 <chapter id="chapter07" xreflabel="Chapter 7">
     1<chapter id="chapter-bootscripts" xreflabel="Chapter 7">
    22<title>Setting up system boot scripts</title>
    33<?dbhtml filename="chapter07.html" dir="chapter07"?>

  • chapter07/loadkeys.xml

    rfe5b13b rdcff046  
    44
    55<para>If you decided to compile your keymap file directly into the kernel back
    6 at the end of <xref linkend="chapter06"/>, then you strictly speaking don't
     6at the end of <xref linkend="chapter-building-system"/>, then you strictly speaking don't
    77need to run this loadkeys script, since the kernel has already set up the
    88keymap for you. You can still run it if you want, it isn't going to hurt you.

  • chapter08/chapter08.xml

    rfe5b13b rdcff046  
    1 <chapter id="chapter08" xreflabel="Chapter 8">
     1<chapter id="chapter-mixture" xreflabel="Chapter 8">
    22<title>Making the LFS system bootable</title>
    33<?dbhtml filename="chapter08.html" dir="chapter08"?>

  • chapter09/chapter09.xml

    rfe5b13b rdcff046  
    1 <chapter id="chapter09" xreflabel="Chapter 9">
     1<chapter id="chapter-finalizing" xreflabel="Chapter 9">
    22<title>The End</title>
    33<?dbhtml filename="chapter09.html" dir="chapter09"?>
Note: See TracChangeset for help on using the changeset viewer.