@@ -22,6 +22,48 @@ Images will output artifacts in an `obj` dir at the root of a repository.
2222- ` scripts ` contains files shared by docker images
2323- ` disabled ` contains images that are not built on travis
2424
25+ ## Docker Toolbox on Windows
26+
27+ For Windows before Windows 10, the docker images can be run on Windows via
28+ [ Docker Toolbox] . There are several preparation needs to be made before running
29+ a Docker image.
30+
31+ 1 . Stop the virtual machine from the terminal with ` docker-machine stop `
32+
33+ 2 . If your Rust source is placed outside of ` C:\Users\** ` , e.g. if you place the
34+ repository in the ` E:\rust ` folder, please add a shared folder from
35+ VirtualBox by:
36+
37+ 1 . Select the "default" virtual machine inside VirtualBox, then click
38+ "Settings"
39+ 2 . Go to "Shared Folders", click "Add shared foldrer" (the folder icon with
40+ a plus sign), fill in the following information, then click "OK":
41+
42+ * Folder path: ` E:\rust `
43+ * Folder name: ` e/rust `
44+ * Read-only: ☐ * unchecked*
45+ * Auto-mount: ☑ * checked*
46+ * Make Permanant: ☑ * checked*
47+
48+ 3 . VirtualBox might not support creating symbolic links inside a shared folder
49+ by default. You can enable it manually by running these from ` cmd.exe ` :
50+
51+ ``` bat
52+ cd "C:\Program Files\Oracle\VirtualBox"
53+ VBoxManage setextradata default VBoxInternal2/SharedFoldersEnableSymlinksCreate/e/rust 1
54+ :: ^~~~~~
55+ :: folder name
56+ ```
57+
58+ 4. Restart the virtual machine from terminal with `docker-machine start`.
59+
60+ To run the image,
61+
62+ 1. Launch the "Docker Quickstart Terminal".
63+ 2. Execute `./src/ci/docker/run.sh $image_name` as explained at the beginning.
64+
65+ [Docker Toolbox]: https://www.docker.com/products/docker-toolbox
66+
2567## Cross toolchains
2668
2769A number of these images take quite a long time to compile as they're building
@@ -137,7 +179,7 @@ For targets: `armv7-unknown-linux-gnueabihf`
137179 libraries like jemalloc. See the mk/cfg/arm(v7)-uknown-linux-gnueabi{,hf}.mk
138180 file in Rust's source code.
139181
140- ## ` aarch64-linux-gnu.config `
182+ ### `aarch64-linux-gnu.config`
141183
142184For targets: `aarch64-unknown-linux-gnu`
143185
@@ -150,7 +192,7 @@ For targets: `aarch64-unknown-linux-gnu`
150192- C compiler > gcc version = 5.2.0
151193- C compiler > C++ = ENABLE -- to cross compile LLVM
152194
153- ## ` powerpc-linux-gnu.config `
195+ ### `powerpc-linux-gnu.config`
154196
155197For targets: `powerpc-unknown-linux-gnu`
156198
@@ -165,7 +207,7 @@ For targets: `powerpc-unknown-linux-gnu`
165207- C compiler > gcc version = 4.9.3
166208- C compiler > C++ = ENABLE -- to cross compile LLVM
167209
168- ## ` powerpc64-linux-gnu.config `
210+ ### `powerpc64-linux-gnu.config`
169211
170212For targets: `powerpc64-unknown-linux-gnu`
171213
@@ -184,7 +226,7 @@ For targets: `powerpc64-unknown-linux-gnu`
184226
185227(+) These CPU options match the configuration of the toolchains in RHEL6.
186228
187- ## ` s390x-linux-gnu.config `
229+ ### `s390x-linux-gnu.config`
188230
189231For targets: `s390x-unknown-linux-gnu`
190232
0 commit comments