generalinstructions: Remove a false statement about "cp -R destroys symlink"
[lfs.git] / chapter02 / stages.xml
blobaeee2588e22511de9ca882b8f9476358f8b7d95e
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4   <!ENTITY % general-entities SYSTEM "../general.ent">
5   %general-entities;
6 ]>
8 <sect1 id="ch-partitioning-stages">
9   <?dbhtml filename="stages.html"?>
11   <title>Building LFS in Stages</title>
13   <para>LFS is designed to be built in one session.  That is, the
14   instructions assume that the system will not be shut down
15   during the process.  This does not mean that the system has to
16   be built in one sitting.  The issue is that certain procedures
17   must be repeated after a reboot when resuming LFS at
18   different points.</para>
20   <sect2>
21   <title>Chapters&nbsp;1&ndash;4</title>
23     <para>These chapters run commands on the host system.  When
24     restarting, be certain of one thing:</para>
26     <itemizedlist>
27       <listitem>
28         <para>Procedures performed as the
29         <systemitem class="username">root</systemitem> user after Section
30         2.4 must have the LFS environment variable set
31         <emphasis>FOR THE ROOT USER</emphasis>.</para>
32       </listitem>
33     </itemizedlist>
34   </sect2>
36   <sect2>
37   <title>Chapters&nbsp;5&ndash;6</title>
39     <itemizedlist>
40       <listitem>
41         <para>The /mnt/lfs partition must be mounted.</para>
42       </listitem>
44       <listitem>
45         <para>These two chapters <emphasis>must</emphasis> be done as user
46         <systemitem class="username">lfs</systemitem>.
47         A <command>su - lfs</command> command must be issued before performing any task in these
48         chapters. If you don't do that, you are at risk of installing packages to the
49         host, and potentially rendering it unusable.</para>
50       </listitem>
52       <listitem>
53          <para>The procedures in <xref linkend='ch-tools-generalinstructions'/>
54          are critical.  If there is any
55          doubt a package has been installed correctly, ensure the previously expanded
56          tarball has been removed, then re-extract the package, and complete all
57          the instructions in that section.</para>
58       </listitem>
59     </itemizedlist>
60   </sect2>
62   <sect2>
63   <title>Chapters&nbsp;7&ndash;10</title>
65     <itemizedlist>
66       <listitem>
67          <para>The /mnt/lfs partition must be mounted.</para>
68       </listitem>
70       <listitem>
71         <para>A few operations, from <quote>Changing Ownership</quote> to
72         <quote>Entering the Chroot Environment,</quote> must be done as the
73         <systemitem class="username">root</systemitem> user, with the LFS
74         environment variable set for the &root; user.</para>
75       </listitem>
77       <listitem>
78          <para> When entering chroot, the LFS environment variable must be set
79          for <systemitem class="username">root</systemitem>. The LFS
80          variable is not used after the chroot environment has been entered.</para>
81       </listitem>
83       <listitem>
84          <para> The virtual file systems must be mounted.  This can be done
85          before or after entering chroot by changing to a host virtual terminal
86          and, as <systemitem class="username">root</systemitem>, running the
87          commands in
88          <xref linkend='ch-tools-bindmount'/> and
89          <xref linkend='ch-tools-kernfsmount'/>.</para>
90       </listitem>
91     </itemizedlist>
92   </sect2>
93 </sect1>