source: chapter02/stages.xml@ 0ba2ee5a

<?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.  This does not mean that the system has to
  be built in one sitting.  The issue is that certain procedures
  must be repeated after a reboot when resuming LFS at
  different points.</para>

  <sect2>
  <title>Chapters&nbsp;1&ndash;4</title>

    <para>These chapters run commands on the host system.  When
    restarting, be certain of one thing:</para>

    <itemizedlist>
      <listitem>
        <para>Procedures performed as the
        <systemitem class="username">root</systemitem> user after Section
        2.4 must 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 performing 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 a package has been installed correctly, ensure the previously expanded
         tarball has been removed, then re-extract the package, 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 the chroot environment has been entered.</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>