Update to systemd-231
[linux_from_scratch.git] / BOOK / chapter06 / introduction.xml
blob4671662c63c37ab5357d116fc0321f673af35334
1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4   <!ENTITY % general-entities SYSTEM "../general.ent">
5   %general-entities;
6 ]>
8 <sect1 id="ch-system-introduction">
9   <?dbhtml filename="introduction.html"?>
11   <title>Introduction</title>
13   <para>In this chapter, we enter the building site and start constructing the
14   LFS system in earnest. That is, we chroot into the temporary mini Linux system,
15   make a few final preparations, and then begin installing the packages.</para>
17   <para>The installation of this software is straightforward. Although in many
18   cases the installation instructions could be made shorter and more generic,
19   we have opted to provide the full instructions for every package to minimize
20   the possibilities for mistakes.  The key to learning what makes a Linux system
21   work is to know what each package is used for and why you (or the system)
22   may need it.</para>
24   <para>We do not recommend using optimizations.  They can make
25   a program run slightly faster, but they may also cause compilation
26   difficulties and problems when running the program.  If a package refuses to
27   compile when using optimization, try to compile it without optimization and
28   see if that fixes the problem. Even if the package does compile when using
29   optimization, there is the risk it may have been compiled incorrectly because
30   of the complex interactions between the code and build tools.  Also note that
31   the <option>-march</option> and <option>-mtune</option> options using values
32   not specified in the book have not been tested. This may cause problems with
33   the toolchain packages (Binutils, GCC and Glibc).  The small potential gains
34   achieved in using compiler optimizations are often outweighed by the risks.
35   First-time builders of LFS are encouraged to build without custom
36   optimizations. The subsequent system will still run very fast and be stable
37   at the same time.</para>
39   <para>The order that packages are installed in this chapter needs to be
40   strictly followed to ensure that no program accidentally acquires a path
41   referring to <filename class="directory">/tools</filename> hard-wired into
42   it.  For the same reason, do not compile separate packages in parallel.
43   Compiling in parallel may save time (especially on dual-CPU machines), but it
44   could result in a program containing a hard-wired path to <filename
45   class="directory">/tools</filename>, which will cause the program to stop
46   working when that directory is removed.</para>
48   <para>Before the installation instructions, each installation page provides
49   information about the package, including a concise description of what it
50   contains, approximately how long it will take to build, and how much disk
51   space is required during this building process. Following the installation
52   instructions, there is a list of programs and libraries (along with brief
53   descriptions of these) that the package installs.</para>
55   <note><para>The SBU values and required disk space includes
56   test suite data for all applicable packages in Chapter 6.</para></note>
58   <sect2>
59     <title>About libraries</title>
61     <para>In general, the LFS editors discourage building and installing static
62     libraries.  The original purpose for most static libraries has been made
63     obsolete in a modern Linux system.  In addition linking a static library
64     into a program can be detrimental.  If an update to the library is needed
65     to remove a security problem, all programs that use the static library will
66     need to be relinked to the new library.  Since the use of static libraries
67     is not always obvious, the relevant programs (and the procedures needed to
68     do the linking) may not even be known.</para>
70     <para>In the procedures in Chapter 6, we remove or disable installation of
71     most static libraries.  In a few cases, especially glibc and gcc, the use
72     of static libraries remains essential to the general package building
73     process.  Usually this is done by passing a
74     <option>--disable-static</option> option to <command>configure</command>.
75     In other cases, alternate means are needed.</para>
77     <para>For a more complete discussion of libraries, see the discussion
78     <ulink url="&blfs-root;/view/&short-version;/introduction/libraries.html">
79     Libraries: Static or shared?</ulink> in the BLFS book.</para>
81   </sect2>
83 </sect1>