gronod/lfs
1
0
Fork 0
mirror of https://git.linuxfromscratch.org/lfs.git synced 2025-06-19 11:49:20 +01:00
Code Issues Packages Projects Releases Wiki Activity

Chapter08 indentation.

Browse Source 
git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@7229 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
This commit is contained in:
Manuel Canales Esparcia 2005-12-18 13:44:24 +00:00
parent 7686ca6aae
commit b78c7479d4
5 changed files with 315 additions and 271 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
chapter08/chapter08.xml
View File

@ -1,13 +1,16 @@
<?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-bootable" xreflabel="Chapter 8"> <chapter id="chapter-bootable" xreflabel="Chapter 8">
<?dbhtml dir="chapter08"?> <?dbhtml dir="chapter08"?>
<title>Making the LFS System Bootable</title>
<?dbhtml filename="chapter08.html"?> <?dbhtml filename="chapter08.html"?>
<title>Making the LFS System Bootable</title>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="introduction.xml"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="introduction.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="fstab.xml"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="fstab.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="kernel.xml"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="kernel.xml"/>

16
chapter08/fstab.xml
View File

@ -1,13 +1,18 @@
<?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-bootable-fstab"> <sect1 id="ch-bootable-fstab">
<title>Creating the /etc/fstab File</title>
<?dbhtml filename="fstab.html"?> <?dbhtml filename="fstab.html"?>
<indexterm zone="ch-bootable-fstab"><primary sortas="e-/etc/fstab">/etc/fstab</primary></indexterm> <title>Creating the /etc/fstab File</title>
<indexterm zone="ch-bootable-fstab">
<primary sortas="e-/etc/fstab">/etc/fstab</primary>
</indexterm>
<para>The <filename>/etc/fstab</filename> file is used by some programs to <para>The <filename>/etc/fstab</filename> file is used by some programs to
determine where file systems are to be mounted by default, in which order, and determine where file systems are to be mounted by default, in which order, and
@ -54,11 +59,10 @@ devices:</para>
<screen>usbfs /proc/bus/usb usbfs devgid=14,devmode=0660 0 0 </screen> <screen>usbfs /proc/bus/usb usbfs devgid=14,devmode=0660 0 0 </screen>
<para>This option will only work if <quote>Support for Host-side USB</quote> and <para>This option will only work if <quote>Support for Host-side USB</quote>
<quote>USB device filesystem</quote> are configured in the kernel. If and <quote>USB device filesystem</quote> are configured in the kernel. If
<quote>Support for Host-side USB</quote> is compiled as a module, then <quote>Support for Host-side USB</quote> is compiled as a module, then
<filename>usbcore</filename> must be listed in <filename>usbcore</filename> must be listed in
<filename>/etc/sysconfig/modules</filename>.</para> <filename>/etc/sysconfig/modules</filename>.</para>
</sect1> </sect1>

36
chapter08/grub.xml
View File

@ -1,15 +1,19 @@
<?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-bootable-grub"> <sect1 id="ch-bootable-grub">
<title>Making the LFS System Bootable</title>
<?dbhtml filename="grub.html"?> <?dbhtml filename="grub.html"?>
<title>Making the LFS System Bootable</title>
<indexterm zone="ch-bootable-grub"> <indexterm zone="ch-bootable-grub">
<primary sortas="a-Grub">GRUB</primary> <primary sortas="a-Grub">GRUB</primary>
<secondary>configuring</secondary></indexterm> <secondary>configuring</secondary>
</indexterm>
<para>Your shiny new LFS system is almost complete. One of the last <para>Your shiny new LFS system is almost complete. One of the last
things to do is to ensure that the system can be properly booted. The things to do is to ensure that the system can be properly booted. The
@ -63,13 +67,14 @@ everywhere to make GRUB show the alternatives:</para>
<screen><userinput>root (hd0,3)</userinput></screen> <screen><userinput>root (hd0,3)</userinput></screen>
<warning><para>The following command will overwrite the current boot <warning>
loader. Do not run the command if this is not desired, for example, if <para>The following command will overwrite the current boot loader. Do not
using a third party boot manager to manage the Master Boot Record run the command if this is not desired, for example, if using a third party
(MBR). In this scenario, it would make more sense to install boot manager to manage the Master Boot Record (MBR). In this scenario, it
GRUB into the <quote>boot sector</quote> of the LFS partition. In this would make more sense to install GRUB into the <quote>boot sector</quote>
case, this next command would become <userinput>setup of the LFS partition. In this case, this next command would become
(hd0,3)</userinput>.</para></warning> <userinput>setup (hd0,3)</userinput>.</para>
</warning>
<para>Tell GRUB to install itself into the MBR of <para>Tell GRUB to install itself into the MBR of
<filename class="partition">hda</filename>:</para> <filename class="partition">hda</filename>:</para>
@ -121,16 +126,15 @@ rootnoverify (hd0,0)
chainloader +1</literal> chainloader +1</literal>
EOF</userinput></screen> EOF</userinput></screen>
<para>If <command>info grub</command> does not provide all necessary material, additional <para>If <command>info grub</command> does not provide all necessary material,
information regarding GRUB is located on its website at: additional information regarding GRUB is located on its website at:
<ulink url="http://www.gnu.org/software/grub/"/>.</para> <ulink url="http://www.gnu.org/software/grub/"/>.</para>
<para>The FHS stipulates that GRUB's <filename>menu.lst</filename> file should be symlinked to <para>The FHS stipulates that GRUB's <filename>menu.lst</filename> file should
<filename class="symlink">/etc/grub/menu.lst</filename>. To satisfy this requirement, issue the be symlinked to <filename class="symlink">/etc/grub/menu.lst</filename>. To
following command:</para> satisfy this requirement, issue the following command:</para>
<screen><userinput>mkdir -v /etc/grub &amp;&amp; <screen><userinput>mkdir -v /etc/grub &amp;&amp;
ln -sv /boot/grub/menu.lst /etc/grub</userinput></screen> ln -sv /boot/grub/menu.lst /etc/grub</userinput></screen>
</sect1> </sect1>

8
chapter08/introduction.xml
View File

@ -1,16 +1,18 @@
<?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-bootable-introduction"> <sect1 id="ch-bootable-introduction">
<title>Introduction</title>
<?dbhtml filename="introduction.html"?> <?dbhtml filename="introduction.html"?>
<title>Introduction</title>
<para>It is time to make the LFS system bootable. This chapter <para>It is time to make the LFS system bootable. This chapter
discusses creating an <filename>fstab</filename> file, building a discusses creating an <filename>fstab</filename> file, building a
kernel for the new LFS system, and installing the GRUB boot loader so kernel for the new LFS system, and installing the GRUB boot loader so
that the LFS system can be selected for booting at startup.</para> that the LFS system can be selected for booting at startup.</para>
</sect1> </sect1>

91
chapter08/kernel.xml
View File

@ -1,37 +1,52 @@
<?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-bootable-kernel" role="wrap"> <sect1 id="ch-bootable-kernel" role="wrap">
<title>Linux-&linux-version;</title>
<?dbhtml filename="kernel.html"?> <?dbhtml filename="kernel.html"?>
<indexterm zone="ch-bootable-kernel"><primary sortas="a-Linux">Linux</primary></indexterm> <title>Linux-&linux-version;</title>
<indexterm zone="ch-bootable-kernel">
<primary sortas="a-Linux">Linux</primary>
</indexterm>
<sect2 role="package">
<title/>
<sect2 role="package"><title/>
<para>The Linux package contains the Linux kernel.</para> <para>The Linux package contains the Linux kernel.</para>
<segmentedlist> <segmentedlist>
<segtitle>&buildtime;</segtitle> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle> <segtitle>&diskspace;</segtitle>
<seglistitem><seg>4.20 SBU</seg>
<seg>181 MB</seg></seglistitem> <seglistitem>
<seg>4.20 SBU</seg>
<seg>181 MB</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<segmentedlist> <segmentedlist>
<segtitle>&dependencies;</segtitle> <segtitle>&dependencies;</segtitle>
<seglistitem><seg>Bash, Binutils, Coreutils, Findutils,
GCC, Glibc, Grep, Gzip, Make, Modutils, Perl, and Sed</seg></seglistitem> <seglistitem>
<seg>Bash, Binutils, Coreutils, Findutils, GCC, Glibc, Grep, Gzip,
Make, Modutils, Perl, and Sed</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
</sect2> </sect2>
<sect2 role="installation"> <sect2 role="installation">
<title>Installation of the kernel</title> <title>Installation of the kernel</title>
<para>Building the kernel involves a few steps&mdash;configuration, compilation, <para>Building the kernel involves a few steps&mdash;configuration,
and installation. Read the <filename>README</filename> file in the kernel source compilation, and installation. Read the <filename>README</filename> file
tree for alternative methods to the way this book configures the kernel.</para> in the kernel source tree for alternative methods to the way this book
configures the kernel.</para>
<para>Prepare for compilation by running the following command:</para> <para>Prepare for compilation by running the following command:</para>
@ -58,9 +73,9 @@ url="&blfs-root;view/svn/longindex.html#kernel-config-index"/>:</para>
<screen role="nodump"><userinput>make menuconfig</userinput></screen> <screen role="nodump"><userinput>make menuconfig</userinput></screen>
<para>Alternatively, <command>make oldconfig</command> may be more appropriate in some <para>Alternatively, <command>make oldconfig</command> may be more
situations. See the <filename>README</filename> file for more appropriate in some situations. See the <filename>README</filename>
information.</para> file for more information.</para>
<para>If desired, skip kernel configuration by copying the kernel <para>If desired, skip kernel configuration by copying the kernel
config file, <filename>.config</filename>, from the host system config file, <filename>.config</filename>, from the host system
@ -70,12 +85,14 @@ we do not recommend this option. It is often better to explore all the
configuration menus and create the kernel configuration from configuration menus and create the kernel configuration from
scratch.</para> scratch.</para>
<note><para>NPTL requires the kernel to be compiled with GCC-3.x or later, in this case <note>
&gcc-version;. It is not recommended to compile the kernel with GCC-2.95.x, as <para>NPTL requires the kernel to be compiled with GCC-3.x or later, in
this causes failures in the Glibc test suite. Normally, this wouldn't be this case &gcc-version;. It is not recommended to compile the kernel with
mentioned as LFS doesn't build GCC-2.95.x. Unfortunately, the kernel GCC-2.95.x, as this causes failures in the Glibc test suite. Normally,
documentation is outdated and still claims GCC-2.95.3 is the recommended this wouldn't be mentioned as LFS doesn't build GCC-2.95.x. Unfortunately,
compiler.</para></note> the kernel documentation is outdated and still claims GCC-2.95.3 is the
recommended compiler.</para>
</note>
<para>Compile the kernel image and modules:</para> <para>Compile the kernel image and modules:</para>
@ -96,7 +113,7 @@ all modules are detectable by Hotplug. Note that statements like the one below
in the <filename>/etc/modprobe.conf</filename> file do not work with in the <filename>/etc/modprobe.conf</filename> file do not work with
Udev:</para> Udev:</para>
<para><screen>alias char-major-XXX some-module</screen></para> <screen><literal>alias char-major-XXX some-module</literal></screen>
<para>Because of the complications with Hotplug, Udev, and modules, we <para>Because of the complications with Hotplug, Udev, and modules, we
strongly recommend starting with a completely non-modular kernel strongly recommend starting with a completely non-modular kernel
@ -147,7 +164,8 @@ source.</para>
class="directory">linux-&linux-version;</filename> directory to ensure class="directory">linux-&linux-version;</filename> directory to ensure
all files are owned by user <emphasis>root</emphasis>.</para> all files are owned by user <emphasis>root</emphasis>.</para>
<warning><para>Some kernel documentation recommends creating a symlink from <warning>
<para>Some kernel documentation recommends creating a symlink from
<filename class="symlink">/usr/src/linux</filename> pointing to the kernel <filename class="symlink">/usr/src/linux</filename> pointing to the kernel
source directory. This is specific to kernels prior to the 2.6 series and source directory. This is specific to kernels prior to the 2.6 series and
<emphasis>must not</emphasis> be created on an LFS system as it can cause <emphasis>must not</emphasis> be created on an LFS system as it can cause
@ -158,20 +176,26 @@ complete.</para>
<filename class="directory">include</filename> directory should <filename class="directory">include</filename> directory should
<emphasis>always</emphasis> be the ones against which Glibc was compiled, <emphasis>always</emphasis> be the ones against which Glibc was compiled,
that is, the ones from the Linux-Libc-Headers package, and therefore, should that is, the ones from the Linux-Libc-Headers package, and therefore, should
<emphasis>never</emphasis> be replaced by the kernel headers.</para></warning> <emphasis>never</emphasis> be replaced by the kernel headers.</para>
</warning>
</sect2> </sect2>
<sect2 id="contents-kernel" role="content"><title>Contents of Linux</title> <sect2 id="contents-kernel" role="content">
<title>Contents of Linux</title>
<segmentedlist> <segmentedlist>
<segtitle>Installed files</segtitle> <segtitle>Installed files</segtitle>
<seglistitem><seg>config-&linux-version;, lfskernel-&linux-version;,
and System.map-&linux-version;</seg></seglistitem> <seglistitem>
<seg>config-&linux-version;, lfskernel-&linux-version;, and
System.map-&linux-version;</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> <variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?> <?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?> <?dbhtml list-presentation="table"?>
@ -179,7 +203,9 @@ and System.map-&linux-version;</seg></seglistitem>
<term><filename>config-&linux-version;</filename></term> <term><filename>config-&linux-version;</filename></term>
<listitem> <listitem>
<para>Contains all the configuration selections for the kernel</para> <para>Contains all the configuration selections for the kernel</para>
<indexterm zone="ch-bootable-kernel config"><primary sortas="e-/boot/config">/boot/config-&linux-version;</primary></indexterm> <indexterm zone="ch-bootable-kernel config">
<primary sortas="e-/boot/config">/boot/config-&linux-version;</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -192,7 +218,9 @@ It detects and initializes all components of the computer's hardware,
then makes these components available as a tree of files to the then makes these components available as a tree of files to the
software and turns a single CPU into a multitasking machine capable software and turns a single CPU into a multitasking machine capable
of running scores of programs seemingly at the same time</para> of running scores of programs seemingly at the same time</para>
<indexterm zone="ch-bootable-kernel lfskernel"><primary sortas="b-lfskernel">lfskernel-&linux-version;</primary></indexterm> <indexterm zone="ch-bootable-kernel lfskernel">
<primary sortas="b-lfskernel">lfskernel-&linux-version;</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -202,9 +230,12 @@ of running scores of programs seemingly at the same time</para>
<para>A list of addresses and symbols; it maps the entry points and <para>A list of addresses and symbols; it maps the entry points and
addresses of all the functions and data structures in the addresses of all the functions and data structures in the
kernel</para> kernel</para>
<indexterm zone="ch-bootable-kernel System.map"><primary sortas="e-/boot/System.map">/boot/System.map-&linux-version;</primary></indexterm> <indexterm zone="ch-bootable-kernel System.map">
<primary sortas="e-/boot/System.map">/boot/System.map-&linux-version;</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </sect2>