source: final-preps/creatingcrossdir.xml@ a0418f7

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../general.ent">
  %general-entities;
]>

<sect1 id="ch-final-preps-creatingcrossdir">
  <?dbhtml filename="creatingcrossdir.html"?>

  <title>Creating the $HOME/cross-tools Directory</title>

  <para>All programs compiled in <xref linkend="chapter-cross-tools"/> will
  be installed under <filename class="directory">$HOME/cross-tools</filename>
  to keep them separate from the host programs. The programs compiled here are
  cross tools and will not be a part of the final LFS system. By keeping these
  programs in a separate directory, they can easily be discarded later after
  their use.</para>

  <para>Create the required directory by running the following as
  the <systemitem class="username">lfs</systemitem> user:</para>

<screen><userinput>install -d $HOME/cross-tools</userinput></screen>

  <para>The next step is to create a <filename
  class="symlink">/cross-tools</filename> symlink on the host system.
  This will point to the newly-created directory in your home directory.
  Since normal users will not have permissions to write to the root tree,
  we need to exit the <command>su</command> and run the symlink command as
  <systemitem class="username">root</systemitem>:</para>

<screen><userinput>exit
LFSHOME=`su - lfs -c 'echo $HOME'`
ln -s $LFSHOME/cross-tools /
unset LFSHOME
su - lfs</userinput></screen>

  <para>TO BE REWRITTEN - The created symlink enables the toolchain to be
  compiled so that
  it always refers to <filename class="directory">/cross-tools</filename>,
  meaning that the compiler, assembler, and linker will work both in
  this chapter and this host architecture and in the next (when we are
  <quote>chrooted</quote> to the LFS partition).</para>

</sect1>