Note how invoking any toolchain command (make, gcc, etc...) is just a matter of prepending **dockcross** in the commandline:
`dockcross [command] [args...]`
Dockcross will thus execute the given command-line inside the container, along with all arguments passed after the command.
Alternatively, if the command matches one of the dockcross built-in commands (see below), that will be executed locally.
Built-in commands
=================
-`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.
Configuration
=============
The following command-line options and environment variables are used. In all cases, the command-line option overrides the environment variable.
Extra arguments to pass to the `docker run` command.
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` files.
3.**dockcross ninja -Cbuild**: Run ninja in the generated build directory.
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/docker-raspberry-pi-cross-compiler <https://github.com/sdt/docker-raspberry-pi-cross-compiler>`_, who invented the base of this **dockcross** script.
