mirror of
https://github.com/bensuperpc/dockcross.git
synced 2024-11-13 22:51:31 +01:00
Merge branch 'master' into remove_manylinux2014-aarch64
This commit is contained in:
GitHub
commit
7eabd4a8ed
218
README.md
218
README.md
@ -1,10 +1,11 @@
|
|||||||
|
|
||||||
# dockcross
|
# dockcross
|
||||||
|
|
||||||
|
|
||||||
Cross compiling toolchains in Docker images.
|
Cross compiling toolchains in Docker images.
|
||||||
|
|
||||||
[](https://github.com/dockcross/dockcross/actions?query=branch%3Amaster)
|
[](https://github.com/dockcross/dockcross/actions?query=branch%3Amaster) [](https://github.com/dockcross/dockcross/actions/workflows/shellcheck.yml)
|
||||||
|
|
||||||
|
 
|
||||||
|
|
||||||
## Features
|
## Features
|
||||||
|
|
||||||
@ -24,8 +25,7 @@ Cross compiling toolchains in Docker images.
|
|||||||
Windows](https://docs.docker.com/docker-for-windows/).
|
Windows](https://docs.docker.com/docker-for-windows/).
|
||||||
- Support using alternative container executor by setting
|
- Support using alternative container executor by setting
|
||||||
[OCI_EXE]{.title-ref} environment variable. By default, it searches
|
[OCI_EXE]{.title-ref} environment variable. By default, it searches
|
||||||
for [docker]{.title-ref} and
|
for [docker]{.title-ref} and [podman](https://podman.io) executable.
|
||||||
\[[podman]{.title-ref}\](<https://podman.io/>) executable.
|
|
||||||
|
|
||||||
## Examples
|
## Examples
|
||||||
|
|
||||||
@ -41,27 +41,23 @@ Cross compiling toolchains in Docker images.
|
|||||||
|
|
||||||
Note that commands are executed verbatim. If any shell processing for
|
Note that commands are executed verbatim. If any shell processing for
|
||||||
environment variable expansion or redirection is required, please use
|
environment variable expansion or redirection is required, please use
|
||||||
[bash -c \'command args\...\']{.title-ref}.
|
```bash
|
||||||
|
bash -c "<command args>"
|
||||||
|
```
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
This image does not need to be run manually. Instead, there is a helper
|
This image does not need to be run manually. Instead, there is a helper script to execute build commands on source code existing on the local host filesystem. This script is bundled with the image.
|
||||||
script to execute build commands on source code existing on the local
|
|
||||||
host filesystem. This script is bundled with the image.
|
|
||||||
|
|
||||||
To install the helper script, run one of the images with no arguments,
|
To install the helper script, run one of the images with no arguments, and redirect the output to a file:
|
||||||
and redirect the output to a file:
|
|
||||||
|
|
||||||
docker run --rm CROSS_COMPILER_IMAGE_NAME > ./dockcross
|
docker run --rm CROSS_COMPILER_IMAGE_NAME > ./dockcross
|
||||||
chmod +x ./dockcross
|
chmod +x ./dockcross
|
||||||
mv ./dockcross ~/bin/
|
mv ./dockcross ~/bin/
|
||||||
|
|
||||||
Where [CROSS_COMPILER_IMAGE_NAME]{.title-ref} is the name of the
|
Where **CROSS_COMPILER_IMAGE_NAME** is the name of the cross-compiler toolchain Docker instance, e.g: **dockcross/linux-armv7**.
|
||||||
cross-compiler toolchain Docker instance, e.g.
|
|
||||||
[dockcross/linux-armv7]{.title-ref}.
|
|
||||||
|
|
||||||
Only 64-bit x86_64 images are provided; a 64-bit x86_64 host system is
|
Only 64-bit x86_64 images are provided; a 64-bit x86_64 host system is required.
|
||||||
required.
|
|
||||||
|
|
||||||
## Usage
|
## Usage
|
||||||
|
|
||||||
@ -72,249 +68,257 @@ For the impatient, here\'s how to compile a hello world for armv7:
|
|||||||
chmod +x ./dockcross-linux-armv7
|
chmod +x ./dockcross-linux-armv7
|
||||||
./dockcross-linux-armv7 bash -c '$CC test/C/hello.c -o hello_arm'
|
./dockcross-linux-armv7 bash -c '$CC test/C/hello.c -o hello_arm'
|
||||||
|
|
||||||
Note how invoking any toolchain command (make, gcc, etc.) is just a
|
Note how invoking any toolchain command (make, gcc, etc.) is just a matter of prepending the **dockcross** script on the commandline:
|
||||||
matter of prepending the **dockcross** script on the commandline:
|
|
||||||
|
|
||||||
./dockcross-linux-armv7 [command] [args...]
|
./dockcross-linux-armv7 [command] [args...]
|
||||||
|
|
||||||
The dockcross script will execute the given command-line inside the
|
The dockcross script will execute the given command-line inside the container, along with all arguments passed after the command. Commands that evaluate environmental variables in the image, like **$CC** or **$CXX** above, should be executed in [bash -c]. The present working directory is mounted within the image, which can be used to make source code available in the Docker container.
|
||||||
container, along with all arguments passed after the command. Commands
|
|
||||||
that evaluate environmental variables in the image, like
|
## Summary cross compilers
|
||||||
[\$CC]{.title-ref} above, should be executed in [bash -c].
|
|
||||||
The present working directory is mounted within the image, which can be
|
| Image name | Arch | Compiler | Target OS |
|
||||||
used to make source code available in the Docker container.
|
|:-------:|:--------:|:------:|:-----:|
|
||||||
|
| dockcross/base | - | - | - |
|
||||||
|
| dockcross/android-arm | ARMv7 | Clang | Android 32 bit |
|
||||||
|
| dockcross/android-arm64 | ARMv8 | Clang | Android |
|
||||||
|
| dockcross/android-x86 | x86 | Clang | Android x86 |
|
||||||
|
| dockcross/android-x86_64 | x86_64 | Clang | Android x86_64 |
|
||||||
|
| dockcross/linux-arm64 | ARMv8 | GCC | Linux ARMv8 |
|
||||||
|
| dockcross/linux-arm64-musl | ARMv8 | GCC + musl | Linux ARMv8 |
|
||||||
|
| dockcross/linux-armv5 | ARMv5 | GCC | Linux ARMv5 |
|
||||||
|
| dockcross/linux-armv5-musl | ARMv5 | GCC + musl | Linux ARMv5 |
|
||||||
|
| dockcross/linux-armv6 | ARMv6 | GCC | Linux ARMv6 |
|
||||||
|
| dockcross/linux-armv6-lts | ARMv6 | GCC + Glibc 2.28 | Linux ARMv6 |
|
||||||
|
| dockcross/linux-armv6-musl | ARMv6 | GCC + musl | Linux ARMv6 |
|
||||||
|
| dockcross/linux-armv7 | ARMv7 | GCC | Linux ARMv7 |
|
||||||
|
| dockcross/linux-armv7a | ARMv7a | GCC | Linux ARMv7a |
|
||||||
|
| dockcross/linux-armv7l-musl | ARMv7l | GCC + musl | Linux ARMv7l |
|
||||||
|
| dockcross/linux-mips | mips | GCC | Linux mips |
|
||||||
|
| dockcross/linux-s390x | s390x | GCC | Linux s390x |
|
||||||
|
| dockcross/linux-ppc64le | ppc64le | GCC | Linux ppc64le |
|
||||||
|
| dockcross/linux-riscv32 | riscv32 | GCC | Linux riscv32 |
|
||||||
|
| dockcross/linux-riscv64 | riscv64 | GCC | Linux riscv64 |
|
||||||
|
| dockcross/linux-m68k-uclibc | m68k | GCC + uclibc | Linux m68k |
|
||||||
|
| dockcross/linux-xtensa-uclibc | xtensa | GCC + uclibc | Linux xtensa |
|
||||||
|
| dockcross/manylinux2014-x86 | x86 | GCC | Linux x86 |
|
||||||
|
| dockcross/manylinux2014-x64 | x86_64 | GCC | Linux x86_64 |
|
||||||
|
| dockcross/linux-x86 | x86 | GCC | Linux x86 |
|
||||||
|
| dockcross/linux-x64 | x86_64 | GCC | Linux x86_64 |
|
||||||
|
| dockcross/linux-x64-clang | x86_64 | Clang | Linux x86_64 |
|
||||||
|
| dockcross/web-wasm | JS | LLVM | Web (JS) |
|
||||||
|
| dockcross/windows-shared-x86 | x86 | GCC | Windows x86 |
|
||||||
|
| dockcross/windows-shared-x64 | x86_64 | GCC | Windows x86_64 |
|
||||||
|
| dockcross/windows-shared-x64-posix | x86_64 | GCC | Windows x86_64 |
|
||||||
|
| dockcross/windows-static-x86 | x86 | GCC | Windows x86 |
|
||||||
|
| dockcross/windows-static-x64 | x86_64 | GCC | Windows x86_64 |
|
||||||
|
| dockcross/windows-static-x64-posix | x86_64 | GCC | Windows x86_64 |
|
||||||
|
|
||||||
## Cross compilers
|
## Cross compilers
|
||||||
|
|
||||||
### dockcross/base
|
### dockcross/base
|
||||||
|
|
||||||
   
|
  
|
||||||
|
|
||||||
Base image for other toolchain images. From Debian Jessie with GCC,
|
Base image for other toolchain images. From Debian Jessie with GCC, make, autotools, CMake, Ninja, Git, and Python.
|
||||||
make, autotools, CMake, Ninja, Git, and Python.
|
|
||||||
|
|
||||||
### dockcross/android-arm
|
### dockcross/android-arm
|
||||||
|
|
||||||
  
|
 
|
||||||
|
|
||||||
The Android NDK standalone toolchain for the arm architecture.
|
The Android NDK standalone toolchain for the arm architecture.
|
||||||
|
|
||||||
### dockcross/android-arm64
|
### dockcross/android-arm64
|
||||||
|
|
||||||
  
|
 
|
||||||
|
|
||||||
The Android NDK standalone toolchain for the arm64 architecture.
|
The Android NDK standalone toolchain for the arm64 architecture.
|
||||||
|
|
||||||
### dockcross/android-x86
|
### dockcross/android-x86
|
||||||
|
|
||||||
  
|
 
|
||||||
|
|
||||||
The Android NDK standalone toolchain for the x86 architecture.
|
The Android NDK standalone toolchain for the x86 architecture.
|
||||||
|
|
||||||
### dockcross/android-x86_64
|
### dockcross/android-x86_64
|
||||||
|
|
||||||
  
|
 
|
||||||
|
|
||||||
The Android NDK standalone toolchain for the x86_64 architecture.
|
The Android NDK standalone toolchain for the x86_64 architecture.
|
||||||
|
|
||||||
### dockcross/linux-arm64
|
### dockcross/linux-arm64
|
||||||
|
|
||||||
  
|
 
|
||||||
|
|
||||||
Cross compiler for the 64-bit ARM platform on Linux, also known as
|
Cross compiler for the 64-bit ARM platform on Linux, also known as AArch64.
|
||||||
AArch64.
|
|
||||||
|
|
||||||
### dockcross/linux-arm64-musl
|
### dockcross/linux-arm64-musl
|
||||||
|
|
||||||
  
|
 
|
||||||
|
|
||||||
Cross compiler for the 64-bit ARM platform on Linux (also known as
|
Cross compiler for the 64-bit ARM platform on Linux (also known as
|
||||||
AArch64), using [musl](https://www.musl-libc.org/) as base \"libc\".
|
AArch64), using [musl](https://www.musl-libc.org/) as base \"libc\".
|
||||||
|
|
||||||
### dockcross/linux-armv5
|
### dockcross/linux-armv5
|
||||||
|
|
||||||
  
|
 
|
||||||
|
|
||||||
Linux armv5 cross compiler toolchain for legacy devices like the
|
Linux armv5 cross compiler toolchain for legacy devices like the
|
||||||
Parrot AR Drone.
|
Parrot AR Drone.
|
||||||
|
|
||||||
### dockcross/linux-armv5-musl
|
### dockcross/linux-armv5-musl
|
||||||
|
|
||||||
  
|
 
|
||||||
|
|
||||||
Linux armv5 cross compiler toolchain using
|
Linux armv5 cross compiler toolchain using
|
||||||
[musl](https://www.musl-libc.org/) as base \"libc\".
|
[musl](https://www.musl-libc.org/) as base \"libc\".
|
||||||
|
|
||||||
### dockcross/linux-armv6
|
### dockcross/linux-armv6
|
||||||
|
|
||||||
  
|
 
|
||||||
|
|
||||||
Linux ARMv6 cross compiler toolchain for the Raspberry Pi
|
Linux ARMv6 cross compiler toolchain for the Raspberry Pi
|
||||||
|
|
||||||
### dockcross/linux-armv6-lts
|
### dockcross/linux-armv6-lts
|
||||||
|
|
||||||
  
|
 
|
||||||
|
|
||||||
Linux ARMv6 cross compiler toolchain for the Raspberry Pi (Debian buster...)
|
Linux ARMv6 cross compiler toolchain for the Raspberry Pi (Debian buster...)
|
||||||
|
|
||||||
### dockcross/linux-armv6-musl
|
### dockcross/linux-armv6-musl
|
||||||
|
|
||||||
  
|
 
|
||||||
|
|
||||||
Linux ARMv6 cross compiler toolchain for the Raspberry Pi, etc,
|
Linux ARMv6 cross compiler toolchain for the Raspberry Pi, etc,
|
||||||
using [musl](https://www.musl-libc.org/) as base \"libc\".
|
using [musl](https://www.musl-libc.org/) as base \"libc\".
|
||||||
|
|
||||||
### dockcross/linux-armv7
|
### dockcross/linux-armv7
|
||||||
|
|
||||||
  
|
 
|
||||||
|
|
||||||
Generic Linux armv7 cross compiler toolchain.
|
Generic Linux armv7 cross compiler toolchain.
|
||||||
|
|
||||||
### dockcross/linux-armv7a
|
### dockcross/linux-armv7a
|
||||||
|
|
||||||
  
|
 
|
||||||
|
|
||||||
Toolchain configured for ARMv7-A used in Beaglebone Black single
|
Toolchain configured for ARMv7-A used in Beaglebone Black single
|
||||||
board PC with TI SoC AM3358 on board, Cortex-A8.
|
board PC with TI SoC AM3358 on board, Cortex-A8.
|
||||||
|
|
||||||
### dockcross/linux-armv7l-musl
|
### dockcross/linux-armv7l-musl
|
||||||
|
|
||||||
  
|
 
|
||||||
|
|
||||||
Toolchain configured for ARMv7-L, using
|
Toolchain configured for ARMv7-L, using
|
||||||
[musl](https://www.musl-libc.org/) as base \"libc\".
|
[musl](https://www.musl-libc.org/) as base \"libc\".
|
||||||
|
|
||||||
### dockcross/linux-mipsel
|
|
||||||
|
|
||||||
  
|
|
||||||
|
|
||||||
Linux mipsel cross compiler toolchain for little endian MIPS GNU
|
|
||||||
systems.
|
|
||||||
|
|
||||||
### dockcross/linux-mips
|
### dockcross/linux-mips
|
||||||
|
|
||||||
  
|
 
|
||||||
|
|
||||||
Linux mips cross compiler toolchain for big endian 32-bit hard float
|
Linux mips cross compiler toolchain for big endian 32-bit hard float
|
||||||
MIPS GNU systems.
|
MIPS GNU systems.
|
||||||
|
|
||||||
### dockcross/linux-s390x
|
### dockcross/linux-s390x
|
||||||
|
|
||||||
  
|
 
|
||||||
|
|
||||||
Linux s390x cross compiler toolchain for S390X GNU systems.
|
Linux s390x cross compiler toolchain for S390X GNU systems.
|
||||||
|
|
||||||
### dockcross/linux-riscv64
|
### dockcross/linux-riscv64
|
||||||
|
|
||||||
  
|
 
|
||||||
|
|
||||||
Linux risc-v 64bit cross compiler toolchain for risc-v 64bit GNU systems.
|
Linux risc-v 64bit cross compiler toolchain for risc-v 64bit GNU systems.
|
||||||
|
|
||||||
### dockcross/linux-riscv32
|
### dockcross/linux-riscv32
|
||||||
|
|
||||||
  
|
 
|
||||||
|
|
||||||
Linux risc-v 32bit cross compiler toolchain for risc-v 32bit GNU systems.
|
Linux risc-v 32bit cross compiler toolchain for risc-v 32bit GNU systems.
|
||||||
|
|
||||||
### dockcross/linux-m68k-uclibc
|
### dockcross/linux-m68k-uclibc
|
||||||
|
|
||||||
  
|
 
|
||||||
|
|
||||||
Linux m68k cross compiler toolchain for m68k GNU systems (http://www.mac.linux-m68k.org/ and http://www.linux-m68k.org/).
|
Linux m68k cross compiler toolchain for m68k GNU systems (http://www.mac.linux-m68k.org/ and http://www.linux-m68k.org/).
|
||||||
|
|
||||||
### dockcross/linux-ppc64le
|
### dockcross/linux-ppc64le
|
||||||
|
|
||||||
  
|
 
|
||||||
|
|
||||||
Linux PowerPC 64 little endian cross compiler toolchain for the
|
Linux PowerPC 64 little endian cross compiler toolchain for the POWER8, etc. Important: Due to Issue #430, automatic build of newer images has been disabled.
|
||||||
POWER8, etc. Important: Due to Issue #430, automatic build of newer
|
|
||||||
images has been disabled.
|
|
||||||
|
|
||||||
### dockcross/linux-x64
|
### dockcross/linux-x64
|
||||||
|
|
||||||
  
|
 
|
||||||
|
|
||||||
Linux x86_64 / amd64 compiler. Since the Docker image is natively
|
Linux x86_64/amd64 compiler. Since the Docker image is natively x86_64, this is not actually a cross compiler.
|
||||||
x86_64, this is not actually a cross compiler.
|
|
||||||
|
|
||||||
### dockcross/linux-x64-clang
|
### dockcross/linux-x64-clang
|
||||||
|
|
||||||
  
|
 
|
||||||
|
|
||||||
Linux clang x86_64 / amd64 compiler. Since the Docker image is
|
Linux clang x86_64/amd64 compiler. Since the Docker image is natively x86_64, this is not actually a cross compiler.
|
||||||
natively x86_64, this is not actually a cross compiler.
|
|
||||||
|
|
||||||
### dockcross/linux-x86
|
### dockcross/linux-x86
|
||||||
|
|
||||||
  
|
 
|
||||||
|
|
||||||
Linux i686 cross compiler.
|
Linux i686 cross compiler.
|
||||||
|
|
||||||
### dockcross/manylinux2014-x64
|
### dockcross/manylinux2014-x64
|
||||||
|
|
||||||
  
|
 
|
||||||
|
|
||||||
Docker [manylinux2014](https://github.com/pypa/manylinux) image for
|
Docker [manylinux2014](https://github.com/pypa/manylinux) image for building Linux x86_64 / amd64 [Python wheel packages](http://pythonwheels.com/). It includes Python 3.5, 3.6, 3.7, 3.8, and 3.9. Also has support for the dockcross script, and it has installations of CMake, Ninja, and [scikit-build](http://scikit-build.org). For CMake, it sets **MANYLINUX2014** to \"TRUE\" in the toolchain.
|
||||||
building Linux x86_64 / amd64 [Python wheel
|
|
||||||
packages](http://pythonwheels.com/). It includes Python 3.5, 3.6,
|
|
||||||
3.7, 3.8, and 3.9. Also has support for the dockcross script, and it
|
|
||||||
has installations of CMake, Ninja, and
|
|
||||||
[scikit-build](http://scikit-build.org). For CMake, it sets
|
|
||||||
[MANYLINUX2014]{.title-ref} to \"TRUE\" in the toolchain.
|
|
||||||
|
|
||||||
### dockcross/manylinux2014-x86
|
### dockcross/manylinux2014-x86
|
||||||
|
|
||||||
  
|
 
|
||||||
|
|
||||||
Docker [manylinux2014](https://github.com/pypa/manylinux) image for
|
Docker [manylinux2014](https://github.com/pypa/manylinux) image for building Linux i686 [Python wheel packages](http://pythonwheels.com/). It includes Python 3.5, 3.6, 3.7, 3.8, and 3.9. Also has support for the dockcross script, and it has installations of CMake, Ninja, and [scikit-build](http://scikit-build.org). For CMake, it sets **MANYLINUX2014** to \"TRUE\" in the toolchain.
|
||||||
building Linux i686 [Python wheel
|
|
||||||
packages](http://pythonwheels.com/). It includes Python 3.5, 3.6,
|
|
||||||
3.7, 3.8, and 3.9. Also has support for the dockcross script, and it
|
|
||||||
has installations of CMake, Ninja, and
|
|
||||||
[scikit-build](http://scikit-build.org). For CMake, it sets
|
|
||||||
[MANYLINUX2014]{.title-ref} to \"TRUE\" in the toolchain.
|
|
||||||
|
|
||||||
### dockcross/web-wasm
|
### dockcross/web-wasm
|
||||||
|
|
||||||
  
|
 
|
||||||
|
|
||||||
The Emscripten WebAssembly/asm.js/JavaScript cross compiler.
|
The Emscripten WebAssembly/asm.js/JavaScript cross compiler.
|
||||||
|
|
||||||
### dockcross/windows-static-x64
|
### dockcross/windows-static-x64
|
||||||
|
|
||||||
  
|
 
|
||||||
|
|
||||||
64-bit Windows cross-compiler based on [MXE/MinGW-w64](https://mxe.cc/) with win32 threads and static
|
64-bit Windows cross-compiler based on [MXE/MinGW-w64](https://mxe.cc/) with win32 threads and static
|
||||||
linking.
|
linking.
|
||||||
|
|
||||||
### dockcross/windows-static-x64-posix
|
### dockcross/windows-static-x64-posix
|
||||||
|
|
||||||
  
|
 
|
||||||
|
|
||||||
64-bit Windows cross-compiler based on [MXE/MinGW-w64](https://mxe.cc/) with posix threads and static
|
64-bit Windows cross-compiler based on [MXE/MinGW-w64](https://mxe.cc/) with posix threads and static
|
||||||
linking.
|
linking.
|
||||||
|
|
||||||
### dockcross/windows-static-x86
|
### dockcross/windows-static-x86
|
||||||
|
|
||||||
  
|
 
|
||||||
|
|
||||||
32-bit Windows cross-compiler based on [MXE/MinGW-w64](https://mxe.cc/) with win32 threads and static linking.
|
32-bit Windows cross-compiler based on [MXE/MinGW-w64](https://mxe.cc/) with win32 threads and static linking.
|
||||||
|
|
||||||
### dockcross/windows-shared-x64
|
### dockcross/windows-shared-x64
|
||||||
|
|
||||||
  
|
 
|
||||||
|
|
||||||
64-bit Windows cross-compiler based on [MXE/MinGW-w64](https://mxe.cc/) with win32 threads and dynamic linking.
|
64-bit Windows cross-compiler based on [MXE/MinGW-w64](https://mxe.cc/) with win32 threads and dynamic linking.
|
||||||
|
|
||||||
### dockcross/windows-shared-x64-posix
|
### dockcross/windows-shared-x64-posix
|
||||||
|
|
||||||
  
|
 
|
||||||
|
|
||||||
64-bit Windows cross-compiler based on [MXE/MinGW-w64](https://mxe.cc/) with posix threads and dynamic linking.
|
64-bit Windows cross-compiler based on [MXE/MinGW-w64](https://mxe.cc/) with posix threads and dynamic linking.
|
||||||
|
|
||||||
### dockcross/windows-shared-x86
|
### dockcross/windows-shared-x86
|
||||||
|
|
||||||
  
|
 
|
||||||
|
|
||||||
32-bit Windows cross-compiler based on [MXE/MinGW-w64](https://mxe.cc/) with win32 threads and dynamic linking.
|
32-bit Windows cross-compiler based on [MXE/MinGW-w64](https://mxe.cc/) with win32 threads and dynamic linking.
|
||||||
|
|
||||||
@ -389,15 +393,11 @@ Default: Image with which the script was created.
|
|||||||
|
|
||||||
### DOCKCROSS_ARGS / \--args\|-a \<docker-run-args>
|
### DOCKCROSS_ARGS / \--args\|-a \<docker-run-args>
|
||||||
|
|
||||||
Extra arguments to pass to the `docker run` command. Quote the entire
|
Extra arguments to pass to the `docker run` command. Quote the entire set of args if they contain spaces.
|
||||||
set of args if they contain spaces.
|
|
||||||
|
|
||||||
## Per-project dockcross configuration
|
## Per-project dockcross configuration
|
||||||
|
|
||||||
If a shell script named `.dockcross` is found in the current directory
|
If a shell script named `.dockcross` is found in the current directory where the dockcross script is started, it is executed before the dockcross script `command` argument. The shell script is expected to have a shebang like `#!/usr/bin/env bash`.
|
||||||
where the dockcross script is started, it is executed before the
|
|
||||||
dockcross script `command` argument. The shell script is expected to
|
|
||||||
have a shebang like `#!/usr/bin/env bash`.
|
|
||||||
|
|
||||||
For example, commands like
|
For example, commands like
|
||||||
`git config --global advice.detachedHead false` can be added to this
|
`git config --global advice.detachedHead false` can be added to this
|
||||||
@ -427,31 +427,17 @@ And then in the shell:
|
|||||||
chmod +x linux-armv7 ## Gives the script execution permission.
|
chmod +x linux-armv7 ## Gives the script execution permission.
|
||||||
./linux-armv7 bash ## Runs the helper script with the argument "bash", which starts an interactive container using your extended image.
|
./linux-armv7 bash ## Runs the helper script with the argument "bash", which starts an interactive container using your extended image.
|
||||||
|
|
||||||
## What is the difference between [dockcross]{.title-ref} and [dockbuild]{.title-ref} ?
|
## What is the difference between **dockcross** and **dockbuild** ?
|
||||||
|
|
||||||
The key difference is that
|
The key difference is that [dockbuild](https://github.com/dockbuild/dockbuild#readme) images do **NOT** provide a [toolchain file](https://cmake.org/cmake/help/latest/manual/cmake-toolchains.7.html) but they use the same method to conveniently isolate the build environment as [dockcross](https://github.com/dockcross/dockcross#readme).
|
||||||
[dockbuild](https://github.com/dockbuild/dockbuild#readme) images do
|
|
||||||
**NOT** provide a [toolchain
|
|
||||||
file](https://cmake.org/cmake/help/latest/manual/cmake-toolchains.7.html)
|
|
||||||
but they use the same method to conveniently isolate the build
|
|
||||||
environment as
|
|
||||||
[dockcross](https://github.com/dockcross/dockcross#readme).
|
|
||||||
|
|
||||||
[dockbuild]{.title-ref} is used to build binaries for Linux x86_64 /
|
**dockbuild** is used to build binaries for Linux x86_64/amd64 that will work across most Linux distributions.
|
||||||
amd64 that will work across most Linux distributions.
|
**dockbuild** performs a native Linux build where the host build system is a Linux x86_64 / amd64 Docker image (so that it can be used for building binaries on any system which can run Docker images) and the target runtime system is Linux x86_x64/ amd64.
|
||||||
[dockbuild]{.title-ref} performs a native Linux build where the host
|
|
||||||
build system is a Linux x86_64 / amd64 Docker image (so that it can be
|
|
||||||
used for building binaries on any system which can run Docker images)
|
|
||||||
and the target runtime system is Linux x86_x64 / amd64.
|
|
||||||
|
|
||||||
[dockcross]{.title-ref} is used to build binaries for many different
|
**dockcross** is used to build binaries for many different platforms. **dockcross** performs a cross compilation where the host build system is a Linux x86_64 / amd64 Docker image (so that it can be used for building binaries on any system which can run Docker images) and the target runtime system varies.
|
||||||
platforms. [dockcross]{.title-ref} performs a cross compilation where
|
|
||||||
the host build system is a Linux x86_64 / amd64 Docker image (so that it
|
|
||||||
can be used for building binaries on any system which can run Docker
|
|
||||||
images) and the target runtime system varies.
|
|
||||||
|
|
||||||
\-\--
|
\-\--
|
||||||
|
|
||||||
Credits go to
|
Credits:
|
||||||
[sdt/docker-raspberry-pi-cross-compiler](https://github.com/sdt/docker-raspberry-pi-cross-compiler),
|
- [sdt/docker-raspberry-pi-cross-compiler](https://github.com/sdt/docker-raspberry-pi-cross-compiler), who invented the base of the **dockcross** script.
|
||||||
who invented the base of the **dockcross** script.
|
- [https://github.com/steeve/cross-compiler](https://github.com/steeve/cross-compiler),
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user