source: cross-tools/common/variables.xml@ 9a636be

<?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-cross-tools-variables">
  <?dbhtml filename="variables.html"?>

  <title>Build Variables</title>

  <bridgehead renderas="sect4">Configuration # 1 - Creating different
  architecture tools</bridgehead>

  <para os="a">This method is recommended for all LiveCD based distro's.</para>

  <para os="b">During the building of the cross-compile tools you will need to
  set a few variables that will be dependent on your particular needs.
  The first variable will be the triplet of the <envar>HOST</envar> machine.
  You will need to set the <envar>CHOST</envar> triplet to match your
  particular needs. To set this information you can issue the following
  command:</para>

<screen os="c"><userinput>export LFS_HOST="${MACHTYPE}"</userinput></screen>

  <para os="d">Now you will need to set the target triplet for the target
  architecture. You can do this by running the same command as above, just
  running it on the target machine. If you can't run the command on the
  target machine, you can use the table at the bottom of this page. Set
  the command using the method listed below:</para>

<screen os="e"><userinput>export LFS_TARGET="{target triplet}"</userinput></screen>

  <bridgehead renderas="sect4">Configuration # 2 - Creating same
  architecture tools</bridgehead>

  <para os="f">You can also create <quote>clean</quote> tools on your current
  distro. This will ensure that you have all the prerequisites for the
  LFS build.</para>

  <para os="g">You will need to set your host target triplet a little differently.
  To set this information you can issue the following commands:</para>

<screen os="h"><userinput>export LFS_HOST="`echo ${MACHTYPE} | sed -e 's/unknown/cross/g' -e 's/-pc-/-cross-/g'`"</userinput></screen>

  <para os="i">Now you will need to set the target triplet for the target, which
  in this case is very simple. Set the command using the method listed
  below:</para>

<screen os="j"><userinput>export LFS_TARGET="${MACHTYPE}"</userinput></screen>

  <bridgehead renderas="sect4">Sanity Check</bridgehead>

  <para os="k">Let's perform a sanity check to prevent build issues. If our LFS_HOST matches our
  target, we will get some failures during our cross-compile:</para>

<screen os="l"><userinput>if [ "${LFS_HOST}" = "${LFS_TARGET}" ]; then \
  echo "Host and Target can't be the same." ; fi</userinput></screen>
 
  <para os="m">If you received an message, "Host and Target can't be the same."
  You will need to use the other Configuration Method. This will prevent build
  issues during the early phases of the build.</para>

  <bridgehead renderas="sect4">Copy settings to Environment</bridgehead>

  <para os="n">Now we will add these to <filename>~/.bashrc</filename>, just in
  case you have to exit and restart building later:</para>

<screen os="o"><userinput>echo export LFS_HOST=\""${LFS_HOST}\"" &gt;&gt; ~/.bashrc
echo export LFS_TARGET=\""${LFS_TARGET}\"" &gt;&gt; ~/.bashrc</userinput></screen>

  <table os="p">
    <title>List of architectures, target triplets, and recommended book</title>
    <tgroup cols="2" align="center">
      <colspec colname="Processor"/>
      <colspec colname="Triplet"/>
      <colspec colname="Book"/>
      <thead>
        <row>
          <entry>Architecture</entry>
          <entry>Target Triplet</entry>
          <entry>32 Bit, 64 Bit, 32/64 Bit</entry>
        </row>
      </thead>
      <tbody>
        <row>
          <entry>Pentium, K6, 586 Compatibles</entry>
          <entry>i586-pc-linux-gnu</entry>
          <entry>32 Bit</entry>
        </row>
        <row>
          <entry>Pentium II, Pentium III, Pentium 4</entry>
          <entry>i686-pc-linux-gnu</entry>
          <entry>32 Bit</entry>
        </row>
        <row>
          <entry>Athlon, Duron</entry>
          <entry>i686-pc-linux-gnu</entry>
          <entry>32 Bit</entry>
        </row>
        <row>
          <entry>Athlon64</entry>
          <entry>x86_64-pc-linux-gnu</entry>
          <entry>32/64 Bit</entry>
        </row>
        <row>
          <entry>PowerPC</entry>
          <entry>powerpc-unknown-linux-gnu</entry>
          <entry>32 Bit</entry>
        </row>
        <row>
          <entry>PowerPC64</entry>
          <entry>ppc64-unknown-linux-gnu</entry>
          <entry>64 Bit</entry>
        </row>
        <row>
          <entry>MIPS</entry>
          <entry>mips-unknown-linux-gnu</entry>
          <entry>32 Bit</entry>
        </row>
        <row>
          <entry>MIPS Little Endian</entry>
          <entry>mipsel-unknown-linux-gnu</entry>
          <entry>32 Bit</entry>
        </row>
        <row>
          <entry>MIPS 64</entry>
          <entry>mips64-unknown-linux-gnu</entry>
          <entry>64 Bit</entry>
        </row>
        <row>
          <entry>MIPS 64 Little Endian</entry>
          <entry>mips64el-unknown-linux-gnu</entry>
          <entry>64 Bit</entry>
        </row>
        <row>
          <entry>Cypress</entry>
          <entry>sparc-unknown-linux-gnu</entry>
          <entry>32 Bit</entry>
        </row>
        <row>
          <entry>Supersparc and Hypersparc</entry>
          <entry>sparc-unknown-linux-gnu</entry>
          <entry>32 Bit</entry>
        </row>
        <row>
          <entry>Ultrasparc</entry>
          <entry>sparc64-unknown-linux-gnu</entry>
          <entry>32/64 Bit</entry>
        </row>
        <row>
          <entry>Alpha</entry>
          <entry>alpha-unknown-linux-gnu</entry>
          <entry>64 Bit</entry>
        </row>
      </tbody>
    </tgroup>
  </table>

</sect1>