Dockerfiles for cross compiling in a Docker container.
- different toolchains for cross compiling
- commands in the container are run as the calling user, so that any created files have the expected ownership (ie. not root)
- make variables (
CC,LDetc) are set to point to the appropriate tools in the container - cmake and ninja are precompiled available with a toolchain file for cmake
- current directory is mounted as the container's workdir,
/build - works with boot2docker on OSX
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.
eg.
docker run CROSS_COMPILER_IMAGE_NAME > dockcross
chmod +x dockcross
mv dockcross ~/bin/
dockcross [command] [args...]
Execute the given command-line inside the container.
If the command matches one of the dockcross built-in commands (see below), that will be executed locally, otherwise the command is executed inside the container.
dockcross -- [command] [args...]
To force 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.
The following command-line options and environment variables are used. In all cases, the command-line option overrides the environment variable.
This file is sourced if it exists.
Default: ~/.dockcross
The docker image to run.
Default: sdt4docker/raspberry-pi-cross-compiler
Extra arguments to pass to the docker run command.
dockcross make
Build the Makefile in the current directory.
dockcross cmake -Bbuild -H. -GNinja
Run CMake with a build directory "build" for the CMakeLists.txt in the current directory and generate ninja files.
dockcross ninja -Cbuild
Run ninja in the generated build directory.
dockcross bash -c 'find . -name \*.o | sort > objects.txt'
Note that commands are executed verbatim. If you require any shell processing for environment variable expansion or redirection, please use bash -c 'command args...'.
Credits go to sdt sdt/docker-raspberry-pi-cross-compiler on GitHub, who invented the base of the dockcross script.