source: chapter06/introduction.xml@ 9829329

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.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
Last change on this file since 9829329 was 9829329, checked in by Matthew Burgess <matthew@…>, 18 years ago

Remove optimization related warnings from the toolchain packages

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

  • Property mode set to 100644
File size: 3.8 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
3 <!ENTITY % general-entities SYSTEM "../general.ent">
4 %general-entities;
5]>
6<sect1 id="ch-system-introduction">
7<title>Introduction</title>
8<?dbhtml filename="introduction.html"?>
9
10<para>In this chapter, we enter the building site and start
11constructing the LFS system in earnest. That is, we chroot into the
12temporary mini Linux system, make a few final preparations, and then
13begin installing the packages.</para>
14
15<para>The installation of this software is straightforward. Although
16in many cases the installation instructions could be made shorter and
17more generic, we have opted to provide the full instructions for every
18package to minimize the possibilities for mistakes. The key to
19learning what makes a Linux system work is to know what each package
20is used for and why the user (or the system) needs it. For every
21installed package, a summary of its contents is given, followed by
22concise descriptions of each program and library the package
23installed.</para>
24
25<para>If using the compiler optimizations provided in this chapter,
26please review the optimization hint at <ulink
27url="&hints-root;optimization.txt"/>. Compiler optimizations can make
28a program run slightly faster, but they may also cause compilation
29difficulties and problems when running the program. If a package
30refuses to compile when using optimization, try to compile it without
31optimization and see if that fixes the problem. Even if the package
32does compile when using optimization, there is the risk it may have
33been compiled incorrectly because of the complex interactions between
34the code and build tools. Also note that the <option>-march</option>
35and <option>-mtune</option> options may cause problems with the
36toolchain packages (Binutils, GCC and Glibc). The small potential
37gains achieved in using compiler optimizations are often outweighed by
38the risks. First-time builders of LFS are encouraged to build without
39custom optimizations. The subsequent system will still run very fast
40and be stable at the same time.</para>
41
42<para>The order that packages are installed in this chapter needs to
43be strictly followed to ensure that no program accidentally acquires a
44path referring to <filename class="directory">/tools</filename>
45hard-wired into it. For the same reason, do not compile packages in
46parallel. Compiling in parallel may save time (especially on dual-CPU
47machines), but it could result in a program containing a hard-wired
48path to <filename class="directory">/tools</filename>, which will
49cause the program to stop working when that directory is
50removed.</para>
51
52<para>Before the installation instructions, each installation page
53provides information about the package, including a concise
54description of what it contains, approximately how long it will take
55to build, how much disk space is required during this building
56process, and any other packages needed to successfully build the
57package. Following the installation instructions, there is a list of
58programs and libraries (along with brief descriptions of these) that
59the package installs.</para>
60
61<para>To keep track of which package installs particular files, a package
62manager can be used. For a general overview of different styles of package
63managers, please refer to <ulink
64url="&blfs-root;view/svn/introduction/important.html"/>.
65For a package management method specifically geared towards LFS, we recommend <ulink
66url="&hints-root;more_control_and_pkg_man.txt"/>.</para>
67
68<note><para>The remainder of this book is to be performed while logged in as
69user <emphasis>root</emphasis> and no longer as user <emphasis>lfs</emphasis>.
70Also, double check that <envar>$LFS</envar> is set.</para></note>
71
72</sect1>
73
Note: See TracBrowser for help on using the repository browser.