/[gentoo]/xml/htdocs/doc/en/handbook/hb-install-mips-system.xml
Gentoo

Diff of /xml/htdocs/doc/en/handbook/hb-install-mips-system.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.3 Revision 1.12
2<!DOCTYPE sections SYSTEM "/dtd/book.dtd"> 2<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
3 3
4<!-- The content of this document is licensed under the CC-BY-SA license --> 4<!-- The content of this document is licensed under the CC-BY-SA license -->
5<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 5<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
6 6
7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/Attic/hb-install-mips-system.xml,v 1.3 2006/11/09 07:39:39 nightmorph Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/Attic/hb-install-mips-system.xml,v 1.12 2013/01/02 19:28:52 swift Exp $ -->
8 8
9<sections> 9<sections>
10 10
11<version>7.2</version> 11<version>13</version>
12<date>2006-11-08</date> 12<date>2013-01-03</date>
13 13
14<section> 14<section>
15<title>Chrooting</title> 15<title>Chrooting</title>
16<!--<subsection> MIPS install media doesn't include mirrorselect
17<title>Optional: Selecting Mirrors</title>
18<body>
19
20<p>
21In order to download source code quickly it is recommended to select a fast
22mirror. Portage will look in your <path>make.conf</path> file for the
23GENTOO_MIRRORS variable and use the mirrors listed therein. You can surf to
24our <uri link="/main/en/mirrors.xml">mirror list</uri> and search
25for a mirror (or mirrors) close to you (as those are most frequently the
26fastest ones), but we provide a nice tool called <c>mirrorselect</c> which
27provides you with a nice interface to select the mirrors you want.
28</p>
29
30<pre caption="Using mirrorselect for the GENTOO_MIRRORS variable">
31# <i>mirrorselect -i -o &gt;&gt; /mnt/gentoo/etc/make.conf</i>
32</pre>
33
34<warn>
35Do not select any IPv6 mirrors. Our stages currently do not support IPv6.
36</warn>
37
38<p>
39A second important setting is the SYNC setting in <path>make.conf</path>. This
40variable contains the rsync server you want to use when updating your Portage
41tree (the collection of ebuilds, scripts containing all the information Portage
42needs to download and install software). Although you can manually enter a SYNC
43server for yourself, <c>mirrorselect</c> can ease that operation for you:
44</p>
45
46<pre caption="Selecting an rsync mirror using mirrorselect">
47# <i>mirrorselect -i -r -o &gt;&gt; /mnt/gentoo/etc/make.conf</i>
48</pre>
49
50<p>
51After running <c>mirrorselect</c> it is adviseable to double-check the settings
52in <path>/mnt/gentoo/etc/make.conf</path> !
53</p>
54
55</body>
56</subsection>-->
57<subsection> 16<subsection>
58<title>Copy DNS Info</title> 17<title>Copy DNS Info</title>
59<body> 18<body>
60 19
61<p> 20<p>
66network. 25network.
67</p> 26</p>
68 27
69<pre caption="Copy over DNS information"> 28<pre caption="Copy over DNS information">
70<comment>(The "-L" option is needed to make sure we don't copy a symbolic link)</comment> 29<comment>(The "-L" option is needed to make sure we don't copy a symbolic link)</comment>
71# <i>cp -L /etc/resolv.conf /mnt/gentoo/etc/resolv.conf</i> 30# <i>cp -L /etc/resolv.conf /mnt/gentoo/etc/</i>
72</pre> 31</pre>
73 32
74</body> 33</body>
75</subsection>
76<subsection> 34</subsection>
35<subsection>
77<title>Mounting the /proc and /dev Filesystems</title> 36<title>Mounting the necessary Filesystems</title>
78<body> 37<body>
79 38
80<p> 39<p>
81Mount the <path>/proc</path> filesystem on <path>/mnt/gentoo/proc</path> to 40Mount the <path>/proc</path> filesystem on <path>/mnt/gentoo/proc</path> to
82allow the installation to use the kernel-provided information within the 41allow the installation to use the kernel-provided information within the
83chrooted environment, and then mount-bind the <path>/dev</path> filesystem. 42chrooted environment, and then mount-bind the <path>/dev</path> and
43<path>/sys</path> filesystems.
84</p> 44</p>
85 45
86<pre caption="Mounting /proc and /dev"> 46<pre caption="Mounting /proc and /dev">
87# <i>mount -t proc none /mnt/gentoo/proc</i> 47# <i>mount -t proc none /mnt/gentoo/proc</i>
48# <i>mount --rbind /sys /mnt/gentoo/sys</i>
88# <i>mount -o bind /dev /mnt/gentoo/dev</i> 49# <i>mount --rbind /dev /mnt/gentoo/dev</i>
89</pre> 50</pre>
90 51
91</body> 52</body>
92</subsection> 53</subsection>
93<subsection> 54<subsection>
103</p> 64</p>
104 65
105<p> 66<p>
106This chrooting is done in three steps. First we will change the root 67This chrooting is done in three steps. First we will change the root
107from <path>/</path> (on the installation medium) to <path>/mnt/gentoo</path> 68from <path>/</path> (on the installation medium) to <path>/mnt/gentoo</path>
108(on your partitions) using <c>chroot</c>. Then we will create a new environment 69(on your partitions) using <c>chroot</c>. Then we will reload some settings, as
109using <c>env-update</c>, which essentially creates environment variables. 70provided by <path>/etc/profile</path>, in memory using <c>source</c>.
110Finally, we load those variables into memory using <c>source</c>.
111</p> 71</p>
112 72
113<pre caption = "Chrooting into the new environment"> 73<pre caption = "Chrooting into the new environment">
114# <i>chroot /mnt/gentoo /bin/bash</i> 74# <i>chroot /mnt/gentoo /bin/bash</i>
115# <i>env-update</i>
116>> Regenerating /etc/ld.so.cache...
117# <i>source /etc/profile</i> 75# <i>source /etc/profile</i>
118# <i>export PS1="(chroot) $PS1"</i> 76# <i>export PS1="(chroot) $PS1"</i>
119</pre> 77</pre>
120 78
121<p> 79<p>
152you. 110you.
153</p> 111</p>
154 112
155<p> 113<p>
156If you are warned that a new Portage version is available and that you should 114If you are warned that a new Portage version is available and that you should
157update Portage, you should do it now using <c>emerge portage</c> command. 115update Portage, you should do it now using <c>emerge --oneshot portage</c>.
158</p> 116</p>
159 117
160</body> 118</body>
161</subsection> 119</subsection>
162<subsection> 120<subsection>
186<c>gcc</c> and <c>mips-sources</c>). 144<c>gcc</c> and <c>mips-sources</c>).
187</p> 145</p>
188 146
189<p> 147<p>
190Thus, care needs to be taken to ensure the correct profile is selected for your 148Thus, care needs to be taken to ensure the correct profile is selected for your
191system type. As of Gentoo/MIPS 2006.1, the profiles are: 149system type. As of Gentoo/MIPS 2007.0, the profiles are:
192</p> 150</p>
193 151
194<table> 152<table>
195 <tr> 153 <tr>
196 <th>System</th> 154 <th>System</th>
197 <th>Profile</th> 155 <th>Profile</th>
198 <th>Userland</th> 156 <th>Userland</th>
199 <th>Status/Notes</th> 157 <th>Status/Notes</th>
200 </tr> 158 </tr>
201
202 <tr> 159 <tr>
203 <ti>Cobalt Qube/RaQ</ti> 160 <ti>Cobalt Qube/RaQ</ti>
204 <ti>default-linux/mips/2006.1/cobalt/o32</ti> 161 <ti>default-linux/mips/2007.0/cobalt/o32</ti>
205 <ti>32-bit Linuxthreads</ti> 162 <ti>32-bit Linuxthreads</ti>
206 <ti>Recommended</ti> 163 <ti>Recommended</ti>
207 </tr> 164 </tr>
208 <tr> 165 <tr>
209 <ti>"</ti> 166 <ti>"</ti>
210 <ti>default-linux/mips/2006.1/cobalt/o32/nptl</ti> 167 <ti>default-linux/mips/2007.0/cobalt/o32/nptl</ti>
211 <ti>32-bit NPTL</ti> 168 <ti>32-bit NPTL</ti>
212 <ti>In Testing (1)</ti> 169 <ti>In Testing (1)</ti>
213 </tr> 170 </tr>
214
215 <tr>
216 <th>&nbsp;</th>
217 <th>&nbsp;</th>
218 <th>&nbsp;</th>
219 <th>&nbsp;</th>
220 </tr> 171 <tr>
221 172 <th>&nbsp;</th>
173 <th>&nbsp;</th>
174 <th>&nbsp;</th>
175 <th>&nbsp;</th>
176 </tr>
222 <tr> 177 <tr>
223 <ti> 178 <ti>
224 Generic Big Endian<br /> 179 Generic Big Endian<br />
225 <e>Including SGI Indy, Indigo2 (R4x00), Challenge S and O2</e> 180 <e>Including SGI Indy, Indigo2 (R4x00), Challenge S and O2</e>
226 </ti> 181 </ti>
227 <ti>default-linux/mips/2006.1/generic-be/o32</ti> 182 <ti>default-linux/mips/2007.0/generic-be/o32</ti>
228 <ti>32-bit Linuxthreads</ti> 183 <ti>32-bit Linuxthreads</ti>
229 <ti>Recommended</ti> 184 <ti>Recommended</ti>
230 </tr> 185 </tr>
231 <tr> 186 <tr>
232 <ti>"</ti> 187 <ti>"</ti>
233 <ti>default-linux/mips/2006.1/generic-be/o32/nptl</ti> 188 <ti>default-linux/mips/2007.0/generic-be/o32/nptl</ti>
234 <ti>32-bit NPTL</ti> 189 <ti>32-bit NPTL</ti>
235 <ti>In Testing (1)</ti> 190 <ti>In Testing (1)</ti>
236 </tr> 191 </tr>
237 <tr> 192 <tr>
238 <ti>"</ti> 193 <ti>"</ti>
239 <ti>default-linux/mips/2006.1/generic-be/n32</ti> 194 <ti>default-linux/mips/2007.0/generic-be/n32</ti>
240 <ti>N32 Linuxthreads</ti> 195 <ti>N32 Linuxthreads</ti>
241 <ti>Highly Experimental (2)</ti> 196 <ti>Highly Experimental (2)</ti>
242 </tr> 197 </tr>
243 <tr> 198 <tr>
244 <ti>"</ti> 199 <ti>"</ti>
245 <ti>default-linux/mips/2006.1/generic-be/n32/nptl</ti> 200 <ti>default-linux/mips/2007.0/generic-be/n32/nptl</ti>
246 <ti>N32 NPTL</ti> 201 <ti>N32 NPTL</ti>
247 <ti>Highly Experimental (1) (2)</ti> 202 <ti>Highly Experimental (1) (2)</ti>
248 </tr> 203 </tr>
249 <tr> 204 <tr>
250 <ti>"</ti> 205 <ti>"</ti>
251 <ti>default-linux/mips/2006.1/generic-be/n64</ti> 206 <ti>default-linux/mips/2007.0/generic-be/n64</ti>
252 <ti>N64 Linuxthreads</ti> 207 <ti>N64 Linuxthreads</ti>
253 <ti>Unsupported (3)</ti> 208 <ti>Unsupported (3)</ti>
254 </tr> 209 </tr>
255 <tr> 210 <tr>
256 <ti>"</ti> 211 <ti>"</ti>
257 <ti>default-linux/mips/2006.1/generic-be/n64/nptl</ti> 212 <ti>default-linux/mips/2007.0/generic-be/n64/nptl</ti>
258 <ti>N64 NPTL</ti> 213 <ti>N64 NPTL</ti>
259 <ti>Unsupported (1) (3)</ti> 214 <ti>Unsupported (1) (3)</ti>
260 </tr> 215 </tr>
261
262 <tr>
263 <th>&nbsp;</th>
264 <th>&nbsp;</th>
265 <th>&nbsp;</th>
266 <th>&nbsp;</th>
267 </tr> 216 <tr>
268 217 <th>&nbsp;</th>
218 <th>&nbsp;</th>
219 <th>&nbsp;</th>
220 <th>&nbsp;</th>
221 </tr>
269 <tr> 222 <tr>
270 <ti>SGI Origin 200/2000</ti> 223 <ti>SGI Origin 200/2000</ti>
271 <ti>default-linux/mips/2006.1/ip27/o32</ti> 224 <ti>default-linux/mips/2007.0/ip27/o32</ti>
272 <ti>32-bit Linuxthreads</ti> 225 <ti>32-bit Linuxthreads</ti>
273 <ti>Recommended</ti> 226 <ti>Recommended</ti>
274 </tr> 227 </tr>
275 <tr> 228 <tr>
276 <ti>"</ti> 229 <ti>"</ti>
277 <ti>default-linux/mips/2006.1/ip27/o32/nptl</ti> 230 <ti>default-linux/mips/2007.0/ip27/o32/nptl</ti>
278 <ti>32-bit NPTL</ti> 231 <ti>32-bit NPTL</ti>
279 <ti>In Testing (1)</ti> 232 <ti>In Testing (1)</ti>
280 </tr> 233 </tr>
281 <tr> 234 <tr>
282 <ti>"</ti> 235 <ti>"</ti>
283 <ti>default-linux/mips/2006.1/ip27/n32</ti> 236 <ti>default-linux/mips/2007.0/ip27/n32</ti>
284 <ti>N32 Linuxthreads</ti> 237 <ti>N32 Linuxthreads</ti>
285 <ti>Highly Experimental (2)</ti> 238 <ti>Highly Experimental (2)</ti>
286 </tr> 239 </tr>
287 <tr> 240 <tr>
288 <ti>"</ti> 241 <ti>"</ti>
289 <ti>default-linux/mips/2006.1/ip27/n32/nptl</ti> 242 <ti>default-linux/mips/2007.0/ip27/n32/nptl</ti>
290 <ti>N32 NPTL</ti> 243 <ti>N32 NPTL</ti>
291 <ti>Highly Experimental (1) (2)</ti> 244 <ti>Highly Experimental (1) (2)</ti>
292 </tr> 245 </tr>
293 246
294 <tr> 247 <tr>
295 <th>&nbsp;</th> 248 <th>&nbsp;</th>
296 <th>&nbsp;</th> 249 <th>&nbsp;</th>
297 <th>&nbsp;</th> 250 <th>&nbsp;</th>
298 <th>&nbsp;</th> 251 <th>&nbsp;</th>
299 </tr> 252 </tr>
300
301 <tr> 253 <tr>
302 <ti>SGI Indigo2 Impact R10000</ti> 254 <ti>SGI Indigo2 Impact R10000</ti>
303 <ti>default-linux/mips/2006.1/ip28/o32</ti> 255 <ti>default-linux/mips/2007.0/ip28/o32</ti>
304 <ti>32-bit Linuxthreads</ti> 256 <ti>32-bit Linuxthreads</ti>
305 <ti>Recommended</ti> 257 <ti>Recommended</ti>
306 </tr> 258 </tr>
307 <tr> 259 <tr>
308 <ti>"</ti> 260 <ti>"</ti>
309 <ti>default-linux/mips/2006.1/ip28/o32/nptl</ti> 261 <ti>default-linux/mips/2007.0/ip28/o32/nptl</ti>
310 <ti>32-bit NPTL</ti> 262 <ti>32-bit NPTL</ti>
311 <ti>In Testing (1)</ti> 263 <ti>In Testing (1)</ti>
312 </tr> 264 </tr>
313 <tr> 265 <tr>
314 <ti>"</ti> 266 <ti>"</ti>
315 <ti>default-linux/mips/2006.1/ip28/n32</ti> 267 <ti>default-linux/mips/2007.0/ip28/n32</ti>
316 <ti>N32 Linuxthreads</ti> 268 <ti>N32 Linuxthreads</ti>
317 <ti>Highly Experimental (2)</ti> 269 <ti>Highly Experimental (2)</ti>
318 </tr> 270 </tr>
319 <tr> 271 <tr>
320 <ti>"</ti> 272 <ti>"</ti>
321 <ti>default-linux/mips/2006.1/ip28/n32/nptl</ti> 273 <ti>default-linux/mips/2007.0/ip28/n32/nptl</ti>
322 <ti>N32 NPTL</ti> 274 <ti>N32 NPTL</ti>
323 <ti>Highly Experimental (1) (2)</ti> 275 <ti>Highly Experimental (1) (2)</ti>
324 </tr> 276 </tr>
325
326 <tr>
327 <th>&nbsp;</th>
328 <th>&nbsp;</th>
329 <th>&nbsp;</th>
330 <th>&nbsp;</th>
331 </tr> 277 <tr>
332 278 <th>&nbsp;</th>
279 <th>&nbsp;</th>
280 <th>&nbsp;</th>
281 <th>&nbsp;</th>
282 </tr>
333 <tr> 283 <tr>
334 <ti>SGI Octane/Octane2</ti> 284 <ti>SGI Octane/Octane2</ti>
335 <ti>default-linux/mips/2006.1/ip30/o32</ti> 285 <ti>default-linux/mips/2007.0/ip30/o32</ti>
336 <ti>32-bit Linuxthreads</ti> 286 <ti>32-bit Linuxthreads</ti>
337 <ti>Recommended</ti> 287 <ti>Recommended</ti>
338 </tr> 288 </tr>
339 <tr> 289 <tr>
340 <ti>"</ti> 290 <ti>"</ti>
341 <ti>default-linux/mips/2006.1/ip30/o32/nptl</ti> 291 <ti>default-linux/mips/2007.0/ip30/o32/nptl</ti>
342 <ti>32-bit NPTL</ti> 292 <ti>32-bit NPTL</ti>
343 <ti>In Testing (1)</ti> 293 <ti>In Testing (1)</ti>
344 </tr> 294 </tr>
345 <tr> 295 <tr>
346 <ti>"</ti> 296 <ti>"</ti>
347 <ti>default-linux/mips/2006.1/ip30/n32</ti> 297 <ti>default-linux/mips/2007.0/ip30/n32</ti>
348 <ti>N32 Linuxthreads</ti> 298 <ti>N32 Linuxthreads</ti>
349 <ti>Highly Experimental (2)</ti> 299 <ti>Highly Experimental (2)</ti>
350 </tr> 300 </tr>
351 <tr> 301 <tr>
352 <ti>"</ti> 302 <ti>"</ti>
353 <ti>default-linux/mips/2006.1/ip30/n32/nptl</ti> 303 <ti>default-linux/mips/2007.0/ip30/n32/nptl</ti>
354 <ti>N32 NPTL</ti> 304 <ti>N32 NPTL</ti>
355 <ti>Highly Experimental (1) (2)</ti> 305 <ti>Highly Experimental (1) (2)</ti>
356 </tr> 306 </tr>
357</table> 307</table>
358 308
359<impo> 309<impo>
360(1) NPTL is in-testing on MIPS at this stage, requiring 310(1) NPTL is in-testing on MIPS at this stage, requiring <c>gcc-4.1</c> and
361<c>gcc-4.1</c> and <c>glibc-2.4</c>. These profiles 311<c>glibc-2.4</c>. It is believed that NPTL should be safe enough now for people
362are a work-in-progress, and are not guaranteed to work. It is recommended that 312to use, and is planned to be the default in future releases. Brave users are
363people do not use these profiles until all the issues have been resolved. 313welcomed to try these profiles out and report back.
364</impo> 314</impo>
365 315
366<warn> 316<warn>
367(2) n32 Userland is highly experimental, a lot of software has problems with 317(2) n32 Userland is highly experimental, a lot of software has problems with
368this ABI, and thus it is practically guaranteed that you will run into stability 318this ABI, and thus it is practically guaranteed that you will run into stability
381You can see what profile you are currently using with the following command: 331You can see what profile you are currently using with the following command:
382</p> 332</p>
383 333
384<pre caption="Verifying system profile"> 334<pre caption="Verifying system profile">
385# <i>ls -FGg /etc/make.profile</i> 335# <i>ls -FGg /etc/make.profile</i>
386lrwxrwxrwx 1 48 Apr 8 18:51 /etc/make.profile -> ../usr/portage/profiles/default-linux/mips/2006.1/generic-be/o32/ 336lrwxrwxrwx 1 48 Apr 8 18:51 /etc/make.profile -> ../usr/portage/profiles/<keyval id="profile"/>
387</pre> 337</pre>
388 338
389<p> 339<p>
390Having looked through the profiles above, and decided which one is the most 340Having looked through the profiles above, and decided which one is the most
391appropriate, you need to adjust your <path>make.profile</path> symlink to 341appropriate, you need to adjust your <path>make.profile</path> symlink to
398<comment>(Delete the old profile symlink)</comment> 348<comment>(Delete the old profile symlink)</comment>
399# <i>rm -f /etc/make.profile</i> 349# <i>rm -f /etc/make.profile</i>
400 350
401<comment>(Create a new symlink pointing to your chosen profile ) 351<comment>(Create a new symlink pointing to your chosen profile )
402(For example, this is what one would use on an Indy or O2.)</comment> 352(For example, this is what one would use on an Indy or O2.)</comment>
403# <i>ln -s /usr/portage/profiles/default-linux/mips/2006.1/generic-be/o32</i> 353# <i>ln -s /usr/portage/profiles/default-linux/mips/2007.0/generic-be/o32</i>
404</pre> 354</pre>
405 355
406<note> 356<note>
407A tip for those not familiar with the Bourne Again Shell... If you partially 357A tip for those not familiar with the Bourne Again Shell... If you partially
408type a filename or command, then hit the TAB key, it will automatically fill out 358type a filename or command, then hit the TAB key, it will automatically fill out
438 388
439<p> 389<p>
440In the <c>USE</c> variable you define keywords which are mapped onto 390In the <c>USE</c> variable you define keywords which are mapped onto
441compile-options. For instance, <e>ssl</e> will compile ssl-support in the 391compile-options. For instance, <e>ssl</e> will compile ssl-support in the
442programs that support it. <e>-X</e> will remove X-server support (note the 392programs that support it. <e>-X</e> will remove X-server support (note the
443minus sign in front). <e>gnome gtk -kde -qt3 -qt4</e> will compile your 393minus sign in front). <e>gnome gtk -kde -qt4</e> will compile your
444programs with gnome (and gtk) support, and not with kde (and qt) support, 394programs with gnome (and gtk) support, and not with kde (and qt) support,
445making your system fully tweaked for GNOME. 395making your system fully tweaked for GNOME.
446</p> 396</p>
447 397
448<p> 398<p>
479<pre caption="Opening /etc/make.conf"> 429<pre caption="Opening /etc/make.conf">
480# <i>nano -w /etc/make.conf</i> 430# <i>nano -w /etc/make.conf</i>
481</pre> 431</pre>
482 432
483<pre caption="USE setting"> 433<pre caption="USE setting">
484USE="-gtk -gnome qt3 qt4 kde dvd alsa cdr" 434USE="-gtk -gnome qt4 kde dvd alsa cdr"
485</pre> 435</pre>
486 436
487</body> 437</body>
488</subsection> 438</subsection>
489<subsection> 439<subsection>
514<p> 464<p>
515The next step is to run <c>locale-gen</c>. It will generate all the locales you 465The next step is to run <c>locale-gen</c>. It will generate all the locales you
516have specified in the <path>/etc/locale.gen</path> file. 466have specified in the <path>/etc/locale.gen</path> file.
517</p> 467</p>
518 468
519<note> 469<pre caption="Running locale-gen">
520<c>locale-gen</c> is available in <c>glibc-2.3.6-r4</c> and newer. If you have 470# <i>locale-gen</i>
521an older version of glibc, you should update it now. 471</pre>
522</note>
523 472
524<p> 473<p>
525Now continue with <uri link="?part=1&amp;chap=7">Configuring the Kernel</uri>. 474Now continue with <uri link="?part=1&amp;chap=7">Configuring the Kernel</uri>.
526</p> 475</p>
527 476

Legend:
Removed from v.1.3  
changed lines
  Added in v.1.12

  ViewVC Help
Powered by ViewVC 1.1.20