mirror of
https://git.linuxfromscratch.org/lfs.git
synced 2025-03-06 06:14:47 +00:00
Indented chapter01 except changelog.xml.
Renamed administrativa.xml to resources.xml. Standarized the ID values. git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@7265 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
This commit is contained in:
Manuel Canales Esparcia
parent
895a637737
commit
13a9dc2d62
@ -1,83 +0,0 @@
|
|||||||
<?xml version="1.0" encoding="ISO-8859-1"?>
|
|
||||||
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
|
|
||||||
<!ENTITY % general-entities SYSTEM "../general.ent">
|
|
||||||
%general-entities;
|
|
||||||
]>
|
|
||||||
<sect1 id="ch-scatter-administrativa">
|
|
||||||
<title>Resources</title>
|
|
||||||
<?dbhtml filename="resources.html"?>
|
|
||||||
|
|
||||||
|
|
||||||
<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)
|
|
||||||
that is located 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. If the FAQ does not solve the
|
|
||||||
problem you are having, the next step would be to search the mailing lists at
|
|
||||||
<ulink url="&lfs-root;search.html"/>.</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>
|
|
||||||
|
|
||||||
<!-- Remove until such time as we have our own News Server, JH 20060105
|
|
||||||
<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-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>.
|
|
||||||
The support channel is named #LFS-support.</para>
|
|
||||||
</sect2>
|
|
||||||
|
|
||||||
<sect2 id="ch-scatter-references">
|
|
||||||
<title>References</title>
|
|
||||||
|
|
||||||
<para>For additional information on the packages, useful tips are
|
|
||||||
available in the LFS Package Reference page located 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;mirrors.html"/> 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>
|
|
||||||
|
|
||||||
@ -1,87 +1,101 @@
|
|||||||
<?xml version="1.0" encoding="ISO-8859-1"?>
|
<?xml version="1.0" encoding="ISO-8859-1"?>
|
||||||
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
|
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
|
||||||
|
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
|
||||||
<!ENTITY % general-entities SYSTEM "../general.ent">
|
<!ENTITY % general-entities SYSTEM "../general.ent">
|
||||||
%general-entities;
|
%general-entities;
|
||||||
]>
|
]>
|
||||||
<sect1 id="prepare-askforhelp">
|
|
||||||
<title>Help</title>
|
|
||||||
<?dbhtml filename="askforhelp.html"?>
|
|
||||||
|
|
||||||
<para>If an issue or a question is encountered while working
|
<sect1 id="ch-intro-askforhelp">
|
||||||
through this book, check the FAQ page at <ulink url="&faq-root;#generalfaq"/>.
|
<?dbhtml filename="askforhelp.html"?>
|
||||||
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>If you cannot find your problem listed in the FAQ, search the mailing
|
<title>Help</title>
|
||||||
lists at <ulink url="&lfs-root;search.html"/>.</para>
|
|
||||||
|
|
||||||
<para>We also have a wonderful LFS community that is willing to offer assistance
|
<para>If an issue or a question is encountered while working through
|
||||||
through the mailing lists and IRC (see the <xref
|
this book, check the FAQ page at <ulink url="&faq-root;#generalfaq"/>.
|
||||||
linkend="ch-scatter-administrativa"/> section of this book). However, we get
|
Questions are often already answered there. If your question is not
|
||||||
several support questions everyday and many of them can be easily answered by
|
answered on this page, try to find the source of the problem. The
|
||||||
going to the FAQ and by searching the mailing lists first. So for us to offer
|
following hint will give you some guidance for troubleshooting:
|
||||||
the best assistance possible, you need to do some research on your own first.
|
<ulink url="&hints-root;errors.txt"/>.</para>
|
||||||
That allows us to focus on the more unusual support needs. If your searches do
|
|
||||||
not produce a solution, please include all relevant information (mentioned
|
|
||||||
below) in your request for help.</para>
|
|
||||||
|
|
||||||
<sect2>
|
<para>If you cannot find your problem listed in the FAQ, search the mailing
|
||||||
<title>Things to Mention</title>
|
lists at <ulink url="&lfs-root;search.html"/>.</para>
|
||||||
|
|
||||||
<para>Apart from a brief explanation of the problem being experienced,
|
|
||||||
the essential things to include in any request for help are:</para>
|
|
||||||
|
|
||||||
<itemizedlist>
|
<para>We also have a wonderful LFS community that is willing to offer
|
||||||
<listitem><para>The version of the book being used (in this case
|
assistance through the mailing lists and IRC (see the <xref
|
||||||
&version;)</para></listitem>
|
linkend="ch-intro-resources"/> section of this book). However,
|
||||||
<listitem><para>The host distribution and version being used to
|
we get several support questions everyday and many of them can be easily
|
||||||
create LFS</para></listitem>
|
answered by going to the FAQ and by searching the mailing lists first.
|
||||||
<listitem><para>The package or section the problem was encountered in</para></listitem>
|
So for us to offer the best assistance possible, you need to do some
|
||||||
<listitem><para>The exact error message or symptom being received</para></listitem>
|
research on your own first. That allows us to focus on the more unusual
|
||||||
<listitem><para>Note whether you have deviated from the book at all </para></listitem>
|
support needs. If your searches do not produce a solution, please include
|
||||||
</itemizedlist>
|
all relevant information (mentioned below) in your request for help.</para>
|
||||||
|
|
||||||
<note><para>Deviating from this book does <emphasis>not</emphasis>
|
<sect2>
|
||||||
mean that we will not help you. After all, LFS is about personal
|
<title>Things to Mention</title>
|
||||||
preference. Being upfront about any changes to the established
|
|
||||||
procedure helps us evaluate and determine possible causes of your
|
|
||||||
problem.</para></note>
|
|
||||||
</sect2>
|
|
||||||
|
|
||||||
<sect2>
|
<para>Apart from a brief explanation of the problem being experienced,
|
||||||
<title>Configure Script Problems</title>
|
the essential things to include in any request for help are:</para>
|
||||||
|
|
||||||
<para>If something goes wrong while running the <command>configure</command>
|
<itemizedlist>
|
||||||
script, review the <filename>config.log</filename> file. This file may
|
<listitem>
|
||||||
contain errors encountered during <command>configure</command> which were not
|
<para>The version of the book being used (in this case &version;)</para>
|
||||||
printed to the screen. Include the <emphasis>relevant</emphasis> lines if you
|
</listitem>
|
||||||
need to ask for help.</para>
|
<listitem>
|
||||||
</sect2>
|
<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>
|
||||||
|
|
||||||
<sect2>
|
<note>
|
||||||
<title>Compilation Problems</title>
|
<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>
|
||||||
|
|
||||||
<para>Both the screen output and the contents of various files are
|
</sect2>
|
||||||
useful in determining the cause of compilation problems. The screen output
|
|
||||||
from the <command>configure</command> script and the
|
<sect2>
|
||||||
<command>make</command> run can be helpful. It
|
<title>Configure Script Problems</title>
|
||||||
is not necessary to include the entire output, but do include enough
|
|
||||||
of the relevant information. Below is an example of the type of
|
<para>If something goes wrong while running the <command>configure</command>
|
||||||
information to include from the screen output from <command>make</command>:</para>
|
script, review the <filename>config.log</filename> file. This file may
|
||||||
|
contain errors encountered during <command>configure</command> which were
|
||||||
|
not printed to the screen. Include the <emphasis>relevant</emphasis> lines
|
||||||
|
if you need to ask for help.</para>
|
||||||
|
|
||||||
|
</sect2>
|
||||||
|
|
||||||
|
<sect2>
|
||||||
|
<title>Compilation Problems</title>
|
||||||
|
|
||||||
|
<para>Both the screen output and the contents of various files are useful
|
||||||
|
in determining the cause of compilation problems. 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:.\"
|
<screen><computeroutput>gcc -DALIASPATH=\"/mnt/lfs/usr/share/locale:.\"
|
||||||
-DLOCALEDIR=\"/mnt/lfs/usr/share/locale\"
|
-DLOCALEDIR=\"/mnt/lfs/usr/share/locale\"
|
||||||
-DLIBDIR=\"/mnt/lfs/usr/lib\"
|
-DLIBDIR=\"/mnt/lfs/usr/lib\"
|
||||||
-DINCLUDEDIR=\"/mnt/lfs/usr/include\" -DHAVE_CONFIG_H -I. -I.
|
-DINCLUDEDIR=\"/mnt/lfs/usr/include\" -DHAVE_CONFIG_H -I. -I.
|
||||||
-g -O2 -c getopt1.c
|
-g -O2 -c getopt1.c
|
||||||
gcc -g -O2 -static -o make ar.o arscan.o commands.o dir.o
|
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
|
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
|
misc.o read.o remake.o rule.o signame.o variable.o vpath.o
|
||||||
default.o remote-stub.o version.o opt1.o
|
default.o remote-stub.o version.o opt1.o
|
||||||
-lutil job.o: In function `load_too_high':
|
-lutil job.o: In function `load_too_high':
|
||||||
/lfs/tmp/make-3.79.1/job.c:1565: undefined reference
|
/lfs/tmp/make-3.79.1/job.c:1565: undefined reference
|
||||||
to `getloadavg'
|
to `getloadavg'
|
||||||
collect2: ld returned 1 exit status
|
collect2: ld returned 1 exit status
|
||||||
make[2]: *** [make] Error 1
|
make[2]: *** [make] Error 1
|
||||||
@ -90,23 +104,23 @@ make[1]: *** [all-recursive] Error 1
|
|||||||
make[1]: Leaving directory `/lfs/tmp/make-3.79.1'
|
make[1]: Leaving directory `/lfs/tmp/make-3.79.1'
|
||||||
make: *** [all-recursive-am] Error 2</computeroutput></screen>
|
make: *** [all-recursive-am] Error 2</computeroutput></screen>
|
||||||
|
|
||||||
<para>In this case, many people would just include the bottom
|
<para>In this case, many people would just include the bottom
|
||||||
section:</para>
|
section:</para>
|
||||||
|
|
||||||
<screen><computeroutput>make [2]: *** [make] Error 1</computeroutput></screen>
|
<screen><computeroutput>make [2]: *** [make] Error 1</computeroutput></screen>
|
||||||
|
|
||||||
<para>This is not enough information to properly diagnose the problem
|
<para>This is not enough information to properly diagnose the problem
|
||||||
because it only notes that something went wrong, not
|
because it only notes that something went wrong, not
|
||||||
<emphasis>what</emphasis> went wrong. The entire section, as in the
|
<emphasis>what</emphasis> went wrong. The entire section, as in the
|
||||||
example above, is what should be saved because it includes the command
|
example above, is what should be saved because it includes the command
|
||||||
that was executed and the associated error message(s).</para>
|
that was executed and the associated error message(s).</para>
|
||||||
|
|
||||||
<para>An excellent article about asking for help on the Internet is
|
<para>An excellent article about asking for help on the Internet is
|
||||||
available online at <ulink
|
available online at <ulink
|
||||||
url="http://catb.org/~esr/faqs/smart-questions.html"/>. Read and
|
url="http://catb.org/~esr/faqs/smart-questions.html"/>. Read and
|
||||||
follow the hints in this document to increase the likelihood of getting
|
follow the hints in this document to increase the likelihood of getting
|
||||||
the help you need.</para>
|
the help you need.</para>
|
||||||
</sect2>
|
|
||||||
|
</sect2>
|
||||||
|
|
||||||
</sect1>
|
</sect1>
|
||||||
|
|
||||||
|
|||||||
@ -1,17 +1,20 @@
|
|||||||
<?xml version="1.0" encoding="ISO-8859-1"?>
|
<?xml version="1.0" encoding="ISO-8859-1"?>
|
||||||
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
|
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
|
||||||
|
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
|
||||||
<!ENTITY % general-entities SYSTEM "../general.ent">
|
<!ENTITY % general-entities SYSTEM "../general.ent">
|
||||||
%general-entities;
|
%general-entities;
|
||||||
]>
|
]>
|
||||||
<chapter id="chapter-intro" xreflabel="Chapter 1">
|
|
||||||
<?dbhtml dir="chapter01"?>
|
|
||||||
<title>Introduction</title>
|
|
||||||
<?dbhtml filename="chapter01.html"?>
|
|
||||||
|
|
||||||
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="how.xml"/>
|
<chapter id="chapter-intro" xreflabel="Chapter 1">
|
||||||
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="changelog.xml"/>
|
<?dbhtml dir="chapter01"?>
|
||||||
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="administrativa.xml"/>
|
<?dbhtml filename="chapter01.html"?>
|
||||||
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="askforhelp.xml"/>
|
|
||||||
<!--<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="livecd.xml"/>-->
|
<title>Introduction</title>
|
||||||
|
|
||||||
|
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="how.xml"/>
|
||||||
|
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="changelog.xml"/>
|
||||||
|
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="resources.xml"/>
|
||||||
|
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="askforhelp.xml"/>
|
||||||
|
<!--<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="livecd.xml"/>-->
|
||||||
|
|
||||||
</chapter>
|
</chapter>
|
||||||
|
|||||||
@ -1,88 +1,89 @@
|
|||||||
<?xml version="1.0" encoding="ISO-8859-1"?>
|
<?xml version="1.0" encoding="ISO-8859-1"?>
|
||||||
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
|
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
|
||||||
|
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
|
||||||
<!ENTITY % general-entities SYSTEM "../general.ent">
|
<!ENTITY % general-entities SYSTEM "../general.ent">
|
||||||
%general-entities;
|
%general-entities;
|
||||||
]>
|
]>
|
||||||
<sect1 id="ch-scatter-how">
|
|
||||||
<title>How to Build an LFS System</title>
|
|
||||||
<?dbhtml filename="how.html"?>
|
|
||||||
|
|
||||||
<para>The LFS system will be built by using a previously installed
|
<sect1 id="ch-intro-how">
|
||||||
Linux distribution (such as Debian, Mandrake, Red Hat, or SuSE). This
|
<?dbhtml filename="how.html"?>
|
||||||
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>As an alternative to installing an entire separate distribution onto your
|
<title>How to Build an LFS System</title>
|
||||||
machine, you may wish to use the Linux From Scratch LiveCD. The CD works well as
|
|
||||||
a host system, providing all the tools you need to successfully follow the
|
|
||||||
instructions in this book. Additionally, it contains all the source packages,
|
|
||||||
patches and a copy of this book. So once you have the CD, no network connection
|
|
||||||
or additional downloads are necessary. For more information about the LFS LiveCD
|
|
||||||
or to download a copy, visit <ulink url="&livecd-root;"/>.</para>
|
|
||||||
|
|
||||||
<para><xref linkend="chapter-partitioning"/> of this book describes how
|
<para>The LFS system will be built by using a previously installed
|
||||||
to create a new Linux native partition and file system, the place
|
Linux distribution (such as Debian, Mandrake, Red Hat, or SuSE). This
|
||||||
where the new LFS system will be compiled and installed. <xref
|
existing Linux system (the host) will be used as a starting point to
|
||||||
linkend="chapter-getting-materials"/> explains which packages and
|
provide necessary programs, including a compiler, linker, and shell,
|
||||||
patches need to be downloaded to build an LFS system and how to store
|
to build the new system. Select the <quote>development</quote> option
|
||||||
them on the new file system. <xref linkend="chapter-final-preps"/>
|
during the distribution installation to be able to access these
|
||||||
discusses the setup for an appropriate working environment. Please read
|
tools.</para>
|
||||||
<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
|
<para>As an alternative to installing an entire separate distribution
|
||||||
installation of a number of packages that will form the basic
|
onto your machine, you may wish to use the Linux From Scratch LiveCD.
|
||||||
development suite (or toolchain) which is used to build the actual
|
The CD works well as a host system, providing all the tools you need
|
||||||
system in <xref linkend="chapter-building-system"/>. Some of these
|
to successfully follow the instructions in this book. Additionally,
|
||||||
packages are needed to resolve circular dependencies—for example,
|
it contains all the source packages, patches and a copy of this book.
|
||||||
to compile a compiler, you need a compiler.</para>
|
So once you have the CD, no network connection or additional downloads
|
||||||
|
are necessary. For more information about the LFS LiveCD or to download
|
||||||
|
a copy, visit <ulink url="&livecd-root;"/>.</para>
|
||||||
|
|
||||||
<para><xref linkend="chapter-temporary-tools"/> also shows the user how
|
<para><xref linkend="chapter-partitioning"/> of this book describes how
|
||||||
to build a first pass of the toolchain, including Binutils and GCC
|
to create a new Linux native partition and file system, the place
|
||||||
(first pass basically means these two core packages will be
|
where the new LFS system will be compiled and installed. <xref
|
||||||
re-installed a second time). The next step is to build Glibc, the C library.
|
linkend="chapter-getting-materials"/> explains which packages and
|
||||||
Glibc will be compiled by the toolchain programs built in the first pass. Then,
|
patches need to be downloaded to build an LFS system and how to store
|
||||||
a second pass of the toolchain will be built. This time, the toolchain will be
|
them on the new file system. <xref linkend="chapter-final-preps"/>
|
||||||
dynamically linked against the newly built Glibc. The remaining
|
discusses the setup for an appropriate working environment. Please read
|
||||||
<xref linkend="chapter-temporary-tools"/> packages are built using this second
|
<xref linkend="chapter-final-preps"/> carefully as it explains several
|
||||||
pass toolchain. When this is done, the LFS installation process will no longer
|
important issues the developer should be aware of before beginning to
|
||||||
depend on the host distribution, with the exception of the running kernel.
|
work through <xref linkend="chapter-temporary-tools"/> and beyond.</para>
|
||||||
</para>
|
|
||||||
|
|
||||||
<para>This effort to isolate the new system from the host distribution may seem
|
<para><xref linkend="chapter-temporary-tools"/> explains the
|
||||||
excessive, but a full technical explanation is provided in
|
installation of a number of packages that will form the basic
|
||||||
<xref linkend="ch-tools-toolchaintechnotes"/>.</para>
|
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>In <xref linkend="chapter-building-system"/>, the full LFS system is
|
<para><xref linkend="chapter-temporary-tools"/> also shows the user how to
|
||||||
built. The <command>chroot</command> (change root) program is used to enter a virtual
|
build a first pass of the toolchain, including Binutils and GCC (first pass
|
||||||
environment and start a new shell whose root directory will be set to
|
basically means these two core packages will be re-installed a second time).
|
||||||
the LFS partition. This is very similar to rebooting and instructing
|
The next step is to build Glibc, the C library. Glibc will be compiled by
|
||||||
the kernel to mount the LFS partition as the root partition. The
|
the toolchain programs built in the first pass. Then, a second pass of the
|
||||||
system does not actually reboot, but instead <command>chroot</command>'s because creating a
|
toolchain will be built. This time, the toolchain will be dynamically linked
|
||||||
bootable system requires additional work which is not necessary just
|
against the newly built Glibc. The remaining <xref
|
||||||
yet. The major advantage is that <quote>chrooting</quote> allows the
|
linkend="chapter-temporary-tools"/> packages are built using this second
|
||||||
builder to continue using the host while LFS is being built. While
|
pass toolchain. When this is done, the LFS installation process will no
|
||||||
waiting for package compilation to complete, a user can switch to a
|
longer depend on the host distribution, with the exception of the running
|
||||||
different virtual console (VC) or X desktop and continue using the
|
kernel. </para>
|
||||||
computer as normal.</para>
|
|
||||||
|
|
||||||
<para>To finish the installation, the LFS-Bootscripts are set up in <xref
|
<para>This effort to isolate the new system from the host distribution may
|
||||||
linkend="chapter-bootscripts"/>, and the kernel and boot loader are set
|
seem excessive, but a full technical explanation is provided in
|
||||||
up in <xref linkend="chapter-bootable"/>. <xref
|
<xref linkend="ch-tools-toolchaintechnotes"/>.</para>
|
||||||
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
|
<para>In <xref linkend="chapter-building-system"/>, the full LFS system is
|
||||||
step is discussed in the following chapters and package descriptions.
|
built. The <command>chroot</command> (change root) program is used to enter
|
||||||
Items that may seem complicated will be clarified, and everything will
|
a virtual environment and start a new shell whose root directory will be
|
||||||
fall into place as the reader embarks on the LFS adventure.</para>
|
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 <command>chroot</command>'s 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 LFS-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 reader embarks on the LFS adventure.</para>
|
||||||
|
|
||||||
</sect1>
|
</sect1>
|
||||||
|
|
||||||
|
|||||||
@ -1,66 +1,106 @@
|
|||||||
<?xml version="1.0" encoding="ISO-8859-1"?>
|
<?xml version="1.0" encoding="ISO-8859-1"?>
|
||||||
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
|
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
|
||||||
|
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
|
||||||
<!ENTITY % general-entities SYSTEM "../general.ent">
|
<!ENTITY % general-entities SYSTEM "../general.ent">
|
||||||
%general-entities;
|
%general-entities;
|
||||||
]>
|
]>
|
||||||
<sect1 id="prepare-livecd">
|
|
||||||
<title>About the Included CD</title>
|
|
||||||
<?dbhtml filename="livecd.html"?>
|
|
||||||
|
|
||||||
<para>For your convenience, we have included a CD with this book that
|
<sect1 id="ch-intro-livecd">
|
||||||
contains the source packages needed for creating a Linux From Scratch
|
<?dbhtml filename="livecd.html"?>
|
||||||
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
|
<title>About the Included CD</title>
|
||||||
on the CD has a number of other helpful tools installed:</para>
|
|
||||||
|
|
||||||
<itemizedlist>
|
<para>For your convenience, we have included a CD with this book that
|
||||||
<listitem><para>An HTML version of this book</para></listitem>
|
contains the source packages needed for creating a Linux From Scratch
|
||||||
<listitem><para>The X Window System Environment</para></listitem>
|
system. The CD is bootable and provides a stable working environment
|
||||||
<listitem>
|
for building LFS. This book refers to this system as the
|
||||||
<para>Web Tools</para>
|
<quote>host system.</quote> The CD images are actively maintained and
|
||||||
<itemizedlist>
|
updated versions can be found at
|
||||||
<listitem><para>Wget (command line file retriever)</para></listitem>
|
<ulink url="ftp://ftp.lfs-matrix.net/pub/lfs-livecd/"/></para>
|
||||||
<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>In addition to the tools required to build LFS, the host system
|
||||||
<para>Text Editors</para>
|
on the CD has a number of other helpful tools installed:</para>
|
||||||
<itemizedlist>
|
|
||||||
<listitem><para>Vim</para></listitem>
|
|
||||||
<listitem><para>Nano</para></listitem>
|
|
||||||
</itemizedlist>
|
|
||||||
</listitem>
|
|
||||||
|
|
||||||
<listitem>
|
<itemizedlist>
|
||||||
<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>
|
<listitem>
|
||||||
<para>Filesystem Programs</para>
|
<para>An HTML version of this book</para>
|
||||||
<itemizedlist>
|
</listitem>
|
||||||
<listitem><para>Reiserfsprogs</para></listitem>
|
|
||||||
<listitem><para>Xfsprogs</para></listitem>
|
|
||||||
</itemizedlist>
|
|
||||||
</listitem>
|
|
||||||
|
|
||||||
<listitem><para>nALFS - A tool for automating LFS builds</para></listitem>
|
<listitem>
|
||||||
</itemizedlist>
|
<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>
|
</sect1>
|
||||||
|
|
||||||
|
|||||||
91
chapter01/resources.xml
Normal file
91
chapter01/resources.xml
Normal file
@ -0,0 +1,91 @@
|
|||||||
|
<?xml version="1.0" encoding="ISO-8859-1"?>
|
||||||
|
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
|
||||||
|
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
|
||||||
|
<!ENTITY % general-entities SYSTEM "../general.ent">
|
||||||
|
%general-entities;
|
||||||
|
]>
|
||||||
|
|
||||||
|
<sect1 id="ch-intro-resources">
|
||||||
|
<?dbhtml filename="resources.html"?>
|
||||||
|
|
||||||
|
<title>Resources</title>
|
||||||
|
|
||||||
|
<sect2 id="ch-intro-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)
|
||||||
|
that is located at <ulink url="&faq-root;"/>.</para>
|
||||||
|
|
||||||
|
</sect2>
|
||||||
|
|
||||||
|
<sect2 id="ch-intro-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. If the FAQ does not solve
|
||||||
|
the problem you are having, the next step would be to search the mailing
|
||||||
|
lists at <ulink url="&lfs-root;search.html"/>.</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>
|
||||||
|
|
||||||
|
<!-- Remove until such time as we have our own News Server, JH 20060105
|
||||||
|
<sect2 id="ch-intro-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-intro-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>. The support channel is named
|
||||||
|
#LFS-support.</para>
|
||||||
|
|
||||||
|
</sect2>
|
||||||
|
|
||||||
|
<sect2 id="ch-intro-references">
|
||||||
|
<title>References</title>
|
||||||
|
|
||||||
|
<para>For additional information on the packages, useful tips are
|
||||||
|
available in the LFS Package Reference page located at <ulink
|
||||||
|
url="http://www.linuxfromscratch.org/~matthew/LFS-references.html"/>.</para>
|
||||||
|
|
||||||
|
</sect2>
|
||||||
|
|
||||||
|
<sect2 id="ch-intro-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;mirrors.html"/> for a list
|
||||||
|
of current mirrors.</para>
|
||||||
|
|
||||||
|
</sect2>
|
||||||
|
|
||||||
|
<sect2 id="ch-intro-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>
|
||||||
@ -81,7 +81,7 @@
|
|||||||
<para>There are several LFS mailing lists you may subscribe to if you
|
<para>There are several LFS mailing lists you may subscribe to if you
|
||||||
are in need of help, want to stay current with the latest developments,
|
are in need of help, want to stay current with the latest developments,
|
||||||
want to contribute to the project, and more. See <xref
|
want to contribute to the project, and more. See <xref
|
||||||
linkend="ch-scatter-maillists"/> for more
|
linkend="ch-intro-maillists"/> for more
|
||||||
information.</para>
|
information.</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
|
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user