source: chapter07/chroot.xml@ 7054cc6

11.3 11.3-rc1 12.0 12.0-rc1 12.1 12.1-rc1 bdubbs/gcc13 multilib renodr/libudev-from-systemd trunk xry111/arm64 xry111/arm64-12.0 xry111/clfs-ng xry111/loongarch xry111/loongarch-12.0 xry111/loongarch-12.1 xry111/mips64el xry111/update-glibc
Last change on this file since 7054cc6 was ebecd08, checked in by David Bryant <davidbryant@…>, 18 months ago

Corrected grammar, spelling, and idiom in chapter 7.

  • Property mode set to 100644
File size: 2.9 KB
Line 
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-tools-chroot">
9 <?dbhtml filename="chroot.html"?>
10
11 <title>Entering the Chroot Environment</title>
12
13 <para>Now that all the packages which are required to build the rest of the
14 needed tools are on the system, it is time to enter the chroot environment and
15 finish installing the temporary tools. This environment will also be
16 used to install the final system. As user <systemitem
17 class="username">root</systemitem>, run the following command to enter the
18 environment that is, at the moment, populated with nothing but temporary
19 tools:</para>
20
21<screen role="nodump"><userinput>chroot "$LFS" /usr/bin/env -i \
22 HOME=/root \
23 TERM="$TERM" \
24 PS1='(lfs chroot) \u:\w\$ ' \
25 PATH=/usr/bin:/usr/sbin \
26 /bin/bash --login</userinput></screen>
27
28 <para>The <parameter>-i</parameter> option given to the <command>env</command>
29 command will clear all the variables in the chroot environment. After that, only
30 the <envar>HOME</envar>, <envar>TERM</envar>, <envar>PS1</envar>, and
31 <envar>PATH</envar> variables are set again. The
32 <parameter>TERM=$TERM</parameter> construct sets the <envar>TERM</envar>
33 variable inside chroot to the same value as outside chroot. This variable is
34 needed so programs like <command>vim</command> and <command>less</command>
35 can operate properly. If other variables are desired, such as
36 <envar>CFLAGS</envar> or <envar>CXXFLAGS</envar>, this is a good place to set
37 them.</para>
38
39 <para>From this point on, there is no need to use the
40 <envar>LFS</envar> variable any more because all work will be restricted
41 to the LFS file system; the <command>chroot</command> command tells the Bash shell that
42 <filename class="directory">$LFS</filename> is now the root
43 (<filename class="directory">/</filename>) directory.</para>
44
45 <para>Notice that <filename class="directory">/tools/bin</filename> is not
46 in the <envar>PATH</envar>. This means that the cross toolchain will no longer be
47 used.</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-tools-bindmount"/> and <xref
59 linkend="ch-tools-kernfsmount"/> and enter chroot again before continuing
60 with the installation.</para>
61 </note>
62
63</sect1>
Note: See TracBrowser for help on using the repository browser.