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">
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)
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>
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>