Bensuperpc/dockcross
1
0
Fork 0
mirror of https://github.com/bensuperpc/dockcross.git synced 2025-01-03 13:44:27 +01:00
Code Issues Packages Projects Releases Wiki Activity

Update README

Browse Source 
Update README

Signed-off-by: Bensuperpc <bensuperpc@gmail.com>
This commit is contained in:
Bensuperpc 2021-08-10 21:39:37 +02:00
parent b5dc5e6488
commit 5b175f9eac
1 changed files with 44 additions and 31 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

75
README.md
View File

@ -41,9 +41,11 @@ This image does not need to be run manually. Instead, there is a helper script t
To install the helper script, run one of the images with no arguments, and redirect the output to a file: To install the helper script, run one of the images with no arguments, and redirect the output to a file:
docker run --rm CROSS_COMPILER_IMAGE_NAME > ./dockcross ```bash
chmod +x ./dockcross docker run --rm CROSS_COMPILER_IMAGE_NAME > ./dockcross
mv ./dockcross ~/bin/ chmod +x ./dockcross
mv ./dockcross ~/bin/
```
Where **CROSS_COMPILER_IMAGE_NAME** is the name of the cross-compiler toolchain Docker instance, e.g: **dockcross/linux-armv7**. Where **CROSS_COMPILER_IMAGE_NAME** is the name of the cross-compiler toolchain Docker instance, e.g: **dockcross/linux-armv7**.
@ -53,14 +55,18 @@ Only 64-bit x86_64 images are provided, a 64-bit x86_64 host system is required.
For the impatient, here\'s how to compile a hello world for armv7: For the impatient, here\'s how to compile a hello world for armv7:
cd ~/src/dockcross ```bash
docker run --rm dockcross/linux-armv7 > ./dockcross-linux-armv7 cd ~/src/dockcross
chmod +x ./dockcross-linux-armv7 docker run --rm dockcross/linux-armv7 > ./dockcross-linux-armv7
./dockcross-linux-armv7 bash -c '$CC test/C/hello.c -o hello_arm' chmod +x ./dockcross-linux-armv7
./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 matter of prepending the **dockcross** script on the commandline: Note how invoking any toolchain command (make, gcc, etc.) is just a matter of prepending the **dockcross** script on the commandline:
./dockcross-linux-armv7 [command] [args...] ```bash
./dockcross-linux-armv7 [command] [args...]
```
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. 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.
@ -357,12 +363,13 @@ cross-compiler Docker image or the dockcross script itself.
To easily download all images, the convenience target `display_images` To easily download all images, the convenience target `display_images`
could be used: could be used:
```bash
curl https://raw.githubusercontent.com/dockcross/dockcross/master/Makefile -o dockcross-Makefile curl https://raw.githubusercontent.com/dockcross/dockcross/master/Makefile -o dockcross-Makefile
for image in $(make -f dockcross-Makefile display_images); do for image in $(make -f dockcross-Makefile display_images); do
echo "Pulling dockcross/$image" echo "Pulling dockcross/$image"
docker pull dockcross/$image docker pull dockcross/$image
done done
```
## Install all dockcross scripts ## Install all dockcross scripts
@ -370,16 +377,18 @@ To automatically install in `~/bin` the dockcross scripts for each
images already downloaded, the convenience target `display_images` could images already downloaded, the convenience target `display_images` could
be used: be used:
curl https://raw.githubusercontent.com/dockcross/dockcross/master/Makefile -o dockcross-Makefile ```bash
for image in $(make -f dockcross-Makefile display_images); do curl https://raw.githubusercontent.com/dockcross/dockcross/master/Makefile -o dockcross-Makefile
if [[ $(docker images -q dockcross/$image) == "" ]]; then for image in $(make -f dockcross-Makefile display_images); do
echo "~/bin/dockcross-$image skipping: image not found locally" if [[ $(docker images -q dockcross/$image) == "" ]]; then
continue echo "~/bin/dockcross-$image skipping: image not found locally"
fi continue
echo "~/bin/dockcross-$image ok" fi
docker run dockcross/$image > ~/bin/dockcross-$image && \ echo "~/bin/dockcross-$image ok"
chmod u+x ~/bin/dockcross-$image docker run dockcross/$image > ~/bin/dockcross-$image && \
done chmod u+x ~/bin/dockcross-$image
done
```
## Dockcross configuration ## Dockcross configuration
@ -424,17 +433,21 @@ In order to extend Dockcross images with your own commands, one must:
An example Dockerfile would be: An example Dockerfile would be:
FROM dockcross/linux-armv7 ```
FROM dockcross/linux-armv7
ENV DEFAULT_DOCKCROSS_IMAGE my_cool_image ENV DEFAULT_DOCKCROSS_IMAGE my_cool_image
RUN apt-get install nano RUN apt-get install nano
```
And then in the shell: And then in the shell:
docker build -t my_cool_image . ## Builds the dockcross image. ```
docker run my_cool_image > linux-armv7 ## Creates a helper script named linux-armv7. docker build -t my_cool_image . ## Builds the dockcross image.
chmod +x linux-armv7 ## Gives the script execution permission. docker run my_cool_image > linux-armv7 ## Creates a helper script named linux-armv7.
./linux-armv7 bash ## Runs the helper script with the argument "bash", which starts an interactive container using your extended image. 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.
```
## What is the difference between **dockcross** and **dockbuild** ? ## What is the difference between **dockcross** and **dockbuild** ?