diff options
Diffstat (limited to 'chapter01')
| -rw-r--r-- | chapter01/administrativa.xml | 82 | ||||
| -rw-r--r-- | chapter01/askforhelp.xml | 106 | ||||
| -rw-r--r-- | chapter01/bootcd.xml | 55 | ||||
| -rw-r--r-- | chapter01/changelog.xml | 217 | ||||
| -rw-r--r-- | chapter01/how.xml | 74 |
5 files changed, 445 insertions, 89 deletions
diff --git a/chapter01/administrativa.xml b/chapter01/administrativa.xml index adf02c2b0..6708e8d06 100644 --- a/chapter01/administrativa.xml +++ b/chapter01/administrativa.xml @@ -7,6 +7,86 @@ <title>Resources</title> <?dbhtml filename="resources.html"?> -<para>See testing</para> + +<sect2 id="ch-scatter-faq"> +<title>FAQ</title> + +<para>If during the building of the LFS system you encounter any +errors, have any questions, or think there is a typo in the book, +please start by consulting the Frequently Asked Questions (FAQ) at +<ulink url="&faq-root;"/>.</para> +</sect2> + +<sect2 id="ch-scatter-maillists" xreflabel="Chapter 1 - Mailing Lists"> +<title>Mailing Lists</title> + +<para>The <uri>linuxfromscratch.org</uri> server hosts a number of +mailing lists used for the development of the LFS project. These lists +include the main development and support lists, among others.</para> + +<para>For information on the different lists, how to subscribe, archive +locations, and additional information, visit +<ulink url="&lfs-root;mail.html"/>.</para> +</sect2> + +<sect2 id="ch-scatter-irc"> +<title>IRC</title> + +<para>Several members of the LFS community offer assistance on our +community Internet Relay Chat (IRC) network. Before using this +support, please make sure that your question is not already answered in the LFS +FAQ or the mailing list archives. You can find the IRC network at +<uri>irc.linuxfromscratch.org</uri>, <uri>irc.linux-phreak.net</uri> +or <uri>irc.lfs-matrix.de</uri>. +The support channel is named #LFS-support.</para> +</sect2> + +<sect2 id="ch-scatter-newsserver"> +<title>News Server</title> + +<para>The mailing lists hosted at <uri>linuxfromscratch.org</uri> are +also accessible via the Network News Transfer Protocol (NNTP) server. +All messages posted to a mailing list are copied to the corresponding +newsgroup, and vice versa.</para> + +<para>The news server is located at +<uri>news.linuxfromscratch.org</uri>.</para> +</sect2> + +<sect2 id="ch-scatter-wiki"> +<title>Wiki</title> + +<para>For more information on packages, updated versions, tweaks, and +personal experiences, see the LFS Wiki at <ulink url="&wiki-root;"/>. +Users can also add information there to help others with their future +LFS activities.</para> +</sect2> + +<sect2 id="ch-scatter-references"> +<title>References</title> + +<para>For additional information on the packages, useful tips are +available at +<ulink +url="http://www.linuxfromscratch.org/~matthew/LFS-references.html"/>.</para> +</sect2> + + +<sect2 id="ch-scatter-mirrors" xreflabel="Chapter 1 - Mirror sites"> +<title>Mirror Sites</title> + +<para>The LFS project has a number of world-wide mirrors to make +accessing the website and downloading the required packages more +convenient. Please visit the LFS website at <ulink url="&lfs-root;"/> +for a list of current mirrors.</para> +</sect2> + +<sect2 id="ch-scatter-contactinfo"> +<title>Contact Information</title> + +<para>Please direct all your questions and comments to one of the LFS mailing +lists (see above).</para> +</sect2> </sect1> + diff --git a/chapter01/askforhelp.xml b/chapter01/askforhelp.xml index df7e83f11..1dc36c365 100644 --- a/chapter01/askforhelp.xml +++ b/chapter01/askforhelp.xml @@ -7,6 +7,110 @@ <title>Help</title> <?dbhtml filename="askforhelp.html"?> -<para>See testing</para> +<para>If an issue or a question is encountered while working +through this book, check the FAQ page at <ulink url="&faq-root;#generalfaq"/>. +Questions are often already answered there. If your question is +not answered on this page, try to find the source of the problem. The +following hint will give you some guidance for troubleshooting: <ulink +url="&hints-root;errors.txt"/>.</para> + +<para>We also have a wonderful LFS community that is willing to offer +assistance through IRC and the mailing lists (see the <xref +linkend="ch-scatter-administrativa"/> section of this book). In order +to assist with diagnosing and solving the problem, please include +all relevant information in your request for help.</para> + +<sect2> +<title>Things to Mention</title> + +<para>Apart from a brief explanation of the problem being experienced, +the essential things to include in any request for help are:</para> + +<itemizedlist> +<listitem><para>The version of the book being used (in this case +&version;)</para></listitem> +<listitem><para>The host distribution and version being used to +create LFS</para></listitem> +<listitem><para>The package or section the problem was encountered in</para></listitem> +<listitem><para>The exact error message or symptom being received</para></listitem> +<listitem><para>Note whether you have deviated from the book at all </para></listitem> +</itemizedlist> + +<note><para>Deviating from this book does <emphasis>not</emphasis> +mean that we will not help you. After all, LFS is about personal +preference. Being upfront about any changes to the established +procedure helps us evaluate and determine possible causes of your +problem.</para></note> +</sect2> + +<sect2> +<title>Configure Problems</title> + +<para>If something goes wrong during the stage where the configure +script is run, review the <filename>config.log</filename> file. This +file may contain errors encountered during configure which were not +printed to the screen. Include those relevant lines if you need to ask +for help.</para> +</sect2> + +<sect2> +<title>Compile Problems</title> + +<para>Both the screen output and the contents of various files are +useful in determining the cause of compile issues. The screen output +from the <command>./configure</command> script and the +<command>make</command> run can be helpful. It +is not necessary to include the entire output, but do include enough +of the relevant information. Below is an example of the type of +information to include from the screen output from <command>make</command>:</para> + +<screen><computeroutput>gcc -DALIASPATH=\"/mnt/lfs/usr/share/locale:.\" +-DLOCALEDIR=\"/mnt/lfs/usr/share/locale\" +-DLIBDIR=\"/mnt/lfs/usr/lib\" +-DINCLUDEDIR=\"/mnt/lfs/usr/include\" -DHAVE_CONFIG_H -I. -I. +-g -O2 -c getopt1.c +gcc -g -O2 -static -o make ar.o arscan.o commands.o dir.o +expand.o file.o function.o getopt.o implicit.o job.o main.o +misc.o read.o remake.o rule.o signame.o variable.o vpath.o +default.o remote-stub.o version.o opt1.o +-lutil job.o: In function `load_too_high': +/lfs/tmp/make-3.79.1/job.c:1565: undefined reference +to `getloadavg' +collect2: ld returned 1 exit status +make[2]: *** [make] Error 1 +make[2]: Leaving directory `/lfs/tmp/make-3.79.1' +make[1]: *** [all-recursive] Error 1 +make[1]: Leaving directory `/lfs/tmp/make-3.79.1' +make: *** [all-recursive-am] Error 2</computeroutput></screen> + +<para>In this case, many people would just include the bottom +section:</para> + +<screen><computeroutput>make [2]: *** [make] Error 1</computeroutput></screen> + +<para>This is not enough information to properly diagnose the problem +because it only notes that something went wrong, not +<emphasis>what</emphasis> went wrong. The entire section, as in the +example above, is what should be saved because it includes the command +that was executed and the associated error message(s).</para> + +<para>An excellent article about asking for help on the Internet is +available online at <ulink +url="http://catb.org/~esr/faqs/smart-questions.html"/>. Read and +follow the hints in this document to increase the likelihood of getting +the help you need.</para> +</sect2> + +<sect2> +<title>Test Suite Problems</title> + +<para>Many packages provide a test suite which, depending on the +importance of the package, should be run. Sometimes packages will +generate false or expected failures. If these errors are encountered, +check the LFS Wiki page at <ulink url="&wiki-root;"/> to see if we have +noted and investigated these issues. If these issues are noted and +addressed, there is no need to be concerned.</para> +</sect2> </sect1> + diff --git a/chapter01/bootcd.xml b/chapter01/bootcd.xml index 773f76c9b..47542fc6f 100644 --- a/chapter01/bootcd.xml +++ b/chapter01/bootcd.xml @@ -7,7 +7,60 @@ <title>About the Included CD</title> <?dbhtml filename="bootcd.html"?> -<para>See testing</para> +<para>For your convenience, we have included a CD with this book that +contains the source packages needed for creating a Linux From Scratch +system. The CD is bootable and provides a stable working environment +for building LFS. This book refers to this system as the +<quote>host system.</quote> The CD images are actively maintained and +updated versions can be found at +<ulink url="ftp://ftp.lfs-matrix.net/pub/lfs-livecd/"/></para> + +<para>In addition to the tools required to build LFS, the host system +on the CD has a number of other helpful tools installed:</para> + +<itemizedlist> + <listitem><para>An HTML version of this book</para></listitem> + <listitem><para>The X Window System Environment</para></listitem> + <listitem> + <para>Web Tools</para> + <itemizedlist> + <listitem><para>Wget (command line file retriever)</para></listitem> + <listitem><para>Lynx (text web browser)</para></listitem> + <listitem><para>Irssi (console IRC client)</para></listitem> + <listitem><para>Firefox (graphical web browser)</para></listitem> + <listitem><para>Xchat (X-based IRC client)</para></listitem> + </itemizedlist> + </listitem> + + <listitem> + <para>Text Editors</para> + <itemizedlist> + <listitem><para>Vim</para></listitem> + <listitem><para>Nano</para></listitem> + </itemizedlist> + </listitem> + + <listitem> + <para>Network Tools</para> + <itemizedlist> + <listitem><para>SSH Server and Client</para></listitem> + <listitem><para>NFS Server and Client</para></listitem> + <listitem><para>Smbmount (mount.cifs) for Windows shares</para></listitem> + <listitem><para>Subversion</para></listitem> + <listitem><para>Dhcpcd (DHCP client)</para></listitem> + </itemizedlist> + </listitem> + + <listitem> + <para>Filesystem Programs</para> + <itemizedlist> + <listitem><para>Reiserfsprogs</para></listitem> + <listitem><para>Xfsprogs</para></listitem> + </itemizedlist> + </listitem> + + <listitem><para>nALFS - A tool for automating LFS builds</para></listitem> +</itemizedlist> </sect1> diff --git a/chapter01/changelog.xml b/chapter01/changelog.xml index 1721d7913..c0f2ba9ed 100644 --- a/chapter01/changelog.xml +++ b/chapter01/changelog.xml @@ -3,7 +3,7 @@ <!ENTITY % general-entities SYSTEM "../general.ent"> %general-entities; ]> -<sect1 id="ch-scatter-changelog" condition="no-print"> +<sect1 id="ch-scatter-changelog" condition="html"> <title>Changelog</title> <?dbhtml filename="changelog.html"?> @@ -12,141 +12,188 @@ version is probably already available. To find out, please check one of the mirrors via <ulink url="&lfs-root;"/>.</para> -<para>Below is a list of differences between the Testing and Unstable versions -of the LFS Book.</para> +<para>Below is a list of changes made since the previous release of the book, +first a summary, then a detailed log.</para> <itemizedlist> <listitem><para>Upgraded to:</para> <itemizedlist> -<listitem><para>automake-1.9.5</para></listitem> -<listitem><para>e2fsprogs-1.36</para></listitem> -<listitem><para>expect-5.43.0</para></listitem> -<listitem><para>file-4.13</para></listitem> -<listitem><para>findutils-4.2.17</para></listitem> -<listitem><para>glibc-2.3.4</para></listitem> -<listitem><para>grub-0.96</para></listitem> -<listitem><para>lfs-bootscripts-3.1.0</para></listitem> -<listitem><para>libol-0.3.15</para></listitem> -<listitem><para>libtool-1.5.14</para></listitem> -<listitem><para>linux-libc-headers-2.6.10.0</para></listitem> -<listitem><para>procps-3.2.5</para></listitem> -<listitem><para>sed-4.1.4</para></listitem> -<listitem><para>shadow-4.0.7</para></listitem> -<listitem><para>syslog-ng-1.6.6</para></listitem> -<listitem><para>util-linux-2.12q</para></listitem> +<listitem><para>Automake 1.9.5</para></listitem> +<listitem><para>Binutils 2.15.94.0.2</para></listitem> +<listitem><para>Bison 2.0</para></listitem> +<listitem><para>E2fsprogs 1.36</para></listitem> +<listitem><para>Expect 5.43.0</para></listitem> +<listitem><para>File 4.13</para></listitem> +<listitem><para>Findutils 4.2.17</para></listitem> +<listitem><para>GCC 3.4.3</para></listitem> +<listitem><para>Glibc 20041011</para></listitem> +<listitem><para>Grep 2.5.1a</para></listitem> +<listitem><para>Grub 0.96</para></listitem> +<listitem><para>Iana-Etc 1.03</para></listitem> +<listitem><para>Iproute2 2.6.9-041019</para></listitem> +<listitem><para>LFS-Bootscripts 3.1.0</para></listitem> +<listitem><para>Libtool 1.5.14</para></listitem> +<listitem><para>Linux 2.6.10</para></listitem> +<listitem><para>Linux-libc-headers 2.6.10.0</para></listitem> +<listitem><para>Man 1.5p</para></listitem> +<listitem><para>Man-pages 2.01</para></listitem> +<listitem><para>Module-init-tools 3.1</para></listitem> +<listitem><para>Perl 5.8.6</para></listitem> +<listitem><para>Procps 3.2.5</para></listitem> +<listitem><para>Sed 4.1.4</para></listitem> +<listitem><para>Shadow 4.0.7</para></listitem> +<listitem><para>Sysvinit 2.86</para></listitem> +<listitem><para>Tar 1.15.1</para></listitem> +<listitem><para>Texinfo 4.8</para></listitem> +<listitem><para>Tcl 8.4.9</para></listitem> +<listitem><para>Udev 050</para></listitem> +<listitem><para>Util-linux 2.12q</para></listitem> +<listitem><para>Zlib 1.2.2</para></listitem> </itemizedlist> </listitem> <listitem><para>Added:</para> <itemizedlist> -<listitem><para>bash-3.0-fixes-3.patch</para></listitem> +<listitem><para>bash-3.0-fixes-1.patch</para></listitem> +<listitem><para>bash-3.0-avoid_WCONTINUED-1.patch</para></listitem> +<listitem><para>Hotplug 2004_09_23</para></listitem> <listitem><para>iproute2-2.6.9_041019-find_update-1.patch</para></listitem> +<listitem><para>Libol 0.3.15</para></listitem> +<listitem><para>linux-2.6.10-security_fix-1.patch</para></listitem> +<listitem><para>Syslog-ng 1.6.6</para></listitem> +<listitem><para>util-linux-2.12p-cramfs-1.patch</para></listitem> +<listitem><para>vim-6.0-security_fix-1.patch</para></listitem> </itemizedlist> </listitem> - + <listitem><para>Removed:</para> <itemizedlist> -<listitem><para>bash-3.0-fixes-1.patch</para></listitem> +<listitem><para>bash-3.0-display_wrap-1.patch</para></listitem> +<listitem><para>man-1.5o1-80cols-1.patch</para></listitem> +<listitem><para>Sysklogd 1.4.1</para></listitem> +<listitem><para>sysvinit-2.85-proclen-1.patch</para></listitem> +<listitem><para>texinfo-4.7-segfault-1.patch</para></listitem> +<listitem><para>util-linux-2.12b-sfdisk-1.patch</para></listitem> +<listitem><para>zlib-1.2.1-security-1.patch</para></listitem> </itemizedlist> </listitem> -<listitem><para>February 13, 2005 [matt]: Add a link to BLFS' index of -packages requiring kernel configuration. Fixes bug 1028.</para></listitem> +<listitem><para>February 19, 2005 [gerard]: Synchronized Testing +branch with current Unstable/Trunk. Move Testing branch to Trunk and +discontinue Testing branch as per lfs-dev discussion on branch +changes.</para></listitem> -<listitem><para>February 13, 2005 [matt]: Fix bug 1030 by moving the <quote>Get -Counted</quote> section to after the user has rebooted for the first time. -Fixes bug 1030.</para></listitem> +<listitem><para>February 5, 2005 [matt]: Copy hotplug's pnp.distmap file to +silence its warnings. Also tidy up some explanatory text</para></listitem> -<listitem><para>February 13, 2005 [matt]: Upgraded to glibc-2.3.4</para> -</listitem> +<listitem><para>January 29, 2005 [matt]: Upgraded to sed-4.1.4</para></listitem> -<listitem><para>February 13, 2005 [matt]: Upgraded to grub-0.96</para> +<listitem><para>January 29, 2005 [matt]: Upgraded to procps-3.2.5</para> </listitem> -<listitem><para>February 13, 2005 [matt]: Upgraded to e2fsprogs-1.36</para> +<listitem><para>January 29, 2005 [matt]: Upgraded to shadow-4.0.7</para> </listitem> -<listitem><para>February 13, 2005 [matt]: Upgraded to findutils-4.2.17</para> +<listitem><para>January 29, 2005 [matt]: Upgraded to util-linux-2.12q.</para> </listitem> -<listitem><para>February 13, 2005 [matt]: Upgraded to expect-5.43.0</para> -</listitem> +<listitem><para>January 27, 2005 [matt]: Added a warning that the +<filename class="symlink">/usr/src/linux</filename> symlink shouldn't be +created. Fixes bug 1012.</para></listitem> -<listitem><para>February 13, 2005 [matt]: Upgraded to libtool-1.5.14</para> -</listitem> +<listitem><para>January 27, 2005 [matt]: Added link to the live-cd FTP +location. Fixes bug 1014.</para></listitem> -<listitem><para>February 13, 2005 [matt]: Upgraded to automake-1.9.5</para> -</listitem> +<listitem><para>January 27, 2005 [matt]: Added bison, flex and m4 to binutils +dependency list. Fixes Bug 1018.</para></listitem> -<listitem><para>February 13, 2005 [matt]: Upgraded to file-4.13</para> -</listitem> +<listitem><para>January 27, 2005 [manuel]: Updated to gcc-3.4.3-specs-2.patch.</para></listitem> -<listitem><para>February 5, 2005 [matt]: Added a space to the toolchain -readjustment <command>perl</command> command. This stops the specs file being -incorrectly modified if the command is run more than once. Fixes bug 1023. -</para></listitem> +<listitem><para>January 19, 2005 [jeremy]: Added an extra symlink for +libgcc_s.so to chapter 6 - this never migrated from unstable until now.</para></listitem> -<listitem><para>February 5, 2005 [matt]: Copy hotplug's pnp.distmap file to -silence its warnings</para></listitem> +<listitem><para>January 9, 2005 [matt]: Added a security patch for the kernel</para></listitem> -<listitem><para>February 5, 2005 [matt]: Upgraded to syslog-ng-1.6.6</para> -</listitem> +<listitem><para>January 9, 2005 [matt]: Added a security patch for vim</para></listitem> -<listitem><para>February 5, 2005 [matt]: Upgraded to libol-0.3.15</para> -</listitem> +<listitem><para>January 9, 2005 [matt]: Upgraded to man-1.5p</para></listitem> -<listitem><para>January 29th, 2005 [matt]: Upgraded to findutils 4.2.15</para> -</listitem> +<listitem><para>January 9, 2005 [matt]: Upgraded to texinfo-4.8</para></listitem> -<listitem><para>January 28th, 2005 [matt]: Upgraded to sed-4.1.4</para> -</listitem> +<listitem><para>January 9, 2005 [matt]: Upgraded to util-linux-2.12p</para></listitem> -<listitem><para>January 27th, 2005 [matt]: Upgraded to findutils 4.2.14</para> -</listitem> +<listitem><para>January 9, 2005 [matt]: Upgraded to udev-050</para></listitem> -<listitem><para>January 27th, 2005 [matt]: Upgraded to sed-4.1.3</para> -</listitem> +<listitem><para>January 9, 2005 [matt]: Upgraded to tcl-8.4.9</para></listitem> -<listitem><para>January 27th, 2005 [matt]: Upgraded to procps-3.2.5</para> -</listitem> +<listitem><para>January 9, 2005 [matt]: Upgraded to tar-1.15.1</para></listitem> -<listitem><para>January 27th, 2005 [matt]: Upgraded to shadow-4.0.7</para> -</listitem> +<listitem><para>January 9, 2005 [matt]: Upgraded to perl-5.8.6</para></listitem> -<listitem><para>January 27th, 2005 [matt]: Upgraded to util-linux-2.12q</para> -</listitem> +<listitem><para>January 9, 2005 [matt]: Upgraded to man-pages-2.01</para></listitem> + +<listitem><para>January 9, 2005 [matt]: Upgraded to linux-libc-headers-2.6.10.0</para></listitem> + +<listitem><para>January 9, 2005 [matt]: Upgraded to linux-2.6.10</para></listitem> + +<listitem><para>January 9, 2005 [matt]: Upgraded to gcc-3.4.3</para></listitem> + +<listitem><para>January 9, 2005 [matt]: Upgraded to bison-2.0</para></listitem> -<listitem><para>January 9th, 2005 [jeremy]: Removed --enable-shared from libol, -since the shared library is installed by default for this package - thanks -Archaic</para></listitem> +<listitem><para>January 9, 2005 [matt]: Upgraded to autoconf-1.9.4</para></listitem> -<listitem><para>January 5th, 2005 [jeremy]: Upgraded to findutils 4.2.11</para></listitem> +<listitem><para>January 5, 2005 [jeremy]: Minor textual correction in network +configuration, since iproute will not recognize the old eth0:1 format for +ip aliasing. Closes bug 1013.</para></listitem> -<listitem><para>December 31st, 2004 [jeremy]: Oops - forgot to remove the -separate targets for hotplug and syslog-ng - fixed.</para></listitem> +<listitem><para>January 5, 2005 [jeremy]: Added the --disable-selinux parameter +to Ch 5 glibc. Allows building from hosts which use SELinux functionality, +like Fedora Core 3</para></listitem> -<listitem><para>December 31st, 2004 [jeremy]: Upgrade to LFS-Bootscripts 3.1.0</para></listitem> +<listitem><para>December 25, 2004 [jeremy]: Added text suggested by MSB, +closing Bug 943</para></listitem> -<listitem><para>December 30th, 2004 [jeremy]: Added Archaic's sed to stop -installation of shadow's groups binary, as well as it's man page.</para></listitem> +<listitem><para>December 25, 2004 [jeremy]: Upgraded binutils to 2.14.94.0.2 - +should fix the TLS strip issue that's been seen, at least on X86</para></listitem> -<listitem><para>December 25th, 2004 [jeremy]: Upgrade to glibc snapshot -of 20041220</para></listitem> +<listitem><para>December 22, 2004 [manuel]: Readded to chapter09/reboot.xml a para lost +from version 5.1.</para></listitem> -<listitem><para>December 19th, 2004 [jeremy]: Updated GCC-testresults link to -be appropriate for GCC 3.4.3</para></listitem> +<listitem><para>December 20, 2004 [manuel]: Made Grub's configuration location +FHS compliant.</para></listitem> -<listitem><para>December 6th, 2004 [jim]: Fixes a few typo's done by me. -Added a patch for IPRoute2 to fix usage with the newer findutils. -Updated Readline and Zlib library location changes. -Bumped findutils to 4.2.9 and util-linux 2.12j. -Used the same methodology used on zlib and readline on shadow.</para></listitem> +<listitem><para>December 19, 2004 [manuel]: Added the irc.lfs-matrix.de IRC server.</para></listitem> -<listitem><para>December 3rd, 2004 [jim]: Changed readline and zlib instructions -to use --libdir for the libraries. Bumped perl to 5.8.6. Corrected wording in -readline.</para></listitem> +<listitem><para>December 5, 2004 [jeremy]: Added the DOCBOOKTOMAN parameter +to Module-init-utils - without this, compilation fails. Thanks Boris Buegling</para></listitem> + +<listitem><para>December 2, 2004 [jeremy]: Removed the old display_wrap bash +patch, in favor of the newer fixes patch, and added the avoid_WCONTINUED +patch as well</para></listitem> + +<listitem><para>December 2, 2004 [jeremy]: Upgraded to TCL 8.4.8, Grep 2.5.1a +Util-linux 2.12i, Iana-etc 1.03, File 4.12, Module-init-tools 3.1, Procps 3.2.4 +</para></listitem> + +<listitem><para>December 2, 2004 [jeremy]: Migrated change from unstable to +build Glibc against sanitized linux-libc-headers instead of raw kernel headers, +bringing us more in line with what the kernel developers think should be +happening.</para></listitem> + +<listitem><para>December 1, 2004 [jeremy]: Dropped Udev from being built in +Chapter 5, in favor of creating a minimal set of devices at the beginning +of Chapter 6. All devices are created after the installation of Udev near +the end of Chapter 6</para></listitem> + +<listitem><para>December 1, 2004 [jeremy]: Upgraded to Automake 1.9.3, +Binutils 2.15.92.0.2, Findutils 4.2.3, GCC 3.4.2, Glibc 20041011, Iana-Etc 1.02 +Iproute2 2.6.9-041019, LFS-Bootscripts 2.2.3, Libtool 1.5.10, Linux 2.6.9 +Linux-libc-headers 2.6.9.1, Man 1.5o1, Man-pages 1.70, Shadow 4.0.6, +Udev 046, Zlib 1.2.2, Hotplug 2004_09_23, Libol 0.3.14, Syslog-ng 1.6.5</para></listitem> </itemizedlist> +<para>Branch frozen for LFS 6.0 as of October 10, 2004</para> + </sect1> diff --git a/chapter01/how.xml b/chapter01/how.xml index 98828fc8a..b2390fb48 100644 --- a/chapter01/how.xml +++ b/chapter01/how.xml @@ -7,6 +7,78 @@ <title>How to Build an LFS System</title> <?dbhtml filename="how.html"?> -<para>See testing</para> +<para>The LFS system will be built by using a previously installed +Linux distribution (such as Debian, Mandrake, Red Hat, or SuSE). This +existing Linux system (the host) will be used as a starting point to +provide necessary programs, including a compiler, linker, and shell, +to build the new system. Select the <quote>development</quote> option +during the distribution installation to be able to access these +tools.</para> + +<para><xref linkend="chapter-partitioning"/> of this book describes how +to create a new Linux native partition and file system, the place +where the new LFS system will be compiled and installed. <xref +linkend="chapter-getting-materials"/> explains which packages and +patches need to be downloaded to build an LFS system and how to store +them on the new file system. <xref linkend="chapter-final-preps"/> +discusses the setup for an appropriate work environment. Please read +<xref linkend="chapter-final-preps"/> carefully as it explains several +important issues the developer should be aware of before beginning to +work through <xref linkend="chapter-temporary-tools"/> and +beyond.</para> + +<para><xref linkend="chapter-temporary-tools"/> explains the +installation of a number of packages that will form the basic +development suite (or toolchain) which is used to build the actual +system in <xref linkend="chapter-building-system"/>. Some of these +packages are needed to resolve circular dependencies—for example, +to compile a compiler, you need a compiler.</para> + +<para><xref linkend="chapter-temporary-tools"/> also shows the user how +to build a first pass of the toolchain, including Binutils and GCC +(first pass basically means these two core packages will be +re-installed a second time). The programs from these packages will be +linked statically in order to be used independently of the host +system. The next step is to build Glibc, the C library. Glibc will be +compiled by the toolchain programs built in the first pass. Then, a +second pass of the toolchain will be built. This time, the toolchain +will be dynamically linked against the newly built Glibc. The +remaining <xref linkend="chapter-temporary-tools"/> packages are built +using this second pass toolchain. When this is done, the LFS +installation process will no longer depend on the host distribution, +with the exception of the running kernel.</para> + +<para>While this may initially seem like a lot of work to get away +from a host distribution, a full technical explanation is provided at +the beginning of <xref linkend="chapter-temporary-tools"/>, +including notes on the differences between +statically and dynamically-linked programs.</para> + +<para>In <xref linkend="chapter-building-system"/>, the full LFS system is +built. The chroot (change root) program is used to enter a virtual +environment and start a new shell whose root directory will be set to +the LFS partition. This is very similar to rebooting and instructing +the kernel to mount the LFS partition as the root partition. The +system does not actually reboot, but instead chroots because creating a +bootable system requires additional work which is not necessary just +yet. The major advantage is that <quote>chrooting</quote> allows the +builder to continue using the host while LFS is being built. While +waiting for package compilation to complete, a user can switch to a +different virtual console (VC) or X desktop and continue using the +computer as normal.</para> + +<para>To finish the installation, the bootscripts are set up in <xref +linkend="chapter-bootscripts"/>, and the kernel and boot loader are set +up in <xref linkend="chapter-bootable"/>. <xref +linkend="chapter-finalizing"/> contains information on furthering the +LFS experience beyond this book. After the steps in this book have +been implemented, the computer will be ready to reboot into the new +LFS system.</para> + +<para>This is the process in a nutshell. Detailed information on each +step is discussed in the following chapters and package descriptions. +Items that may seem complicated will be clarified, and everything will +fall into place as the developer embarks on the LFS adventure.</para> </sect1> + |