source: chapter02/stages.xml@ 67756f3

<?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="ch-partitioning-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&nbsp;1&ndash;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
        <systemitem class="username">root</systemitem> 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>Chapters&nbsp;5&ndash;6</title>

    <itemizedlist>
      <listitem>
        <para>The /mnt/lfs partition must be mounted.</para>
      </listitem>

      <listitem>
        <para>These two chapters <emphasis>must</emphasis> be done as user
        <systemitem class="username">lfs</systemitem>.
        A <command>su - lfs</command> command must be issued before any task in these
        chapters. If you don't do that, you are at risk of installing packages to the
        host, and potentially rendering it unusable.</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, then re-extract the package files, and complete all
         the instructions in that section.</para>
      </listitem>
    </itemizedlist>
  </sect2>

  <sect2>
  <title>Chapters&nbsp;7&ndash;10</title>

    <itemizedlist>
      <listitem>
         <para>The /mnt/lfs partition must be mounted.</para>
      </listitem>

      <listitem>
        <para>A few operations, from <quote>Changing Ownership</quote> to
        <quote>Entering the Chroot Environment</quote>, must be done as the
        <systemitem class="username">root</systemitem> user, with the LFS
        environment variable set for the &root; user.</para>
      </listitem>

      <listitem>
         <para> When entering chroot, the LFS environment variable must be set
         for <systemitem class="username">root</systemitem>. The LFS
         variable is not used after entering the chroot environment.</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 <systemitem class="username">root</systemitem>, running the
         commands in
         <xref linkend='ch-tools-bindmount'/> and
         <xref linkend='ch-tools-kernfsmount'/>.</para>
      </listitem>
    </itemizedlist>
  </sect2>
</sect1>