gronod/lfs
1
0
Fork 0
mirror of https://git.linuxfromscratch.org/lfs.git synced 2025-06-19 03:39: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"?>
<!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">
%general-entities;
]>
<chapter id="chapter-bootable" xreflabel="Chapter 8">
<?dbhtml dir="chapter08"?>
<title>Making the LFS System Bootable</title>
<?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="fstab.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"?>
<!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">
%general-entities;
]>
<sect1 id="ch-bootable-fstab">
<title>Creating the /etc/fstab File</title>
<?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
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>
<para>This option will only work if <quote>Support for Host-side USB</quote> and
<quote>USB device filesystem</quote> are configured in the kernel. If
<para>This option will only work if <quote>Support for Host-side USB</quote>
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
<filename>usbcore</filename> must be listed in
<filename>/etc/sysconfig/modules</filename>.</para>
</sect1>

36
chapter08/grub.xml
View File

@ -1,15 +1,19 @@
<?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">
%general-entities;
]>
<sect1 id="ch-bootable-grub">
<title>Making the LFS System Bootable</title>
<?dbhtml filename="grub.html"?>
<title>Making the LFS System Bootable</title>
<indexterm zone="ch-bootable-grub">
<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
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>
<warning><para>The following command will overwrite the current boot
loader. Do not run the command if this is not desired, for example, if
using a third party boot manager to manage the Master Boot Record
(MBR). In this scenario, it would make more sense to install
GRUB into the <quote>boot sector</quote> of the LFS partition. In this
case, this next command would become <userinput>setup
(hd0,3)</userinput>.</para></warning>
<warning>
<para>The following command will overwrite the current boot loader. Do not
run the command if this is not desired, for example, if using a third party
boot manager to manage the Master Boot Record (MBR). In this scenario, it
would make more sense to install GRUB into the <quote>boot sector</quote>
of the LFS partition. In this case, this next command would become
<userinput>setup (hd0,3)</userinput>.</para>
</warning>
<para>Tell GRUB to install itself into the MBR of
<filename class="partition">hda</filename>:</para>
@ -121,16 +126,15 @@ rootnoverify (hd0,0)
chainloader +1</literal>
EOF</userinput></screen>
<para>If <command>info grub</command> does not provide all necessary material, additional
information regarding GRUB is located on its website at:
<para>If <command>info grub</command> does not provide all necessary material,
additional information regarding GRUB is located on its website at:
<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
<filename class="symlink">/etc/grub/menu.lst</filename>. To satisfy this requirement, issue the
following command:</para>
<para>The FHS stipulates that GRUB's <filename>menu.lst</filename> file should
be symlinked to <filename class="symlink">/etc/grub/menu.lst</filename>. To
satisfy this requirement, issue the following command:</para>
<screen><userinput>mkdir -v /etc/grub &amp;&amp;
ln -sv /boot/grub/menu.lst /etc/grub</userinput></screen>
</sect1>

8
chapter08/introduction.xml
View File

@ -1,16 +1,18 @@
<?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">
%general-entities;
]>
<sect1 id="ch-bootable-introduction">
<title>Introduction</title>
<?dbhtml filename="introduction.html"?>
<title>Introduction</title>
<para>It is time to make the LFS system bootable. This chapter
discusses creating an <filename>fstab</filename> file, building a
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>
</sect1>

91
chapter08/kernel.xml
View File

@ -1,37 +1,52 @@
<?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">
%general-entities;
]>
<sect1 id="ch-bootable-kernel" role="wrap">
<title>Linux-&linux-version;</title>
<?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>
<segmentedlist>
<segtitle>&buildtime;</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>
<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>
</sect2>
<sect2 role="installation">
<title>Installation of the kernel</title>
<para>Building the kernel involves a few steps&mdash;configuration, compilation,
and installation. Read the <filename>README</filename> file in the kernel source
tree for alternative methods to the way this book configures the kernel.</para>
<para>Building the kernel involves a few steps&mdash;configuration,
compilation, and installation. Read the <filename>README</filename> file
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>
@ -58,9 +73,9 @@ url="&blfs-root;view/svn/longindex.html#kernel-config-index"/>:</para>
<screen role="nodump"><userinput>make menuconfig</userinput></screen>
<para>Alternatively, <command>make oldconfig</command> may be more appropriate in some
situations. See the <filename>README</filename> file for more
information.</para>
<para>Alternatively, <command>make oldconfig</command> may be more
appropriate in some situations. See the <filename>README</filename>
file for more information.</para>
<para>If desired, skip kernel configuration by copying the kernel
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
scratch.</para>
<note><para>NPTL requires the kernel to be compiled with GCC-3.x or later, in this case
&gcc-version;. It is not recommended to compile the kernel with GCC-2.95.x, as
this causes failures in the Glibc test suite. Normally, this wouldn't be
mentioned as LFS doesn't build GCC-2.95.x. Unfortunately, the kernel
documentation is outdated and still claims GCC-2.95.3 is the recommended
compiler.</para></note>
<note>
<para>NPTL requires the kernel to be compiled with GCC-3.x or later, in
this case &gcc-version;. It is not recommended to compile the kernel with
GCC-2.95.x, as this causes failures in the Glibc test suite. Normally,
this wouldn't be mentioned as LFS doesn't build GCC-2.95.x. Unfortunately,
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>
@ -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
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
strongly recommend starting with a completely non-modular kernel
@ -147,7 +164,8 @@ source.</para>
class="directory">linux-&linux-version;</filename> directory to ensure
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
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
@ -158,20 +176,26 @@ complete.</para>
<filename class="directory">include</filename> directory should
<emphasis>always</emphasis> be the ones against which Glibc was compiled,
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 id="contents-kernel" role="content"><title>Contents of Linux</title>
<sect2 id="contents-kernel" role="content">
<title>Contents of Linux</title>
<segmentedlist>
<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>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
@ -179,7 +203,9 @@ and System.map-&linux-version;</seg></seglistitem>
<term><filename>config-&linux-version;</filename></term>
<listitem>
<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>
</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
software and turns a single CPU into a multitasking machine capable
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>
</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
addresses of all the functions and data structures in the
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>
</varlistentry>
</variablelist>
</sect2>