root/current/website/trunk/spanish/crosstools.wml

#use wml::emdebian::mainpage title="Cross-development toolchains"
#use wml::emdebian::recent_list
# #include "$(ENGLISHDIR)/releases/info"

<h2>Cross Toolchains</h2>

We provide a set of aptable tools built from standard Debian binutils and gcc sources. 
These provide cross-build toolchains from i386 to arm, mips, mipsel and powerpc 
targets currently. Others can easily be built if they are needed - please ask.
They are maintained by <a href="http://zigzag.lvk.cs.msu.su/~nikita">Nikita 
Youschenko</a>.

<h3>Download</h3>
<p>Currently binutils 2.15, gcc3.3.5 and 3.4.3 are provided, built for Debian stable.</p>

You just have to add this line to your /etc/apt/sources.list:</p>
<box>
\###################################### <br>
\# Emdebian tools<br>
\#<br>
deb http://www.emdebian.org/emdebian-tools/stable ./<br>
</box>
<br>

<p>Then do <b>apt-get update</b> to update your local lists.

<p><b><tt>apt-get install gcc-3.3-arm-linux
libc6-dev-arm-cross</tt></b> will install the gcc3.3 
toolchain for arm cross-compiling</p>

<p><b><tt>apt-get install gcc-3.4-arm-linux
libc6-dev-arm-cross</tt></b> for the 3.4 version</p>

<p>Another alternative you have is to use Slind toolchain
repository. This uses Nikita's patches plus Slind team
patches, check <a href="./slind.html">Slind webpage</a> for more information about
it. </p>

<box>
\#######################<br>
\# SLIND Toolchain<br>
deb http://www.emdebian.org/slind/host/ suffolk main<br>
deb-src http://www.emdebian.org/slind/host/ suffolk main<br>
</box>
<br>

<h3>Building your own</h3>

<p>Note that you have an <a
href="./docs/slind-toolchain.html">alternative
method</a> described by
Alexander Shiskin about building cross toolchains.</p>

<p>Below is documented the build process for building cross-toolchains the 
'Debian Way'. You only need to do this if the above bre-built tools 
do not satisfy your needs for some reason.</p>

<p>We use the <a href="./files/compbuildscript">compbuildscript</a>
to build the toolchains. 
This takes care of downloading the sources and patches, installing the 
necessary arch-specific packages (glibc, kernel headers), and building
the compilers. It is essentially a script implmenting what is described below.</p>

<p><a href="http://zigzag.lvk.cs.msu.su/~nikita/debian/cross-patches">These 
patches</a> to the debian sources are used for this build.</p>
<hr />

<p>Notation and exactly what things are called is important otherwise
there can be much confusion, so we will clarify: The building machine
is called the <b>build host</b> or <b>host</b> and the target device 
is referred toas the <b>target</b>. </p>

<p>Building your own toolchain is not a trivial matter, although this 
method is actually quite strightforward.</p>
<ul>
<li><dt><b> Install a binary toolchain </b></dt>
<dd>
<br>
<br>
</dd>
</li>
<li><dt><b> Install a toolchain from sources </b></dt>
<dd>

<p>
This one is valid for gcc-3.4 and should work with the following releases too, when the patches 
get accepted in mainstream Debian.</p>

<p>First get all the necessary build dependencies: </p>
<p>$ apt-get install dpkg-cross fakeroot dpatch autoconf2.13 gawk flex realpath automake1.7 debhelper cdbs <p/>
<p><h4>This is not a complete list, of course you need gcc, but these are the most often forgotten ones.</h4></p>
<p>Get the necessary sources :</p>
<p>$ apt-get source  gcc-3.4 binutils libc</p>
<p>Now you have to get the patch for binutils, which has not yet been accepted in Debian proper, at
<a href="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=231707">bugs.debian.org.</a>It can be found <a href="http://zigzag.lvk.cs.msu.su/~nikita/debian/cross-patches/binutils-cross-2.15-6.patch.20050707">here</a>
and it is called binutils-cross-2.15-6.patch. Apply it before building the binutils.</p>
<p>$ patch -p0 &lt binutils-cross-2.15-6.patch <br>
$ cd binutils-2.15 <br>
$ TARGET=arch-linux fakeroot debian/rules binary-cross (replace arch by arm, alpha,...)</p>
<p>Once the build is finished you have to install the package that was created with dpkg -i</p>
<p>For the next step you can use the existing Debian packages for your target architecture, after 
converting them with dpkg-cross, for the kernel-headers, and the related architectures</p>
<p>Find the packages for libdb1-compat, libc6, libc6-dev and linux-kernel-headers for your target architecture.
Either through packages.debian.org or a Debian mirror. Then convert and install them.</p>
<p>$ dpkg-cross -b -a arch package<br>
$ dpkg -i converted-package<br></p>
<p>When this process was succesful, we start with the last steps. We have to build 
the actual compiler. (note: gcc-3.3 needs an older flex than gcc-3.4)</p>
<p>
$ export GCC_TARGET=arch (replace arch trough arm, alpha,...)<br>
$ cd gcc-3.4-3.4.2<br>
$ debian/rules control<br>
$ dpkg-buildpackage -b -rfakeroot<br>
</p>
<p>After a succesful build, install the newly created gcc packages with dpkg -i package-name. 
These are (for arm): <ul> 
<li> libstdc++6-0-arm-cross_3.4.2-3_all.deb
<li>libstdc++6-0-dev-arm-cross_3.4.2-3_all.deb
<li>libstdc++6-0-dbg-arm-cross_3.4.2-3_all.deb
<li>libstdc++6-0-pic-arm-cross_3.4.2-3_all.deb, 
<li>g++-3.4-arm-linux_3.4.2-3_i386.deb
<li>gcc-3.4-arm-linux_3.4.2-3_i386.deb
<li>cpp-3.4-arm-linux_3.4.2-3_i386.deb
<li>libgcc1-arm-cross_3.4.2-3_all.deb. 
</ul><br>
Now you should have a brand new cross-compiler at your disposition.</p>

</dd>
</li>
</ul>
<p>Once build host is setted up, we've got a target device that is going to be used</p>