source: chroot/common/chroot.xml@ b133767

Last change on this file since b133767 was bf8c11f, checked in by Jim Gifford <clfs@…>, 19 years ago

r627@server (orig r625): jim | 2005-10-31 12:59:34 -0800
Import of Cross-LFS Book

  • Property mode set to 100644
File size: 3.0 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6]>
7
8<sect1 id="ch-chroot-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
14 and installing the final LFS system. As user <systemitem
15 class="username">root</systemitem>, run the following command to
16 enter the realm that is, at the moment, populated with only the
17 temporary tools:</para>
18
19<screen><userinput>chroot "$LFS" /tools/bin/env -i \
20 HOME=/root TERM="$TERM" PS1='\u:\w\$ ' \
21 PATH=/bin:/usr/bin:/sbin:/usr/sbin:/tools/bin \
22 /tools/bin/bash --login +h</userinput></screen>
23
24 <para>The <parameter>-i</parameter> option given to the
25 <command>env</command> command will clear all variables of the chroot
26 environment. After that, only the <envar>HOME</envar>,
27 <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
30 <envar>TERM</envar> variable inside chroot to the same value as
31 outside chroot. This variable is needed for programs like
32 <command>vim</command> and <command>less</command> to operate
33 properly. If other variables are needed, such as
34 <envar>CFLAGS</envar> or <envar>CXXFLAGS</envar>, this is
35 a good place to set them again.</para>
36
37 <para>From this point on, there is no need to use the
38 <envar>LFS</envar> variable anymore, because all work will be
39 restricted to the LFS file system. This is because the Bash shell is
40 told that <filename class="directory">$LFS</filename> is now the root
41 (<filename class="directory">/</filename>) directory.</para>
42
43 <para>Notice that <filename class="directory">/tools/bin</filename> comes
44 last in the <envar>PATH</envar>. This means that a temporary tool will no
45 longer be used once its final version is installed. This occurs when the
46 shell does not <quote>remember</quote> the locations of executed
47 binaries&mdash;for this reason, hashing is switched off by passing the
48 <parameter>+h</parameter> option to <command>bash</command>.</para>
49
50 <para>It is important that all the commands throughout the remainder
51 of this chapter and the following chapters are run from within the
52 chroot environment. If you leave this environment for any reason
53 (rebooting for example), remember to first mount the <systemitem
54 class="filesystem">proc</systemitem> and <systemitem
55 class="filesystem">devpts</systemitem> file systems (discussed in the
56 previous section) and enter chroot again before continuing with the
57 installations.</para>
58
59 <para>Note that the <command>bash</command> prompt will say
60 <computeroutput>I have no name!</computeroutput> This is normal because the
61 <filename>/etc/passwd</filename> file has not been created yet.</para>
62
63</sect1>
Note: See TracBrowser for help on using the repository browser.