newxml/chapter05/introduction.xml

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
   3   <!ENTITY % general-entities SYSTEM "../general.ent">
   4   %general-entities;
   5 ]>
   6 <sect1 id="ch-tools-introduction">
   7 <title>Introduction</title>
   8 <?dbhtml filename="introduction.html"?>
   9
  10 <para>In this chapter we will compile and install a minimal
  11 Linux system. This system will contain just enough tools to be able
  12 to start constructing the final LFS system in the next chapter and allow
  13 a working environment with a little more user convenience than a minimum
  14 environment.</para>
  15
  16 <para>The building of this minimal system is done in two steps: first we
  17 build a brand-new and host-independent toolchain (compiler, assembler,
  18 linker, libraries, and a few useful utilities), and then use this to build all the other essential
  19 tools.</para>
  20
  21 <para>The files compiled in this chapter will be installed under the
  22 <filename class="directory">$LFS/tools</filename> directory
  23 to keep them separate from the files installed in the next chapter and your host's production directories.
  24 Since the packages compiled here are merely temporary, we don't want
  25 them to pollute the soon-to-be LFS system.</para>
  26
  27 <para>Before issuing the build instructions for a package, you are expected to
  28 have already unpacked it (explained shortly) as user <emphasis>lfs</emphasis>,
  29 and to have performed a <userinput>cd</userinput> into the created directory.
  30 The build instructions assume that you are using the <command>bash</command>
  31 shell.</para>
  32
  33 <para>Several of the packages are patched before compilation, but only when
  34 the patch is needed to circumvent a problem. Often the patch is needed in
  35 both this and the next chapter, but sometimes in only one of them. Therefore,
  36 don't worry when instructions for a downloaded patch seem to be missing. Also,
  37 when applying a patch, you'll occasionally see warning messages about
  38 <emphasis>offset</emphasis> or <emphasis>fuzz</emphasis>. These warnings are
  39 nothing to worry about, as the patch was still successfully applied.</para>
  40
  41 <para>During the compilation of most packages you will see many warnings
  42 scroll by on your screen. These are normal and can safely be ignored. They are
  43 just what they say they are: warnings -- mostly about deprecated, but not
  44 invalid, use of the C or C++ syntax. It's just that C standards have changed
  45 rather often and some packages still use the older standard, which is not
  46 really a problem.</para>
  47
  48 <para>After installing each package you should delete its source and build
  49 directories, <emphasis>unless</emphasis> told otherwise. Deleting the sources
  50 saves space, but also prevents mis-configuration when the same package is
  51 reinstalled further on. Only for three packages you will need to keep the
  52 source and build directories around for a while, so their contents can be used
  53 by later commands. Do not miss the reminders.</para>
  54
  55 <para>Now first check that your LFS environment variable is set up
  56 properly:</para>
  57
  58 <screen><userinput>echo $LFS</userinput></screen>
  59
  60 <para>Make sure the output shows the path to your LFS partition's mount
  61 point, which is <filename class="directory">/mnt/lfs</filename> if you
  62 followed our example.</para>
  63
  64 </sect1>