source: final-preps/creatingcrossdir.xml@ 496be96

<?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 $LFS/cross-tools Directory</title>

  <para>All programs compiled in <xref linkend="chapter-cross-tools"/> will
  be installed under <filename class="directory">$LFS/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
  <systemitem class="username">root</systemitem>:</para>

<screen><userinput>install -d $LFS/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>ln -s $LFS/cross-tools /</userinput></screen>

  <para>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 be avaialble for
  use later if some unforseen circumstances happen.</para>

</sect1>