redox

History

fengalin c323f81b8c Update docker container build script and README - Use https for redox apt repository - Import the repository's key - Update [toolchain packages' names](https://github.com/redox-os/cookbook/pull/59) - Install `wget` which is needed by [coobook/recipes/xz](https://github.com/redox-os/cookbook/blob/master/recipes/xz/recipe.sh) - Update README file to reflect the [discussion about when the submodules are needed](https://github.com/redox-os/redox/pull/1005#discussion_r129432929) - Update README file to suggest using `make fetch all` in place of `make update all` since `Cargo.lock` files come with the sources now. See this [comment](https://github.com/redox-os/redox/issues/1021#issuecomment-320946322) Note: current source tree generation requires runing the docker container with `bash -c RUSTFLAGS=\"-A unused_mut\" make fetch all` in place of `make fetch all`		2017-08-12 15:29:27 +02:00
..
Dockerfile	Update docker container build script and README	2017-08-12 15:29:27 +02:00
entrypoint.sh	Build docker container with ready to use user env	2017-07-26 00:18:27 +02:00
README.md	Update docker container build script and README	2017-08-12 15:29:27 +02:00

README.md

Building Redox using Docker images with the toolchain

All you need is git, make, qemu, fuse and docker. The method requires a non-privileged user able to run the docker command, which is usually achieved by adding the user to the docker group.

git clone https://github.com/redox-os/redox.git ; cd redox #1
docker build --build-arg LOCAL_UID="$(id -u)" --build-arg LOCAL_GID="$(id -g)" \
    -t redox docker/ #2
git pull --rebase --recurse-submodules && git submodule sync \
    && git submodule update --recursive --init #3
docker run --cap-add MKNOD --cap-add SYS_ADMIN \
    -e LOCAL_UID="$(id -u)" -e LOCAL_GID="$(id -g)" \
    --device /dev/fuse -v "$(pwd):/home/user/src" --rm redox make fetch all #4
make qemu #5

To unpack:

Creates a local copy of the repository.
Creates a new image in the local image repository named redox with Redox toolchain installed. You only need to rebuild the image if you want to update the toolchain.
Updates all the submodules in the repository.
Builds Redox using the redox image. The arguments allow the container to use fuse and ensure the resulting files are owned by the current user.
Runs Redox.

On selinux systems, replace #4 with:

docker run --cap-add MKNOD --cap-add SYS_ADMIN \
    -e LOCAL_UID="$(id -u)" -e LOCAL_GID="$(id -g)" \
    --device /dev/fuse -v "$(pwd):/home/user/src" --security-opt label=disable \
    --rm redox make fetch all