Differences between revisions 14 and 16 (spanning 2 versions)
Revision 14 as of 2009-04-05 03:28:13
Size: 5211
Editor: HectorOron
Comment: add cross libraries chapter
Revision 16 as of 2010-12-29 18:54:31
Size: 6098
Comment: add notes while going through this
Deletions are marked like this. Additions are marked like this.
Line 6: Line 6:
so you may well just be able to apt-get what you need on their Toolchains page: http://www.emdebian.org/tools/crosstools.html . They also maintain scripts which effectively do what this page describes. Take a look at the emdebian-tools package (the 'emchain' utility will build a current cross-toolchain), and 'buildcross', which will build a whole range of toolchains. so you may well just be able to apt-get what you need on their Toolchains page: http://www.emdebian.org/tools/crosstools.html . They also maintain scripts which effectively do what this page describes. Take a look at the 'buildcross' package from Debian experimental, which will build a whole range of toolchains.
Line 11: Line 11:

==== Notes for Debian unstable ====

We build {{{gcc-4.4}}} whose cross package additionally build-depends on {{{gcc-4.4-source}}} which you henceforth must install.

The package {{{linux-kernel-headers}}} is now called {{{linux-libc-dev}}} instead.

The three packages {{{libc6-dev}}}, {{{libc6}}}, {{{linux-libc-dev}}} have additional dependencies, so you need to get the (native for the target arch) {{{gcc-4.4-base}}}, {{{libc-bin}}}, {{{libc-dev-bin}}} and {{{libgcc2}}} (libgcc1, libgcc4, whatever your target needs) packages additionally. Now, {{{dpkg-cross}}} refuses to convert those without “any useful files”, so you need to pass the -A option in addition to -b and -a $ARCH.
Line 129: Line 137:
Need to install apt-cross apt-cross is in Lenny but no longer in Squeeze. [[DebPkg:pdebuild-cross|pdebuild-cross]] in Squeeze contains an early version of {{{xapt}}} or you can use the [[DebPkg:xapt]] {{{xapt}}} package from experimental until Squeeze is released.

apt-cross reminders:
Line 143: Line 153:


Building a Cross Compiler

This document will help you build Debian packages of a cross-compilation toolchain. It is based on a HOWTO by Josh Triplett, with his kind permission.

Note that most sensible cross-toolchain combinations within Debian are built by the Embedded Debian Project, so you may well just be able to apt-get what you need on their Toolchains page: http://www.emdebian.org/tools/crosstools.html . They also maintain scripts which effectively do what this page describes. Take a look at the 'buildcross' package from Debian experimental, which will build a whole range of toolchains.

Commands you need to run as root assume you have already set up sudo on your system.

We will be building a cross-compiler from the gcc-4.1 package. Specific version numbers for packages are listed as VERSION; substitute the version number of the latest package in unstable (or testing).

Notes for Debian unstable

We build gcc-4.4 whose cross package additionally build-depends on gcc-4.4-source which you henceforth must install.

The package linux-kernel-headers is now called linux-libc-dev instead.

The three packages libc6-dev, libc6, linux-libc-dev have additional dependencies, so you need to get the (native for the target arch) gcc-4.4-base, libc-bin, libc-dev-bin and libgcc2 (libgcc1, libgcc4, whatever your target needs) packages additionally. Now, dpkg-cross refuses to convert those without “any useful files”, so you need to pass the -A option in addition to -b and -a $ARCH.

Build a cross-compilation toolchain

Create a working directory

mkdir -p ~/src/cross-toolchain
cd ~/src/cross-toolchain

Some useful variables

These will be used in the commands in this document. Replace "arm" with the architecture for which you are building a cross-compiler.

export -n ARCH=arm  # set and do not export to invoked commands

Get the source for binutils and GCC

apt-get source binutils gcc-4.1

Install Build-Depends

sudo apt-get build-dep binutils gcc-4.1

Note that gcc-4.1 may have build-dependencies that apt-get can't figure out; this is not a problem, just make sure you install all the ones that apt-get understands. Unfortunately, apt-get build-dep may give an error if such a situation arises; in this case, take the list of packages apt-get provided before giving an error, and install them using "sudo apt-get install pkg1 pkg2 pkg3 ...".

Install fakeroot

fakeroot allows you to build packages without being root.

sudo apt-get install fakeroot

Install dpkg-cross

dpkg-cross adds cross-compilation support to some of the basic Debian package tools. dpkg-cross can also convert packages designed for the target architecture into packages usable for cross-compilation to that architecture.

sudo apt-get install dpkg-cross

Build and install binutils

cd binutils-VERSION
export TARGET=$(dpkg-architecture -a$ARCH -qDEB_HOST_GNU_TYPE 2> /dev/null)
fakeroot debian/rules binary-cross > ../binutils.build 2>&1 || echo 'Build error'
unset TARGET
cd ..
sudo dpkg -i binutils-$ARCH-linux-gnu_VERSION_HOSTARCH.deb

Convert library packages

You will need cross-compilation packages for various libraries; dpkg-cross can convert native packages for the target architecture into packages usable for cross-compilation. Note that the mirror ftp.us.debian.org only has amd64 and i386 packages, so to build a cross-compilation toolchain for another architecture (e.g. arm), you will have to use a mirror other than ftp.us.debian.org.

wget http://ftp.XX.debian.org/debian/pool/main/g/glibc/libc6-dev_VERSION_$ARCH.deb
wget http://ftp.XX.debian.org/debian/pool/main/g/glibc/libc6_VERSION_$ARCH.deb
wget http://ftp.XX.debian.org/debian/pool/main/l/linux-kernel-headers/linux-kernel-headers_VERSION_$ARCH.deb
dpkg-cross -a $ARCH -b l*.deb
sudo dpkg -i l*$ARCH-cross*.deb

Build and install GCC

Now that you have all the necessary prerequisites, you can build a cross-compiling GCC.

cd gcc-VERSION
export GCC_TARGET=$ARCH
debian/rules control
dpkg-buildpackage -us -uc -rfakeroot -b > ../gcc.build 2>&1 || echo 'Build error'
cd ..
sudo dpkg -i *-VERSION-$ARCH-linux-gnu*.deb *-$ARCH-cross_VERSION*.deb

Test the cross-compile environment

Test compilation

Create a file "hello.c", containing the following code:

#include <stdio.h>

int main()
{
    printf("Hello cross-compiling world!\n");
    return 0;
}

Compile it statically with the new cross-compiler.

$ARCH-linux-gnu-gcc -static hello.c -o hello

Check the binary's type with "file".

file hello

You should see something like:

hello: ELF 32-bit MSB executable, PowerPC or cisco 4500, version 1 (SYSV), for GNU/Linux 2.2.0, statically linked, not stripped

for the PowerPC architecture.

Install qemu

qemu is an emulator for various architectures. It supports both whole-system emulation as well as single-program emulation with system-call conversion.

sudo apt-get install qemu

Run the test program with qemu

To run the test program with qemu, just prefix it with "qemu-$ARCH" (assuming of course that your architecture is supported by qemu).

qemu-$ARCH ./hello

You should see:

Hello cross-compiling world!

Get all the libraries you need

apt-cross is in Lenny but no longer in Squeeze. pdebuild-cross in Squeeze contains an early version of xapt or you can use the xapt xapt package from experimental until Squeeze is released.

apt-cross reminders:

apt-get install apt-cross dpkg-cross

Update

apt-cross -a $ARCH -u

Fetch your cross favorite library

apt-cross -a $ARCH -i $LIBRARY


CategoryEmdebian