From e5cd5e345f97ad9e7a4317f9da436098743679e9 Mon Sep 17 00:00:00 2001
From: Bruce Dubbs <bdubbs@linuxfromscratch.org>
Date: Tue, 17 May 2016 01:06:38 +0000
Subject: [PATCH] Add new section on resuming the LFS build after a reboot

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@11063 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
---
 chapter02/chapter02.xml |  1 +
 chapter02/stages.xml    | 82 +++++++++++++++++++++++++++++++++++++++++
 2 files changed, 83 insertions(+)
 create mode 100644 chapter02/stages.xml

diff --git a/chapter02/chapter02.xml b/chapter02/chapter02.xml
index 35d265bb7..39ed9ce59 100644
--- a/chapter02/chapter02.xml
+++ b/chapter02/chapter02.xml
@@ -13,6 +13,7 @@
 
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="introduction.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="hostreqs.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="stages.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="creatingpartition.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="creatingfilesystem.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="aboutlfs.xml"/>
diff --git a/chapter02/stages.xml b/chapter02/stages.xml
new file mode 100644
index 000000000..fd5792f7c
--- /dev/null
+++ b/chapter02/stages.xml
@@ -0,0 +1,82 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../general.ent">
+  %general-entities;
+]>
+
+<sect1 id="stages">
+  <?dbhtml filename="stages.html"?>
+
+  <title>Building LFS in Stages</title>
+
+  <para>LFS is designed to be built in one session.  That is, the
+  instructions assume that the system will not be shut down
+  during the process.  That does not mean that the system has to
+  be done in one sitting.  The issue is that certain procedures
+  have to be re-accomplished after a reboot if resuming LFS at
+  different points.</para>
+
+  <sect2>
+  <title>Chapters 1-4</title>
+
+    <para>These chapters are accomplished on the host system.  When
+    restarting, be careful of the following:</para>
+  
+    <itemizedlist>
+      <listitem>
+         <para>Procedures done as the root user after Section 2.4 need to 
+         have the LFS environment variable set <emphasis>FOR THE ROOT
+         USER</emphasis>.</para>
+      </listitem>
+    </itemizedlist>
+  </sect2>
+  
+  <sect2>
+  <title>Chapter 5</title>
+
+    <itemizedlist>
+      <listitem>
+         <para>The /mnt/lfs partition must be mounted.</para>
+      </listitem>
+
+      <listitem>
+         <para><emphasis>ALL</emphasis> instructions in Chapter 5 
+         must be done by user <emphasis>lfs</emphasis>.  
+         A  <command>su - lfs</command> needs to be done before any 
+         task in Chapter 5.</para>
+      </listitem>
+
+      <listitem>
+         <para>The procedures in <xref linkend='ch-tools-generalinstructions'/>
+         are critical.  If there is any
+         doubt about installing a package, ensure any previously expanded
+         tarballs are removed, re-extract the package files, and complete all
+         instructions in that section.</para>
+      </listitem>
+    </itemizedlist>
+  </sect2>
+
+  <sect2>
+  <title>Chapters 6-8</title>
+
+    <itemizedlist>
+      <listitem>
+         <para>The /mnt/lfs partition must be mounted.</para>
+      </listitem>
+
+      <listitem>
+         <para> When entering chroot, the LFS environment variable must be set
+         for root.  The LFS variable is not used otherwise.</para>
+      </listitem>
+
+      <listitem>
+         <para> The virtual file systems must be mounted.  This can be done
+         before or after entering chroot by changing to a host virtual terminal
+         and, as root, running the commands in 
+         <xref linkend='ch-system-bindmount'/> and 
+         <xref linkend='ch-system-kernfsmount'/>.</para>
+      </listitem>
+    </itemizedlist>
+  </sect2>
+</sect1>