2016-03-02 19:18:29 +01:00
cross-compilers
2016-05-27 00:54:02 +02:00
---------------
Dockerfiles for cross compiling in a Docker container.
Features
========
2016-07-04 04:20:01 +02:00
* Different toolchains for cross compiling.
* Commands in the container are run as the calling user, so that any created files have the expected ownership, (i.e. not root).
* Make variables (`CC` `LD`
* Recent cmake and ninja are precompiled. Toolchain files available for cmake.
* Current directory is mounted as the container's workdir, `` /build `` .
* Works with boot2docker on OSX and Docker for Mac beta (1.11.1-beta12).
2016-05-27 00:54:02 +02:00
Installation
============
This image is not intended to be run manually. Instead, there is a helper script which comes bundled with the image.
To install the helper script, run the image with no arguments, and redirect the output to a file::
2016-07-04 04:51:10 +02:00
docker run --rm CROSS_COMPILER_IMAGE_NAME > ./dockcross
chmod +x ./dockcross
mv ./dockcross ~/bin/
2016-05-27 00:54:02 +02:00
Usage
=====
For the impatient, here's a one-liner to compile a hello world for armv7::
2016-07-04 04:51:10 +02:00
docker run --rm thewtex/cross-compiler-linux-armv7 > ./dockcross && chmod +x ./dockcross && ./dockcross gcc test/C/hello.c -o hello_arm
2016-05-27 00:54:02 +02:00
2016-07-04 04:20:01 +02:00
Note how invoking any toolchain command (make, gcc, etc...) is just a matter of prepending **dockcross** in the commandline::
2016-05-27 00:54:02 +02:00
2016-07-04 04:20:01 +02:00
dockcross [command] [args...]
2016-05-27 00:54:02 +02:00
2016-07-04 04:20:01 +02:00
The dockcross script will execute the given command-line inside the container, along with all arguments passed after the command.
2016-05-27 00:54:02 +02:00
2016-07-04 04:20:01 +02:00
Alternatively, if the command matches one of the dockcross built-in commands (see below), they will be executed locally.
2016-05-27 00:54:02 +02:00
Built-in commands
=================
2016-07-04 04:20:01 +02:00
- `` dockcross -- [command] [args...] `` : Forces a command to run inside the container (in case of a name clash with a built-in command), use `` -- `` before the command.
- `` dockcross update-image `` : Fetch the latest version of the docker image.
- `` dockcross update-script `` : Update the installed dockcross script with the one bundled in the image.
- `` dockcross update `` : Update both the docker image, and the dockcross script.
2016-05-27 00:54:02 +02:00
Configuration
=============
The following command-line options and environment variables are used. In all cases, the command-line option overrides the environment variable.
2016-07-04 04:20:01 +02:00
DOCKCROSS_CONFIG / --config <path-to-config-file>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
2016-05-27 00:54:02 +02:00
This file is sourced if it exists.
2016-07-04 04:20:01 +02:00
Default: `` ~/.dockcross ``
2016-05-27 00:54:02 +02:00
2016-07-04 04:20:01 +02:00
DOCKCROSS_IMAGE / --image <docker-image-name>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
2016-05-27 00:54:02 +02:00
The docker image to run.
2016-07-04 04:51:10 +02:00
Default: image with which the script was created
2016-05-27 00:54:02 +02:00
2016-07-04 04:20:01 +02:00
DOCKCROSS_ARGS / --args <docker-run-args>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
2016-05-27 00:54:02 +02:00
2016-07-04 04:51:10 +02:00
Extra arguments to pass to the `` docker run `` command.
2016-05-27 00:54:02 +02:00
Examples
========
1. **dockcross make** : Build the Makefile in the current directory.
2. **dockcross cmake -Bbuild -H. -GNinja** *: Run CMake with a build directory "build" for the CMakeLists.txt in the current directory and generate `ninja`
3. **dockcross ninja -Cbuild** : Run ninja in the generated build directory.
4. **dockcross bash -c 'find . -name \*.o | sort > objects.txt'**
2016-07-04 04:20:01 +02:00
Note that commands are executed verbatim. If you require any shell processing for environment variable expansion or redirection, please use `` bash -c 'command args...' `` .
2016-05-27 00:54:02 +02:00
---
2016-07-04 04:20:01 +02:00
Credits go to `sdt/docker-raspberry-pi-cross-compiler <https://github.com/sdt/docker-raspberry-pi-cross-compiler> `_ , who invented the base of the **dockcross** script.
2016-05-27 00:54:02 +02:00
CI status
---------
2016-03-02 19:18:29 +01:00
.. image :: https://circleci.com/gh/thewtex/cross-compilers/tree/master.svg?style=svg
:target: https://circleci.com/gh/thewtex/cross-compilers/tree/master
2016-03-02 19:22:38 +01:00
2016-03-07 04:43:02 +01:00
2016-03-02 19:22:38 +01:00
.. |base-images| image :: https://badge.imagelayers.io/thewtex/cross-compiler-base:latest.svg
:target: https://imagelayers.io/?images=thewtex/cross-compiler-base:latest
thewtex/cross-compiler-base
|base-images| Base image for other toolchain images. From Debian Jessie with GCC,
make, autotools, CMake, Ninja, Git, and Python.
2016-03-07 04:43:02 +01:00
.. |android-arm-images| image :: https://badge.imagelayers.io/thewtex/cross-compiler-android-arm:latest.svg
:target: https://imagelayers.io/?images=thewtex/cross-compiler-android-arm:latest
thewtex/cross-compiler-android-arm
|android-arm-images| The Android NDK standalone toolchain for the arm
architecture.
2016-03-13 03:50:54 +01:00
.. |browser-asmjs-images| image :: https://badge.imagelayers.io/thewtex/cross-compiler-browser-asmjs:latest.svg
:target: https://imagelayers.io/?images=thewtex/cross-compiler-browser-asmjs:latest
thewtex/cross-compiler-browser-asmjs
|browser-asmjs-images| The Emscripten JavaScript cross compiler.
2016-03-14 22:58:05 +01:00
.. |linux-armv6-images| image :: https://badge.imagelayers.io/thewtex/cross-compiler-linux-armv6:latest.svg
:target: https://imagelayers.io/?images=thewtex/cross-compiler-linux-armv6:latest
thewtex/cross-compiler-linux-armv6
|linux-armv6-images| Linux ARMv6 cross compiler toolchain for the Raspberry
Pi, etc.
2016-03-18 23:21:43 +01:00
.. |linux-armv7-images| image :: https://badge.imagelayers.io/thewtex/cross-compiler-linux-armv7:latest.svg
:target: https://imagelayers.io/?images=thewtex/cross-compiler-linux-armv7:latest
thewtex/cross-compiler-linux-armv7
|linux-armv7-images| Generic Linux armv7 cross compiler toolchain.
2016-03-21 02:31:41 +01:00
.. |linux-ppc64le-images| image :: https://badge.imagelayers.io/thewtex/cross-compiler-linux-ppc64le:latest.svg
:target: https://imagelayers.io/?images=thewtex/cross-compiler-linux-ppc64le:latest
thewtex/cross-compiler-linux-ppc64le
|linux-ppc64le-images| Linux PowerPC 64 little endian cross compiler
toolchain for the POWER8, etc.
2016-03-28 19:09:10 +02:00
.. |linux-x64-images| image :: https://badge.imagelayers.io/thewtex/cross-compiler-linux-x64:latest.svg
:target: https://imagelayers.io/?images=thewtex/cross-compiler-linux-x64:latest
thewtex/cross-compiler-linux-x64
2016-04-06 23:09:03 +02:00
|linux-x64-images| Linux x86_64 / amd64 compiler. Since the Docker image is
natively x86_64, this is not actually a cross compiler.
.. |linux-x86-images| image :: https://badge.imagelayers.io/thewtex/cross-compiler-linux-x86:latest.svg
:target: https://imagelayers.io/?images=thewtex/cross-compiler-linux-x86:latest
thewtex/cross-compiler-linux-x86
2016-04-19 07:12:35 +02:00
|linux-x86-images| Linux i686 cross compiler.
2016-04-13 03:34:23 +02:00
.. |windows-x64-images| image :: https://badge.imagelayers.io/thewtex/cross-compiler-windows-x64:latest.svg
:target: https://imagelayers.io/?images=thewtex/cross-compiler-windows-x64:latest
thewtex/cross-compiler-windows-x64
|windows-x64-images| 64-bit Windows cross-compiler based on MXE/MinGW-w64.
2016-04-17 04:35:19 +02:00
.. |windows-x86-images| image :: https://badge.imagelayers.io/thewtex/cross-compiler-windows-x86:latest.svg
:target: https://imagelayers.io/?images=thewtex/cross-compiler-windows-x86:latest
thewtex/cross-compiler-windows-x86
|windows-x86-images| 32-bit Windows cross-compiler based on MXE/MinGW-w64.
