BOOK/chapter06/chroot.xml

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   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 ]>
   7
   8 <sect1 id="ch-system-chroot">
   9   <?dbhtml filename="chroot.html"?>
  10
  11   <title>Entering the Chroot Environment</title>
  12
  13   <para>It is time to enter the chroot environment to begin building and
  14   installing the final LFS system. As user <systemitem
  15   class="username">root</systemitem>, run the following command to enter the
  16   realm that is, at the moment, populated with only the temporary tools:</para>
  17
  18 <screen role="nodump"><userinput>chroot "$LFS" /tools/bin/env -i \
  19     HOME=/root                  \
  20     TERM="$TERM"                \
  21     PS1='\u:\w\$ '              \
  22     PATH=/bin:/usr/bin:/sbin:/usr/sbin:/tools/bin \
  23     /tools/bin/bash --login +h</userinput></screen>
  24
  25   <para>The <parameter>-i</parameter> option given to the <command>env</command>
  26   command will clear all variables of the chroot environment. After that, only
  27   the <envar>HOME</envar>, <envar>TERM</envar>, <envar>PS1</envar>, and
  28   <envar>PATH</envar> variables are set again. The
  29   <parameter>TERM=$TERM</parameter> construct will set the <envar>TERM</envar>
  30   variable inside chroot to the same value as outside chroot. This variable is
  31   needed for programs like <command>vim</command> and <command>less</command>
  32   to operate properly.  If other variables are needed, such as
  33   <envar>CFLAGS</envar> or <envar>CXXFLAGS</envar>, this is a good place to set
  34   them again.</para>
  35
  36   <para>From this point on, there is no need to use the
  37   <envar>LFS</envar> variable anymore, because all work will be restricted
  38   to the LFS file system.  This is because the Bash shell is told that
  39   <filename class="directory">$LFS</filename> is now the root
  40   (<filename class="directory">/</filename>) directory.</para>
  41
  42   <para>Notice that <filename class="directory">/tools/bin</filename> comes last
  43   in the <envar>PATH</envar>. This means that a temporary tool will no longer be
  44   used once its final version is installed. This occurs when the shell does not
  45   <quote>remember</quote> the locations of executed binaries&mdash;for this
  46   reason, hashing is switched off by passing the <parameter>+h</parameter> option
  47   to <command>bash</command>.</para>
  48
  49   <para>Note that the <command>bash</command> prompt will say
  50   <computeroutput>I have no name!</computeroutput> This is normal because the
  51   <filename>/etc/passwd</filename> file has not been created yet.</para>
  52
  53   <note>
  54     <para>It is important that all the commands throughout the remainder of this
  55     chapter and the following chapters are run from within the chroot
  56     environment. If you leave this environment for any reason (rebooting for
  57     example), ensure that the virtual kernel filesystems are mounted as
  58     explained in <xref linkend="ch-system-bindmount"/> and <xref
  59     linkend="ch-system-kernfsmount"/> and enter chroot again before continuing
  60     with the installation.</para>
  61   </note>
  62
  63 </sect1>