chapter02/aboutlfs.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-partitioning-aboutlfs">
   9   <?dbhtml filename="aboutlfs.html"?>
  10
  11   <title>Setting The $LFS Variable</title>
  12
  13   <para>Throughout this book, the environment variable <envar>LFS</envar> will
  14   be used several times. You should ensure that this variable is always defined
  15   throughout the LFS build process. It should be set to the name of the
  16   directory where you will be building your LFS system - we will use
  17   <filename class="directory">/mnt/lfs</filename> as an example, but the
  18   directory choice is up to you. If you are building LFS on a separate
  19   partition, this directory will be the mount point for the partition.
  20   Choose a directory location and set the variable with the
  21   following command:</para>
  22
  23 <screen role="nodump"><userinput>export LFS=<replaceable>/mnt/lfs</replaceable></userinput></screen>
  24
  25   <para>Having this variable set is beneficial in that commands such as
  26   <command>mkdir -v $LFS/tools</command> can be typed literally. The shell
  27   will automatically replace <quote>$LFS</quote> with
  28   <quote>/mnt/lfs</quote> (or whatever the variable was set to) when it
  29   processes the command line.</para>
  30
  31   <para>Do not forget to check that <envar>LFS</envar> is set whenever
  32   you leave and reenter the current working environment (such as when doing a
  33   <command>su</command> to <systemitem class="username">root</systemitem> or
  34   another user). Check that the <envar>LFS</envar> variable is set up
  35   properly with:</para>
  36
  37 <screen role="nodump"><userinput>echo $LFS</userinput></screen>
  38
  39   <para>Make sure the output shows the path to your LFS system's build
  40   location, which is <filename class="directory">/mnt/lfs</filename> if the
  41   provided example was followed. If the output is incorrect, use the command
  42   given earlier on this  page to set <envar>$LFS</envar> to the correct
  43   directory name.</para>
  44
  45   <note><para>One way to ensure that the <envar>LFS</envar> variable is always
  46   set is to edit the <filename>.bash_profile</filename> file in both your
  47   personal home directory and in  <filename>/root/.bash_profile</filename> and
  48   enter the export command above.  </para></note>
  49
  50 </sect1>