@@ -22,6 +22,48 @@ Images will output artifacts in an `obj` dir at the root of a repository.
22
22
- ` scripts ` contains files shared by docker images
23
23
- ` disabled ` contains images that are not built on travis
24
24
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
+
25
67
## Cross toolchains
26
68
27
69
A 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`
137
179
libraries like jemalloc. See the mk/cfg/arm(v7)-uknown-linux-gnueabi{,hf}.mk
138
180
file in Rust's source code.
139
181
140
- ## ` aarch64-linux-gnu.config `
182
+ ### `aarch64-linux-gnu.config`
141
183
142
184
For targets: `aarch64-unknown-linux-gnu`
143
185
@@ -150,7 +192,7 @@ For targets: `aarch64-unknown-linux-gnu`
150
192
- C compiler > gcc version = 5.2.0
151
193
- C compiler > C++ = ENABLE -- to cross compile LLVM
152
194
153
- ## ` powerpc-linux-gnu.config `
195
+ ### `powerpc-linux-gnu.config`
154
196
155
197
For targets: `powerpc-unknown-linux-gnu`
156
198
@@ -165,7 +207,7 @@ For targets: `powerpc-unknown-linux-gnu`
165
207
- C compiler > gcc version = 4.9.3
166
208
- C compiler > C++ = ENABLE -- to cross compile LLVM
167
209
168
- ## ` powerpc64-linux-gnu.config `
210
+ ### `powerpc64-linux-gnu.config`
169
211
170
212
For targets: `powerpc64-unknown-linux-gnu`
171
213
@@ -184,7 +226,7 @@ For targets: `powerpc64-unknown-linux-gnu`
184
226
185
227
(+) These CPU options match the configuration of the toolchains in RHEL6.
186
228
187
- ## ` s390x-linux-gnu.config `
229
+ ### `s390x-linux-gnu.config`
188
230
189
231
For targets: `s390x-unknown-linux-gnu`
190
232
0 commit comments