aboutsummaryrefslogtreecommitdiffstats
path: root/chapter02/aboutlfs.xml
diff options
context:
space:
mode:
authorBruce Dubbs <bdubbs@linuxfromscratch.org>2014-06-11 04:57:05 +0000
committerBruce Dubbs <bdubbs@linuxfromscratch.org>2014-06-11 04:57:05 +0000
commit448e2261fb9720f0d5401d06f5a15fb8098c5e03 (patch)
tree30d5488d2df08bc0e5d839b2767b07537744d049 /chapter02/aboutlfs.xml
parent4ae2e7a4b215f7c367ccfe7b9d53a22c92eee492 (diff)
Text changes:
Move about LFS to Chapter 2. Add intor to Chapter 4. Explain why specific symlinks are needed in Chapter 6. Remove obsolete reference to old glibc version. git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@10575 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
Diffstat (limited to 'chapter02/aboutlfs.xml')
-rw-r--r--chapter02/aboutlfs.xml50
1 files changed, 50 insertions, 0 deletions
diff --git a/chapter02/aboutlfs.xml b/chapter02/aboutlfs.xml
new file mode 100644
index 000000000..fe8a97902
--- /dev/null
+++ b/chapter02/aboutlfs.xml
@@ -0,0 +1,50 @@
+<?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-aboutlfs">
+ <?dbhtml filename="aboutlfs.html"?>
+
+ <title>Setting The $LFS Variable</title>
+
+ <para>Throughout this book, the environment variable <envar>LFS</envar> will
+ be used several times. You should ensure that this variable is always defined
+ throughout the LFS build process. It should be set to the name of the
+ directory where you will be building your LFS system - we will use
+ <filename class="directory">/mnt/lfs</filename> as an example, but the
+ directory choice is up to you. If you are building LFS on a separate
+ partition, this directory will be the mount point for the partition.
+ Choose a directory location and set the variable with the
+ following command:</para>
+
+<screen role="nodump"><userinput>export LFS=<replaceable>/mnt/lfs</replaceable></userinput></screen>
+
+ <para>Having this variable set is beneficial in that commands such as
+ <command>mkdir -v $LFS/tools</command> can be typed literally. The shell
+ will automatically replace <quote>$LFS</quote> with
+ <quote>/mnt/lfs</quote> (or whatever the variable was set to) when it
+ processes the command line.</para>
+
+ <para>Do not forget to check that <envar>LFS</envar> is set whenever
+ you leave and reenter the current working environment (such as when doing a
+ <command>su</command> to <systemitem class="username">root</systemitem> or
+ another user). Check that the <envar>LFS</envar> variable is set up
+ properly with:</para>
+
+<screen role="nodump"><userinput>echo $LFS</userinput></screen>
+
+ <para>Make sure the output shows the path to your LFS system's build
+ location, which is <filename class="directory">/mnt/lfs</filename> if the
+ provided example was followed. If the output is incorrect, use the command
+ given earlier on this page to set <envar>$LFS</envar> to the correct
+ directory name.</para>
+
+ <note><para>One way to ensure that the <envar>LFS</envar> variable is always
+ set is to edit the <filename>.bash_profile</filename> file in both your
+ personal home directory and in <filename>/root/.bash_profile</filename> and
+ enter the export command above. </para></note>
+
+</sect1>