1 |
fox2mike 06/02/27 00:55:35 |
2 |
|
3 |
Modified: xml/htdocs/doc/en/handbook handbook-mips.xml |
4 |
handbook-ppc.xml hb-install-alpha-medium.xml |
5 |
hb-install-amd64-medium.xml hb-install-config.xml |
6 |
hb-install-hppa-kernel.xml |
7 |
hb-install-hppa-medium.xml |
8 |
hb-install-mips-bootloader.xml |
9 |
hb-install-mips-disk.xml hb-install-mips-kernel.xml |
10 |
hb-install-mips-medium.xml |
11 |
hb-install-ppc-bootloader.xml |
12 |
hb-install-ppc-disk.xml hb-install-ppc-kernel.xml |
13 |
hb-install-ppc-medium.xml |
14 |
hb-install-ppc64-bootloader.xml |
15 |
hb-install-ppc64-disk.xml |
16 |
hb-install-ppc64-kernel.xml |
17 |
hb-install-ppc64-medium.xml |
18 |
hb-install-sparc-medium.xml hb-install-stage.xml |
19 |
hb-install-system.xml hb-install-x86-medium.xml |
20 |
index.xml |
21 |
Added: xml/htdocs/doc/en/handbook hb-install-mips-stage.xml |
22 |
Log: |
23 |
Handbook for 2006.0, "Chuck Norris can divide by zero" |
24 |
|
25 |
Revision Changes Path |
26 |
1.108 +6 -6 xml/htdocs/doc/en/handbook/handbook-mips.xml |
27 |
|
28 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-mips.xml?rev=1.108&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
29 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-mips.xml?rev=1.108&content-type=text/plain&cvsroot=gentoo |
30 |
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-mips.xml.diff?r1=1.107&r2=1.108&cvsroot=gentoo |
31 |
|
32 |
Index: handbook-mips.xml |
33 |
=================================================================== |
34 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-mips.xml,v |
35 |
retrieving revision 1.107 |
36 |
retrieving revision 1.108 |
37 |
diff -u -r1.107 -r1.108 |
38 |
--- handbook-mips.xml 19 Dec 2005 12:36:15 -0000 1.107 |
39 |
+++ handbook-mips.xml 27 Feb 2006 00:55:34 -0000 1.108 |
40 |
@@ -1,7 +1,7 @@ |
41 |
<?xml version='1.0' encoding='UTF-8'?> |
42 |
<!DOCTYPE book SYSTEM "/dtd/book.dtd"> |
43 |
|
44 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-mips.xml,v 1.107 2005/12/19 12:36:15 jkt Exp $ --> |
45 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-mips.xml,v 1.108 2006/02/27 00:55:34 fox2mike Exp $ --> |
46 |
|
47 |
<book link="handbook-mips.xml"> |
48 |
<title>Gentoo Linux/MIPS Handbook</title> |
49 |
@@ -90,7 +90,7 @@ |
50 |
<mail link="kumba@g.o">Joshua Kinard</mail> |
51 |
</author> |
52 |
<author title="Editor"> |
53 |
- <mail link="stuartl@××××××××××××××××××.org">Stuart Longland</mail> |
54 |
+ <mail link="redhatter@g.o">Stuart Longland</mail> |
55 |
</author> |
56 |
<author title="Editor"> |
57 |
<mail link="dertobi123@g.o">Tobias Scherbaum</mail> |
58 |
@@ -124,8 +124,8 @@ |
59 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
60 |
<license/> |
61 |
|
62 |
-<version>4.3</version> |
63 |
-<date>2005-12-19</date> |
64 |
+<version>4.4</version> |
65 |
+<date>2006-02-27</date> |
66 |
|
67 |
<part> |
68 |
<title>Installing Gentoo</title> |
69 |
@@ -175,7 +175,7 @@ |
70 |
Gentoo installs work through a stage3 archive. In this chapter we |
71 |
describe how you extract the stage3 archive and configure Portage. |
72 |
</abstract> |
73 |
- <include href="hb-install-stage.xml"/> |
74 |
+ <include href="hb-install-mips-stage.xml"/> |
75 |
</chapter> |
76 |
|
77 |
<chapter> |
78 |
@@ -221,7 +221,7 @@ |
79 |
<abstract> |
80 |
On both Silicon Graphics machines, and on Cobalt servers, both require the use |
81 |
of a bootloader to load the kernel. This section covers setting up |
82 |
-arcboot (for SGI machines) and colo for Cobalt servers. |
83 |
+arcboot/arcload (for SGI machines) and colo for Cobalt servers. |
84 |
</abstract> |
85 |
<include href="hb-install-mips-bootloader.xml"/> |
86 |
</chapter> |
87 |
|
88 |
|
89 |
|
90 |
1.138 +6 -3 xml/htdocs/doc/en/handbook/handbook-ppc.xml |
91 |
|
92 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc.xml?rev=1.138&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
93 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc.xml?rev=1.138&content-type=text/plain&cvsroot=gentoo |
94 |
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/handbook-ppc.xml.diff?r1=1.137&r2=1.138&cvsroot=gentoo |
95 |
|
96 |
Index: handbook-ppc.xml |
97 |
=================================================================== |
98 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc.xml,v |
99 |
retrieving revision 1.137 |
100 |
retrieving revision 1.138 |
101 |
diff -u -r1.137 -r1.138 |
102 |
--- handbook-ppc.xml 19 Dec 2005 12:36:15 -0000 1.137 |
103 |
+++ handbook-ppc.xml 27 Feb 2006 00:55:34 -0000 1.138 |
104 |
@@ -1,7 +1,7 @@ |
105 |
<?xml version='1.0' encoding='UTF-8'?> |
106 |
<!DOCTYPE book SYSTEM "/dtd/book.dtd"> |
107 |
|
108 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc.xml,v 1.137 2005/12/19 12:36:15 jkt Exp $ --> |
109 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc.xml,v 1.138 2006/02/27 00:55:34 fox2mike Exp $ --> |
110 |
|
111 |
<book link="handbook-ppc.xml"> |
112 |
<title>Gentoo Linux PPC Handbook</title> |
113 |
@@ -101,6 +101,9 @@ |
114 |
<author title="Editor"> |
115 |
<mail link="neysx@g.o">Xavier Neys</mail> |
116 |
</author> |
117 |
+<author title="Editor"> |
118 |
+ <mail link="josejx@g.o">Joseph Jezak</mail> |
119 |
+</author> |
120 |
<author title="Reviewer"> |
121 |
<mail link="g2boojum@g.o">Grant Goodyear</mail> |
122 |
</author> |
123 |
@@ -124,8 +127,8 @@ |
124 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
125 |
<license/> |
126 |
|
127 |
-<version>4.3</version> |
128 |
-<date>2005-12-19</date> |
129 |
+<version>4.4</version> |
130 |
+<date>2006-02-27</date> |
131 |
|
132 |
<part> |
133 |
<title>Installing Gentoo</title> |
134 |
|
135 |
|
136 |
|
137 |
1.40 +23 -14 xml/htdocs/doc/en/handbook/hb-install-alpha-medium.xml |
138 |
|
139 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-alpha-medium.xml?rev=1.40&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
140 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-alpha-medium.xml?rev=1.40&content-type=text/plain&cvsroot=gentoo |
141 |
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-alpha-medium.xml.diff?r1=1.39&r2=1.40&cvsroot=gentoo |
142 |
|
143 |
Index: hb-install-alpha-medium.xml |
144 |
=================================================================== |
145 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-medium.xml,v |
146 |
retrieving revision 1.39 |
147 |
retrieving revision 1.40 |
148 |
diff -u -r1.39 -r1.40 |
149 |
--- hb-install-alpha-medium.xml 29 Nov 2005 14:48:46 -0000 1.39 |
150 |
+++ hb-install-alpha-medium.xml 27 Feb 2006 00:55:34 -0000 1.40 |
151 |
@@ -4,12 +4,12 @@ |
152 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
153 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
154 |
|
155 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-medium.xml,v 1.39 2005/11/29 14:48:46 jkt Exp $ --> |
156 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-medium.xml,v 1.40 2006/02/27 00:55:34 fox2mike Exp $ --> |
157 |
|
158 |
<sections> |
159 |
|
160 |
-<version>2.10</version> |
161 |
-<date>2005-11-29</date> |
162 |
+<version>2.11</version> |
163 |
+<date>2006-02-27</date> |
164 |
|
165 |
<section> |
166 |
<title>Hardware Requirements</title> |
167 |
@@ -80,7 +80,7 @@ |
168 |
<p> |
169 |
If you wish to install Gentoo without a working Internet connection, please use |
170 |
the installation instructions described in the <uri |
171 |
-link="2005.1/index.xml">Gentoo 2005.1 Handbooks</uri>. |
172 |
+link="2006.0/index.xml">Gentoo 2006.0 Handbooks</uri>. |
173 |
</p> |
174 |
|
175 |
<p> |
176 |
@@ -112,8 +112,8 @@ |
177 |
<body> |
178 |
|
179 |
<p> |
180 |
-The Minimal Installation CD is called <c>install-alpha-minimal-2005.1.iso</c> |
181 |
-and takes up only 54 MB of diskspace. You can use this Installation CD to |
182 |
+The Minimal Installation CD is called <c>install-alpha-minimal-2006.0.iso</c> |
183 |
+and takes up only 65 MB of diskspace. You can use this Installation CD to |
184 |
install Gentoo, but always with a working Internet connection only. |
185 |
</p> |
186 |
|
187 |
@@ -142,11 +142,11 @@ |
188 |
<body> |
189 |
|
190 |
<p> |
191 |
-The Universal Installation CD is called <c>install-alpha-universal-2005.1.iso</c> |
192 |
-and consumes the entire surface of a 650 MB CD. You can use this Installation CD |
193 |
-to install Gentoo, and you can even use it to install Gentoo without a working |
194 |
-internet connection, just in case you want to bring Gentoo to another PC than |
195 |
-the one you are currently installing Gentoo on :) |
196 |
+The Universal Installation CD is called <c>install-alpha-universal-2006.0.iso</c> |
197 |
+and consumes about 316 MB on a CD. You can use this Installation CD to install |
198 |
+Gentoo, and you can even use it to install Gentoo without a working internet |
199 |
+connection, just in case you want to bring Gentoo to another PC than the one |
200 |
+you are currently installing Gentoo on :) |
201 |
</p> |
202 |
|
203 |
<table> |
204 |
@@ -171,6 +171,7 @@ |
205 |
|
206 |
</body> |
207 |
</subsection> |
208 |
+<!-- No package CDs for Alpha - 2006.0 |
209 |
<subsection> |
210 |
<title>Other CDs</title> |
211 |
<body> |
212 |
@@ -190,7 +191,7 @@ |
213 |
</p> |
214 |
|
215 |
</body> |
216 |
-</subsection> |
217 |
+</subsection>--> |
218 |
<subsection> |
219 |
<title>The Stage3 Tarball</title> |
220 |
<body> |
221 |
@@ -225,7 +226,7 @@ |
222 |
<p> |
223 |
You can download any of the Installation CDs (and, if you want to, a Packages |
224 |
CD as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The |
225 |
-Installation CDs are located in the <path>releases/alpha/2005.1/installcd</path> |
226 |
+Installation CDs are located in the <path>releases/alpha/2006.0/installcd</path> |
227 |
directory. |
228 |
</p> |
229 |
|
230 |
@@ -237,7 +238,7 @@ |
231 |
<p> |
232 |
In case you wonder if your downloaded file is corrupted or not, you can |
233 |
check its MD5 checksum and compare it with the MD5 checksum we provide (such as |
234 |
-<path>install-alpha-minimal-2005.1.iso.md5</path>). You can check the MD5 |
235 |
+<path>install-alpha-minimal-2006.0.iso.DIGESTS</path>). You can check the MD5 |
236 |
checksum with the <c>md5sum</c> tool under Linux/Unix or <uri |
237 |
link="http://www.etree.org/md5com.html">md5sum</uri> for Windows. |
238 |
</p> |
239 |
@@ -336,6 +337,14 @@ |
240 |
MILO> <i>boot hdb:/boot/gentoo_2.4 initrd=/boot/gentoo_2_4.igz root=/dev/ram0 init=/linuxrc looptype=zisofs loop=/zisofs cdroot</i> |
241 |
</pre> |
242 |
|
243 |
+<note> |
244 |
+The default Alpha profile uses nptl and requires a 2.6 kernel. If your system |
245 |
+cannot support nptl (or you do not want to use nptl), you should use the 2.4 |
246 |
+kernel. Alternatively, if you prefer to compile your system without nptl, you |
247 |
+will be given the chance to select a stage built without nptl in <uri |
248 |
+link="?part=1&chap=5">Installing a Stage Tarball</uri>. |
249 |
+</note> |
250 |
+ |
251 |
<p> |
252 |
You should have a root ("#") prompt on the current console and can also switch |
253 |
to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get back to the one you |
254 |
|
255 |
|
256 |
|
257 |
1.44 +12 -12 xml/htdocs/doc/en/handbook/hb-install-amd64-medium.xml |
258 |
|
259 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-amd64-medium.xml?rev=1.44&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
260 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-amd64-medium.xml?rev=1.44&content-type=text/plain&cvsroot=gentoo |
261 |
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-amd64-medium.xml.diff?r1=1.43&r2=1.44&cvsroot=gentoo |
262 |
|
263 |
Index: hb-install-amd64-medium.xml |
264 |
=================================================================== |
265 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-amd64-medium.xml,v |
266 |
retrieving revision 1.43 |
267 |
retrieving revision 1.44 |
268 |
diff -u -r1.43 -r1.44 |
269 |
--- hb-install-amd64-medium.xml 6 Jan 2006 09:50:09 -0000 1.43 |
270 |
+++ hb-install-amd64-medium.xml 27 Feb 2006 00:55:34 -0000 1.44 |
271 |
@@ -4,12 +4,12 @@ |
272 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
273 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
274 |
|
275 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-amd64-medium.xml,v 1.43 2006/01/06 09:50:09 fox2mike Exp $ --> |
276 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-amd64-medium.xml,v 1.44 2006/02/27 00:55:34 fox2mike Exp $ --> |
277 |
|
278 |
<sections> |
279 |
|
280 |
-<version>2.12</version> |
281 |
-<date>2005-11-29</date> |
282 |
+<version>2.13</version> |
283 |
+<date>2006-02-27</date> |
284 |
|
285 |
<section> |
286 |
<title>Hardware Requirements</title> |
287 |
@@ -81,7 +81,7 @@ |
288 |
<p> |
289 |
If you wish to install Gentoo without a working Internet connection, please use |
290 |
the installation instructions described in the <uri |
291 |
-link="2005.1/index.xml">Gentoo 2005.1 Handbooks</uri>. |
292 |
+link="2006.0/index.xml">Gentoo 2006.0 Handbooks</uri>. |
293 |
</p> |
294 |
|
295 |
<p> |
296 |
@@ -114,7 +114,7 @@ |
297 |
|
298 |
<p> |
299 |
The Minimal Installation CD is called |
300 |
-<c>install-amd64-minimal-2005.1-r1.iso</c> and takes up only 67 MB of |
301 |
+<c>install-amd64-minimal-2006.0.iso</c> and takes up only 45 MB of |
302 |
diskspace. You can use this Installation CD to install Gentoo, but always with |
303 |
a working Internet connection only. |
304 |
</p> |
305 |
@@ -145,7 +145,7 @@ |
306 |
|
307 |
<p> |
308 |
The Universal Installation CD is called |
309 |
-<c>install-amd64-universal-2005.1-r1.iso</c> and takes up 393 MB. You can use |
310 |
+<c>install-amd64-universal-2006.0.iso</c> and takes up 401 MB. You can use |
311 |
this Installation CD to install Gentoo, and you can even use it to install |
312 |
Gentoo without a working internet connection, just in case you want to bring |
313 |
Gentoo to another PC than the one you are currently installing Gentoo on :) |
314 |
@@ -225,7 +225,7 @@ |
315 |
<p> |
316 |
You can download any of the Installation CDs (and, if you want to, a Packages |
317 |
CD as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The |
318 |
-Installation CDs are located in the <path>releases/amd64/2005.1-r1/installcd</path> |
319 |
+Installation CDs are located in the <path>releases/amd64/2006.0/installcd</path> |
320 |
directory. |
321 |
</p> |
322 |
|
323 |
@@ -237,7 +237,7 @@ |
324 |
<p> |
325 |
In case you wonder if your downloaded file is corrupted or not, you can |
326 |
check its MD5 checksum and compare it with the MD5 checksum we provide (such as |
327 |
-<path>install-amd64-minimal-2005.1-r1.iso.md5</path>). You can check the MD5 |
328 |
+<path>install-amd64-minimal-2006.0.iso.DIGESTS</path>). You can check the MD5 |
329 |
checksum with the <c>md5sum</c> tool under Linux/Unix or <uri |
330 |
link="http://www.etree.org/md5com.html">md5sum</uri> for Windows. |
331 |
</p> |
332 |
@@ -501,23 +501,23 @@ |
333 |
|
334 |
<p> |
335 |
If you want to view the documentation on the CD you can immediately run |
336 |
-<c>links2</c> to read it: |
337 |
+<c>links</c> to read it: |
338 |
</p> |
339 |
|
340 |
<pre caption="Viewing the on-CD documentation"> |
341 |
-# <i>links2 /mnt/cdrom/docs/handbook/html/index.html</i> |
342 |
+# <i>links /mnt/cdrom/docs/handbook/html/index.html</i> |
343 |
</pre> |
344 |
|
345 |
<p> |
346 |
However, it is preferred that you use the online Gentoo Handbook as it will be |
347 |
-more recent than the one provided on the CD. You can view it using <c>links2</c> |
348 |
+more recent than the one provided on the CD. You can view it using <c>links</c> |
349 |
as well, but only after having completed the <e>Configuring your Network</e> |
350 |
chapter (otherwise you won't be able to go on the Internet to view the |
351 |
document): |
352 |
</p> |
353 |
|
354 |
<pre caption="Viewing the Online Documentation"> |
355 |
-# <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-amd64.xml</i> |
356 |
+# <i>links http://www.gentoo.org/doc/en/handbook/handbook-amd64.xml</i> |
357 |
</pre> |
358 |
|
359 |
<p> |
360 |
|
361 |
|
362 |
|
363 |
1.75 +5 -4 xml/htdocs/doc/en/handbook/hb-install-config.xml |
364 |
|
365 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-config.xml?rev=1.75&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
366 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-config.xml?rev=1.75&content-type=text/plain&cvsroot=gentoo |
367 |
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-config.xml.diff?r1=1.74&r2=1.75&cvsroot=gentoo |
368 |
|
369 |
Index: hb-install-config.xml |
370 |
=================================================================== |
371 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-config.xml,v |
372 |
retrieving revision 1.74 |
373 |
retrieving revision 1.75 |
374 |
diff -u -r1.74 -r1.75 |
375 |
--- hb-install-config.xml 19 Nov 2005 09:31:05 -0000 1.74 |
376 |
+++ hb-install-config.xml 27 Feb 2006 00:55:34 -0000 1.75 |
377 |
@@ -4,12 +4,12 @@ |
378 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
379 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
380 |
|
381 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-config.xml,v 1.74 2005/11/19 09:31:05 swift Exp $ --> |
382 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-config.xml,v 1.75 2006/02/27 00:55:34 fox2mike Exp $ --> |
383 |
|
384 |
<sections> |
385 |
|
386 |
-<version>2.15</version> |
387 |
-<date>2005-11-19</date> |
388 |
+<version>2.17</version> |
389 |
+<date>2006-02-27</date> |
390 |
|
391 |
<section> |
392 |
<title>Filesystem Information</title> |
393 |
@@ -80,7 +80,8 @@ |
394 |
<p> |
395 |
Let us take a look at how we write down the options for the <path>/boot</path> |
396 |
partition. This is just an example, so if your architecture doesn't require a |
397 |
-<path>/boot</path> partition (such as <b>PPC</b>), don't copy it verbatim. |
398 |
+<path>/boot</path> partition (such as Apple <b>PPC</b> machines), don't copy it |
399 |
+verbatim. |
400 |
</p> |
401 |
|
402 |
<p> |
403 |
|
404 |
|
405 |
|
406 |
1.31 +5 -5 xml/htdocs/doc/en/handbook/hb-install-hppa-kernel.xml |
407 |
|
408 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-hppa-kernel.xml?rev=1.31&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
409 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-hppa-kernel.xml?rev=1.31&content-type=text/plain&cvsroot=gentoo |
410 |
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-hppa-kernel.xml.diff?r1=1.30&r2=1.31&cvsroot=gentoo |
411 |
|
412 |
Index: hb-install-hppa-kernel.xml |
413 |
=================================================================== |
414 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-kernel.xml,v |
415 |
retrieving revision 1.30 |
416 |
retrieving revision 1.31 |
417 |
diff -u -r1.30 -r1.31 |
418 |
--- hb-install-hppa-kernel.xml 8 Jan 2006 14:05:29 -0000 1.30 |
419 |
+++ hb-install-hppa-kernel.xml 27 Feb 2006 00:55:34 -0000 1.31 |
420 |
@@ -4,12 +4,12 @@ |
421 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
422 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
423 |
|
424 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-kernel.xml,v 1.30 2006/01/08 14:05:29 neysx Exp $ --> |
425 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-kernel.xml,v 1.31 2006/02/27 00:55:34 fox2mike Exp $ --> |
426 |
|
427 |
<sections> |
428 |
|
429 |
-<version>1.23</version> |
430 |
-<date>2006-01-06</date> |
431 |
+<version>1.24</version> |
432 |
+<date>2006-02-27</date> |
433 |
|
434 |
<section> |
435 |
<title>Timezone</title> |
436 |
@@ -63,13 +63,13 @@ |
437 |
<p> |
438 |
When you take a look in <path>/usr/src</path> you should see a symlink called |
439 |
<path>linux</path> pointing to your kernel source. In this case, the installed |
440 |
-kernel source points to <c>hppa-sources-2.6.12.2-pa2</c>. Your version may be |
441 |
+kernel source points to <c>hppa-sources-2.6.15.1-pa4</c>. Your version may be |
442 |
different, so keep this in mind. |
443 |
</p> |
444 |
|
445 |
<pre caption="Viewing the kernel source symlink"> |
446 |
# <i>ls -l /usr/src/linux</i> |
447 |
-lrwxrwxrwx 1 root root 12 Oct 13 11:04 /usr/src/linux -> linux-2.6.12.2-pa2 |
448 |
+lrwxrwxrwx 1 root root 12 Oct 13 11:04 /usr/src/linux -> linux-2.6.15.1-pa4 |
449 |
</pre> |
450 |
|
451 |
<p> |
452 |
|
453 |
|
454 |
|
455 |
1.39 +16 -16 xml/htdocs/doc/en/handbook/hb-install-hppa-medium.xml |
456 |
|
457 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-hppa-medium.xml?rev=1.39&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
458 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-hppa-medium.xml?rev=1.39&content-type=text/plain&cvsroot=gentoo |
459 |
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-hppa-medium.xml.diff?r1=1.38&r2=1.39&cvsroot=gentoo |
460 |
|
461 |
Index: hb-install-hppa-medium.xml |
462 |
=================================================================== |
463 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-medium.xml,v |
464 |
retrieving revision 1.38 |
465 |
retrieving revision 1.39 |
466 |
diff -u -r1.38 -r1.39 |
467 |
--- hb-install-hppa-medium.xml 29 Nov 2005 14:48:46 -0000 1.38 |
468 |
+++ hb-install-hppa-medium.xml 27 Feb 2006 00:55:34 -0000 1.39 |
469 |
@@ -4,12 +4,12 @@ |
470 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
471 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
472 |
|
473 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-medium.xml,v 1.38 2005/11/29 14:48:46 jkt Exp $ --> |
474 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-medium.xml,v 1.39 2006/02/27 00:55:34 fox2mike Exp $ --> |
475 |
|
476 |
<sections> |
477 |
|
478 |
-<version>1.29</version> |
479 |
-<date>2005-11-29</date> |
480 |
+<version>1.30</version> |
481 |
+<date>2006-02-27</date> |
482 |
|
483 |
<section> |
484 |
<title>Hardware Requirements</title> |
485 |
@@ -79,7 +79,7 @@ |
486 |
<p> |
487 |
If you wish to install Gentoo without a working Internet connection, please use |
488 |
the installation instructions described in the <uri |
489 |
-link="2005.1/index.xml">Gentoo 2005.1 Handbooks</uri>. |
490 |
+link="2006.0/index.xml">Gentoo 2006.0 Handbooks</uri>. |
491 |
</p> |
492 |
|
493 |
<p> |
494 |
@@ -111,8 +111,8 @@ |
495 |
<body> |
496 |
|
497 |
<p> |
498 |
-The Minimal Installation CD is called <c>install-hppa-minimal-2005.1.iso</c> |
499 |
-and takes up only 65 MB of diskspace. You can use this Installation CD to |
500 |
+The Minimal Installation CD is called <c>install-hppa-minimal-2006.0.iso</c> |
501 |
+and takes up only 75 MB of diskspace. You can use this Installation CD to |
502 |
install Gentoo, but always with a working Internet connection only. |
503 |
</p> |
504 |
|
505 |
@@ -141,11 +141,11 @@ |
506 |
<body> |
507 |
|
508 |
<p> |
509 |
-The Universal Installation CD is called <c>install-hppa-universal-2005.1.iso</c> |
510 |
-and consumes the entire surface of a 650 MB CD. You can use this Installation |
511 |
-CD to install Gentoo, and you can even use it to install Gentoo without a |
512 |
-working internet connection, just in case you want to bring Gentoo to another |
513 |
-PC than the one you are currently installing Gentoo on :) |
514 |
+The Universal Installation CD is called <c>install-hppa-universal-2006.0.iso</c> |
515 |
+and consumes about 339 MB on a CD. You can use this Installation CD to install |
516 |
+Gentoo, and you can even use it to install Gentoo without a working internet |
517 |
+connection, just in case you want to bring Gentoo to another PC than the one |
518 |
+you are currently installing Gentoo on :) |
519 |
</p> |
520 |
|
521 |
<table> |
522 |
@@ -222,7 +222,7 @@ |
523 |
<p> |
524 |
You can download any of the Installation CDs (and, if you want to, a Packages |
525 |
CD as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The |
526 |
-Installation CDs are located in the <path>releases/hppa/2005.1/installcd</path> |
527 |
+Installation CDs are located in the <path>releases/hppa/2006.0/installcd</path> |
528 |
directory. |
529 |
</p> |
530 |
|
531 |
@@ -518,23 +518,23 @@ |
532 |
|
533 |
<p> |
534 |
If you want to view the documentation on the CD you can immediately run |
535 |
-<c>links2</c> to read it: |
536 |
+<c>links</c> to read it: |
537 |
</p> |
538 |
|
539 |
<pre caption="Viewing the on-CD documentation"> |
540 |
-# <i>links2 /mnt/cdrom/docs/handbook/html/index.html</i> |
541 |
+# <i>links /mnt/cdrom/docs/handbook/html/index.html</i> |
542 |
</pre> |
543 |
|
544 |
<p> |
545 |
However, it is preferred that you use the online Gentoo Handbook as it will be |
546 |
-more recent than the one provided on the CD. You can view it using <c>links2</c> |
547 |
+more recent than the one provided on the CD. You can view it using <c>links</c> |
548 |
as well, but only after having completed the <e>Configuring your Network</e> |
549 |
chapter (otherwise you won't be able to go on the Internet to view the |
550 |
document): |
551 |
</p> |
552 |
|
553 |
<pre caption="Viewing the Online Documentation"> |
554 |
-# <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-hppa.xml</i> |
555 |
+# <i>links http://www.gentoo.org/doc/en/handbook/handbook-hppa.xml</i> |
556 |
</pre> |
557 |
|
558 |
<p> |
559 |
|
560 |
|
561 |
|
562 |
1.13 +379 -66 xml/htdocs/doc/en/handbook/hb-install-mips-bootloader.xml |
563 |
|
564 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-mips-bootloader.xml?rev=1.13&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
565 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-mips-bootloader.xml?rev=1.13&content-type=text/plain&cvsroot=gentoo |
566 |
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-mips-bootloader.xml.diff?r1=1.12&r2=1.13&cvsroot=gentoo |
567 |
|
568 |
Index: hb-install-mips-bootloader.xml |
569 |
=================================================================== |
570 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-bootloader.xml,v |
571 |
retrieving revision 1.12 |
572 |
retrieving revision 1.13 |
573 |
diff -u -r1.12 -r1.13 |
574 |
--- hb-install-mips-bootloader.xml 19 Jan 2006 21:48:10 -0000 1.12 |
575 |
+++ hb-install-mips-bootloader.xml 27 Feb 2006 00:55:34 -0000 1.13 |
576 |
@@ -4,15 +4,73 @@ |
577 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
578 |
<!-- See http://creativecommons.org/licenses/by-sa/1.0 --> |
579 |
|
580 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-bootloader.xml,v 1.12 2006/01/19 21:48:10 neysx Exp $ --> |
581 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-bootloader.xml,v 1.13 2006/02/27 00:55:34 fox2mike Exp $ --> |
582 |
|
583 |
<sections> |
584 |
|
585 |
-<version>1.8</version> |
586 |
-<date>2006-01-19</date> |
587 |
+<version>1.10</version> |
588 |
+<date>2006-02-27</date> |
589 |
|
590 |
<section id="sgi"> |
591 |
-<title>Silicon Graphics Machines -- Setting Up Arcboot</title> |
592 |
+<title>Silicon Graphics Machines -- Setting Up arcboot/arcload</title> |
593 |
+<subsection> |
594 |
+<title>Which one?</title> |
595 |
+<body> |
596 |
+ |
597 |
+<p> |
598 |
+On SGI machines, you have two options for bootloaders. <c>arcboot</c> and |
599 |
+<c>arcload</c>. The table below lists the pros and cons for each bootloader. |
600 |
+</p> |
601 |
+ |
602 |
+<table> |
603 |
+<tr> |
604 |
+ <th> </th> |
605 |
+ <th>arcboot</th> |
606 |
+</tr> |
607 |
+<tr> |
608 |
+ <th>+</th> |
609 |
+ <ti> |
610 |
+ It can load off EXT2 and EXT3 partitions, so no need to store them in the |
611 |
+ volume header |
612 |
+ </ti> |
613 |
+</tr> |
614 |
+<tr> |
615 |
+ <th>-</th> |
616 |
+ <ti> |
617 |
+ It doesn't work on Octane/Octane2, Origin 200/2000 or |
618 |
+ Indigo2 Impact (R10000) |
619 |
+ </ti> |
620 |
+</tr> |
621 |
+</table> |
622 |
+ |
623 |
+<table> |
624 |
+<tr> |
625 |
+ <th> </th> |
626 |
+ <th>arcload</th> |
627 |
+</tr> |
628 |
+<tr> |
629 |
+ <th>+</th> |
630 |
+ <ti> |
631 |
+ It boots ALL Linux-compatable SGI systems |
632 |
+ </ti> |
633 |
+</tr> |
634 |
+<tr> |
635 |
+ <th>-</th> |
636 |
+ <ti> |
637 |
+ Currently, It cannot read EXT2/EXT3 partitions, and so needs the kernels |
638 |
+ and config file to be placed in the volume header |
639 |
+ </ti> |
640 |
+</tr> |
641 |
+</table> |
642 |
+ |
643 |
+<note> |
644 |
+The SGI volume header filenames are limited to 8 characters, and there may be no |
645 |
+more than 16 files contained in a single volume header. |
646 |
+</note> |
647 |
+ |
648 |
+</body> |
649 |
+</subsection> |
650 |
+ |
651 |
<subsection> |
652 |
<title>Installing arcboot</title> |
653 |
<body> |
654 |
@@ -45,13 +103,22 @@ |
655 |
header and loads kernels for us, and <c>dvhtool</c> which helps us put |
656 |
<c>arcboot</c> into the volume header. |
657 |
</p> |
658 |
+ |
659 |
<p> |
660 |
-The magic binary we want, hides in <path>/usr/lib/arcboot</path> -- on IP22 |
661 |
-systems (Indy, Indigo 2, Challenge S), it'll be called |
662 |
-<path>arcboot.ip22</path>. Other systems should be similar. We |
663 |
-first copy this file into the volume header. |
664 |
+The <c>arcboot</c> binary lurks in <path>/usr/lib/arcboot</path>. The name of |
665 |
+the binary depends on the machine it's compiled for. |
666 |
</p> |
667 |
|
668 |
+<ul> |
669 |
+ <li> |
670 |
+ <c>arcboot.ip22</c>: The binary for Indy, Indigo2 (R4k) and Challenge S |
671 |
+ systems |
672 |
+ </li> |
673 |
+ <li> |
674 |
+ <c>arcboot.ip32</c>: The binary for O2 systems |
675 |
+ </li> |
676 |
+</ul> |
677 |
+ |
678 |
<pre caption="Installing arcboot into the volume header"> |
679 |
# <i>dvhtool --unix-to-vh /usr/lib/arcboot/arcboot.ip?? arcboot</i> |
680 |
</pre> |
681 |
@@ -70,20 +137,12 @@ |
682 |
</pre> |
683 |
|
684 |
<note> |
685 |
-You'll notice that in my case, I've got two old kernels sitting around there, |
686 |
-<path>linux</path> and <path>newlinux</path>. This is a hangover from before we |
687 |
-started using <c>arcboot</c>. Their presence doesn't matter -- just so long as |
688 |
-<c>arcboot</c> is present, everything is fine. |
689 |
+You'll notice that in the example above, there are two old kernels sitting |
690 |
+around, <path>linux</path> and <path>newlinux</path>. This is a hangover from |
691 |
+before we started using <c>arcboot</c>. Their presence doesn't matter -- just |
692 |
+so long as <c>arcboot</c> is present, everything is fine. |
693 |
</note> |
694 |
|
695 |
-</body> |
696 |
-</subsection> |
697 |
- |
698 |
-<subsection> |
699 |
-<title>Configuring arcboot</title> |
700 |
- |
701 |
-<body> |
702 |
- |
703 |
<p> |
704 |
If you've ever set up the Linux Loader (<c>lilo</c>) before, you'll find that |
705 |
<c>arcboot</c> employs a similar syntax in its configuration file. Bear in mind |
706 |
@@ -92,9 +151,14 @@ |
707 |
is to make sure <path>/boot</path> is an EXT2/3 partition and that there's a |
708 |
file called <path>arcboot.conf</path> inside the <path>/boot/etc</path> |
709 |
directory. An example config can be found in |
710 |
-<path>/etc/arcboot.conf.sample</path> |
711 |
+<path>/etc/arcboot.conf.sample</path>. |
712 |
</p> |
713 |
|
714 |
+<note> |
715 |
+Adjust the paths accordingly if you |
716 |
+don't have a separate <path>/boot</path> partition. |
717 |
+</note> |
718 |
+ |
719 |
<pre caption="Putting arcboot.conf in its place"> |
720 |
<comment>(Create the /boot/etc directory)</comment> |
721 |
# <i>mkdir /boot/etc</i> |
722 |
@@ -111,9 +175,10 @@ |
723 |
|
724 |
<p> |
725 |
You can then edit <path>/etc/arcboot.conf</path> to your own preference. |
726 |
-Personally, I prefer to set up two kernel images: <path>new</path>, a freshly built |
727 |
-image that may or may not work; and <path>working</path>, a proven trustworthy |
728 |
-kernel image. My <path>arcboot.conf</path> looks a bit like this. |
729 |
+One possible layout, is to set up two kernel images: <path>new</path>, a |
730 |
+freshly built image that may or may not work; and <path>working</path>, a |
731 |
+proven trustworthy kernel image. The <path>arcboot.conf</path> for that |
732 |
+setup looks a bit like this. |
733 |
</p> |
734 |
|
735 |
<pre caption="Example arcboot.conf"> |
736 |
@@ -121,11 +186,12 @@ |
737 |
<comment>#</comment> |
738 |
<comment># copyright 2002 Guido Guenther <agx@×××××××.org></comment> |
739 |
<comment>#</comment> |
740 |
+<comment># known working version</comment> |
741 |
label=working |
742 |
image=/vmlinux |
743 |
append="root=/dev/sda3" |
744 |
|
745 |
-<comment># backup version</comment> |
746 |
+<comment># fresh "untested" version</comment> |
747 |
label=new |
748 |
image=/vmlinux-new |
749 |
append="root=/dev/sda3" |
750 |
@@ -140,6 +206,129 @@ |
751 |
|
752 |
</body> |
753 |
</subsection> |
754 |
+ |
755 |
+<subsection> |
756 |
+<title>Installing arcload</title> |
757 |
+<body> |
758 |
+ |
759 |
+<p> |
760 |
+<c>arcload</c> was written for machines that require 64-bit kernels, and |
761 |
+therefore can't use <c>arcboot</c> (which can't easily be compiled as a 64-bit |
762 |
+binary). It also works around peculiarities that arise when loading kernels |
763 |
+directly from the volume header. So, now you know what this is about, we |
764 |
+can proceed with the installation: |
765 |
+</p> |
766 |
+ |
767 |
+<pre caption="Merging arcload and dvhtool"> |
768 |
+# <i>emerge arcload dvhtool</i> |
769 |
+</pre> |
770 |
+ |
771 |
+<p> |
772 |
+Once this has finished, you should find the <c>arcload</c> binary in |
773 |
+<path>/usr/lib/arcload</path>. Now, two files exist: |
774 |
+</p> |
775 |
+ |
776 |
+<ul> |
777 |
+ <li> |
778 |
+ <c>sashARCS</c>: The 32-bit binary for Indy, Indigo2 (R4k), Challenge S |
779 |
+ and O2 systems |
780 |
+ </li> |
781 |
+ <li> |
782 |
+ <c>sash64</c>: The 64-bit binary for Octane/Octane2, Origin 200/2000 and |
783 |
+ Indigo2 Impact systems |
784 |
+ </li> |
785 |
+</ul> |
786 |
+ |
787 |
+<p> |
788 |
+Use <c>dvhtool</c> to install the appropriate binary for your system into the |
789 |
+volume header: |
790 |
+</p> |
791 |
+ |
792 |
+<pre caption="Placing arcload in the volume header"> |
793 |
+<comment>(Indy/Indigo2/Challenge S/O2 users)</comment> |
794 |
+# <i>dvhtool --unix-to-vh /usr/lib/arcload/sashARCS sashARCS</i> |
795 |
+ |
796 |
+<comment>(Indigo2 Impact/Octane/Octane2/Origin 200/Origin 2000 users)</comment> |
797 |
+# <i>dvhtool --unix-to-vh /usr/lib/arcload/sash64 sash64</i> |
798 |
+</pre> |
799 |
+ |
800 |
+<note> |
801 |
+You don't have to use the name <c>sashARCS</c> or <c>sash64</c>, unless you are |
802 |
+installing to the volume header of a bootable CD. For normal boot from |
803 |
+hard-disk, you may name them something else if you wish. |
804 |
+</note> |
805 |
+ |
806 |
+<p> |
807 |
+Now just use <c>dvhtool</c> to verify they are in the volume header. |
808 |
+</p> |
809 |
+ |
810 |
+<pre caption="Checking arcload is present in the volume header"> |
811 |
+# <i>dvhtool --print-volume-directory</i> |
812 |
+----- directory entries ----- |
813 |
+Entry #0, name "sash64", start 4, bytes 55859 |
814 |
+# |
815 |
+</pre> |
816 |
+ |
817 |
+<p> |
818 |
+Now, the <c>arc.cf</c> file has a C-like syntax. For the full detail on how |
819 |
+one configures it, see the <uri |
820 |
+link="http://www.linux-mips.org/wiki/Arcload">arcload page on the |
821 |
+Linux/MIPS wiki</uri>. In short, you define a number of options, which you |
822 |
+enable and disable at boot time using the <c>OSLoadFilename</c> variable. |
823 |
+</p> |
824 |
+ |
825 |
+<pre caption="An example arc.cf"> |
826 |
+<comment># ARCLoad Configuration</comment> |
827 |
+ |
828 |
+<comment># Some default settings...</comment> |
829 |
+append "root=/dev/sda3"; |
830 |
+append "ro"; |
831 |
+append "console=ttyS0,9600"; |
832 |
+ |
833 |
+<comment># Our main definition. ip28 may be changed if you wish.</comment> |
834 |
+ip28 { |
835 |
+ <comment># Definition for a "working" kernel</comment> |
836 |
+ <comment># Select this by setting OSLoadFilename="ip28(working)"</comment> |
837 |
+ working { |
838 |
+ description "SGI Indigo2 Impact R10000\n\r"; |
839 |
+ image system "/working"; |
840 |
+ } |
841 |
+ |
842 |
+ <comment># Definition for a "new" kernel</comment> |
843 |
+ <comment># Select this by setting OSLoadFilename="ip28(new)"</comment> |
844 |
+ new { |
845 |
+ description "SGI Indigo2 Impact R10000 - Testing Kernel\n\r"; |
846 |
+ image system "/new"; |
847 |
+ } |
848 |
+ |
849 |
+ <comment># For debugging a kernel</comment> |
850 |
+ <comment># Select this by setting OSLoadFilename="ip28(working,debug)"</comment> |
851 |
+ <comment># or OSLoadFilename="ip28(new,debug)"</comment> |
852 |
+ debug { |
853 |
+ description "Debug console"; |
854 |
+ append "init=/bin/bash"; |
855 |
+ } |
856 |
+} |
857 |
+</pre> |
858 |
+ |
859 |
+<p> |
860 |
+This is then placed in the volume header with <c>sash64</c> (or |
861 |
+<c>sashARCS</c>) as shown below. Kernels also get placed in the volume header. |
862 |
+</p> |
863 |
+ |
864 |
+<pre caption="Placing arc.cf and kernel in the volume header"> |
865 |
+# <i>dvhtool --unix-to-vh arc.cf arc.cf</i> |
866 |
+# <i>dvhtool --unix-to-vh /usr/src/linux/vmlinux new</i> |
867 |
+</pre> |
868 |
+ |
869 |
+<p> |
870 |
+With this done, now all that's left is to set some options in the PROM. See the |
871 |
+section on <uri link="#reboot">Rebooting the System</uri>. |
872 |
+</p> |
873 |
+ |
874 |
+</body> |
875 |
+</subsection> |
876 |
+ |
877 |
</section> |
878 |
|
879 |
<section id="cobalt"> |
880 |
@@ -156,9 +345,9 @@ |
881 |
|
882 |
<ul> |
883 |
<li> |
884 |
- There's a 675kB limit on kernels. The current size of Linux 2.4 makes it |
885 |
- damn near impossible to make a kernel this size. Linux 2.6 is totally out |
886 |
- of the question. |
887 |
+ There's a 675kB (approximate) limit on kernels. The current size of Linux |
888 |
+ 2.4 makes it damn near impossible to make a kernel this size. Linux 2.6 is |
889 |
+ totally out of the question. |
890 |
</li> |
891 |
<li> |
892 |
64-bit kernels are not supported by the stock firmware (although these are |
893 |
@@ -254,41 +443,40 @@ |
894 |
|
895 |
<p> |
896 |
It is also possible to ask a question, such as which kernel & configuration |
897 |
-you'd like to boot, with a default timeout. This is the configuration I use on |
898 |
-my Cobalt server: |
899 |
+you'd like to boot, with a default timeout. This configuration does exactly |
900 |
+this, asks the user which kernel they wish to use, and executes the chosen |
901 |
+image. <path>vmlinux.gz.new</path> and <path>vmlinux.gz.working</path> may be |
902 |
+actual kernel images, or just symlinks pointing to the kernel images on that |
903 |
+disk. The <c>50</c> argument to <c>select</c> specifies that it should proceed |
904 |
+with the first option ("Working") after 50/10 seconds. |
905 |
</p> |
906 |
|
907 |
-<impo> |
908 |
-Please note that you need to be using CoLo v1.12 or v1.13 to use the <c>menu</c> |
909 |
-command. The following example won't work with v1.11. |
910 |
-</impo> |
911 |
- |
912 |
-<impo> |
913 |
-The <c>menu</c> command was replaced by the <c>select</c> command in CoLo v1.14. |
914 |
-If you've installed a later version by hand, have a look at |
915 |
-<path>menu.colo</path> in the <path>examples</path> subdirectory of the CoLo |
916 |
-distribution. |
917 |
-</impo> |
918 |
- |
919 |
<pre caption="Menu-based configuration"> |
920 |
<comment>#:CoLo:#</comment> |
921 |
|
922 |
lcd "Mounting hda1" |
923 |
mount hda1 |
924 |
-menu "Which Kernel?" 50 Working working New new |
925 |
-lcd "Loading Linux" {menu-option} |
926 |
-load /kernel.gz.{menu-option} |
927 |
+select "Which Kernel?" 50 Working New |
928 |
+ |
929 |
+goto {menu-option} |
930 |
+var image-name vmlinux.gz.working |
931 |
+goto 3f |
932 |
+@var image-name vmlinux.gz.working |
933 |
+goto 2f |
934 |
+@var image-name vmlinux.gz.new |
935 |
+ |
936 |
+@lcd "Loading Linux" {image-name} |
937 |
+load /{image-name} |
938 |
lcd "Booting..." |
939 |
execute root=/dev/hda5 ro console=ttyS0,115200 |
940 |
boot |
941 |
</pre> |
942 |
|
943 |
<p> |
944 |
-The above script asks the user which kernel he/she would like to boot (either |
945 |
-New or Working), then loads <path>vmlinux.gz.new</path> or |
946 |
-<path>vmlinux.gz.working</path> depending on the selection. If a selection is |
947 |
-not made within 5 seconds (50/10ths of a second) it boots the first option. |
948 |
+See the documentation in <path>/usr/share/doc/colo-VERSION</path> for more |
949 |
+details. |
950 |
</p> |
951 |
+ |
952 |
</body> |
953 |
|
954 |
</subsection> |
955 |
@@ -307,7 +495,7 @@ |
956 |
</p> |
957 |
|
958 |
<note> |
959 |
-Those who do have the luxury of a supported framebuffer may skip this section if |
960 |
+Those who do have the luxury of a supported video chipset may skip this section if |
961 |
they wish. |
962 |
</note> |
963 |
|
964 |
@@ -395,10 +583,10 @@ |
965 |
|
966 |
<note> |
967 |
<e>Cobalt Users:</e> The rest of this section covers the setting up of the SGI |
968 |
-PROM so that it boots <c>arcboot</c> off disk and loads Linux. This is not |
969 |
-applicable to the setup of Cobalt servers. In fact, all your work is done -- |
970 |
-there is no configuration needed for the first boot up, you can skip to the next |
971 |
-section: <uri link="?part=1&chap=11">Finalising your Gentoo |
972 |
+PROM so that it boots <c>arcboot</c>/<c>arcload</c> off disk and loads Linux. |
973 |
+This is not applicable to the setup of Cobalt servers. In fact, all your work |
974 |
+is done -- there is no configuration needed for the first boot up, you can skip |
975 |
+to the next section: <uri link="?part=1&chap=11">Finalising your Gentoo |
976 |
Installation</uri> |
977 |
</note> |
978 |
|
979 |
@@ -408,14 +596,29 @@ |
980 |
<section> |
981 |
<title>Tweaking the SGI PROM</title> |
982 |
<subsection> |
983 |
+<title>Setting generic PROM settings</title> |
984 |
<body> |
985 |
|
986 |
<p> |
987 |
+Now that you've installed the bootloader, you're ready to reboot the machine. |
988 |
+</p> |
989 |
+ |
990 |
+<pre caption="Rebooting"> |
991 |
+<comment>(Exit the chroot environment)</comment> |
992 |
+# <i>exit</i> |
993 |
+ |
994 |
+<comment>(Unmount the drives)</comment> |
995 |
+# <i>umount /gentoo/boot</i> |
996 |
+# <i>umount /gentoo</i> |
997 |
+ |
998 |
+<comment>(Reboot)</comment> |
999 |
+# <i>reboot</i> |
1000 |
+</pre> |
1001 |
+ |
1002 |
+<p> |
1003 |
When you are rebooted, go to the <e>System Maintenance Menu</e> and select |
1004 |
-<e>Enter Command Monitor</e> (<c>5</c>). If you want to test your new Gentoo |
1005 |
-installation, you can just run <c>boot -f <kernel name></c>. To have your |
1006 |
-system permanently boot into the Gentoo installation, you need to set some |
1007 |
-variables in the SGI PROM: |
1008 |
+<e>Enter Command Monitor</e> (<c>5</c>) like you did when you netbooted the |
1009 |
+machine. |
1010 |
</p> |
1011 |
|
1012 |
<pre caption="Configuring the PROM to Boot Gentoo"> |
1013 |
@@ -428,6 +631,46 @@ |
1014 |
Option? <i>5</i> |
1015 |
Command Monitor. Type "exit" to return to the menu. |
1016 |
|
1017 |
+<comment>(Set some options which are common for both arcload and arcboot)</comment> |
1018 |
+ |
1019 |
+<comment>(Provide the location of the Volume Header)</comment> |
1020 |
+>> <i>setenv SystemPartition scsi(0)disk(1)rdisk(0)partition(8)</i> |
1021 |
+ |
1022 |
+<comment>(Automatically boot Gentoo)</comment> |
1023 |
+>> <i>setenv AutoLoad Yes</i> |
1024 |
+ |
1025 |
+<comment>(Set the timezone)</comment> |
1026 |
+>> <i>setenv TimeZone EST5EDT</i> |
1027 |
+ |
1028 |
+<comment>(Use the serial console - graphic adapter users should have "g" instead of "d1" (one))</comment> |
1029 |
+>> <i>setenv console d1</i> |
1030 |
+ |
1031 |
+<comment>(Setting the serial console baud rate. This is optional, 9600 is the ) |
1032 |
+(default setting, although one may use rates up to 38400 if that is desired. )</comment> |
1033 |
+>> <i>setenv dbaud 9600</i> |
1034 |
+</pre> |
1035 |
+ |
1036 |
+<p> |
1037 |
+Now, the next settings depend on how you are booting the system. |
1038 |
+</p> |
1039 |
+ |
1040 |
+</body> |
1041 |
+</subsection> |
1042 |
+ |
1043 |
+<subsection> |
1044 |
+<title>Settings for direct volume-header booting</title> |
1045 |
+<body> |
1046 |
+ |
1047 |
+<p> |
1048 |
+This is covered here for completeness. It's recommended that users look into |
1049 |
+installing <c>arcboot</c> or <c>arcload</c> instead. |
1050 |
+</p> |
1051 |
+ |
1052 |
+<note> |
1053 |
+This only works on the Indy, Indigo2 (R4k) and Challenge S. |
1054 |
+</note> |
1055 |
+ |
1056 |
+<pre caption="PROM settings for booting off the volume header"> |
1057 |
<comment>(<root device> = Gentoo's root partition, e.g. /dev/sda3)</comment> |
1058 |
>> <i>setenv OSLoadPartition <root device></i> |
1059 |
|
1060 |
@@ -437,21 +680,91 @@ |
1061 |
|
1062 |
<comment>(Declare the kernel parameters you want to pass)</comment> |
1063 |
>> <i>setenv OSLoadOptions <kernel parameters></i> |
1064 |
+</pre> |
1065 |
|
1066 |
-<comment>(Provide the location of the Volume Header)</comment> |
1067 |
->> <i>setenv SystemPartition scsi(0)disk(1)rdisk(0)partition(8)</i> |
1068 |
+<p> |
1069 |
+If you wish to try a kernel without messing with kernel parameters, you may do |
1070 |
+so using the <c>boot -f</c> PROM command: |
1071 |
+</p> |
1072 |
|
1073 |
-<comment>(Automatically boot Gentoo)</comment> |
1074 |
->> <i>setenv AutoLoad Yes</i> |
1075 |
+<pre caption="Booting without changing environment variables"> |
1076 |
+<comment>(Booting a kernel, "new", with additional options)</comment> |
1077 |
+# <i>boot -f new root=/dev/sda3 ro</i> |
1078 |
+</pre> |
1079 |
|
1080 |
-<comment>(Set the timezone)</comment> |
1081 |
->> <i>setenv TimeZone EST5EDT</i> |
1082 |
+</body> |
1083 |
+</subsection> |
1084 |
|
1085 |
-<comment>(Use the serial console - graphic adapter users should have "g" instead of "d1" (one))</comment> |
1086 |
->> <i>setenv console d1</i> |
1087 |
+<subsection> |
1088 |
+<title>Settings for arcload</title> |
1089 |
+<body> |
1090 |
+ |
1091 |
+<p> |
1092 |
+<c>arcload</c> uses the <c>OSLoadFilename</c> option to specify which options to |
1093 |
+set from <path>arc.cf</path>. The configuration file is essentially a script, |
1094 |
+with the top-level blocks defining boot images for different systems, and inside |
1095 |
+that, optional settings. Thus, setting <c>OSLoadFilename=mysys(serial)</c> |
1096 |
+pulls in the settings for the <c>mysys</c> block, then sets further options |
1097 |
+overridden in <c>serial</c>. |
1098 |
+</p> |
1099 |
+ |
1100 |
+<p> |
1101 |
+In the example file above, we have one system block defined, <c>ip28</c> with |
1102 |
+<c>working</c>, <c>new</c> and <c>debug</c> options available. We define our |
1103 |
+PROM variables as so: |
1104 |
+</p> |
1105 |
+ |
1106 |
+<pre caption="PROM settings for using arcload"> |
1107 |
+<comment>(Select arcload as the bootloader:- sash64 or sashARCS)</comment> |
1108 |
+>> setenv OSLoader sash64 |
1109 |
+ |
1110 |
+<comment>(Use the "working" kernel image, defined in "ip28" section of arc.cf)</comment> |
1111 |
+>> setenv OSLoadFilename ip28(working) |
1112 |
+</pre> |
1113 |
+ |
1114 |
+</body> |
1115 |
+</subsection> |
1116 |
+ |
1117 |
+<subsection> |
1118 |
+<title>Settings for arcboot</title> |
1119 |
+<body> |
1120 |
+ |
1121 |
+<p> |
1122 |
+<c>arcboot</c> loads its configuration file and kernels from your |
1123 |
+<path>/boot</path> partition, which needs to be formatted either EXT2 or EXT3. |
1124 |
+Thus <c>OSLoadPartition</c> needs to point to that partition. <c>OSLoader</c> |
1125 |
+should point to the <c>arcboot</c> binary in the volume header, and |
1126 |
+<c>OSLoadFilename</c> is the image name being used. |
1127 |
+</p> |
1128 |
+ |
1129 |
+<pre caption="PROM settings for using arcboot"> |
1130 |
+<comment>(Read configuration and kernels from SCSI ID# 1, partition 0 -- sda1)</comment> |
1131 |
+>> <i>setenv OSLoadPartition scsi(0)disk(1)rdisk(0)partition(0)</i> |
1132 |
+ |
1133 |
+<comment>(Use arcboot as the bootloader)</comment> |
1134 |
+>> <i>setenv OSLoader arcload</i> |
1135 |
+ |
1136 |
+<comment>(Which boot image in arcboot.conf to load)</comment> |
1137 |
+>> <i>setenv OSLoadFilename working</i> |
1138 |
</pre> |
1139 |
|
1140 |
<p> |
1141 |
+When testing kernels via <c>arcboot</c> you can specify an alternate image like |
1142 |
+so (where <c>new</c> is the alternate image): |
1143 |
+</p> |
1144 |
+ |
1145 |
+<pre caption="Specifying an alternate image"> |
1146 |
+# <i>boot new</i> |
1147 |
+</pre> |
1148 |
+ |
1149 |
+</body> |
1150 |
+</subsection> |
1151 |
+ |
1152 |
+<subsection> |
1153 |
+<title>All Done</title> |
1154 |
+<body> |
1155 |
+ |
1156 |
+<p> |
1157 |
Now you're ready to enjoy Gentoo! Boot in your Gentoo installation and finish |
1158 |
up with <uri link="?part=1&chap=11">Finalizing your Gentoo |
1159 |
Installation</uri>. |
1160 |
|
1161 |
|
1162 |
|
1163 |
1.18 +12 -3 xml/htdocs/doc/en/handbook/hb-install-mips-disk.xml |
1164 |
|
1165 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-mips-disk.xml?rev=1.18&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
1166 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-mips-disk.xml?rev=1.18&content-type=text/plain&cvsroot=gentoo |
1167 |
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-mips-disk.xml.diff?r1=1.17&r2=1.18&cvsroot=gentoo |
1168 |
|
1169 |
Index: hb-install-mips-disk.xml |
1170 |
=================================================================== |
1171 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-disk.xml,v |
1172 |
retrieving revision 1.17 |
1173 |
retrieving revision 1.18 |
1174 |
diff -u -r1.17 -r1.18 |
1175 |
--- hb-install-mips-disk.xml 14 Dec 2005 00:22:34 -0000 1.17 |
1176 |
+++ hb-install-mips-disk.xml 27 Feb 2006 00:55:34 -0000 1.18 |
1177 |
@@ -4,12 +4,12 @@ |
1178 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
1179 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
1180 |
|
1181 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-disk.xml,v 1.17 2005/12/14 00:22:34 vanquirius Exp $ --> |
1182 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-disk.xml,v 1.18 2006/02/27 00:55:34 fox2mike Exp $ --> |
1183 |
|
1184 |
<sections> |
1185 |
|
1186 |
-<version>1.11</version> |
1187 |
-<date>2005-10-02</date> |
1188 |
+<version>1.13</version> |
1189 |
+<date>2006-02-27</date> |
1190 |
|
1191 |
<section> |
1192 |
<title>Introduction to Block Devices</title> |
1193 |
@@ -223,6 +223,15 @@ |
1194 |
with each image allowed eight-character names. |
1195 |
</p> |
1196 |
|
1197 |
+<note> |
1198 |
+On SGI systems, there are two bootloaders available: <c>arcboot</c> and |
1199 |
+<c>arcload</c>. Currently, only the Indy, Indigo2 (R4k variety), Challenge S |
1200 |
+and O2 are capable of using <c>arcboot</c> as a bootloader, whereas |
1201 |
+<c>arcload</c> runs on all the Linux-supported SGI machines. Unlike |
1202 |
+<c>arcboot</c> however, <c>arcload</c> cannot presently read EXT2/3 partitions, |
1203 |
+and thus, loads its kernels from the volume header. |
1204 |
+</note> |
1205 |
+ |
1206 |
<p> |
1207 |
The process of making the volume header larger isn't exactly straight-forward; |
1208 |
there's a bit of a trick to it. One cannot simply delete and re-add the volume |
1209 |
|
1210 |
|
1211 |
|
1212 |
1.20 +216 -74 xml/htdocs/doc/en/handbook/hb-install-mips-kernel.xml |
1213 |
|
1214 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-mips-kernel.xml?rev=1.20&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
1215 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-mips-kernel.xml?rev=1.20&content-type=text/plain&cvsroot=gentoo |
1216 |
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-mips-kernel.xml.diff?r1=1.19&r2=1.20&cvsroot=gentoo |
1217 |
|
1218 |
Index: hb-install-mips-kernel.xml |
1219 |
=================================================================== |
1220 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-kernel.xml,v |
1221 |
retrieving revision 1.19 |
1222 |
retrieving revision 1.20 |
1223 |
diff -u -r1.19 -r1.20 |
1224 |
--- hb-install-mips-kernel.xml 8 Jan 2006 14:05:29 -0000 1.19 |
1225 |
+++ hb-install-mips-kernel.xml 27 Feb 2006 00:55:34 -0000 1.20 |
1226 |
@@ -4,12 +4,12 @@ |
1227 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
1228 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
1229 |
|
1230 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-kernel.xml,v 1.19 2006/01/08 14:05:29 neysx Exp $ --> |
1231 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-kernel.xml,v 1.20 2006/02/27 00:55:34 fox2mike Exp $ --> |
1232 |
|
1233 |
<sections> |
1234 |
|
1235 |
-<version>1.15</version> |
1236 |
-<date>2006-01-06</date> |
1237 |
+<version>1.16</version> |
1238 |
+<date>2006-02-27</date> |
1239 |
|
1240 |
<section> |
1241 |
<title>Timezone</title> |
1242 |
@@ -44,34 +44,75 @@ |
1243 |
</p> |
1244 |
|
1245 |
<p> |
1246 |
-MIPS-based systems can choose from <c>mips-sources</c> (the default kernel |
1247 |
-source for the MIPS architecture) and <c>mips-prepatch-sources</c> (prerelease |
1248 |
-kernel tree). |
1249 |
+MIPS-based systems have just the one kernel tree to choose from, <c>mips-sources</c>. |
1250 |
+Special patches are needed to make certain systems work. The table below |
1251 |
+displays the USE flags required to enable the patchsets. Note that Indy, |
1252 |
+Indigo2 (R4k) and Challenge S systems do not require any additional patchsets. |
1253 |
</p> |
1254 |
|
1255 |
-<p> |
1256 |
-Choose your kernel source and install it using <c>emerge</c>. Of course |
1257 |
-substitute with your choice of sources, this is merely an example. The |
1258 |
-<c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other |
1259 |
-dependencies at this point. <c>USE="symlink"</c> is not necessary for a new |
1260 |
-install, but ensures proper creation of the <path>/usr/src/linux</path> |
1261 |
-symlink. |
1262 |
-</p> |
1263 |
+<table> |
1264 |
+<tr> |
1265 |
+ <th>USE flag</th> |
1266 |
+ <th>System</th> |
1267 |
+</tr> |
1268 |
+<tr> |
1269 |
+ <ti><c>cobalt</c></ti> |
1270 |
+ <ti>Cobalt Qube/RaQ support</ti> |
1271 |
+</tr> |
1272 |
+<tr> |
1273 |
+ <ti><c>ip27</c></ti> |
1274 |
+ <ti>SGI Origin 200/2000 support (1)</ti> |
1275 |
+</tr> |
1276 |
+<tr> |
1277 |
+ <ti><c>ip28</c></ti> |
1278 |
+ <ti>SGI Indigo2 Impact (R10000) support (1,2)</ti> |
1279 |
+</tr> |
1280 |
+<tr> |
1281 |
+ <ti><c>ip30</c></ti> |
1282 |
+ <ti>SGI Octane/Octane2 support (1)</ti> |
1283 |
+</tr> |
1284 |
+</table> |
1285 |
|
1286 |
<note> |
1287 |
-Special patches are needed to make a kernel work on Cobalt servers. The |
1288 |
-<c>cobalt</c> USE flag must be defined in order to grab the necessary patches |
1289 |
-and apply them. |
1290 |
+The <c>USE="-doc"</c> disables the generation of kernel API documentation, which |
1291 |
+would otherwise pull in numerous dependancies not required for this step. |
1292 |
</note> |
1293 |
|
1294 |
-<pre caption="Installing a kernel source"> |
1295 |
-<comment>(For SGI machines)</comment> |
1296 |
-# <i>USE="-doc symlink" emerge mips-sources</i> |
1297 |
- |
1298 |
-<comment>(For Cobalt machines)</comment> |
1299 |
-# <i>mkdir -p /etc/portage</i> |
1300 |
+<pre caption="Setting USE flags and merging kernel sources..."> |
1301 |
+<comment>(Substitute cobalt with the appropriate USE flag for your system if required)</comment> |
1302 |
+# <i>mkdir /etc/portage</i> |
1303 |
# <i>echo "sys-kernel/mips-sources cobalt" >> /etc/portage/package.use</i> |
1304 |
-# <i>USE="-doc symlink" emerge mips-sources</i> |
1305 |
+ |
1306 |
+<comment>(Unpack & install the kernel sources)</comment> |
1307 |
+# <i>USE="-doc" emerge mips-sources</i> |
1308 |
+</pre> |
1309 |
+ |
1310 |
+<impo> |
1311 |
+(1) On the Origin 200/2000, Indigo2 Impact (R10000), Octane/Octane2 and O2, a |
1312 |
+64-bit kernel is required to boot these systems. For these machines, you should |
1313 |
+switch to the <path>default-linux/mips/mips64/RELEASE</path> |
1314 |
+profile by altering the <path>/etc/make.profile</path> symlink. Then you can |
1315 |
+<c>emerge gcc-mips64</c> to create a cross-compiler for building 64-bit kernels. |
1316 |
+</impo> |
1317 |
+ |
1318 |
+<impo> |
1319 |
+(2) The Indigo2 Impact is a special case in that it requires special patch to |
1320 |
+be applied to <c>gcc</c> before it will build an IP28 kernel correctly. This |
1321 |
+patch adds support for the <c>-mip28-cache-barriers</c> CFLAG, which is used |
1322 |
+when building kernels to work around the inherent hardware bug brought on by |
1323 |
+speculative execution. This USE flag can be set in |
1324 |
+<path>/etc/make.conf</path>. This is done for you by setting your profile to |
1325 |
+<path>default-linux/mips/mips64/ip28/RELEASE</path>, which also |
1326 |
+takes care of (1). |
1327 |
+</impo> |
1328 |
+ |
1329 |
+<pre caption="Changing Profiles and installing gcc-mips64..."> |
1330 |
+<comment>(This assumes PORTDIR is in the usual location; /usr/portage)</comment> |
1331 |
+# <i>rm /etc/make.profile</i> |
1332 |
+# <i>ln -s /usr/portage/profiles/default-linux/mips/mips64/2005.0</i> <comment>(or .../mips64/ip28/2005.0)</comment> |
1333 |
+ |
1334 |
+<comment>(Install the 64-bit kernel toolchain)</comment> |
1335 |
+# <i>emerge gcc-mips64</i> |
1336 |
</pre> |
1337 |
|
1338 |
<p> |
1339 |
@@ -83,7 +124,18 @@ |
1340 |
|
1341 |
<pre caption="Viewing the kernel source symlink"> |
1342 |
# <i>ls -l /usr/src/linux</i> |
1343 |
-lrwxrwxrwx 1 root root 12 Oct 13 11:04 /usr/src/linux -> linux-2.4.24 |
1344 |
+lrwxrwxrwx 1 root root 12 Oct 13 11:04 /usr/src/linux -> linux-2.6.13.4 |
1345 |
+</pre> |
1346 |
+ |
1347 |
+<p> |
1348 |
+If this isn't the case (i.e. the symlink points to a different kernel source) |
1349 |
+change the symlink before you continue: |
1350 |
+</p> |
1351 |
+ |
1352 |
+<pre caption="Changing the kernel source symlink"> |
1353 |
+# <i>rm /usr/src/linux</i> |
1354 |
+# <i>cd /usr/src</i> |
1355 |
+# <i>ln -s linux-2.6.13.4 linux</i> |
1356 |
</pre> |
1357 |
|
1358 |
<p> |
1359 |
@@ -101,53 +153,107 @@ |
1360 |
|
1361 |
<p> |
1362 |
Previously, we went through the manual configuration of how to set up the kernel |
1363 |
-sources. Instead, we have uploaded a number of sample configurations which you |
1364 |
-can base your configuration upon. Simply click on the closest option that |
1365 |
-matches your system and kernel version. You may also find other configuration |
1366 |
-samples at the URLs mentioned below. |
1367 |
+sources. This has become impractical with the number of systems we now support. |
1368 |
+This section details various sources for sample kernel configurations. |
1369 |
+</p> |
1370 |
+ |
1371 |
+</body> |
1372 |
+</subsection> |
1373 |
+<subsection> |
1374 |
+<title>Using sample configurations in the kernel source</title> |
1375 |
+<body> |
1376 |
+ |
1377 |
+<p> |
1378 |
+Many of the systems supported have sample .configs hiding in amongst the kernel |
1379 |
+source. Not all systems have configs distributed in this way. Those that do, |
1380 |
+can be configured using the commands mentioned in the table below. |
1381 |
</p> |
1382 |
|
1383 |
<table> |
1384 |
- <tr> |
1385 |
- <th>System</th> |
1386 |
- <th>Kernel Version</th> |
1387 |
- </tr> |
1388 |
- <tr> |
1389 |
- <ti>SGI IP22 (Indy, Indigo 2, Challenge S)</ti> |
1390 |
- <ti> |
1391 |
- <uri link="http://www.longlandclan.hopto.org/~stuartl/mips-linux/sgi/ip22/config/2.4.29-mipscvs-20050130.gz">2.4.29</uri> |
1392 |
- </ti> |
1393 |
- </tr> |
1394 |
- <tr> |
1395 |
- <ti>Cobalt Qube/Raq 2800</ti> |
1396 |
- <ti> |
1397 |
- <uri link="http://dev.gentoo.org/~kumba/mips/cobalt/kernel/cobalt-2605.config">2.6.5</uri> |
1398 |
- <uri link="http://dev.gentoo.org/~kumba/mips/cobalt/kernel/cobalt-2606.config">2.6.6</uri> |
1399 |
- <uri link="http://dev.gentoo.org/~kumba/mips/cobalt/kernel/cobalt-config-2609">2.6.9</uri> |
1400 |
- </ti> |
1401 |
- </tr> |
1402 |
+<tr> |
1403 |
+ <th>System</th> |
1404 |
+ <th>Configure command</th> |
1405 |
+</tr> |
1406 |
+<tr> |
1407 |
+ <ti>Cobalt Servers</ti> |
1408 |
+ <ti><c>make cobalt_defconfig</c></ti> |
1409 |
+</tr> |
1410 |
+<tr> |
1411 |
+ <ti>Indy, Indigo2 (R4k), Challenge S</ti> |
1412 |
+ <ti><c>make ip22_defconfig</c></ti> |
1413 |
+</tr> |
1414 |
+<tr> |
1415 |
+ <ti>Origin 200/2000</ti> |
1416 |
+ <ti><c>make ip27_defconfig</c></ti> |
1417 |
+</tr> |
1418 |
+<tr> |
1419 |
+ <ti>Indigo2 Impact (R10k)</ti> |
1420 |
+ <ti> |
1421 |
+ <c>make ip28_defconfig</c> (requires <c>mips-sources-2.6.14.5</c> or |
1422 |
+ later) |
1423 |
+ </ti> |
1424 |
+</tr> |
1425 |
+<tr> |
1426 |
+ <ti>O2</ti> |
1427 |
+ <ti><c>make ip32_defconfig</c></ti> |
1428 |
+</tr> |
1429 |
</table> |
1430 |
|
1431 |
-<ul> |
1432 |
- <li> |
1433 |
- IP22 (Indy, Indigo2, Challenge S) Configurations: |
1434 |
- <uri link="http://www.longlandclan.hopto.org/~stuartl/mips-linux/sgi/ip22/config"> |
1435 |
- http://www.longlandclan.hopto.org/~stuartl/mips-linux/sgi/ip22/config |
1436 |
- </uri> |
1437 |
- </li> |
1438 |
- <li> |
1439 |
- Cobalt Server Configurations: |
1440 |
- <uri link="http://dev.gentoo.org/~kumba/mips"> |
1441 |
- http://dev.gentoo.org/~kumba/mips |
1442 |
- </uri> |
1443 |
- </li> |
1444 |
-</ul> |
1445 |
+</body> |
1446 |
+</subsection> |
1447 |
|
1448 |
-<note> |
1449 |
-More kernel configuration examples can be found on the Gentoo/MIPS Hardware |
1450 |
-Support Database, which is located at |
1451 |
+<subsection> |
1452 |
+<title>Using the running kernel config from the installation media</title> |
1453 |
+<body> |
1454 |
+ |
1455 |
+<p> |
1456 |
+All of the Gentoo installation images provide a kernel config option as part of |
1457 |
+the image itself, accessible as <path>/proc/config.gz</path>. This may be used |
1458 |
+in many cases. It is best though if your kernel source matches closely, the |
1459 |
+kernel that is currently running. To extract it, simply run it through |
1460 |
+<c>zcat</c> as shown below. |
1461 |
+</p> |
1462 |
+ |
1463 |
+<pre caption="Extracting .config from /proc/config.gz"> |
1464 |
+# <i>zcat /proc/config.gz > .config</i> |
1465 |
+</pre> |
1466 |
+ |
1467 |
+<impo> |
1468 |
+This kernel config is set up for a netboot image. That |
1469 |
+is, it will expect to find a root filesystem image somewhere nearby, either as a |
1470 |
+directory for initramfs, or a loopback device for initrd. When you run <c>make |
1471 |
+menuconfig</c> below, don't forget to go into General Setup and disable the |
1472 |
+options for initramfs. |
1473 |
+</impo> |
1474 |
+ |
1475 |
+</body> |
1476 |
+</subsection> |
1477 |
+ |
1478 |
+<subsection> |
1479 |
+<title>The Hardware Compatability Database</title> |
1480 |
+<body> |
1481 |
+ |
1482 |
+<p> |
1483 |
+As an aid to users in finding working settings, a hardware compatability |
1484 |
+database was set up. This database lists the support for various MIPS devices, |
1485 |
+and allows users to contribute kernel configurations that are known to work. |
1486 |
+The address for this site is |
1487 |
<uri>http://stuartl.longlandclan.hopto.org/gentoo/mips</uri>. |
1488 |
-</note> |
1489 |
+</p> |
1490 |
+ |
1491 |
+<p> |
1492 |
+If you find this service useful, you're welcome to contribute your notes and |
1493 |
+.config files so that others may benefit from your experience. It should be |
1494 |
+noted however that there is no guarantee that any of the configuration files |
1495 |
+downloaded from this site will work. |
1496 |
+</p> |
1497 |
+ |
1498 |
+</body> |
1499 |
+</subsection> |
1500 |
+ |
1501 |
+<subsection> |
1502 |
+<title>Customising the configuration for your needs.</title> |
1503 |
+<body> |
1504 |
|
1505 |
<p> |
1506 |
Once you have found a configuration, download it into your kernel source |
1507 |
@@ -164,6 +270,15 @@ |
1508 |
# <i>make menuconfig</i> |
1509 |
</pre> |
1510 |
|
1511 |
+<impo> |
1512 |
+In the Kernel Hacking section, there is an option named "Are You Using A Cross |
1513 |
+Compiler?". This tells the kernel Makefiles to prepend "<c>mips-linux-</c>" (or |
1514 |
+<c>mipsel-linux</c> ... etc) to <c>gcc</c> and <c>as</c> commands when compiling |
1515 |
+the kernel. This should be turned off, even if cross-compiling. Instead, if |
1516 |
+you do need to call a cross-compiler, specify the prefix using the |
1517 |
+<c>CROSS_COMPILE</c> variable as shown in the next section. |
1518 |
+</impo> |
1519 |
+ |
1520 |
</body> |
1521 |
</subsection> |
1522 |
<subsection id="compiling"> |
1523 |
@@ -175,12 +290,40 @@ |
1524 |
the configuration and start the compilation process: |
1525 |
</p> |
1526 |
|
1527 |
+<note> |
1528 |
+On 64-bit machines, you need to specify |
1529 |
+<c>CROSS_COMPILE=mips64-unknown-linux-gnu-</c> (or <c>mips64el-...</c> if on |
1530 |
+a little-endian system) to use the 64-bit compiler. |
1531 |
+</note> |
1532 |
+ |
1533 |
<pre caption="Compiling the kernel"> |
1534 |
-<comment>(For 2.4 kernel)</comment> |
1535 |
-# <i>make dep && make vmlinux modules modules_install</i> |
1536 |
+<comment>(For 2.4 kernel only)</comment> |
1537 |
+# <i>make dep</i> |
1538 |
+ |
1539 |
+<comment>(2.4 and 2.6 kernels -- compiling natively)</comment> |
1540 |
+# <i>make vmlinux modules modules_install</i> |
1541 |
|
1542 |
-<comment>(For 2.6 kernel)</comment> |
1543 |
-# <i>make && make modules_install</i> |
1544 |
+<comment>(2.4 and 2.6 kernels -- cross-compiling on target machine)</comment> |
1545 |
+<comment>( Adjust the mips64-unknown-linux-gnu- accordingly )</comment> |
1546 |
+# <i>make vmlinux modules modules_install CROSS_COMPILE=mips64-unknown-linux-gnu-</i> |
1547 |
+ |
1548 |
+<comment>(When compiling on another machine, such as an x86 box... use the)</comment> |
1549 |
+<comment>( following commands to compile the kernel & install modules into)</comment> |
1550 |
+<comment>( a specific directory to be transferred to the target machine. )</comment> |
1551 |
+# <i>make vmlinux modules CROSS_COMPILE=mips64-unknown-linux-gnu-</i> |
1552 |
+# <i>make modules_install INSTALL_MOD_PATH=/somewhere</i> |
1553 |
+</pre> |
1554 |
+ |
1555 |
+<impo> |
1556 |
+When compiling a 64-bit kernel for the Indy, Indigo2 (R4k), Challenge S and O2, |
1557 |
+use the <c>vmlinux.32</c> target instead of <c>vmlinux</c>. Otherwise, your |
1558 |
+machine will not be able to boot. This is to work around the PROM not |
1559 |
+understanding the ELF64 format. |
1560 |
+</impo> |
1561 |
+ |
1562 |
+<pre caption="Using the vmlinux.32 target"> |
1563 |
+# <i>make vmlinux.32</i> |
1564 |
+<comment>(This will create vmlinux.32 -- which is your final kernel)</comment> |
1565 |
</pre> |
1566 |
|
1567 |
<p> |
1568 |
@@ -190,15 +333,14 @@ |
1569 |
|
1570 |
<note> |
1571 |
On Cobalt servers, the bootloader will expect to see a compressed kernel image. |
1572 |
-Remember to <c>gzip -9</c> the file once it is in <path>/boot</path>. In the |
1573 |
-following example, replace <path><kernel-version></path> with your kernel |
1574 |
-version. |
1575 |
+Remember to <c>gzip -9</c> the file once it is in <path>/boot</path>. |
1576 |
</note> |
1577 |
|
1578 |
<pre caption="Installing the kernel"> |
1579 |
-# <i>cp vmlinux /boot/<kernel-version<</i> |
1580 |
+# <i>cp vmlinux /boot/kernel-2.6.13.4</i> |
1581 |
+ |
1582 |
<comment>(Cobalt Servers -- Compressing the kernel image)</comment> |
1583 |
-# <i>gzip -9v /boot/<kernel-version<</i> |
1584 |
+# <i>gzip -9v /boot/kernel-2.6.13.4</i> |
1585 |
</pre> |
1586 |
|
1587 |
<!-- |
1588 |
|
1589 |
|
1590 |
|
1591 |
1.17 +153 -257 xml/htdocs/doc/en/handbook/hb-install-mips-medium.xml |
1592 |
|
1593 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-mips-medium.xml?rev=1.17&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
1594 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-mips-medium.xml?rev=1.17&content-type=text/plain&cvsroot=gentoo |
1595 |
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-mips-medium.xml.diff?r1=1.16&r2=1.17&cvsroot=gentoo |
1596 |
|
1597 |
Index: hb-install-mips-medium.xml |
1598 |
=================================================================== |
1599 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-medium.xml,v |
1600 |
retrieving revision 1.16 |
1601 |
retrieving revision 1.17 |
1602 |
diff -u -r1.16 -r1.17 |
1603 |
--- hb-install-mips-medium.xml 11 Nov 2005 17:27:15 -0000 1.16 |
1604 |
+++ hb-install-mips-medium.xml 27 Feb 2006 00:55:34 -0000 1.17 |
1605 |
@@ -4,12 +4,12 @@ |
1606 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
1607 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
1608 |
|
1609 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-medium.xml,v 1.16 2005/11/11 17:27:15 swift Exp $ --> |
1610 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-medium.xml,v 1.17 2006/02/27 00:55:34 fox2mike Exp $ --> |
1611 |
|
1612 |
<sections> |
1613 |
|
1614 |
-<version>1.11</version> |
1615 |
-<date>2005-11-11</date> |
1616 |
+<version>1.13</version> |
1617 |
+<date>2006-02-27</date> |
1618 |
|
1619 |
<section> |
1620 |
<title>Hardware Requirements</title> |
1621 |
@@ -30,6 +30,14 @@ |
1622 |
|
1623 |
<table> |
1624 |
<tr> |
1625 |
+ <th>CPU <e>(Big Endian port)</e></th> |
1626 |
+ <ti>MIPS3, MIPS4, MIPS5 or MIPS64-class CPU</ti> |
1627 |
+</tr> |
1628 |
+<tr> |
1629 |
+ <th>CPU <e>(Little Endian port)</e></th> |
1630 |
+ <ti>MIPS4, MIPS5 or MIPS64-class CPU</ti> |
1631 |
+</tr> |
1632 |
+<tr> |
1633 |
<th>Memory</th> |
1634 |
<ti>64 MB</ti> |
1635 |
</tr> |
1636 |
@@ -107,6 +115,7 @@ |
1637 |
<uri link="http://www.linux-mips.org/wiki/index.php/R5000">RM5000</uri>, |
1638 |
<uri link="http://www.linux-mips.org/wiki/index.php/RM7000">RM7000</uri> |
1639 |
<uri link="http://www.linux-mips.org/wiki/index.php/R8000">R8000</uri>, |
1640 |
+ R9000, |
1641 |
<uri link="http://www.linux-mips.org/wiki/index.php/R10000">R10000</uri>, |
1642 |
<uri link="http://www.linux-mips.org/wiki/index.php/R10000">R12000</uri>, |
1643 |
<uri link="http://www.linux-mips.org/wiki/index.php/R10000">R14000</uri>, |
1644 |
@@ -120,8 +129,36 @@ |
1645 |
None As Yet |
1646 |
</ti> |
1647 |
</tr> |
1648 |
+ <tr> |
1649 |
+ <ti>MIPS32</ti> |
1650 |
+ <ti>32-bit</ti> |
1651 |
+ <ti> |
1652 |
+ AMD Alchemy series, 4kc, 4km, many others... |
1653 |
+ </ti> |
1654 |
+ </tr> |
1655 |
+ <tr> |
1656 |
+ <ti>MIPS64</ti> |
1657 |
+ <ti>64-bit</ti> |
1658 |
+ <ti> |
1659 |
+ Broadcom SiByte SB1, 5kc ... etc... |
1660 |
+ </ti> |
1661 |
+ </tr> |
1662 |
</table> |
1663 |
|
1664 |
+<note> |
1665 |
+The <c>MIPS5</c> ISA level was designed by Silicon Graphics back in 1994, but |
1666 |
+never actually got used in a real life CPU. It lives on as part of the |
1667 |
+<c>MIPS64</c> ISA. |
1668 |
+</note> |
1669 |
+ |
1670 |
+<note> |
1671 |
+The <c>MIPS32</c> and <c>MIPS64</c> ISAs are a common source of confusion. The |
1672 |
+<c>MIPS64</c> ISA level is actually a superset of the <c>MIPS5</c> ISA, so it |
1673 |
+includes all instructions from <c>MIPS5</c> and earlier ISAs. <c>MIPS32</c> is |
1674 |
+the 32-bit subset of <c>MIPS64</c>, it exists because most applications only |
1675 |
+require 32-bit processing. |
1676 |
+</note> |
1677 |
+ |
1678 |
<p> |
1679 |
Also, another important concept to grasp is the concept of <b>endianness</b>. |
1680 |
Endianness refers to the way that a CPU reads words from main memory. A word |
1681 |
@@ -222,8 +259,8 @@ |
1682 |
<p> |
1683 |
In this section, we'll cover what you need in order to successfully network boot |
1684 |
a Silicon Graphics workstation or Cobalt Server appliance. This is just a brief |
1685 |
-guide, it is not intended to be thorough, for more information, I recommend |
1686 |
-reading the <uri link="/doc/en/diskless-howto.xml">Diskless |
1687 |
+guide, it is not intended to be thorough, for more information, it is |
1688 |
+recommended that you read the <uri link="/doc/en/diskless-howto.xml">Diskless |
1689 |
HOWTO</uri>. |
1690 |
</p> |
1691 |
|
1692 |
@@ -268,12 +305,9 @@ |
1693 |
SGI machines use a MiniDIN 8 connector for the serial ports. Apparently Apple |
1694 |
modem cables work just fine as serial cables, but with Apple machines being |
1695 |
equipped with USB & internal modems, these are getting harder to |
1696 |
-find. A number of sites describe how to make these cables (Google is your |
1697 |
-friend). The following site describes making such a cable. It's in German, |
1698 |
-but has a reasonably good wiring diagram. |
1699 |
-<uri link="http://www.arbeitsplatzvernichtung-durch-outsourcing.de/marty44/sgihard.html"> |
1700 |
- http://www.arbeitsplatzvernichtung-durch-outsourcing.de/marty44/sgihard.html |
1701 |
-</uri> |
1702 |
+find. One wiring diagram is available from the <uri |
1703 |
+link="http://www.linux-mips.org/wiki/Serial_Cable">Linux/MIPS Wiki</uri>, and |
1704 |
+most electronics stores should stock the plugs required. |
1705 |
</note> |
1706 |
|
1707 |
<note> |
1708 |
@@ -302,7 +336,7 @@ |
1709 |
|
1710 |
<p> |
1711 |
Okay, so you've got your bits and pieces together, now to set everything up. As |
1712 |
-I mentioned earlier -- this is not a complete guide, this is a bare-bones config |
1713 |
+mentioned earlier -- this is not a complete guide, this is a bare-bones config |
1714 |
that will just get things rolling. You can either use this when starting a |
1715 |
setup from scratch, or use the suggestions to amend your existing setup to |
1716 |
support netbooting. |
1717 |
@@ -315,6 +349,12 @@ |
1718 |
separate machine to the DHCP server if desired. |
1719 |
</p> |
1720 |
|
1721 |
+<warn> |
1722 |
+The Gentoo/MIPS Team cannot help you with setting up other operating |
1723 |
+systems as netboot servers. If you choose a different OS, it is assumed you |
1724 |
+know what you're doing. |
1725 |
+</warn> |
1726 |
+ |
1727 |
<p> |
1728 |
First Step -- configuring DHCP. In order for the ISC DHCP daemon to respond |
1729 |
to BOOTP requests (as required by the SGI & Cobalt BOOTROM) you need to |
1730 |
@@ -361,10 +401,9 @@ |
1731 |
</p> |
1732 |
|
1733 |
<p> |
1734 |
-Next Step -- Setting up TFTP server. For the purposes of this guide, I'll |
1735 |
-restrict this to the tftp-hpa TFTP daemon. I use this myself on SGI machines, |
1736 |
-Cobalt servers and PXE clients alike without any hassle. Installation and |
1737 |
-configuration is fairly straightforward: |
1738 |
+Next Step -- Setting up TFTP server. It is recommended that you use |
1739 |
+<c>tftp-hpa</c> as it is the only TFTP daemon known to work correctly. Proceed |
1740 |
+by installing it as shown below. |
1741 |
</p> |
1742 |
|
1743 |
<pre caption="Installing tftp-hpa"> |
1744 |
@@ -372,15 +411,9 @@ |
1745 |
</pre> |
1746 |
|
1747 |
<p> |
1748 |
-Now, I personally like to move my <path>/tftpboot</path> directory into |
1749 |
-<path>/home</path> where I have more space. This is totally optional, and can |
1750 |
-be configured through the <path>/etc/conf.d/in.tftpd</path> file. For the |
1751 |
-purposes of this guide, I'll assume you've left it in the default place. |
1752 |
-</p> |
1753 |
- |
1754 |
-<p> |
1755 |
-Now that everything is configured, we're ready to move onto the fun bit -- |
1756 |
-tayloring our config to suit the machine we wish to netboot. |
1757 |
+This will create <path>/tftproot</path> for you to store the netboot images. |
1758 |
+You may move this elsewhere if you wish. For the purposes of this guide, it is |
1759 |
+assumed that you have left it in the default location. |
1760 |
</p> |
1761 |
|
1762 |
</body> |
1763 |
@@ -458,16 +491,12 @@ |
1764 |
<body> |
1765 |
|
1766 |
<p> |
1767 |
-Once you have downloaded the file, simply place it in your |
1768 |
-<path>/tftpboot</path> directory. Then edit your |
1769 |
-<path>/etc/dhcp/dhcpd.conf</path> and add the entry for your SGI client. |
1770 |
+Once you have downloaded the file, place the decompressed image file in your |
1771 |
+<path>/tftproot</path> directory. (Use <c>bzip2 -d</c> to decompress) |
1772 |
+Then edit your <path>/etc/dhcp/dhcpd.conf</path> and add the entry for your |
1773 |
+SGI client. |
1774 |
</p> |
1775 |
|
1776 |
-<note> |
1777 |
-You may need to create the <path>/tftpboot</path> directory if it isn't |
1778 |
-there already. |
1779 |
-</note> |
1780 |
- |
1781 |
<pre caption="dhcpd.conf snippet for SGI Workstation"> |
1782 |
subnet xxx.xxx.xxx.xxx netmask xxx.xxx.xxx.xxx { |
1783 |
<comment># ... usual stuff here ...</comment> |
1784 |
@@ -625,25 +654,18 @@ |
1785 |
|
1786 |
<ul> |
1787 |
<li> |
1788 |
- dhcpd is giving the SGI Machine an IP Address. You should see some |
1789 |
+ <c>dhcpd</c> is giving the SGI Machine an IP Address. You should see some |
1790 |
messages about a BOOTP request in the system logs. <c>tcpdump</c> is also |
1791 |
useful here. |
1792 |
</li> |
1793 |
<li> |
1794 |
Permissions are set properly in your tftp folder (typically |
1795 |
- <path>/tftpboot</path> -- should be world readable) |
1796 |
+ <path>/tftproot</path> -- should be world readable) |
1797 |
</li> |
1798 |
<li> |
1799 |
Check system logs to see what the tftp server is reporting (errors |
1800 |
perhaps) |
1801 |
</li> |
1802 |
-<!-- |
1803 |
- I really think this tip can go... |
1804 |
- |
1805 |
- <li> |
1806 |
- Pray to a Tux plushie (this may or may not work, and is not an officially |
1807 |
- supported troubleshooting technique) |
1808 |
- </li>--> |
1809 |
</ul> |
1810 |
|
1811 |
<p> |
1812 |
@@ -664,6 +686,82 @@ |
1813 |
</section> |
1814 |
|
1815 |
<section> |
1816 |
+<title>Alternative Method: Gentoo/MIPS SGI LiveCD</title> |
1817 |
+<subsection> |
1818 |
+<title>Overview</title> |
1819 |
+<body> |
1820 |
+ |
1821 |
+<p> |
1822 |
+On Silicon Graphics machines, it is possible to boot from a CD in order to |
1823 |
+install operating systems. (This is how one installs IRIX for instance) |
1824 |
+Recently, images for such bootable CDs to install Gentoo have been made |
1825 |
+possible. These CDs are designed to work in the same way. |
1826 |
+</p> |
1827 |
+ |
1828 |
+<p> |
1829 |
+At the moment the Gentoo/MIPS Live CD will only work on the SGI Indy, |
1830 |
+Indigo 2 and O2 workstations equipped with R4000 and R5000-series CPUs, however |
1831 |
+other platforms may be possible in future. |
1832 |
+</p> |
1833 |
+ |
1834 |
+<p> |
1835 |
+You can find the Live CD images for download on your favourite Gentoo Mirror |
1836 |
+under the <path>experimental/mips/livecd</path> directory. |
1837 |
+</p> |
1838 |
+ |
1839 |
+<warn> |
1840 |
+These CDs are highly experimental at this time. They may or may not work at |
1841 |
+this time. You can report success or failures either on |
1842 |
+<uri link="http://bugs.gentoo.org">Bugzilla</uri>, |
1843 |
+<uri link="http://forums.gentoo.org/viewtopic.php?t=242518">this forum |
1844 |
+thread</uri> or in the <c>#gentoo-mips</c> |
1845 |
+<uri link="http://www.gentoo.org/main/en/irc.xml">IRC channel</uri>. We would |
1846 |
+love to hear from you. |
1847 |
+</warn> |
1848 |
+ |
1849 |
+</body> |
1850 |
+ |
1851 |
+</subsection> |
1852 |
+ |
1853 |
+<subsection> |
1854 |
+<title>Burning a Live CD</title> |
1855 |
+<body> |
1856 |
+ |
1857 |
+<p> |
1858 |
+An important thing to note, the SGI PROM does not understand the ISO9660 format, |
1859 |
+nor does it know anything about the El Torito boot standard. These CD images |
1860 |
+are constructed as a SGI disklabel with the boot image in the volume header like |
1861 |
+a hard drive. Therefore, care must be taken when burning the CD image. |
1862 |
+</p> |
1863 |
+ |
1864 |
+<p> |
1865 |
+Below is an example command that assumes 24x burning speed on an IDE burner. If |
1866 |
+you have a SCSI burner for instance, you may want to adjust the <c>dev</c> |
1867 |
+statement as appropriate. Likewise with the <c>speed</c> option - if you |
1868 |
+strike troubles, you might want to try dropping the speed. |
1869 |
+</p> |
1870 |
+ |
1871 |
+<pre caption="Burning using cdrecord"> |
1872 |
+# <i>bzip2 -d mips-livecd-prototype-rc2-20041027.img.bz2</i> |
1873 |
+# <i>cdrecord -vv -pad speed=24 dev=ATAPI:0,0,0 -tao mips-livecd-prototype-rc2-20041027.img</i> |
1874 |
+</pre> |
1875 |
+ |
1876 |
+<note> |
1877 |
+It may be possible to burn these CDs under Windows, assuming your burning |
1878 |
+program just blindly burns the image as is. However, no one has succeeded in |
1879 |
+making a working CD this way to date. |
1880 |
+</note> |
1881 |
+ |
1882 |
+<note> |
1883 |
+If you don't know what to put as your <c>dev</c> argument, run <c>cdrecord |
1884 |
+-scanbus</c> as root - this will tell you where your burner is located. |
1885 |
+</note> |
1886 |
+ |
1887 |
+</body> |
1888 |
+</subsection> |
1889 |
+</section> |
1890 |
+ |
1891 |
+<section> |
1892 |
<title>Netbooting on Cobalt Servers</title> |
1893 |
<subsection> |
1894 |
<body> |
1895 |
@@ -681,17 +779,7 @@ |
1896 |
buttons whilst powering the unit on. The machine will then attempt to obtain an |
1897 |
IP number via BOOTP, mount the <path>/nfsroot</path> directory from the server via |
1898 |
NFS, then try to download and boot the file <path>vmlinux_raq-2800.gz</path> |
1899 |
-which it assumes to be a standard ELF binary. |
1900 |
-</p> |
1901 |
- |
1902 |
-<p> |
1903 |
-Unfortunately, the Cobalt BOOTROM does not give us any say in this procedure, |
1904 |
-so the file HAS to reside in <path>/nfsroot</path> directory, and must be less |
1905 |
-than 675kB in size. In this guide, we'll set up |
1906 |
-<uri link="http://www.colonel-panic.org/cobalt-mips/">CoLo</uri> to allow us to |
1907 |
-boot larger kernels than this limit. CoLo also supports embedded ramdisks, |
1908 |
-therefore ridding the need of a full root filesystem sitting in |
1909 |
-<path>/nfsroot</path>. |
1910 |
+(depending on the model) which it assumes to be a standard ELF binary. |
1911 |
</p> |
1912 |
|
1913 |
</body> |
1914 |
@@ -703,52 +791,18 @@ |
1915 |
|
1916 |
<p> |
1917 |
Inside |
1918 |
-<uri link="http://dev.gentoo.org/~kumba/mips/cobalt/netboot/"> |
1919 |
-http://dev.gentoo.org/~kumba/mips/cobalt/netboot/</uri> |
1920 |
+<uri link="http://dev.gentoo.org/~redhatter/mips/cobalt/netboots/"> |
1921 |
+http://dev.gentoo.org/~redhatter/mips/cobalt/netboots/</uri> |
1922 |
you'll find the necessary boot images for getting a Cobalt up |
1923 |
and running. The files you need will have the name |
1924 |
-<path>cobalt-netboot-YYYYMMDD.img.gz</path> -- select the most recent one and |
1925 |
-place it in your <path>/nfsroot</path> directory. For convenience, rename the |
1926 |
-file to <path>gentoo-cobalt.img.gz</path> -- I'll assume that you have done |
1927 |
-this. |
1928 |
-</p> |
1929 |
- |
1930 |
-<p> |
1931 |
-Once that is done, head over to |
1932 |
-<uri link="http://www.colonel-panic.org/cobalt-mips/"> |
1933 |
-http://www.colonel-panic.org/cobalt-mips/</uri> and |
1934 |
-download the latest release of the CoLo bootloader. Untar this somewhere |
1935 |
-convenient. Inside the <path>colo-1.XX/binaries</path> directory created, |
1936 |
-you should find under a file named <path>colo-chain.elf</path>. Gzip this |
1937 |
-file up and place it in <path>/nfsroot</path> calling it |
1938 |
-<path>vmlinux_raq-2800.gz</path>. Also, in some cases, you will need to create a |
1939 |
-symbolic link called <path>boot</path> that points back to |
1940 |
-<path>/nfsroot</path>. You can do this in one hit using these commands: |
1941 |
+<path>nfsroot-KERNEL-COLO-DATE-cobalt.tar</path> -- select the most recent one and |
1942 |
+unpack it to <path>/</path> as shown below: |
1943 |
</p> |
1944 |
|
1945 |
-<note> |
1946 |
-Please note, the RaQ1 and Qube 2700 look for <path>vmlinux.gz</path> rather than |
1947 |
-<path>vmlinux_raq-2800.gz</path>. |
1948 |
-</note> |
1949 |
- |
1950 |
-<pre caption="Putting CoLo in the nfsroot"> |
1951 |
-# <i>tar -xzvf colo-1.XX.tar.gz</i> |
1952 |
-# <i>cd colo-1.XX/binaries</i> |
1953 |
- |
1954 |
-<comment>(For Qube 2800, RaQ2, etc)</comment> |
1955 |
-# <i>gzip -9vc colo-chain.elf > /nfsroot/vmlinux_raq-2800.gz</i> |
1956 |
- |
1957 |
-<comment>(For RaQ1, Qube 2700)</comment> |
1958 |
-# <i>gzip -9vc colo-chain.elf > /nfsroot/vmlinux.gz</i> |
1959 |
-# <i>cd /nfsroot</i> |
1960 |
-# <i>ln . boot</i> |
1961 |
+<pre caption="Unpacking the nfsroot image"> |
1962 |
+# <i>tar -C / -xvf nfsroot-2.6.13.4-1.19-20051122.tar</i> |
1963 |
</pre> |
1964 |
|
1965 |
-<note> |
1966 |
-If the latest CoLo release fails to boot, you may wish to try an earlier |
1967 |
-release. Version 1.16 and earlier are known to work. |
1968 |
-</note> |
1969 |
- |
1970 |
</body> |
1971 |
</subsection> |
1972 |
|
1973 |
@@ -812,6 +866,7 @@ |
1974 |
host <i>qube</i> { |
1975 |
<comment># Path to the nfsroot directory.</comment> |
1976 |
<comment># This is mainly for when using the TFTP boot option on CoLo</comment> |
1977 |
+ <comment># You shouldn't need to change this.</comment> |
1978 |
option root-path "/nfsroot"; |
1979 |
|
1980 |
<comment># Cobalt server's ethernet MAC address</comment> |
1981 |
@@ -823,9 +878,9 @@ |
1982 |
<comment># IP address of cobalt server</comment> |
1983 |
fixed-address <i>192.168.10.2</i>; |
1984 |
|
1985 |
- <comment># Image to download</comment> |
1986 |
- <comment># Again, this has more to do with CoLo</comment> |
1987 |
- filename "<i>gentoo-cobalt.img.gz</i>"; |
1988 |
+ <comment># Location of the default.colo file relative to /nfsroot</comment> |
1989 |
+ <comment># You shouldn't need to change this.</comment> |
1990 |
+ filename "default.colo"; |
1991 |
} |
1992 |
} |
1993 |
</pre> |
1994 |
@@ -872,91 +927,11 @@ |
1995 |
<p> |
1996 |
If all is well, the back panel should display "Net Booting", you should |
1997 |
see some network activity, closely followed by CoLo kicking in. On the rear |
1998 |
-panel, scroll down the menu until you see "Boot Shell" then press ENTER. On the |
1999 |
-serial console, you should be dropped to a prompt as shown below. |
2000 |
-</p> |
2001 |
- |
2002 |
-<note> |
2003 |
-It has been reported that simply selecting the NFS boot option does all of this |
2004 |
-for you under modern versions of CoLo. If selecting this option does not work, |
2005 |
-then read on. |
2006 |
-</note> |
2007 |
- |
2008 |
-<pre caption="CoLo booting to a prompt"> |
2009 |
-[ "CoLo" v1.13 ] |
2010 |
-stage2: 87fb0000-88000000 |
2011 |
-pci: unit type <Qube2> |
2012 |
-tulip: {00:10:e0:00:86:3d} |
2013 |
-ide: resetting |
2014 |
-boot: running boot menu |
2015 |
-> |
2016 |
-</pre> |
2017 |
- |
2018 |
-<p> |
2019 |
-First step, tell the machine to fetch an address via DHCP. Type <c>dhcp</c> at |
2020 |
-the prompt. |
2021 |
-</p> |
2022 |
- |
2023 |
-<pre caption="Fetching an address via DHCP"> |
2024 |
-> <i>dhcp</i> |
2025 |
-net: interface up |
2026 |
-dhcp: DISCOVER |
2027 |
-dhcp: OFFER 10.0.0.1 <-- 192.168.10.254 |
2028 |
-dhcp: REQUEST |
2029 |
-arp: sent request for 192.168.10.254 |
2030 |
-udp: no matching socket 192.168.5.1:67 --> 10.0.0.1:68 |
2031 |
-arp: resolved 192.168.10.254 |
2032 |
-udp: no matching socket 192.168.5.1:67 --> 10.0.0.1:68 |
2033 |
-dhcp: DISCOVER |
2034 |
-dhcp: OFFER 10.0.0.1 <-- 192.168.10.254 |
2035 |
-dhcp: REQUEST |
2036 |
-udp: no matching socket 192.168.5.1:67 --> 10.0.0.1:68 |
2037 |
-dhcp: ACK |
2038 |
-net: interface down |
2039 |
-net: interface up |
2040 |
- address 10.0.0.1 |
2041 |
- netmask 255.255.255.0 |
2042 |
- gateway 10.0.0.254 |
2043 |
- name server 192.168.5.1 |
2044 |
-</pre> |
2045 |
- |
2046 |
-<p> |
2047 |
-NOTE: If you have a Windows network you may see messages along the lines of |
2048 |
-<c>udp: no matching socket</c>. These are in response to network broadcasts on |
2049 |
-ports that CoLo doesn't recognise. As annoying as they are, they are perfectly |
2050 |
-harmless. |
2051 |
-</p> |
2052 |
- |
2053 |
-<pre caption="'no matching socket' error messages"> |
2054 |
-udp: no matching socket 10.0.0.254:138 --> 10.0.0.255:138 |
2055 |
-udp: no matching socket 10.0.0.254:138 --> 10.0.0.255:138 |
2056 |
-udp: no matching socket 10.0.0.253:1062 --> 10.0.0.255:137 |
2057 |
-udp: no matching socket 10.0.0.253:1062 --> 10.0.0.255:137 |
2058 |
-</pre> |
2059 |
- |
2060 |
-<p> |
2061 |
-Okay, the next step is to tell the Cobalt server to download its kernel. |
2062 |
-</p> |
2063 |
- |
2064 |
-<pre caption="Downloading the kernel"> |
2065 |
-> <i>nfs 10.0.0.254 /nfsroot gentoo.img.gz</i> |
2066 |
-arp: sent request for 10.0.0.254 |
2067 |
-arp: resolved 10.0.0.254 |
2068 |
-udp: no matching socket 10.0.0.253:1062 --> 10.0.0.255:137 |
2069 |
-nfs: mounted "/nfsroot" |
2070 |
-nfs: lookup "gentoo.img.gz" |
2071 |
-nfs: mode <0100644> |
2072 |
-4651KB loaded (1240KB/sec) |
2073 |
-0048ada0 4763040t |
2074 |
-</pre> |
2075 |
- |
2076 |
-<p> |
2077 |
-And that's it... it has now downloaded its kernel, we now can tell it to start |
2078 |
-booting. |
2079 |
+panel, scroll down the menu until you see "Network (NFS)" then press ENTER. |
2080 |
+You should notice the machine starts booting on the serial console. |
2081 |
</p> |
2082 |
|
2083 |
<pre caption="Booting the kernel"> |
2084 |
-> <i>execute</i> |
2085 |
elf: 80080000 <-- 00001000 6586368t + 192624t |
2086 |
elf: entry 80328040 |
2087 |
net: interface down |
2088 |
@@ -1040,84 +1015,5 @@ |
2089 |
</body> |
2090 |
</subsection> |
2091 |
</section> |
2092 |
-<!-- |
2093 |
- |
2094 |
- Commented Out Until Further Notice |
2095 |
|
2096 |
-<section> |
2097 |
-<title>Gentoo/MIPS LiveCD</title> |
2098 |
-<subsection> |
2099 |
-<title>Overview</title> |
2100 |
-<body> |
2101 |
- |
2102 |
-<p> |
2103 |
-On Silicon Graphics machines, it is possible to boot from a CD in order to |
2104 |
-install operating systems. (This is how one installs IRIX for instance) |
2105 |
-Recently, images for such bootable CDs to install Gentoo have been made |
2106 |
-possible. These CDs are designed to work in the same way. |
2107 |
-</p> |
2108 |
- |
2109 |
-<p> |
2110 |
-At the moment the Gentoo/MIPS Live CD will only work on the SGI Indy, |
2111 |
-Indigo 2 and O2 workstations equipped with R4000 and R5000-series CPUs, however |
2112 |
-other platforms may be possible in future. |
2113 |
-</p> |
2114 |
- |
2115 |
-<p> |
2116 |
-You can find the Live CD images for download on your favourite Gentoo Mirror |
2117 |
-under the <path>experimental/mips/livecd</path> directory. |
2118 |
-</p> |
2119 |
- |
2120 |
-<warn> |
2121 |
-These CDs are highly experimental at this time. They may or may not work at |
2122 |
-this time. You can report success or failures either on |
2123 |
-<uri link="http://bugs.gentoo.org">Bugzilla</uri>, |
2124 |
-<uri link="http://forums.gentoo.org/viewtopic.php?t=242518">this forum |
2125 |
-thread</uri> or in the <c>#gentoo-mips</c> |
2126 |
-<uri link="http://www.gentoo.org/main/en/irc.xml">IRC channel</uri>. We would |
2127 |
-love to hear from you. |
2128 |
-</warn> |
2129 |
- |
2130 |
-</body> |
2131 |
- |
2132 |
-</subsection> |
2133 |
- |
2134 |
-<subsection> |
2135 |
-<title>Burning a Live CD</title> |
2136 |
-<body> |
2137 |
- |
2138 |
-<p> |
2139 |
-An important thing to note, the SGI PROM does not understand the ISO9660 format, |
2140 |
-nor does it know anything about the El Torito boot standard. These CD images |
2141 |
-are constructed as a SGI disklabel with the boot image in the volume header like |
2142 |
-a hard drive. Therefore, care must be taken when burning the CD image. |
2143 |
-</p> |
2144 |
- |
2145 |
-<p> |
2146 |
-Below is an example command that assumes 24x burning speed on an IDE burner. If |
2147 |
-you have a SCSI burner for instance, you may want to adjust the <c>dev</c> |
2148 |
-statement as appropriate. Likewise with the <c>speed</c> option - if you |
2149 |
-strike troubles, you might want to try dropping the speed. |
2150 |
-</p> |
2151 |
- |
2152 |
-<pre caption="Burning using cdrecord"> |
2153 |
-# <i>bzip2 -d mips-livecd-prototype-rc2-20041027.img.bz2</i> |
2154 |
-# <i>cdrecord -vv -pad speed=24 dev=ATAPI:0,0,0 -tao mips-livecd-prototype-rc2-20041027.img</i> |
2155 |
-</pre> |
2156 |
- |
2157 |
-<note> |
2158 |
-It may be possible to burn these CDs under Windows, assuming your burning |
2159 |
-program just blindly burns the image as is. However, no one has succeeded in |
2160 |
-making a working CD this way to date. |
2161 |
-</note> |
2162 |
- |
2163 |
-<note> |
2164 |
-If you don't know what to put as your <c>dev</c> argument, run <c>cdrecord |
2165 |
--scanbus</c> as root - this will tell you where your burner is located. |
2166 |
-</note> |
2167 |
- |
2168 |
-</body> |
2169 |
-</subsection> |
2170 |
-</section> |
2171 |
---> |
2172 |
</sections> |
2173 |
|
2174 |
|
2175 |
|
2176 |
1.33 +47 -36 xml/htdocs/doc/en/handbook/hb-install-ppc-bootloader.xml |
2177 |
|
2178 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc-bootloader.xml?rev=1.33&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
2179 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc-bootloader.xml?rev=1.33&content-type=text/plain&cvsroot=gentoo |
2180 |
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc-bootloader.xml.diff?r1=1.32&r2=1.33&cvsroot=gentoo |
2181 |
|
2182 |
Index: hb-install-ppc-bootloader.xml |
2183 |
=================================================================== |
2184 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-bootloader.xml,v |
2185 |
retrieving revision 1.32 |
2186 |
retrieving revision 1.33 |
2187 |
diff -u -r1.32 -r1.33 |
2188 |
--- hb-install-ppc-bootloader.xml 19 Jan 2006 21:48:10 -0000 1.32 |
2189 |
+++ hb-install-ppc-bootloader.xml 27 Feb 2006 00:55:34 -0000 1.33 |
2190 |
@@ -4,12 +4,12 @@ |
2191 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
2192 |
<!-- See http://creativecommons.org/licenses/by-sa/1.0 --> |
2193 |
|
2194 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-bootloader.xml,v 1.32 2006/01/19 21:48:10 neysx Exp $ --> |
2195 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-bootloader.xml,v 1.33 2006/02/27 00:55:34 fox2mike Exp $ --> |
2196 |
|
2197 |
<sections> |
2198 |
|
2199 |
-<version>2.8</version> |
2200 |
-<date>2006-01-19</date> |
2201 |
+<version>2.9</version> |
2202 |
+<date>2006-02-27</date> |
2203 |
|
2204 |
<section> |
2205 |
<title>Choosing a Bootloader</title> |
2206 |
@@ -43,16 +43,21 @@ |
2207 |
<impo> |
2208 |
yaboot can only be used on NewWorld Apple or IBM machines! |
2209 |
</impo> |
2210 |
- |
2211 |
+ |
2212 |
<p> |
2213 |
-In order to find the boot devices, yaboot needs access to the <path>/dev</path> |
2214 |
-filesystem. To do this, you will need to "bind-map" the <path>/dev</path> |
2215 |
-filesystem from the Installation CD to <path>/dev</path> inside of the chroot. |
2216 |
+In order to find the boot devices, yaboot needs access to the device nodes |
2217 |
+created by udev on startup and the sysfs filesystem. These two filesystems |
2218 |
+are found at <path>/dev</path> and <path>sys</path> respectively. To do this, |
2219 |
+you will need to "bind mount" these filesystems from the Installation CD's root |
2220 |
+to the <path>/dev</path> and <path>/sys</path> mount points inside the chroot. |
2221 |
+If you have already bind mounted these filesystems, there is no need to do it |
2222 |
+again. |
2223 |
</p> |
2224 |
- |
2225 |
-<pre caption="Bind-mounting the /dev filesystem"> |
2226 |
+ |
2227 |
+<pre caption="Bind-mounting the device and sysfs filesystems"> |
2228 |
# <i>exit </i> # this will exit the chroot |
2229 |
# <i>mount -o bind /dev /mnt/gentoo/dev</i> |
2230 |
+# <i>mount -o bind /sys /mnt/gentoo/sys</i> |
2231 |
# <i>chroot /mnt/gentoo /bin/bash</i> |
2232 |
# <i>/usr/sbin/env-update && source /etc/profile </i> |
2233 |
</pre> |
2234 |
@@ -73,10 +78,10 @@ |
2235 |
<pre caption="Adding genkernel boot arguments to yaboot.conf"> |
2236 |
<comment>########################################################### |
2237 |
## This section can be duplicated if you have more than one |
2238 |
-## kernel or set of boot options - replace kernel-2.6.12 |
2239 |
+## kernel or set of boot options - replace kernel-2.6.15 |
2240 |
## with the exact filename of your kernel. |
2241 |
###########################################################</comment> |
2242 |
-image=/boot/kernel-2.6.12 |
2243 |
+image=/boot/kernel-2.6.15 |
2244 |
label=Linux |
2245 |
root=/dev/ram0 <comment># If using genkernel this is /dev/ram0</comment> |
2246 |
partition=3 |
2247 |
@@ -104,27 +109,28 @@ |
2248 |
<c>yabootconfig</c> will auto-detect the partitions on your machine and will |
2249 |
set up dual and triple boot combinations with Linux, Mac OS, and Mac OS X. |
2250 |
</p> |
2251 |
- |
2252 |
+ |
2253 |
<p> |
2254 |
To use <c>yabootconfig</c>, your drive must have an Apple_Bootstrap partition, |
2255 |
-and <path>/etc/fstab</path> must be configured with your Linux partitions. Both |
2256 |
-of these steps should have been completed already. First, make sure that you |
2257 |
-have the latest version of <c>yaboot</c> installed. |
2258 |
+and <path>/etc/fstab</path> must be configured to reflect your Linux |
2259 |
+partitions. These steps should have already been completed before, but check |
2260 |
+<path>/etc/fstab</path> before proceeding. Now, ensure that you have |
2261 |
+<c>yaboot</c> installed. |
2262 |
</p> |
2263 |
- |
2264 |
-<pre caption = "Installing yaboot with GRP"> |
2265 |
-# <i>emerge --usepkg --update yaboot</i> |
2266 |
+ |
2267 |
+<pre caption = "Installing yaboot"> |
2268 |
+# <i>emerge yaboot</i> |
2269 |
</pre> |
2270 |
- |
2271 |
+ |
2272 |
<p> |
2273 |
-Now, exit the chroot and run <c>yabootconfig --chroot /mnt/gentoo</c>. It will |
2274 |
-ask you to confirm the location of the Apple_Bootstrap partition. Type <c>Y</c> |
2275 |
-if it is correct. If not, check <path>/etc/fstab</path> and ensure that the |
2276 |
-device paths are correct. Once the bootstrap partition has been selected, |
2277 |
-<c>yabootconfig</c> will scan your system setup, create |
2278 |
-<path>/etc/yaboot.conf</path> and run <c>mkofboot</c>. <c>mkofboot</c> |
2279 |
-formats the Apple_Bootstrap partition, and installs the yaboot configuration |
2280 |
-file onto it. After this is complete, enter the chroot again. |
2281 |
+Now exit the chroot and run <c>yabootconfig --chroot /mnt/gentoo</c>. First, |
2282 |
+the program will confirm the location of the bootstrap partition. If you are |
2283 |
+using the suggested disk partitioning scheme, your bootstrap partition should |
2284 |
+be /dev/hda2. Type <c>Y</c> if the output is correct. If not, double check your |
2285 |
+<path>/etc/fstab</path>. <c>yabootconfig</c> will then scan your system setup, |
2286 |
+create <path>/etc/yaboot.conf</path> and run <c>mkofboot</c> for you. |
2287 |
+<c>mkofboot</c> is used to format the Apple_Bootstrap partition, and install |
2288 |
+the yaboot configuration file into it. After this enter the chroot again. |
2289 |
</p> |
2290 |
|
2291 |
<pre caption="Re-enter the chroot"> |
2292 |
@@ -150,11 +156,11 @@ |
2293 |
<body> |
2294 |
|
2295 |
<p> |
2296 |
-First, make sure you have the latest version of <c>yaboot</c> installed. |
2297 |
+First, make sure you have <c>yaboot</c> installed. |
2298 |
</p> |
2299 |
|
2300 |
<pre caption = "Installing yaboot"> |
2301 |
-# <i>emerge --usepkg --update yaboot</i> |
2302 |
+# <i>emerge yaboot</i> |
2303 |
</pre> |
2304 |
|
2305 |
<p> |
2306 |
@@ -313,6 +319,12 @@ |
2307 |
BootX home page</uri> for more information. |
2308 |
</p> |
2309 |
|
2310 |
+<impo> |
2311 |
+Make sure that you have support for HFS and HFS+ filesystems in your kernel, |
2312 |
+otherwise you will not be able to upgrade or change the kernel on your MacOS |
2313 |
+partition. |
2314 |
+</impo> |
2315 |
+ |
2316 |
<p> |
2317 |
Now reboot again and boot into Linux, then continue with <uri |
2318 |
link="?part=1&chap=11">Finalizing your Gentoo Installation</uri>. |
2319 |
@@ -346,12 +358,12 @@ |
2320 |
|
2321 |
<pre caption="Configuring quik.conf"> |
2322 |
# Example of quik.conf |
2323 |
-init-message = "Gentoo 2005.1\n" |
2324 |
+init-message = "Gentoo 2006.0\n" |
2325 |
partition = 2 <comment># This is the boot partition</comment> |
2326 |
root = /dev/hda4 |
2327 |
timeout = 30 |
2328 |
default = gentoo |
2329 |
-image = /vmlinux-2.6.12 |
2330 |
+image = /vmlinux-2.6.15 |
2331 |
label = gentoo |
2332 |
</pre> |
2333 |
|
2334 |
@@ -379,7 +391,7 @@ |
2335 |
# <i>nvsetenv input-device kbd</i> |
2336 |
# <i>nvsetenv boot-device scsi/sd@1:0</i> <comment># For SCSI</comment> |
2337 |
# <i>nvsetenv boot-device ata/ata-disk@0:0</i> <comment># For ATA</comment> |
2338 |
-# <i>nvsetenv boot-file /boot/vmlinux-2.6.12 root=/dev/hda4</i> <comment>First item is the path to the kernel, the second is the root partition. You may append any kernel options to the end of this line.</comment> |
2339 |
+# <i>nvsetenv boot-file /boot/vmlinux-2.6.15 root=/dev/hda4</i> <comment>First item is the path to the kernel, the second is the root partition. You may append any kernel options to the end of this line.</comment> |
2340 |
# <i>nvsetenv boot-command boot</i> <comment># Set this to bye for MacOS and boot for Linux</comment> |
2341 |
</pre> |
2342 |
|
2343 |
@@ -464,12 +476,12 @@ |
2344 |
ide:0 boot2.img ramdebug edebugflags="logkprintf" |
2345 |
|
2346 |
[SECTION] |
2347 |
-Local HD -> Linux 2.6.12 (Normal) |
2348 |
-ide:0 linux-2.6.12 video=radeonfb:1024x768@70 root=/dev/hda3 |
2349 |
+Local HD -> Linux 2.6.15 (Normal) |
2350 |
+ide:0 linux-2.6.15 video=radeonfb:1024x768@70 root=/dev/hda3 |
2351 |
|
2352 |
[SECTION] |
2353 |
Local HD -> Genkernel (Normal) |
2354 |
-ide:0 kernelz-2.6.12 root=/dev/ram0 real_root=/dev/hda3 init=/linuxrc |
2355 |
+ide:0 kernelz-2.6.15 root=/dev/ram0 real_root=/dev/hda3 init=/linuxrc |
2356 |
</pre> |
2357 |
|
2358 |
<p> |
2359 |
@@ -492,7 +504,6 @@ |
2360 |
<uri link="#reboot">Rebooting the System</uri>. |
2361 |
</p> |
2362 |
|
2363 |
- |
2364 |
</body> |
2365 |
</section> |
2366 |
<section id="reboot"> |
2367 |
|
2368 |
|
2369 |
|
2370 |
1.34 +16 -18 xml/htdocs/doc/en/handbook/hb-install-ppc-disk.xml |
2371 |
|
2372 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc-disk.xml?rev=1.34&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
2373 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc-disk.xml?rev=1.34&content-type=text/plain&cvsroot=gentoo |
2374 |
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc-disk.xml.diff?r1=1.33&r2=1.34&cvsroot=gentoo |
2375 |
|
2376 |
Index: hb-install-ppc-disk.xml |
2377 |
=================================================================== |
2378 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-disk.xml,v |
2379 |
retrieving revision 1.33 |
2380 |
retrieving revision 1.34 |
2381 |
diff -u -r1.33 -r1.34 |
2382 |
--- hb-install-ppc-disk.xml 5 Sep 2005 23:17:21 -0000 1.33 |
2383 |
+++ hb-install-ppc-disk.xml 27 Feb 2006 00:55:34 -0000 1.34 |
2384 |
@@ -4,12 +4,12 @@ |
2385 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
2386 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
2387 |
|
2388 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-disk.xml,v 1.33 2005/09/05 23:17:21 vanquirius Exp $ --> |
2389 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-disk.xml,v 1.34 2006/02/27 00:55:34 fox2mike Exp $ --> |
2390 |
|
2391 |
<sections> |
2392 |
|
2393 |
-<version>2.4</version> |
2394 |
-<date>2005-08-25</date> |
2395 |
+<version>2.5</version> |
2396 |
+<date>2006-02-27</date> |
2397 |
|
2398 |
<section> |
2399 |
<title>Introduction to Block Devices</title> |
2400 |
@@ -26,10 +26,10 @@ |
2401 |
</p> |
2402 |
|
2403 |
<p> |
2404 |
-To begin, we'll introduce <e>block devices</e>. The most famous block device is |
2405 |
-probably the one that represents the first IDE drive in a Linux system, namely |
2406 |
-<path>/dev/hda</path>. If your system uses SCSI or SATA drives, then your first |
2407 |
-hard drive would be <path>/dev/sda</path>. |
2408 |
+To begin, we'll introduce <e>block devices</e>. The most common block device is |
2409 |
+the one that represents the first IDE drive in a Linux system, namely |
2410 |
+<path>/dev/hda</path>. If you are installing onto SCSI, FireWire, USB or SATA |
2411 |
+drives, then your first hard drive would be <path>/dev/sda</path>. |
2412 |
</p> |
2413 |
|
2414 |
<p> |
2415 |
@@ -108,7 +108,7 @@ |
2416 |
<ti>(Not applicable)</ti> |
2417 |
<ti><path>/dev/hda2</path> (If using quik)</ti> |
2418 |
<ti><path>/dev/hda1</path></ti> |
2419 |
- <ti>(Not needed)</ti> |
2420 |
+ <ti>(Not applicable)</ti> |
2421 |
<ti>ext2</ti> |
2422 |
<ti>32MB</ti> |
2423 |
<ti>Boot partition</ti> |
2424 |
@@ -138,18 +138,17 @@ |
2425 |
Apple_FWDriver, Apple_Driver_IOKit, Apple_Patches</path>. If you are not |
2426 |
planning to use MacOS 9 you can delete them, because MacOS X and Linux don't |
2427 |
need them. To delete them, either use parted or erase the whole disk by |
2428 |
-initialing the partition map. |
2429 |
+initializing the partition map. |
2430 |
</note> |
2431 |
- |
2432 |
+ |
2433 |
<warn> |
2434 |
-<c>parted</c> is able to resize partitions. On the Installation CD there |
2435 |
-are patches included to resize HFS+ filesystem. Unfortunately it is risky to |
2436 |
-resize HFS+ journaled filesystems, be sure to switch off journaling in Mac OS X |
2437 |
-first and make sure to run a disk checking tool after the resize. Everything |
2438 |
-you do with resizing in parted you do it at your own risk! Be sure to have a |
2439 |
-backup of your data! |
2440 |
+<c>parted</c> is able to resize partitions including HFS+. Unfortunately it is |
2441 |
+not possible to resize HFS+ journaled filesystems, so switch off journaling in |
2442 |
+Mac OS X before resizing. Remeber that any resizing operation is dangerous, |
2443 |
+so attempt at your own risk! Be sure to always have a backup of your data |
2444 |
+before resizing! |
2445 |
</warn> |
2446 |
- |
2447 |
+ |
2448 |
<p> |
2449 |
If you are interested in knowing how big a partition should be, or even how many |
2450 |
partitions you need, read on. Otherwise continue now with |
2451 |
@@ -523,7 +522,6 @@ |
2452 |
also holds for <path>/var/tmp</path>. |
2453 |
</note> |
2454 |
|
2455 |
- |
2456 |
<p> |
2457 |
We will have to mount the proc filesystem (a virtual interface with the |
2458 |
kernel) on <path>/proc</path>. But first we will need to place our files on the |
2459 |
|
2460 |
|
2461 |
|
2462 |
1.39 +21 -16 xml/htdocs/doc/en/handbook/hb-install-ppc-kernel.xml |
2463 |
|
2464 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc-kernel.xml?rev=1.39&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
2465 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc-kernel.xml?rev=1.39&content-type=text/plain&cvsroot=gentoo |
2466 |
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc-kernel.xml.diff?r1=1.38&r2=1.39&cvsroot=gentoo |
2467 |
|
2468 |
Index: hb-install-ppc-kernel.xml |
2469 |
=================================================================== |
2470 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-kernel.xml,v |
2471 |
retrieving revision 1.38 |
2472 |
retrieving revision 1.39 |
2473 |
diff -u -r1.38 -r1.39 |
2474 |
--- hb-install-ppc-kernel.xml 8 Jan 2006 14:05:29 -0000 1.38 |
2475 |
+++ hb-install-ppc-kernel.xml 27 Feb 2006 00:55:34 -0000 1.39 |
2476 |
@@ -4,12 +4,12 @@ |
2477 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
2478 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
2479 |
|
2480 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-kernel.xml,v 1.38 2006/01/08 14:05:29 neysx Exp $ --> |
2481 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-kernel.xml,v 1.39 2006/02/27 00:55:34 fox2mike Exp $ --> |
2482 |
|
2483 |
<sections> |
2484 |
|
2485 |
-<version>2.15</version> |
2486 |
-<date>2006-01-06</date> |
2487 |
+<version>2.16</version> |
2488 |
+<date>2006-02-27</date> |
2489 |
|
2490 |
<section> |
2491 |
<title>Timezone</title> |
2492 |
@@ -59,24 +59,16 @@ |
2493 |
# <i>USE="-doc symlink" emerge gentoo-sources</i> |
2494 |
</pre> |
2495 |
|
2496 |
-<!-- Removed, as we're trying to avoid specific kernel versions to improve HB |
2497 |
-maintainability |
2498 |
-<note> |
2499 |
-The suggested sources at the time of the 2005.1 release are |
2500 |
-<c>gentoo-sources-2.6.12-r4</c> and <c>vanilla-sources-2.6.12.2</c>. |
2501 |
-</note> |
2502 |
---> |
2503 |
- |
2504 |
<p> |
2505 |
If you take a look in <path>/usr/src</path> you should see a symlink named |
2506 |
<path>linux</path> pointing to your current kernel source. In this case, the |
2507 |
-installed kernel source points to <c>gentoo-sources-2.6.12-r4</c>. Your version |
2508 |
+installed kernel source points to <c>gentoo-sources-2.6.15</c>. Your version |
2509 |
may be different, so keep this in mind. |
2510 |
</p> |
2511 |
|
2512 |
<pre caption="Viewing the kernel source symlink"> |
2513 |
# <i>ls -l /usr/src/linux</i> |
2514 |
-lrwxrwxrwx 1 root root 22 Mar 18 16:23 /usr/src/linux -> linux-2.6.12-gentoo-r4 |
2515 |
+lrwxrwxrwx 1 root root 22 Mar 18 16:23 /usr/src/linux -> linux-2.6.15-gentoo |
2516 |
</pre> |
2517 |
|
2518 |
<p> |
2519 |
@@ -303,13 +295,26 @@ |
2520 |
|
2521 |
<p> |
2522 |
When the kernel has finished compiling, copy the kernel image to |
2523 |
-<path>/boot</path> (be sure that it is mounted properly on the Pegasos). |
2524 |
+<path>/boot</path> (be sure that it is mounted properly on Pegasos computers). |
2525 |
+If you are using BootX to boot, we'll copy the kernel later. |
2526 |
+</p> |
2527 |
+ |
2528 |
+<p> |
2529 |
+Yaboot and BootX expect to use an uncompressed kernel unlike many other |
2530 |
+bootloaders. The uncompressed kernel is called vmlinux and it is placed in |
2531 |
+<path>/usr/src/linux</path> after the kernel has finished compiling. If you |
2532 |
+are using a Pegasos machine, the Pegasos firmware requires a compressed |
2533 |
+kernel called zImage.chrp which can be found in |
2534 |
+<path>/usr/src/linux/arch/ppc/boot/images</path>. |
2535 |
</p> |
2536 |
|
2537 |
<pre caption="Installing the kernel"> |
2538 |
+# <i>cd /usr/src/linux</i> |
2539 |
<comment>replace <kernel-version> with your kernel version</comment> |
2540 |
-(Apple/IBM) # <i>cp vmlinux /boot/<kernel-version></i> |
2541 |
-(Pegasos) # <i>cp arch/ppc/boot/images/zImage.chrp /boot/<kernel-version></i> |
2542 |
+<comment>(Apple/IBM)</comment> |
2543 |
+# <i>cp vmlinux /boot/<kernel-version></i> |
2544 |
+<comment>(Pegasos)</comment> |
2545 |
+# <i>cp arch/ppc/boot/images/zImage.chrp /boot/<kernel-version></i> |
2546 |
</pre> |
2547 |
|
2548 |
<p> |
2549 |
|
2550 |
|
2551 |
|
2552 |
1.52 +61 -50 xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml |
2553 |
|
2554 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml?rev=1.52&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
2555 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml?rev=1.52&content-type=text/plain&cvsroot=gentoo |
2556 |
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml.diff?r1=1.51&r2=1.52&cvsroot=gentoo |
2557 |
|
2558 |
Index: hb-install-ppc-medium.xml |
2559 |
=================================================================== |
2560 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml,v |
2561 |
retrieving revision 1.51 |
2562 |
retrieving revision 1.52 |
2563 |
diff -u -r1.51 -r1.52 |
2564 |
--- hb-install-ppc-medium.xml 29 Nov 2005 14:48:46 -0000 1.51 |
2565 |
+++ hb-install-ppc-medium.xml 27 Feb 2006 00:55:34 -0000 1.52 |
2566 |
@@ -4,12 +4,12 @@ |
2567 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
2568 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
2569 |
|
2570 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml,v 1.51 2005/11/29 14:48:46 jkt Exp $ --> |
2571 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml,v 1.52 2006/02/27 00:55:34 fox2mike Exp $ --> |
2572 |
|
2573 |
<sections> |
2574 |
|
2575 |
-<version>2.8</version> |
2576 |
-<date>2005-11-29</date> |
2577 |
+<version>2.9</version> |
2578 |
+<date>2006-02-27</date> |
2579 |
|
2580 |
<section> |
2581 |
<title>Hardware Requirements</title> |
2582 |
@@ -71,8 +71,9 @@ |
2583 |
</table> |
2584 |
|
2585 |
<p> |
2586 |
-Be sure to read up on the <uri link="/doc/en/gentoo-ppc-faq.xml">Gentoo |
2587 |
-PPC FAQ</uri> before you begin. |
2588 |
+Be sure to read the <uri link="/doc/en/gentoo-ppc-faq.xml">Gentoo PPC FAQ</uri> |
2589 |
+for help with some common installation related issues or if you're unsure as to |
2590 |
+just what's in that PowerPC machine you've got sitting on your desk right now. |
2591 |
</p> |
2592 |
|
2593 |
</body> |
2594 |
@@ -104,7 +105,7 @@ |
2595 |
<p> |
2596 |
If you wish to install Gentoo without a working Internet connection, please use |
2597 |
the installation instructions described in the <uri |
2598 |
-link="2005.1/index.xml">Gentoo 2005.1 Handbooks</uri>. |
2599 |
+link="2006.0/index.xml">Gentoo 2006.0 Handbooks</uri>. |
2600 |
</p> |
2601 |
|
2602 |
<p> |
2603 |
@@ -136,7 +137,7 @@ |
2604 |
<body> |
2605 |
|
2606 |
<p> |
2607 |
-The Minimal Installation CD is called <c>install-ppc-minimal-2005.1.iso</c> and |
2608 |
+The Minimal Installation CD is called <c>install-ppc-minimal-2006.0.iso</c> and |
2609 |
takes up only 52 MB of diskspace. You can use this Installation CD to install |
2610 |
Gentoo, but always with a working Internet connection only. |
2611 |
</p> |
2612 |
@@ -166,11 +167,11 @@ |
2613 |
<body> |
2614 |
|
2615 |
<p> |
2616 |
-The Universal Installation CD is called <c>install-ppc-universal-2005.1.iso</c> |
2617 |
-and consumes the entire surface of a 650 MB CD. You can use this Installation |
2618 |
-CD to install Gentoo, and you can even use it to install Gentoo without a |
2619 |
-working internet connection, just in case you want to bring Gentoo to another |
2620 |
-PC than the one you are currently installing Gentoo on :) |
2621 |
+The Universal Installation CD is called <c>install-ppc-universal-2006.0.iso</c> |
2622 |
+and consumes about 578 MB on a CD. You can use this Installation CD to install |
2623 |
+Gentoo, and you can even use it to install Gentoo without a working internet |
2624 |
+connection, just in case you want to bring Gentoo to another PC than the one |
2625 |
+you are currently installing Gentoo on :) |
2626 |
</p> |
2627 |
|
2628 |
<table> |
2629 |
@@ -247,7 +248,7 @@ |
2630 |
<p> |
2631 |
You can download any of the Installation CDs (and, if you want to, a Packages |
2632 |
CD as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The |
2633 |
-Installation CDs are located in the <path>releases/ppc/2005.1/installcd</path> |
2634 |
+Installation CDs are located in the <path>releases/ppc/2006.0/ppc32/installcd</path> |
2635 |
directory. |
2636 |
</p> |
2637 |
|
2638 |
@@ -259,7 +260,7 @@ |
2639 |
<p> |
2640 |
In case you wonder if your downloaded file is corrupted or not, you can |
2641 |
check its MD5 checksum and compare it with the MD5 checksum we provide (such as |
2642 |
-<path>install-ppc-minimal-2005.1.iso.md5</path>). You can check the MD5 checksum |
2643 |
+<path>install-ppc-minimal-2006.0.iso.DIGESTS</path>). You can check the MD5 checksum |
2644 |
with the <c>md5sum</c> tool under Linux/Unix or |
2645 |
<uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows. If |
2646 |
<c>md5sum</c> is not available on Mac OS X, see the |
2647 |
@@ -322,15 +323,13 @@ |
2648 |
</p> |
2649 |
|
2650 |
<p> |
2651 |
-At this prompt you are able to select a kernel for the subarchitecture you use. |
2652 |
-We provide <c>G3</c>, <c>G4</c> and <c>G5</c>. All kernels are built with |
2653 |
-support for multiple CPUs, but they will boot on single processor machines as |
2654 |
-well. |
2655 |
+We provide one generic kernel, <e>ppc32</e>. This kernel is built with support |
2656 |
+for multiple CPUs, but it will boot on single processor machines as well. |
2657 |
</p> |
2658 |
|
2659 |
<p> |
2660 |
-You are also able to tweak some kernel options at this prompt. The following |
2661 |
-table lists some of the available boot options you can add: |
2662 |
+You can tweak some kernel options at this prompt. The following table lists |
2663 |
+some of the available boot options you can add: |
2664 |
</p> |
2665 |
|
2666 |
<table> |
2667 |
@@ -342,10 +341,13 @@ |
2668 |
<ti><c>video</c></ti> |
2669 |
<ti> |
2670 |
This option takes one of the following vendor-specific tags: |
2671 |
- <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>, <c>aty128</c> or |
2672 |
- <c>ofonly</c>. You can follow this tag with the resolution and refreshrate |
2673 |
- you want to use. For instance <c>video=radeonfb:1280x1024@75</c>. If you are |
2674 |
- uncertain what to choose, <c>ofonly</c> will most certainly work. |
2675 |
+ <c>nvidiafb</c>, <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>, |
2676 |
+ <c>aty128</c> or <c>ofonly</c>. You can follow this tag with the resolution |
2677 |
+ refresh rate and color depth you want to use. For instance, |
2678 |
+ <c>video=radeonfb:1280x1024@75-32</c> will select the ATI Radeon frame buffer |
2679 |
+ at a resolution of 1280x1024 with a refresh rate of 75Hz and a color depth of |
2680 |
+ 32 bits. If you are uncertain what to choose, and the default doesn't work, |
2681 |
+ <c>video=ofonly</c> will most certainly work. |
2682 |
</ti> |
2683 |
</tr> |
2684 |
<tr> |
2685 |
@@ -385,11 +387,11 @@ |
2686 |
On the Pegasos simply insert the CD and at the SmartFirmware boot-prompt type |
2687 |
<c>boot cd /boot/menu</c>. This will open a small bootmenu where you can choose |
2688 |
between several preconfigured video configs. If you need any special boot |
2689 |
-options you can append them to the command-line. For instance <c>boot cd |
2690 |
-/boot/pegasos video=radeonfb:1280x1024@75 mem=256M</c>. The complete list of |
2691 |
-kernel appends (in case something goes wrong and you need it) is preconfigured |
2692 |
-in the kernel with <c>console=ttyS0,115200 console=tty0 init=/linuxrc |
2693 |
-looptype=squashfs loop=/livecd.squashfs udev nodevfs cdroot root=/dev/ram0</c>. |
2694 |
+options you can append them to the command-line just like with Yaboot above. |
2695 |
+For example: <c>boot cd /boot/pegasos video=radeonfb:1280x1024@75 mem=256M</c>. |
2696 |
+The default kernel options (in case something goes wrong and you need it) are |
2697 |
+preconfigured with <c>console=ttyS0,115200 console=tty0 init=/linuxrc |
2698 |
+looptype=squashfs loop=/image.squashfs udev nodevfs cdroot root=/dev/ram0</c>. |
2699 |
</p> |
2700 |
|
2701 |
</body> |
2702 |
@@ -402,8 +404,7 @@ |
2703 |
<p> |
2704 |
If you have an OldWorld Mac the bootable portion of the livecd can't be used. |
2705 |
The most simple solution is to use MacOS to bootstrap into a Linux environment |
2706 |
-with a tool called BootX. Boot floppies are being prepared for Macs without |
2707 |
-MacOS, but they are not available at this time. |
2708 |
+with a tool called BootX. |
2709 |
</p> |
2710 |
|
2711 |
<p> |
2712 |
@@ -412,33 +413,34 @@ |
2713 |
archive into <c>Extensions Folder</c> and the BootX App Control Panel into |
2714 |
<c>Control Panels</c>, both of which are located in your MacOS System Folder. |
2715 |
Next, create a folder called "Linux Kernels" in your System folder and copy the |
2716 |
-<c>G3G4</c> kernel from the CD to this folder. Finally, copy <c>G3G4.igz</c> |
2717 |
+<c>ppc32</c> kernel from the CD to this folder. Finally, copy <c>ppc32.igz</c> |
2718 |
from the Installation CD <path>boot</path> folder into the MacOS |
2719 |
<c>System Folder</c>. |
2720 |
</p> |
2721 |
|
2722 |
<p> |
2723 |
To prepare BootX, start the BootX App Control Panel. First select the Options |
2724 |
-dialog and check <c>Use Specified RAM Disk</c> and select <c>G3G4.igz</c> from |
2725 |
+dialog and check <c>Use Specified RAM Disk</c> and select <c>ppc32.igz</c> from |
2726 |
your System Folder. Continue back to the initial screen and ensure that the |
2727 |
ramdisk size is at least <c>32000</c>. Finally, set the kernel arguments as |
2728 |
shown below: |
2729 |
</p> |
2730 |
|
2731 |
<pre caption="BootX kernel arguments"> |
2732 |
-cdroot root=/dev/ram0 init=linuxrc loop=livecd.squashfs looptype=squashfs console=tty0 nodevfs udev |
2733 |
+cdroot root=/dev/ram0 init=linuxrc loop=image.squashfs looptype=squashfs console=tty0 nodevfs udev |
2734 |
</pre> |
2735 |
|
2736 |
<note> |
2737 |
-The kernel parameters in the yaboot section above are also applicable here. |
2738 |
+The kernel parameters in the yaboot section above are also applicable here. You |
2739 |
+can append any of those options to the kernel arguments above. |
2740 |
</note> |
2741 |
|
2742 |
<p> |
2743 |
Check once more to make sure the settings are correct and then save the |
2744 |
configuration. This saves typing just in case it doesn't boot or something is |
2745 |
-missing. Press the Linux button at the top of the window to boot into the |
2746 |
-Installation CD and continue with <uri link="#booted">And When |
2747 |
-You're Booted...</uri> |
2748 |
+missing. Press the Linux button at the top of the window. If everything goes |
2749 |
+correctly, it should boot into the Installation CD. Continue with |
2750 |
+<uri link="#booted">And When You're Booted...</uri> |
2751 |
</p> |
2752 |
|
2753 |
</body> |
2754 |
@@ -451,8 +453,8 @@ |
2755 |
<p> |
2756 |
You will be greeted by a root ("#") prompt on the current console. You can also |
2757 |
switch to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get |
2758 |
-back to the one you started on by pressing Alt-F1. Probably you have to hit |
2759 |
-Alt-fn-Fx on Apple machines. |
2760 |
+back to the one you started on by pressing Alt-F1. Due to the keyboard layout, |
2761 |
+you may need to press Alt-fn-Fx on Apple machines. |
2762 |
</p> |
2763 |
|
2764 |
<p> |
2765 |
@@ -496,16 +498,25 @@ |
2766 |
of your system's hardware, you will have to load the appropriate kernel modules |
2767 |
manually. |
2768 |
</p> |
2769 |
- |
2770 |
+ |
2771 |
<p> |
2772 |
-In the next example we try to load the <c>airport</c> module. This module |
2773 |
-supports only the old Airport cards (b-net). AirportExtreme is currently not |
2774 |
-supported under Linux: |
2775 |
+In the next example we try to load the <c>airport</c> module. This module |
2776 |
+supports only the old Airport cards (802.11b). Airport Extreme (802.11g) is not |
2777 |
+supported on the InstallCD due to restrictions on firmware distribution. |
2778 |
</p> |
2779 |
- |
2780 |
-<pre caption="Loading kernel modules"> |
2781 |
+ |
2782 |
+<pre caption="Loading the airport module"> |
2783 |
# <i>modprobe airport</i> |
2784 |
</pre> |
2785 |
+ |
2786 |
+<p> |
2787 |
+On older iMacs, sometimes the network card is not detected properly. These use |
2788 |
+the BMAC driver: |
2789 |
+</p> |
2790 |
+ |
2791 |
+<pre caption="Loading the bmac module"> |
2792 |
+# <i>modprobe bmac</i> |
2793 |
+</pre> |
2794 |
|
2795 |
</body> |
2796 |
</subsection> |
2797 |
@@ -595,23 +606,23 @@ |
2798 |
|
2799 |
<p> |
2800 |
If you want to view the documentation on the CD you can immediately run |
2801 |
-<c>links2</c> to read it: |
2802 |
+<c>links</c> to read it: |
2803 |
</p> |
2804 |
|
2805 |
<pre caption="Viewing the on-CD documentation"> |
2806 |
-# <i>links2 /mnt/cdrom/docs/handbook/html/index.html</i> |
2807 |
+# <i>links /mnt/cdrom/docs/handbook/html/index.html</i> |
2808 |
</pre> |
2809 |
|
2810 |
<p> |
2811 |
However, it is preferred that you use the online Gentoo Handbook as it will be |
2812 |
-more recent than the one provided on the CD. You can view it using <c>links2</c> |
2813 |
+more recent than the one provided on the CD. You can view it using <c>links</c> |
2814 |
as well, but only after having completed the <e>Configuring your Network</e> |
2815 |
chapter (otherwise you won't be able to go on the Internet to view the |
2816 |
document): |
2817 |
</p> |
2818 |
|
2819 |
<pre caption="Viewing the Online Documentation"> |
2820 |
-# <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-ppc.xml</i> |
2821 |
+# <i>links http://www.gentoo.org/doc/en/handbook/handbook-ppc.xml</i> |
2822 |
</pre> |
2823 |
|
2824 |
<p> |
2825 |
|
2826 |
|
2827 |
|
2828 |
1.23 +14 -5 xml/htdocs/doc/en/handbook/hb-install-ppc64-bootloader.xml |
2829 |
|
2830 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc64-bootloader.xml?rev=1.23&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
2831 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc64-bootloader.xml?rev=1.23&content-type=text/plain&cvsroot=gentoo |
2832 |
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc64-bootloader.xml.diff?r1=1.22&r2=1.23&cvsroot=gentoo |
2833 |
|
2834 |
Index: hb-install-ppc64-bootloader.xml |
2835 |
=================================================================== |
2836 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-bootloader.xml,v |
2837 |
retrieving revision 1.22 |
2838 |
retrieving revision 1.23 |
2839 |
diff -u -r1.22 -r1.23 |
2840 |
--- hb-install-ppc64-bootloader.xml 20 Jan 2006 10:52:15 -0000 1.22 |
2841 |
+++ hb-install-ppc64-bootloader.xml 27 Feb 2006 00:55:34 -0000 1.23 |
2842 |
@@ -4,12 +4,12 @@ |
2843 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
2844 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
2845 |
|
2846 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-bootloader.xml,v 1.22 2006/01/20 10:52:15 neysx Exp $ --> |
2847 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-bootloader.xml,v 1.23 2006/02/27 00:55:34 fox2mike Exp $ --> |
2848 |
|
2849 |
<sections> |
2850 |
|
2851 |
-<version>2.7</version> |
2852 |
-<date>2006-01-20</date> |
2853 |
+<version>2.8</version> |
2854 |
+<date>2006-02-27</date> |
2855 |
|
2856 |
<section> |
2857 |
<title>Making your Choice</title> |
2858 |
@@ -39,8 +39,9 @@ |
2859 |
<body> |
2860 |
|
2861 |
<impo> |
2862 |
-You have to use yaboot-static instead of yaboot, because yaboot won't |
2863 |
-compile on PPC64. |
2864 |
+If you are using a 64-bit userland, you must use the <c>yaboot-static</c> |
2865 |
+package because yaboot cannot be compiled as a 64-bit application. The 32-bit |
2866 |
+userlands should use the regular yaboot package. |
2867 |
</impo> |
2868 |
|
2869 |
<p> |
2870 |
@@ -93,7 +94,11 @@ |
2871 |
</p> |
2872 |
|
2873 |
<pre caption = "Installing yaboot-static"> |
2874 |
+<comment>(For 64-bit users)</comment> |
2875 |
# <i>emerge --update yaboot-static</i> |
2876 |
+ |
2877 |
+<comment>(For 32-bit users)</comment> |
2878 |
+# <i>emerge yaboot</i> |
2879 |
</pre> |
2880 |
|
2881 |
<p> |
2882 |
@@ -128,7 +133,11 @@ |
2883 |
</p> |
2884 |
|
2885 |
<pre caption = "Installing yaboot"> |
2886 |
+<comment>(For 64-bit users)</comment> |
2887 |
# <i>emerge --update yaboot-static</i> |
2888 |
+ |
2889 |
+<comment>(For 32-bit users)</comment> |
2890 |
+# <i>emerge yaboot</i> |
2891 |
</pre> |
2892 |
|
2893 |
<p> |
2894 |
|
2895 |
|
2896 |
|
2897 |
1.24 +17 -8 xml/htdocs/doc/en/handbook/hb-install-ppc64-disk.xml |
2898 |
|
2899 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc64-disk.xml?rev=1.24&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
2900 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc64-disk.xml?rev=1.24&content-type=text/plain&cvsroot=gentoo |
2901 |
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc64-disk.xml.diff?r1=1.23&r2=1.24&cvsroot=gentoo |
2902 |
|
2903 |
Index: hb-install-ppc64-disk.xml |
2904 |
=================================================================== |
2905 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-disk.xml,v |
2906 |
retrieving revision 1.23 |
2907 |
retrieving revision 1.24 |
2908 |
diff -u -r1.23 -r1.24 |
2909 |
--- hb-install-ppc64-disk.xml 20 Jan 2006 10:52:15 -0000 1.23 |
2910 |
+++ hb-install-ppc64-disk.xml 27 Feb 2006 00:55:34 -0000 1.24 |
2911 |
@@ -4,12 +4,12 @@ |
2912 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
2913 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
2914 |
|
2915 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-disk.xml,v 1.23 2006/01/20 10:52:15 neysx Exp $ --> |
2916 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-disk.xml,v 1.24 2006/02/27 00:55:34 fox2mike Exp $ --> |
2917 |
|
2918 |
<sections> |
2919 |
|
2920 |
-<version>2.6</version> |
2921 |
-<date>2006-01-20</date> |
2922 |
+<version>2.7</version> |
2923 |
+<date>2006-02-27</date> |
2924 |
|
2925 |
<section> |
2926 |
<title>Introduction to Block Devices</title> |
2927 |
@@ -245,11 +245,20 @@ |
2928 |
|
2929 |
<note> |
2930 |
If you are planning to use a RAID disk array for your gentoo installation and |
2931 |
-you are using POWER5-based hardware, you should now run <c>iprutils</c> to |
2932 |
-format the disks to Advanced Function format and create the disk array. |
2933 |
+you are using POWER5-based hardware, you should now run <c>iprconfig</c> to |
2934 |
+format the disks to Advanced Function format and create the disk array. You |
2935 |
+should emerge <c>iprutils</c> after your install is complete. |
2936 |
</note> |
2937 |
|
2938 |
<p> |
2939 |
+If you have an ipr based SCSI adapter, you should start the ipr utilities now. |
2940 |
+</p> |
2941 |
+ |
2942 |
+<pre caption="Starting ipr utilities"> |
2943 |
+# <i>/etc/init.d/iprinit start</i> |
2944 |
+</pre> |
2945 |
+ |
2946 |
+<p> |
2947 |
The following parts explain how to create the example partition layout |
2948 |
described previously, namely: |
2949 |
</p> |
2950 |
@@ -562,9 +571,9 @@ |
2951 |
<body> |
2952 |
|
2953 |
<note> |
2954 |
-Several filesystems are available. Ext2 and ext3 are found stable on the |
2955 |
-PPC64 architecture, reiserfs and xfs are in experimental stage. jfs is |
2956 |
-unsupported. |
2957 |
+Several filesystems are available. ext2, ext3 and ReiserFS support is built in |
2958 |
+the Installation CD kernels. JFS and XFS support is available through kernel |
2959 |
+modules. |
2960 |
</note> |
2961 |
|
2962 |
<p> |
2963 |
|
2964 |
|
2965 |
|
2966 |
1.23 +7 -8 xml/htdocs/doc/en/handbook/hb-install-ppc64-kernel.xml |
2967 |
|
2968 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc64-kernel.xml?rev=1.23&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
2969 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc64-kernel.xml?rev=1.23&content-type=text/plain&cvsroot=gentoo |
2970 |
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc64-kernel.xml.diff?r1=1.22&r2=1.23&cvsroot=gentoo |
2971 |
|
2972 |
Index: hb-install-ppc64-kernel.xml |
2973 |
=================================================================== |
2974 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-kernel.xml,v |
2975 |
retrieving revision 1.22 |
2976 |
retrieving revision 1.23 |
2977 |
diff -u -r1.22 -r1.23 |
2978 |
--- hb-install-ppc64-kernel.xml 8 Jan 2006 14:05:29 -0000 1.22 |
2979 |
+++ hb-install-ppc64-kernel.xml 27 Feb 2006 00:55:34 -0000 1.23 |
2980 |
@@ -4,12 +4,12 @@ |
2981 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
2982 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
2983 |
|
2984 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-kernel.xml,v 1.22 2006/01/08 14:05:29 neysx Exp $ --> |
2985 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-kernel.xml,v 1.23 2006/02/27 00:55:34 fox2mike Exp $ --> |
2986 |
|
2987 |
<sections> |
2988 |
|
2989 |
-<version>2.10</version> |
2990 |
-<date>2006-01-06</date> |
2991 |
+<version>2.11</version> |
2992 |
+<date>2006-02-27</date> |
2993 |
|
2994 |
<section> |
2995 |
<title>Timezone</title> |
2996 |
@@ -107,13 +107,12 @@ |
2997 |
uses (it might provide you with a nice hint on what to enable). |
2998 |
</p> |
2999 |
|
3000 |
-<p> |
3001 |
-Now go to your kernel source directory and execute <c>make |
3002 |
-menuconfig</c>. This will fire up an ncurses-based configuration menu. |
3003 |
-</p> |
3004 |
- |
3005 |
<pre caption="Invoking menuconfig"> |
3006 |
# <i>cd /usr/src/linux</i> |
3007 |
+<comment>Important: In case you are in 32-bit userland, you must edit the top |
3008 |
+level Makefile in /usr/src/linux and change the CROSS_COMPILE option to |
3009 |
+CROSS_COMPILE ?= powerpc64-unknown-linux-gnu-. You must do this before you run |
3010 |
+make menuconfig or it may result in kernel compilation problems.</comment> |
3011 |
# <i>make menuconfig</i> |
3012 |
</pre> |
3013 |
|
3014 |
|
3015 |
|
3016 |
|
3017 |
1.29 +14 -15 xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml |
3018 |
|
3019 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml?rev=1.29&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
3020 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml?rev=1.29&content-type=text/plain&cvsroot=gentoo |
3021 |
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml.diff?r1=1.28&r2=1.29&cvsroot=gentoo |
3022 |
|
3023 |
Index: hb-install-ppc64-medium.xml |
3024 |
=================================================================== |
3025 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml,v |
3026 |
retrieving revision 1.28 |
3027 |
retrieving revision 1.29 |
3028 |
diff -u -r1.28 -r1.29 |
3029 |
--- hb-install-ppc64-medium.xml 29 Nov 2005 14:48:47 -0000 1.28 |
3030 |
+++ hb-install-ppc64-medium.xml 27 Feb 2006 00:55:34 -0000 1.29 |
3031 |
@@ -4,12 +4,12 @@ |
3032 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
3033 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
3034 |
|
3035 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml,v 1.28 2005/11/29 14:48:47 jkt Exp $ --> |
3036 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml,v 1.29 2006/02/27 00:55:34 fox2mike Exp $ --> |
3037 |
|
3038 |
<sections> |
3039 |
|
3040 |
-<version>2.10</version> |
3041 |
-<date>2005-11-29</date> |
3042 |
+<version>2.11</version> |
3043 |
+<date>2006-02-27</date> |
3044 |
|
3045 |
<section> |
3046 |
<title>Hardware Requirements</title> |
3047 |
@@ -87,7 +87,7 @@ |
3048 |
<p> |
3049 |
If you wish to install Gentoo without a working Internet connection, please use |
3050 |
the installation instructions described in the <uri |
3051 |
-link="2005.1/index.xml">Gentoo 2005.1 Handbooks</uri>. This is currently not |
3052 |
+link="2006.0/index.xml">Gentoo 2006.0 Handbooks</uri>. This is currently not |
3053 |
supported for the PPC64 architecture though. |
3054 |
</p> |
3055 |
|
3056 |
@@ -121,7 +121,7 @@ |
3057 |
|
3058 |
<p> |
3059 |
The Minimal Installation CD is called |
3060 |
-<c>install-ppc64-minimal-2005.1-r1.iso</c> and takes up only 143 MB of |
3061 |
+<c>install-ppc64-minimal-2006.0.iso</c> and takes up only 124 MB of |
3062 |
diskspace. You can use this Installation CD to install Gentoo, but always with a |
3063 |
working Internet connection only. |
3064 |
</p> |
3065 |
@@ -152,11 +152,10 @@ |
3066 |
|
3067 |
<p> |
3068 |
The Universal Installation CD is called |
3069 |
-<c>install-ppc64-universal-2005.1-r1.iso</c> and uses |
3070 |
-486 MB. You can use this Installation CD to install Gentoo, and you can |
3071 |
-even use it to install Gentoo without a working internet |
3072 |
-connection, just in case you want to bring Gentoo to another PC than the one you |
3073 |
-are currently installing Gentoo on :) |
3074 |
+<c>install-ppc64-universal-2006.0-32ul.iso</c> and uses 460 MB. You can use |
3075 |
+this Installation CD to install Gentoo, and you can even use it to install |
3076 |
+Gentoo without a working internet connection, just in case you want to bring |
3077 |
+Gentoo to another PC than the one you are currently installing Gentoo on :) |
3078 |
</p> |
3079 |
|
3080 |
<table> |
3081 |
@@ -214,7 +213,7 @@ |
3082 |
You can download any of the Installation CDs (and, if you want to, a Packages |
3083 |
CD as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The |
3084 |
Installation CDs are located in the |
3085 |
-<path>releases/ppc64/2005.1-r1/installcd</path> directory. |
3086 |
+<path>releases/ppc/2006.0/ppc64/installcd</path> directory. |
3087 |
</p> |
3088 |
|
3089 |
<p> |
3090 |
@@ -225,7 +224,7 @@ |
3091 |
<p> |
3092 |
In case you wonder if your downloaded file is corrupted or not, you can |
3093 |
check its MD5 checksum and compare it with the MD5 checksum we provide (such as |
3094 |
-<path>install-ppc64-minimal-2005.1-r1.iso.md5</path>). You can check the MD5 |
3095 |
+<path>install-ppc64-minimal-2006.0.iso.DIGESTS</path>). You can check the MD5 |
3096 |
checksum with the <c>md5sum</c> tool under Linux/Unix or <uri |
3097 |
link="http://www.etree.org/md5com.html">md5sum</uri> for Windows. |
3098 |
</p> |
3099 |
@@ -517,11 +516,11 @@ |
3100 |
|
3101 |
<p> |
3102 |
If you want to view the documentation on the CD you can immediately run |
3103 |
-<c>links2</c> to read it: |
3104 |
+<c>links</c> to read it: |
3105 |
</p> |
3106 |
|
3107 |
<pre caption="Viewing the on-CD documentation"> |
3108 |
-# <i>links2 /mnt/cdrom/docs/handbook/html/index.html</i> |
3109 |
+# <i>links /mnt/cdrom/docs/handbook/html/index.html</i> |
3110 |
</pre> |
3111 |
|
3112 |
<p> |
3113 |
@@ -530,7 +529,7 @@ |
3114 |
</p> |
3115 |
|
3116 |
<pre caption="Viewing the Online Documentation"> |
3117 |
-# <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-ppc64.xml</i> |
3118 |
+# <i>links http://www.gentoo.org/doc/en/handbook/handbook-ppc64.xml</i> |
3119 |
</pre> |
3120 |
|
3121 |
<p> |
3122 |
|
3123 |
|
3124 |
|
3125 |
1.41 +16 -15 xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml |
3126 |
|
3127 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml?rev=1.41&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
3128 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml?rev=1.41&content-type=text/plain&cvsroot=gentoo |
3129 |
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml.diff?r1=1.40&r2=1.41&cvsroot=gentoo |
3130 |
|
3131 |
Index: hb-install-sparc-medium.xml |
3132 |
=================================================================== |
3133 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml,v |
3134 |
retrieving revision 1.40 |
3135 |
retrieving revision 1.41 |
3136 |
diff -u -r1.40 -r1.41 |
3137 |
--- hb-install-sparc-medium.xml 29 Nov 2005 14:48:47 -0000 1.40 |
3138 |
+++ hb-install-sparc-medium.xml 27 Feb 2006 00:55:35 -0000 1.41 |
3139 |
@@ -4,12 +4,12 @@ |
3140 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
3141 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
3142 |
|
3143 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml,v 1.40 2005/11/29 14:48:47 jkt Exp $ --> |
3144 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml,v 1.41 2006/02/27 00:55:35 fox2mike Exp $ --> |
3145 |
|
3146 |
<sections> |
3147 |
|
3148 |
-<version>2.8</version> |
3149 |
-<date>2005-11-29</date> |
3150 |
+<version>2.9</version> |
3151 |
+<date>2006-02-27</date> |
3152 |
|
3153 |
<section> |
3154 |
<title>Hardware Requirements</title> |
3155 |
@@ -32,7 +32,8 @@ |
3156 |
<tr> |
3157 |
<th>Sparc System</th> |
3158 |
<ti> |
3159 |
- Please check the <uri |
3160 |
+ Please check the <uri link="/proj/en/base/sparc/sunhw.xml">Gentoo |
3161 |
+ Linux/SPARC64 Compatibility list</uri> or the <uri |
3162 |
link="http://www.ultralinux.org/faq.html#s_2">UltraLinux FAQ</uri> |
3163 |
</ti> |
3164 |
</tr> |
3165 |
@@ -86,7 +87,7 @@ |
3166 |
<p> |
3167 |
If you wish to install Gentoo without a working Internet connection, please use |
3168 |
the installation instructions described in the <uri |
3169 |
-link="2005.1/index.xml">Gentoo 2005.1 Handbooks</uri>. |
3170 |
+link="2006.0/index.xml">Gentoo 2006.0 Handbooks</uri>. |
3171 |
</p> |
3172 |
|
3173 |
<p> |
3174 |
@@ -126,7 +127,7 @@ |
3175 |
<body> |
3176 |
|
3177 |
<p> |
3178 |
-The Minimal Installation CD is called <c>install-sparc64-minimal-2005.1-r1.iso</c> |
3179 |
+The Minimal Installation CD is called <c>install-sparc64-minimal-2006.0.iso</c> |
3180 |
and takes up only 32 MB of diskspace. You can use this Installation CD to |
3181 |
install Gentoo, but always with a working Internet connection only. |
3182 |
</p> |
3183 |
@@ -157,7 +158,7 @@ |
3184 |
|
3185 |
<p> |
3186 |
The Universal Installation CD is called |
3187 |
-<c>install-sparc-universal-2005.1-r1.iso</c> and use 525 MB. You can use this |
3188 |
+<c>install-sparc64-universal-2006.0.iso</c> and uses 287 MB. You can use this |
3189 |
Installation CD to install Gentoo, and you can even use it to install Gentoo |
3190 |
without a working internet connection, just in case you want to bring Gentoo to |
3191 |
another PC than the one you are currently installing Gentoo on :) |
3192 |
@@ -238,7 +239,7 @@ |
3193 |
You can download any of the Installation CDs (and, if you want to, a Packages |
3194 |
CD as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The |
3195 |
Installation CDs are located in the |
3196 |
-<path>releases/sparc/2005.1-r1/sparc64/installcd</path> directory. |
3197 |
+<path>releases/sparc/2006.0/sparc64/installcd</path> directory. |
3198 |
</p> |
3199 |
|
3200 |
<p> |
3201 |
@@ -249,7 +250,7 @@ |
3202 |
<p> |
3203 |
In case you wonder if your downloaded file is corrupted or not, you can check its |
3204 |
MD5 checksum and compare it with the MD5 checksum we provide (such as |
3205 |
-<path>install-sparc64-minimal-2005.1-r1.iso.md5</path>). You can check the MD5 |
3206 |
+<path>install-sparc64-minimal-2006.0.iso.DIGESTS</path>). You can check the MD5 |
3207 |
checksum with the <c>md5sum</c> tool under Linux/Unix or <uri |
3208 |
link="http://www.etree.org/md5com.html">md5sum</uri> for Windows. |
3209 |
</p> |
3210 |
@@ -310,12 +311,12 @@ |
3211 |
|
3212 |
<p> |
3213 |
You will be greeted by the SILO boot manager (on the Installation CD). Type in |
3214 |
-<c>gentoo-2.4</c> and press enter to continue booting the |
3215 |
+<c>gentoo</c> and press enter to continue booting the |
3216 |
system: |
3217 |
</p> |
3218 |
|
3219 |
<pre caption="Continue booting from the Installation CD"> |
3220 |
-boot: <i>gentoo-2.4</i> |
3221 |
+boot: <i>gentoo</i> |
3222 |
</pre> |
3223 |
|
3224 |
<p> |
3225 |
@@ -414,23 +415,23 @@ |
3226 |
|
3227 |
<p> |
3228 |
If you want to view the documentation on the CD you can immediately run |
3229 |
-<c>links2</c> to read it: |
3230 |
+<c>links</c> to read it: |
3231 |
</p> |
3232 |
|
3233 |
<pre caption="Viewing the on-CD documentation"> |
3234 |
-# <i>links2 /mnt/cdrom/docs/handbook/html/index.html</i> |
3235 |
+# <i>links /mnt/cdrom/docs/handbook/html/index.html</i> |
3236 |
</pre> |
3237 |
|
3238 |
<p> |
3239 |
However, it is preferred that you use the online Gentoo Handbook as it will be |
3240 |
-more recent than the one provided on the CD. You can view it using <c>links2</c> |
3241 |
+more recent than the one provided on the CD. You can view it using <c>links</c> |
3242 |
as well, but only after having completed the <e>Configuring your Network</e> |
3243 |
chapter (otherwise you won't be able to go on the Internet to view the |
3244 |
document): |
3245 |
</p> |
3246 |
|
3247 |
<pre caption="Viewing the Online Documentation"> |
3248 |
-# <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-sparc.xml</i> |
3249 |
+# <i>links http://www.gentoo.org/doc/en/handbook/handbook-sparc.xml</i> |
3250 |
</pre> |
3251 |
|
3252 |
<p> |
3253 |
|
3254 |
|
3255 |
|
3256 |
1.94 +21 -22 xml/htdocs/doc/en/handbook/hb-install-stage.xml |
3257 |
|
3258 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-stage.xml?rev=1.94&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
3259 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-stage.xml?rev=1.94&content-type=text/plain&cvsroot=gentoo |
3260 |
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-stage.xml.diff?r1=1.93&r2=1.94&cvsroot=gentoo |
3261 |
|
3262 |
Index: hb-install-stage.xml |
3263 |
=================================================================== |
3264 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v |
3265 |
retrieving revision 1.93 |
3266 |
retrieving revision 1.94 |
3267 |
diff -u -r1.93 -r1.94 |
3268 |
--- hb-install-stage.xml 15 Feb 2006 13:05:58 -0000 1.93 |
3269 |
+++ hb-install-stage.xml 27 Feb 2006 00:55:35 -0000 1.94 |
3270 |
@@ -4,12 +4,12 @@ |
3271 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
3272 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
3273 |
|
3274 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v 1.93 2006/02/15 13:05:58 rane Exp $ --> |
3275 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v 1.94 2006/02/27 00:55:35 fox2mike Exp $ --> |
3276 |
|
3277 |
<sections> |
3278 |
|
3279 |
-<version>2.7</version> |
3280 |
-<date>2005-11-24</date> |
3281 |
+<version>2.8</version> |
3282 |
+<date>2006-02-27</date> |
3283 |
|
3284 |
<section> |
3285 |
<title>Installing a Stage Tarball</title> |
3286 |
@@ -86,13 +86,13 @@ |
3287 |
|
3288 |
<p> |
3289 |
Depending on your installation medium, you have a couple of tools available to |
3290 |
-download a stage. If you have <c>links2</c> available, then you can immediately |
3291 |
+download a stage. If you have <c>links</c> available, then you can immediately |
3292 |
surf to <uri link="/main/en/mirrors.xml">the Gentoo mirrorlist</uri> and |
3293 |
choose a mirror close to you. |
3294 |
</p> |
3295 |
|
3296 |
<p> |
3297 |
-If you don't have <c>links2</c> available you should have <c>lynx</c> at your |
3298 |
+If you don't have <c>links</c> available you should have <c>lynx</c> at your |
3299 |
disposal. If you need to go through a proxy, export the <c>http_proxy</c> and |
3300 |
<c>ftp_proxy</c> variables: |
3301 |
</p> |
3302 |
@@ -103,24 +103,23 @@ |
3303 |
</pre> |
3304 |
|
3305 |
<p> |
3306 |
-We will now assume that you have <c>links2</c> at your disposal. |
3307 |
+We will now assume that you have <c>links</c> at your disposal. |
3308 |
</p> |
3309 |
|
3310 |
<p> |
3311 |
Pick the <path>releases/</path> directory, followed by your architecture (for |
3312 |
-instance <path>x86/</path>) and the Gentoo version (<path>2005.1/</path> or |
3313 |
-<path>2005.1-r1/</path> if available) to finish up with the |
3314 |
-<path>stages/</path> directory. There you should see all available stage files |
3315 |
-for your architecture (they might be stored within subdirectories named to the |
3316 |
-individual subarchitectures). Select one and press <c>D</c> to download. When |
3317 |
-you're finished, press <c>Q</c> to quit the browser. |
3318 |
+instance <path>x86/</path>) and the Gentoo version (<path>2006.0/</path>) to |
3319 |
+finish up with the <path>stages/</path> directory. There you should see all |
3320 |
+available stage files for your architecture (they might be stored within |
3321 |
+subdirectories named to the individual subarchitectures). Select one and press |
3322 |
+<c>D</c> to download. When you're finished, press <c>Q</c> to quit the browser. |
3323 |
</p> |
3324 |
|
3325 |
-<pre caption="Surfing to the mirror listing with links2"> |
3326 |
-# <i>links2 http://www.gentoo.org/main/en/mirrors.xml</i> |
3327 |
+<pre caption="Surfing to the mirror listing with links"> |
3328 |
+# <i>links http://www.gentoo.org/main/en/mirrors.xml</i> |
3329 |
|
3330 |
-<comment>(If you need proxy support with links2:)</comment> |
3331 |
-# <i>links2 -http-proxy proxy.server.com:8080 http://www.gentoo.org/main/en/mirrors.xml</i> |
3332 |
+<comment>(If you need proxy support with links:)</comment> |
3333 |
+# <i>links -http-proxy proxy.server.com:8080 http://www.gentoo.org/main/en/mirrors.xml</i> |
3334 |
</pre> |
3335 |
|
3336 |
<p> |
3337 |
@@ -135,8 +134,8 @@ |
3338 |
</p> |
3339 |
|
3340 |
<pre caption="Example checking integrity of a stage tarball"> |
3341 |
-# <i>md5sum -c stage3-x86-2005.1-r1.tar.bz2.md5</i> |
3342 |
-stage3-x86-2005.1-r1.tar.bz2: OK |
3343 |
+# <i>md5sum -c stage3-x86-2006.0.tar.bz2.DIGESTS</i> |
3344 |
+stage3-x86-2006.0.tar.bz2: OK |
3345 |
</pre> |
3346 |
|
3347 |
</body> |
3348 |
@@ -215,12 +214,12 @@ |
3349 |
<c>tar</c>. Make sure you use the same options (<c>xvjpf</c>). The <c>v</c> |
3350 |
argument is optional and not supported in some <c>tar</c> versions. In the |
3351 |
next example, we extract the stage tarball |
3352 |
-<path>stage3-<subarch>-2005.1-r1.tar.bz2</path>. Be sure to substitute |
3353 |
+<path>stage3-<subarch>-2006.0.tar.bz2</path>. Be sure to substitute |
3354 |
the tarball filename with your stage. |
3355 |
</p> |
3356 |
|
3357 |
<pre caption="Extracting the stage tarball"> |
3358 |
-# <i>tar xvjpf /mnt/cdrom/stages/stage3-<subarch>-2005.1-r1.tar.bz2</i> |
3359 |
+# <i>tar xvjpf /mnt/cdrom/stages/stage3-<subarch>-2006.0.tar.bz2</i> |
3360 |
</pre> |
3361 |
|
3362 |
<p> |
3363 |
@@ -258,14 +257,14 @@ |
3364 |
</pre> |
3365 |
|
3366 |
<p> |
3367 |
-Fire up <c>links2</c> (or <c>lynx</c>) and go to our <uri |
3368 |
+Fire up <c>links</c> (or <c>lynx</c>) and go to our <uri |
3369 |
link="/main/en/mirrors.xml">Gentoo mirror list</uri>. Pick a mirror close to |
3370 |
you and open the <path>snapshots/</path> directory. There, download the latest |
3371 |
Portage snapshot by selecting it and pressing <c>D</c>. |
3372 |
</p> |
3373 |
|
3374 |
<pre caption="Browsing the Gentoo mirrorlist"> |
3375 |
-# <i>links2 http://www.gentoo.org/main/en/mirrors.xml</i> |
3376 |
+# <i>links http://www.gentoo.org/main/en/mirrors.xml</i> |
3377 |
</pre> |
3378 |
|
3379 |
<p> |
3380 |
|
3381 |
|
3382 |
|
3383 |
1.90 +20 -20 xml/htdocs/doc/en/handbook/hb-install-system.xml |
3384 |
|
3385 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-system.xml?rev=1.90&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
3386 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-system.xml?rev=1.90&content-type=text/plain&cvsroot=gentoo |
3387 |
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-system.xml.diff?r1=1.89&r2=1.90&cvsroot=gentoo |
3388 |
|
3389 |
Index: hb-install-system.xml |
3390 |
=================================================================== |
3391 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml,v |
3392 |
retrieving revision 1.89 |
3393 |
retrieving revision 1.90 |
3394 |
diff -u -r1.89 -r1.90 |
3395 |
--- hb-install-system.xml 22 Feb 2006 10:17:44 -0000 1.89 |
3396 |
+++ hb-install-system.xml 27 Feb 2006 00:55:35 -0000 1.90 |
3397 |
@@ -4,12 +4,12 @@ |
3398 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
3399 |
<!-- See http://creativecommons.org/licenses/by-sa/1.0 --> |
3400 |
|
3401 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml,v 1.89 2006/02/22 10:17:44 neysx Exp $ --> |
3402 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml,v 1.90 2006/02/27 00:55:35 fox2mike Exp $ --> |
3403 |
|
3404 |
<sections> |
3405 |
|
3406 |
-<version>2.16</version> |
3407 |
-<date>2006-02-22</date> |
3408 |
+<version>2.17</version> |
3409 |
+<date>2006-02-27</date> |
3410 |
|
3411 |
<section> |
3412 |
<title>Chrooting</title> |
3413 |
@@ -113,7 +113,7 @@ |
3414 |
<pre caption = "Chrooting into the new environment"> |
3415 |
# <i>chroot /mnt/gentoo /bin/bash</i> |
3416 |
# <i>env-update</i> |
3417 |
->>> Regenerating /etc/ld.so.cache... |
3418 |
+ * Caching service dependencies... |
3419 |
# <i>source /etc/profile</i> |
3420 |
# <i>export PS1="(chroot) $PS1"</i> |
3421 |
</pre> |
3422 |
@@ -189,7 +189,7 @@ |
3423 |
|
3424 |
<pre caption="Verifying system profile"> |
3425 |
# <i>ls -FGg /etc/make.profile</i> |
3426 |
-lrwxrwxrwx 1 48 Apr 8 18:51 /etc/make.profile -> ../usr/portage/profiles/default-linux/x86/2005.1/ |
3427 |
+lrwxrwxrwx 1 48 Apr 8 18:51 /etc/make.profile -> ../usr/portage/profiles/default-linux/x86/2006.0/ |
3428 |
</pre> |
3429 |
|
3430 |
<p> |
3431 |
@@ -227,42 +227,42 @@ |
3432 |
</pre> |
3433 |
|
3434 |
<p> |
3435 |
-For ppc, there are a number of new profiles provided with 2005.1. |
3436 |
+For ppc, there are a number of new profiles provided with 2006.0 |
3437 |
</p> |
3438 |
|
3439 |
<pre caption="PPC Profiles"> |
3440 |
<comment>(Generic PPC profile, for all PPC machines)</comment> |
3441 |
-# <i>ln -snf /usr/portage/profiles/default-linux/ppc/2005.1/ppc /etc/make.profile</i> |
3442 |
+# <i>ln -snf /usr/portage/profiles/default-linux/ppc/2006.0/ppc32 /etc/make.profile</i> |
3443 |
<comment>(G3 profile)</comment> |
3444 |
-# <i>ln -snf /usr/portage/profiles/default-linux/ppc/2005.1/ppc/G3 /etc/make.profile</i> |
3445 |
+# <i>ln -snf /usr/portage/profiles/default-linux/ppc/2006.0/ppc32/G3 /etc/make.profile</i> |
3446 |
<comment>(G3 Pegasos profile)</comment> |
3447 |
-# <i>ln -snf /usr/portage/profiles/default-linux/ppc/2005.1/ppc/G3/Pegasos/ /etc/make.profile</i> |
3448 |
+# <i>ln -snf /usr/portage/profiles/default-linux/ppc/2006.0/ppc32/G3/Pegasos/ /etc/make.profile</i> |
3449 |
<comment>(G4 (Altivec) profile)</comment> |
3450 |
-# <i>ln -snf /usr/portage/profiles/default-linux/ppc/2005.1/ppc/G4 /etc/make.profile</i> |
3451 |
-<comment>(G4 Pegasos profile)</comment> |
3452 |
-# <i>ln -snf /usr/portage/profiles/default-linux/ppc/2005.1/ppc/G4/Pegasos/ /etc/make.profile</i> |
3453 |
+# <i>ln -snf /usr/portage/profiles/default-linux/ppc/2006.0/ppc32/G4 /etc/make.profile</i> |
3454 |
+<comment>(G4 (Altivec) Pegasos profile)</comment> |
3455 |
+# <i>ln -snf /usr/portage/profiles/default-linux/ppc/2006.0/ppc32/G4/Pegasos/ /etc/make.profile</i> |
3456 |
</pre> |
3457 |
|
3458 |
<p> |
3459 |
-For ppc64, there are a number of new profiles provided with 2005.1. |
3460 |
+For ppc64, there are a number of new profiles provided with 2006.0. |
3461 |
</p> |
3462 |
|
3463 |
<pre caption="PPC64 Profiles"> |
3464 |
<comment>(Generic 64bit userland PPC64 profile, for all PPC64 machines)</comment> |
3465 |
-# <i>ln -snf /usr/portage/profiles/default-linux/ppc/2005.1/ppc64/64bit-userland /etc/make.profile</i> |
3466 |
+# <i>ln -snf /usr/portage/profiles/default-linux/ppc/2006.0/ppc64/64bit-userland /etc/make.profile</i> |
3467 |
<comment>(Generic 32bit userland PPC64 profile, for all PPC64 machines)</comment> |
3468 |
-# <i>ln -snf /usr/portage/profiles/default-linux/ppc/2005.1/ppc64/32bit-userland /etc/make.profile</i> |
3469 |
+# <i>ln -snf /usr/portage/profiles/default-linux/ppc/2006.0/ppc64/32bit-userland /etc/make.profile</i> |
3470 |
<comment>(Each type of userland has sub profiles as follows, with (userland) replaced with the chosen userland from above)</comment> |
3471 |
<comment>(970 profile for JS20)</comment> |
3472 |
-# <i>ln -snf /usr/portage/profiles/default-linux/ppc/2005.1/ppc64/(userland)/970 /etc/make.profile</i> |
3473 |
+# <i>ln -snf /usr/portage/profiles/default-linux/ppc/2006.0/ppc64/(userland)/970 /etc/make.profile</i> |
3474 |
<comment>(G5 profile)</comment> |
3475 |
-# <i>ln -snf /usr/portage/profiles/default-linux/ppc/2005.1/ppc64/(userland)/970/pmac /etc/make.profile</i> |
3476 |
+# <i>ln -snf /usr/portage/profiles/default-linux/ppc/2006.0/ppc64/(userland)/970/pmac /etc/make.profile</i> |
3477 |
<comment>(POWER3 profile)</comment> |
3478 |
-# <i>ln -snf /usr/portage/profiles/default-linux/ppc/2005.1/ppc64/(userland)/power3 /etc/make.profile</i> |
3479 |
+# <i>ln -snf /usr/portage/profiles/default-linux/ppc/2006.0/ppc64/(userland)/power3 /etc/make.profile</i> |
3480 |
<comment>(POWER4 profile)</comment> |
3481 |
-# <i>ln -snf /usr/portage/profiles/default-linux/ppc/2005.1/ppc64/(userland)/power4 /etc/make.profile</i> |
3482 |
+# <i>ln -snf /usr/portage/profiles/default-linux/ppc/2006.0/ppc64/(userland)/power4 /etc/make.profile</i> |
3483 |
<comment>(POWER5 profile)</comment> |
3484 |
-# <i>ln -snf /usr/portage/profiles/default-linux/ppc/2005.1/ppc64/(userland)/power5 /etc/make.profile</i> |
3485 |
+# <i>ln -snf /usr/portage/profiles/default-linux/ppc/2006.0/ppc64/(userland)/power5 /etc/make.profile</i> |
3486 |
<comment>(The multilib profile is not stable as of this release.)</comment> |
3487 |
</pre> |
3488 |
|
3489 |
|
3490 |
|
3491 |
|
3492 |
1.45 +30 -21 xml/htdocs/doc/en/handbook/hb-install-x86-medium.xml |
3493 |
|
3494 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-x86-medium.xml?rev=1.45&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
3495 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-x86-medium.xml?rev=1.45&content-type=text/plain&cvsroot=gentoo |
3496 |
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-x86-medium.xml.diff?r1=1.44&r2=1.45&cvsroot=gentoo |
3497 |
|
3498 |
Index: hb-install-x86-medium.xml |
3499 |
=================================================================== |
3500 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86-medium.xml,v |
3501 |
retrieving revision 1.44 |
3502 |
retrieving revision 1.45 |
3503 |
diff -u -r1.44 -r1.45 |
3504 |
--- hb-install-x86-medium.xml 29 Nov 2005 14:48:47 -0000 1.44 |
3505 |
+++ hb-install-x86-medium.xml 27 Feb 2006 00:55:35 -0000 1.45 |
3506 |
@@ -4,7 +4,7 @@ |
3507 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
3508 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
3509 |
|
3510 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86-medium.xml,v 1.44 2005/11/29 14:48:47 jkt Exp $ --> |
3511 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86-medium.xml,v 1.45 2006/02/27 00:55:35 fox2mike Exp $ --> |
3512 |
|
3513 |
<sections> |
3514 |
|
3515 |
@@ -73,11 +73,12 @@ |
3516 |
latest version of the available packages. |
3517 |
</p> |
3518 |
|
3519 |
-<p> |
3520 |
-If you wish to install Gentoo without a working Internet connection, please use |
3521 |
-the installation instructions described in the <uri |
3522 |
-link="2005.1/index.xml">Gentoo 2005.1 Handbooks</uri>. |
3523 |
-</p> |
3524 |
+<impo> |
3525 |
+If you wish to install Gentoo without a working Internet connection or would |
3526 |
+like to use one of the provided installers, please use the installation |
3527 |
+instructions described in the <uri link="2006.0/index.xml">Gentoo 2006.0 |
3528 |
+Handbooks</uri>. |
3529 |
+</impo> |
3530 |
|
3531 |
<p> |
3532 |
The two Installation CDs that we currently provide are: |
3533 |
@@ -90,9 +91,10 @@ |
3534 |
continue with the Gentoo installation. |
3535 |
</li> |
3536 |
<li> |
3537 |
- The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same |
3538 |
- abilities as the Minimal Installation CD. Additionally, it contains |
3539 |
- several stage3 tarballs (optimized for the individual subarchitectures). |
3540 |
+ The Gentoo <e>Installer LiveCD</e> contains everything you need to install |
3541 |
+ Gentoo. It provides a graphical environment, a graphical as well as console |
3542 |
+ based installer which automatically carries out the installation for you, |
3543 |
+ and of course, the installation instructions for your architecture. |
3544 |
</li> |
3545 |
</ul> |
3546 |
|
3547 |
@@ -108,8 +110,8 @@ |
3548 |
<body> |
3549 |
|
3550 |
<p> |
3551 |
-The Minimal Installation CD is called <c>install-x86-minimal-2005.1-r1.iso</c> |
3552 |
-and takes up only 58 MB of diskspace. You can use this Installation CD to |
3553 |
+The Minimal Installation CD is called <c>install-x86-minimal-2006.0.iso</c> |
3554 |
+and takes up only 49 MB of diskspace. You can use this Installation CD to |
3555 |
install Gentoo, but always with a working Internet connection only. |
3556 |
</p> |
3557 |
|
3558 |
@@ -134,12 +136,12 @@ |
3559 |
</body> |
3560 |
</subsection> |
3561 |
<subsection> |
3562 |
-<title>Gentoo's Universal Installation CD</title> |
3563 |
+<title>Gentoo's Installer LiveCD</title> |
3564 |
<body> |
3565 |
|
3566 |
<p> |
3567 |
-The Universal Installation CD is called |
3568 |
-<c>install-x86-universal-2005.1-r1.iso</c> and takes up 398 MB. You can use |
3569 |
+The Installer LiveCD is called |
3570 |
+<c>livecd-i686-installer-2006.0.iso</c> and takes up 697 MB. You can use |
3571 |
this Installation CD to install Gentoo, and you can even use it to install |
3572 |
Gentoo without a working internet connection, just in case you want to bring |
3573 |
Gentoo to another PC than the one you are currently installing Gentoo on :) |
3574 |
@@ -165,6 +167,7 @@ |
3575 |
|
3576 |
</body> |
3577 |
</subsection> |
3578 |
+<!-- PackageCDs on x86 are outdated |
3579 |
<subsection> |
3580 |
<title>Other CDs</title> |
3581 |
<body> |
3582 |
@@ -184,7 +187,7 @@ |
3583 |
</p> |
3584 |
|
3585 |
</body> |
3586 |
-</subsection> |
3587 |
+</subsection>--> |
3588 |
<subsection> |
3589 |
<title>The Stage3 Tarball</title> |
3590 |
<body> |
3591 |
@@ -200,6 +203,12 @@ |
3592 |
Using a Stage1 or Stage2 Tarball?</uri> |
3593 |
</p> |
3594 |
|
3595 |
+<p> |
3596 |
+Stage3 tarballs can be downloaded from <path>releases/x86/2006.0/stages/</path> |
3597 |
+on any of the <uri link="/main/en/mirrors.xml">Official Gentoo Mirrors</uri> |
3598 |
+and are not provided on the LiveCD. |
3599 |
+</p> |
3600 |
+ |
3601 |
</body> |
3602 |
</subsection> |
3603 |
</section> |
3604 |
@@ -219,7 +228,7 @@ |
3605 |
<p> |
3606 |
You can download any of the Installation CDs (and, if you want to, a Packages |
3607 |
CD as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The |
3608 |
-Installation CDs are located in the <path>releases/x86/2005.1-r1/installcd</path> |
3609 |
+Installation CDs are located in the <path>releases/x86/2006.0/installcd</path> |
3610 |
directory. |
3611 |
</p> |
3612 |
|
3613 |
@@ -231,7 +240,7 @@ |
3614 |
<p> |
3615 |
In case you wonder if your downloaded file is corrupted or not, you can check |
3616 |
its MD5 checksum and compare it with the MD5 checksum we provide (such as |
3617 |
-<path>install-x86-minimal-2005.1-r1.iso.md5</path>). You can check the MD5 |
3618 |
+<path>install-x86-minimal-2006.0.iso.DIGESTS</path>). You can check the MD5 |
3619 |
checksum with the <c>md5sum</c> tool under Linux/Unix or <uri |
3620 |
link="http://www.etree.org/md5com.html">md5sum</uri> for Windows. |
3621 |
</p> |
3622 |
@@ -507,23 +516,23 @@ |
3623 |
|
3624 |
<p> |
3625 |
If you want to view the documentation on the CD you can immediately run |
3626 |
-<c>links2</c> to read it: |
3627 |
+<c>links</c> to read it: |
3628 |
</p> |
3629 |
|
3630 |
<pre caption="Viewing the on-CD documentation"> |
3631 |
-# <i>links2 /mnt/cdrom/docs/html/index.html</i> |
3632 |
+# <i>links /mnt/cdrom/docs/html/index.html</i> |
3633 |
</pre> |
3634 |
|
3635 |
<p> |
3636 |
However, it is preferred that you use the online Gentoo Handbook as it will be |
3637 |
-more recent than the one provided on the CD. You can view it using <c>links2</c> |
3638 |
+more recent than the one provided on the CD. You can view it using <c>links</c> |
3639 |
as well, but only after having completed the <e>Configuring your Network</e> |
3640 |
chapter (otherwise you won't be able to go on the Internet to view the |
3641 |
document): |
3642 |
</p> |
3643 |
|
3644 |
<pre caption="Viewing the Online Documentation"> |
3645 |
-# <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-x86.xml</i> |
3646 |
+# <i>links http://www.gentoo.org/doc/en/handbook/handbook-x86.xml</i> |
3647 |
</pre> |
3648 |
|
3649 |
<p> |
3650 |
|
3651 |
|
3652 |
|
3653 |
1.59 +6 -6 xml/htdocs/doc/en/handbook/index.xml |
3654 |
|
3655 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/index.xml?rev=1.59&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
3656 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/index.xml?rev=1.59&content-type=text/plain&cvsroot=gentoo |
3657 |
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/index.xml.diff?r1=1.58&r2=1.59&cvsroot=gentoo |
3658 |
|
3659 |
Index: index.xml |
3660 |
=================================================================== |
3661 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/index.xml,v |
3662 |
retrieving revision 1.58 |
3663 |
retrieving revision 1.59 |
3664 |
diff -u -r1.58 -r1.59 |
3665 |
--- index.xml 12 Jan 2006 13:30:17 -0000 1.58 |
3666 |
+++ index.xml 27 Feb 2006 00:55:35 -0000 1.59 |
3667 |
@@ -1,7 +1,7 @@ |
3668 |
<?xml version='1.0' encoding="UTF-8"?> |
3669 |
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
3670 |
|
3671 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/index.xml,v 1.58 2006/01/12 13:30:17 neysx Exp $ --> |
3672 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/index.xml,v 1.59 2006/02/27 00:55:35 fox2mike Exp $ --> |
3673 |
|
3674 |
<guide link="index.xml"> |
3675 |
<title>Gentoo Handbook</title> |
3676 |
@@ -19,8 +19,8 @@ |
3677 |
|
3678 |
<license/> |
3679 |
|
3680 |
-<version>0.33</version> |
3681 |
-<date>2006-01-12</date> |
3682 |
+<version>0.34</version> |
3683 |
+<date>2006-02-27</date> |
3684 |
|
3685 |
<chapter> |
3686 |
<title>The Gentoo Handbook Effort</title> |
3687 |
@@ -121,8 +121,8 @@ |
3688 |
</tr> |
3689 |
<tr> |
3690 |
<ti>HTML</ti> |
3691 |
- <ti>2005.1 Specific Networkless Installation Instructions</ti> |
3692 |
- <ti><uri link="2005.1/index.xml">2005.1 Gentoo Handbooks</uri></ti> |
3693 |
+ <ti>2006.0 Specific Networkless Installation Instructions</ti> |
3694 |
+ <ti><uri link="2006.0/index.xml">2006.0 Gentoo Handbooks</uri></ti> |
3695 |
</tr> |
3696 |
</table> |
3697 |
|
3698 |
@@ -130,7 +130,7 @@ |
3699 |
We also have release-specific handbooks which include the installation |
3700 |
instructions for networkless installations using the released CDs. If you are |
3701 |
interested in performing a networkless installation, please consult the <uri |
3702 |
-link="2005.1/index.xml">Gentoo Linux 2005.1 Handbook</uri> for your |
3703 |
+link="2006.0/index.xml">Gentoo Linux 2006.0 Handbook</uri> for your |
3704 |
architecture. |
3705 |
</p> |
3706 |
|
3707 |
|
3708 |
|
3709 |
|
3710 |
1.1 xml/htdocs/doc/en/handbook/hb-install-mips-stage.xml |
3711 |
|
3712 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-mips-stage.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
3713 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-mips-stage.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo |
3714 |
|
3715 |
Index: hb-install-mips-stage.xml |
3716 |
=================================================================== |
3717 |
<?xml version='1.0' encoding='UTF-8'?> |
3718 |
<!DOCTYPE sections SYSTEM "/dtd/book.dtd"> |
3719 |
|
3720 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
3721 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
3722 |
|
3723 |
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-stage.xml,v 1.1 2006/02/27 00:55:34 fox2mike Exp $ --> |
3724 |
|
3725 |
<sections> |
3726 |
|
3727 |
<version>1.0</version> |
3728 |
<date>2006-02-27</date> |
3729 |
|
3730 |
<section> |
3731 |
<title>Installing a Stage Tarball</title> |
3732 |
<subsection> |
3733 |
<title>Setting the Date/Time Right</title> |
3734 |
<body> |
3735 |
|
3736 |
<p> |
3737 |
Before you continue you need to check your date/time and update it. A |
3738 |
misconfigured clock may lead to strange results in the future! |
3739 |
</p> |
3740 |
|
3741 |
<p> |
3742 |
To verify the current date/time, run <c>date</c>: |
3743 |
</p> |
3744 |
|
3745 |
<pre caption="Verifying the date/time"> |
3746 |
# <i>date</i> |
3747 |
Fri Mar 29 16:21:18 CEST 2005 |
3748 |
</pre> |
3749 |
|
3750 |
<p> |
3751 |
If the date/time displayed is wrong, update it using the <c>date |
3752 |
MMDDhhmmYYYY</c> syntax (<b>M</b>onth, <b>D</b>ay, <b>h</b>our, <b>m</b>inute |
3753 |
and <b>Y</b>ear). For instance, to set the date to March 29th, 16:21 in the |
3754 |
year 2005: |
3755 |
</p> |
3756 |
|
3757 |
<pre caption="Setting the date/time"> |
3758 |
# <i>date 032916212005</i> |
3759 |
</pre> |
3760 |
|
3761 |
</body> |
3762 |
</subsection> |
3763 |
<subsection> |
3764 |
<title>Making your Choice</title> |
3765 |
<body> |
3766 |
|
3767 |
<p> |
3768 |
The next step you need to perform is to install the <e>stage</e> tarball of |
3769 |
your choice onto your system. |
3770 |
<!--You have the option of downloading the required |
3771 |
tarball from the Internet or, if you are booted from one of the Gentoo |
3772 |
Universal Installation CDs, copy it over from the CD itself. If you have a |
3773 |
Universal CD and the stage you want to use is on the CD, downloading it from |
3774 |
the Internet is just a waste of bandwidth as the stage files are the same. In |
3775 |
most cases, the command <c>uname -m</c> can be used to help you decide which |
3776 |
stage file to download. --> |
3777 |
</p> |
3778 |
|
3779 |
<!-- |
3780 |
<ul> |
3781 |
<li><uri link="#doc_chap2">Default: Using a Stage from the Internet</uri></li> |
3782 |
<li> |
3783 |
<uri link="#doc_chap3">Alternative: Using a Stage from the Installation CD</uri> |
3784 |
</li> |
3785 |
</ul>--> |
3786 |
|
3787 |
</body> |
3788 |
</subsection> |
3789 |
</section> |
3790 |
<section> |
3791 |
<title>Using a Stage from the Internet</title> |
3792 |
<subsection> |
3793 |
<title>Downloading the Stage Tarball</title> |
3794 |
<body> |
3795 |
|
3796 |
<p> |
3797 |
Go to the Gentoo mountpoint at which you mounted your filesystems |
3798 |
(most likely <path>/gentoo</path>): |
3799 |
</p> |
3800 |
|
3801 |
<pre caption="Going to the Gentoo mountpoint"> |
3802 |
# <i>cd /gentoo</i> |
3803 |
</pre> |
3804 |
|
3805 |
<p> |
3806 |
The table below specifies exactly which stages you need for your system. |
3807 |
Stages may be downloaded |
3808 |
off the <uri link="/main/en/mirrors.xml">official Gentoo mirrors</uri> under the |
3809 |
<c>releases/mips/current</c> directory. |
3810 |
</p> |
3811 |
|
3812 |
<table> |
3813 |
<tr> |
3814 |
<th>Endianness</th> |
3815 |
<th>CPU</th> |
3816 |
<th>Location</th> |
3817 |
</tr> |
3818 |
<tr> |
3819 |
<ti> |
3820 |
Big Endian<br /> |
3821 |
<e>(SGI Users)</e> |
3822 |
</ti> |
3823 |
<ti> |
3824 |
R4000<br /> |
3825 |
R4400<br /> |
3826 |
R4600 |
3827 |
</ti> |
3828 |
<ti><c>mips3/stage#-mips3-RELEASE.tar.bz2</c></ti> |
3829 |
</tr> |
3830 |
<tr> |
3831 |
<ti> |
3832 |
Big Endian<br /> |
3833 |
<e>(SGI Users)</e> |
3834 |
</ti> |
3835 |
<ti> |
3836 |
R5000<br /> |
3837 |
RM5200<br /> |
3838 |
RM7000<br /> |
3839 |
R10000<br /> |
3840 |
R12000<br /> |
3841 |
R14000 |
3842 |
</ti> |
3843 |
<ti><c>mips4/stage#-mips4-RELEASE.tar.bz2</c></ti> |
3844 |
</tr> |
3845 |
<tr> |
3846 |
<ti> |
3847 |
Little Endian<br /> |
3848 |
<e>(Cobalt Users)</e> |
3849 |
</ti> |
3850 |
<ti> |
3851 |
RM5230<br /> |
3852 |
RM5231 |
3853 |
</ti> |
3854 |
<ti><c>cobalt/stage#-mipsel4-RELEASE.tar.bz2</c></ti> |
3855 |
</tr> |
3856 |
</table> |
3857 |
|
3858 |
<p> |
3859 |
If you need to go through a proxy, export the <c>http_proxy</c> and |
3860 |
<c>ftp_proxy</c> variables: |
3861 |
</p> |
3862 |
|
3863 |
<pre caption="Setting proxy information for wget"> |
3864 |
# <i>export http_proxy="http://proxy.server.com:port"</i> |
3865 |
# <i>export ftp_proxy="http://proxy.server.com:port"</i> |
3866 |
</pre> |
3867 |
|
3868 |
<p> |
3869 |
The Gentoo/MIPS netboot images provide <c>wget</c> as a means of downloading |
3870 |
files. Due to space constraints, it is not possible to provide more capable |
3871 |
browsers on SGI netboot images. LiveCD users may use <c>elinks</c>. |
3872 |
</p> |
3873 |
|
3874 |
<pre caption="Fetching the tarball via wget"> |
3875 |
# <i>wget -c http://distfiles.gentoo.org/releases/mips/mips4/stage3-mips4-2006.0.tar.bz2</i> |
3876 |
</pre> |
3877 |
|
3878 |
<p> |
3879 |
If you want to check the integrity of the downloaded stage tarball, use |
3880 |
<c>md5sum</c> and compare the output with the MD5 checksum provided on the |
3881 |
mirror. For instance, to check the validity of the mips4 stage tarball: |
3882 |
</p> |
3883 |
|
3884 |
<pre caption="Example checking integrity of a stage tarball"> |
3885 |
# <i>md5sum -c stage3-mips4-2006.0.tar.bz2.md5</i> |
3886 |
stage3-mips4-2006.0.tar.bz2: OK |
3887 |
</pre> |
3888 |
|
3889 |
</body> |
3890 |
</subsection> |
3891 |
<subsection> |
3892 |
<title>Unpacking the Stage Tarball</title> |
3893 |
<body> |
3894 |
|
3895 |
<p> |
3896 |
Now unpack your downloaded stage onto your system. We use GNU's <c>tar</c> to |
3897 |
proceed as it is the easiest method: |
3898 |
</p> |
3899 |
|
3900 |
<pre caption="Unpacking the stage"> |
3901 |
# <i>tar -xjpf stage?-*.tar.bz2</i> |
3902 |
</pre> |
3903 |
|
3904 |
<p> |
3905 |
Make sure that you use the same options (<c>-xjpf</c>). The <c>x</c> stands for |
3906 |
<e>Extract</e>, the <c>j</c> for <e>Decompress with bzip2</e>, the <c>p</c> for |
3907 |
<e>Preserve permissions</e> and the <c>f</c> to denote that we want to extract |
3908 |
a file, not standard input. |
3909 |
</p> |
3910 |
|
3911 |
<p> |
3912 |
Now that the stage is installed, continue with <uri |
3913 |
link="#installing_portage">Installing Portage</uri>. |
3914 |
</p> |
3915 |
|
3916 |
</body> |
3917 |
</subsection> |
3918 |
</section> |
3919 |
<!-- |
3920 |
<section> |
3921 |
<title>Alternative: Using a Stage from the Installation CD</title> |
3922 |
<subsection> |
3923 |
<title>Extracting the Stage Tarball</title> |
3924 |
<body> |
3925 |
|
3926 |
<p> |
3927 |
The stages on the CD reside in the <path>/mnt/cdrom/stages</path> directory. To |
3928 |
see a listing of available stages, use <c>ls</c>: |
3929 |
</p> |
3930 |
|
3931 |
<pre caption="List all available stages"> |
3932 |
# <i>ls /mnt/cdrom/stages</i> |
3933 |
</pre> |
3934 |
|
3935 |
<p> |
3936 |
If the system replies with an error, you may need to mount the CD-ROM first: |
3937 |
</p> |
3938 |
|
3939 |
<pre caption="Mounting the CD-ROM"> |
3940 |
# <i>ls /mnt/cdrom/stages</i> |
3941 |
ls: /mnt/cdrom/stages: No such file or directory |
3942 |
# <i>mount /dev/cdroms/cdrom0 /mnt/cdrom</i> |
3943 |
# <i>ls /mnt/cdrom/stages</i> |
3944 |
</pre> |
3945 |
|
3946 |
<p> |
3947 |
Now go into your Gentoo mountpoint (usually <path>/mnt/gentoo</path>): |
3948 |
</p> |
3949 |
|
3950 |
<pre caption="Changing directory to /mnt/gentoo"> |
3951 |
# <i>cd /mnt/gentoo</i> |
3952 |
</pre> |
3953 |
|
3954 |
<p> |
3955 |
We will now extract the stage tarball of your choice. We will do this with the |
3956 |
GNU <c>tar</c> tool. Make sure you use the same options (<c>-xvjpf</c>)! Again, |
3957 |
the <c>v</c> argument is optional and not supported in some <c>tar</c> versions. |
3958 |
In the next example, we extract the stage tarball |
3959 |
<path>stage3-<subarch>-2006.0.tar.bz2</path>. |
3960 |
Be sure to substitute the tarball filename with your stage. |
3961 |
</p> |
3962 |
|
3963 |
<pre caption="Extracting the stage tarball"> |
3964 |
# <i>tar -xvjpf /mnt/cdrom/stages/stage3-<subarch>-2006.0.tar.bz2</i> |
3965 |
</pre> |
3966 |
|
3967 |
<p> |
3968 |
Now that the stage is installed, continue with <uri |
3969 |
link="#installing_portage">Installing Portage</uri>. |
3970 |
</p> |
3971 |
|
3972 |
</body> |
3973 |
</subsection> |
3974 |
</section>--> |
3975 |
<section id="installing_portage"> |
3976 |
<title>Installing Portage</title> |
3977 |
<subsection> |
3978 |
<title>Unpacking a Portage Snapshot</title> |
3979 |
<body> |
3980 |
|
3981 |
<p> |
3982 |
You now have to install a Portage snapshot, a collection of files that inform |
3983 |
Portage what software titles you can install, which profiles are available, etc. |
3984 |
</p> |
3985 |
|
3986 |
</body> |
3987 |
</subsection> |
3988 |
<subsection id="installing_from_Internet"> |
3989 |
<title>Download and Install a Portage Snapshot</title> |
3990 |
<body> |
3991 |
|
3992 |
<p> |
3993 |
Go to the mountpoint where you mounted your filesystem (most likely |
3994 |
<path>/gentoo</path>): |
3995 |
</p> |
3996 |
|
3997 |
<pre caption="Going to the Gentoo mountpoint"> |
3998 |
# <i>cd /gentoo</i> |
3999 |
</pre> |
4000 |
|
4001 |
<p> |
4002 |
Download a portage snapshot from a <uri |
4003 |
link="/main/en/mirrors.xml">local mirror</uri>. |
4004 |
You'll find them in the <path>snapshots/</path> directory. Transfer it to the |
4005 |
target system in the same manner that you did for the stage tarball. |
4006 |
</p> |
4007 |
|
4008 |
<pre caption="Extracting the Portage snapshot"> |
4009 |
# <i>tar -xjf portage-*.tar.bz2 -C /gentoo/usr</i> |
4010 |
</pre> |
4011 |
|
4012 |
</body> |
4013 |
</subsection> |
4014 |
</section> |
4015 |
|
4016 |
<section id="compile_options"> |
4017 |
<title>Configuring the Compile Options</title> |
4018 |
<subsection> |
4019 |
<title>Introduction</title> |
4020 |
<body> |
4021 |
|
4022 |
<p> |
4023 |
To optimize Gentoo, you can set a couple of variables which impact Portage |
4024 |
behaviour. All those variables can be set as environment variables (using |
4025 |
<c>export</c>) but that isn't permanent. To keep your settings, Portage provides |
4026 |
you with <path>/etc/make.conf</path>, a configuration file for Portage. It is |
4027 |
this file we will edit now. |
4028 |
</p> |
4029 |
|
4030 |
<note> |
4031 |
A commented listing of all possible variables can be found in |
4032 |
<path>/gentoo/etc/make.conf.example</path>. For a successful Gentoo |
4033 |
installation you'll only need to set the variables which are mentioned beneath. |
4034 |
</note> |
4035 |
|
4036 |
<p> |
4037 |
Fire up a text editor so we can alter the optimization variables we will discuss |
4038 |
hereafter. Two editors are provided, <c>vi</c> (part of Busybox) and |
4039 |
<c>nano</c>. We will assume you're using <c>nano</c>. |
4040 |
</p> |
4041 |
|
4042 |
<pre caption="Opening /etc/make.conf"> |
4043 |
# <i>nano -w /gentoo/etc/make.conf</i> |
4044 |
</pre> |
4045 |
|
4046 |
<p> |
4047 |
As you probably noticed, the <path>make.conf.example</path> file is |
4048 |
structured in a generic way: commented lines start with "#", other lines define |
4049 |
variables using the <c>VARIABLE="content"</c> syntax. The <path>make.conf</path> |
4050 |
file uses the same syntax. Several of those variables are discussed next. |
4051 |
</p> |
4052 |
|
4053 |
</body> |
4054 |
</subsection> |
4055 |
<!--<subsection> |
4056 |
<title>CHOST</title> |
4057 |
<body> |
4058 |
|
4059 |
<warn> |
4060 |
Although it might be tempting for non-stage1 users, they should <e>not</e> |
4061 |
change the <c>CHOST</c> setting in <path>make.conf</path>. Doing so might render |
4062 |
their system unusable. Again: only change this variable if you use a |
4063 |
<e>stage1</e> installation. |
4064 |
</warn> |
4065 |
|
4066 |
<p> |
4067 |
The <c>CHOST</c> variable defines what architecture <c>gcc</c> has to |
4068 |
compile programs for, as well as the <c>libc</c> (<c>glibc</c> or <c>µClibc</c>) used |
4069 |
for linking. |
4070 |
</p> |
4071 |
|
4072 |
<table> |
4073 |
<tr> |
4074 |
<th>Endianness</th> |
4075 |
<th>Userland/ABI</th> |
4076 |
<th>CHOST Setting</th> |
4077 |
</tr> |
4078 |
<tr> |
4079 |
<ti>Big Endian <e>(SGI Users)</e></ti> |
4080 |
<ti><c>glibc</c> <c>o32</c></ti> |
4081 |
<ti>mips-unknown-linux-gnu</ti> |
4082 |
</tr> |
4083 |
<tr> |
4084 |
<ti>Big Endian <e>(SGI Users)</e></ti> |
4085 |
<ti><c>µClibc</c> <c>o32</c></ti> |
4086 |
<ti>mips-unknown-linux-uclibc (1)</ti> |
4087 |
</tr> |
4088 |
<tr> |
4089 |
<ti>Big Endian <e>(SGI Users)</e></ti> |
4090 |
<ti><c>glibc</c> <c>n32</c> & <c>n64</c></ti> |
4091 |
<ti>mips64-unknown-linux-gnu (2)</ti> |
4092 |
</tr> |
4093 |
<tr> |
4094 |
<ti>Little Endian <e>(Cobalt Users)</e></ti> |
4095 |
<ti><c>glibc</c> <c>o32</c></ti> |
4096 |
<ti>mipsel-unknown-linux-gnu</ti> |
4097 |
</tr> |
4098 |
<tr> |
4099 |
<ti>Little Endian <e>(Cobalt Users)</e></ti> |
4100 |
<ti><c>µClibc</c> <c>o32</c></ti> |
4101 |
<ti>mipsel-unknown-linux-uclibc (1)</ti> |
4102 |
</tr> |
4103 |
<tr> |
4104 |
<ti>Little Endian <e>(Cobalt Users)</e></ti> |
4105 |
<ti><c>glibc</c> <c>n32</c> & <c>n64</c></ti> |
4106 |
<ti>mips64el-unknown-linux-gnu (2)</ti> |
4107 |
</tr> |
4108 |
</table> |
4109 |
|
4110 |
<warn> |
4111 |
(1) µClibc stages are the realm of the |
4112 |
<uri link="/proj/en/base/embedded/">Gentoo Embedded</uri> |
4113 |
team, and are therefore not officially supported by the |
4114 |
Gentoo/MIPS team. This <c>CHOST</c> setting is only mentioned here for |
4115 |
completeness. |
4116 |
</warn> |
4117 |
|
4118 |
<warn> |
4119 |
(2) Currently we do not provide <c>n64</c> stages, and only provide <c>n32</c> |
4120 |
stages on the Big Endian MIPS4 architecture. These are highly experimental |
4121 |
stages and are known to be totally broken in places. Users are thus |
4122 |
<e>highly</e> recommended to avoid these like the plague. |
4123 |
The only reason one would need the <c>mips64(el)</c> <c>CHOST</c>, is to use a |
4124 |
64-bit (<c>n32</c> or <c>n64</c>) userland. This <c>CHOST</c> setting is only |
4125 |
mentioned here for completeness. |
4126 |
</warn> |
4127 |
|
4128 |
</body> |
4129 |
</subsection>--> |
4130 |
<subsection> |
4131 |
<title>CFLAGS and CXXFLAGS</title> |
4132 |
<body> |
4133 |
|
4134 |
<p> |
4135 |
The <c>CFLAGS</c> and <c>CXXFLAGS</c> variables define the optimization flags |
4136 |
for the <c>gcc</c> C and C++ compiler respectively. Although we define those |
4137 |
generally here, you will only have maximum performance if you optimize these |
4138 |
flags for each program separately. The reason for this is because every program |
4139 |
is different. |
4140 |
</p> |
4141 |
|
4142 |
<p> |
4143 |
In <path>make.conf</path> you should define the optimization flags you think |
4144 |
will make your system the most responsive <e>generally</e>. Don't place |
4145 |
experimental settings in this variable; too much optimization can make |
4146 |
programs behave bad (crash, or even worse, malfunction). |
4147 |
</p> |
4148 |
|
4149 |
<p> |
4150 |
We will not explain all possible optimization options. If you want to know |
4151 |
them all, read the <uri link="http://gcc.gnu.org/onlinedocs/">GNU |
4152 |
Online Manual(s)</uri> or the <c>gcc</c> info page (<c>info gcc</c> -- only |
4153 |
works on a working Linux system). The <path>make.conf.example</path> file |
4154 |
itself also contains lots of examples and information; don't forget to read it |
4155 |
too. |
4156 |
</p> |
4157 |
|
4158 |
<p> |
4159 |
A first setting is the <c>-march=</c> flag, which specifies the name of the |
4160 |
target architecture. Possible options are described in the |
4161 |
<path>make.conf.example</path> file (as comments). Examples include ISA levels |
4162 |
(<c>mips1</c> ... <c>mips4</c>) and CPU models (<c>r4400</c>, <c>r4600</c> ... |
4163 |
etc). For pure ISA level architectures, one can simply specify <c>-mips3</c> |
4164 |
rather than <c>-march=mips3</c>. |
4165 |
</p> |
4166 |
|
4167 |
<pre caption="The GCC -march and -mips# settings"> |
4168 |
<comment>(For an R4600 system...)</comment> |
4169 |
-march=r4600 |
4170 |
|
4171 |
<comment>(Any MIPS4-class CPU...)</comment> |
4172 |
-march=mips4 |
4173 |
|
4174 |
<comment>(Or just specify the ISA level directly...)</comment> |
4175 |
-mips4 |
4176 |
</pre> |
4177 |
|
4178 |
<p> |
4179 |
A second one is the <c>-O</c> flag (that is a capital O, not a zero), |
4180 |
which specifies the <c>gcc</c> optimization |
4181 |
class flag. Possible classes are <c>s</c> (for size-optimized), |
4182 |
<c>0</c> (zero - for no optimizations), <c>1</c>, <c>2</c> or <c>3</c> for more |
4183 |
speed-optimization flags (every class has the same flags as the one before, plus |
4184 |
some extras). For instance, for a class-2 optimization: |
4185 |
</p> |
4186 |
|
4187 |
<pre caption="The GCC O setting"> |
4188 |
-O2 |
4189 |
</pre> |
4190 |
|
4191 |
<p> |
4192 |
A very important setting in the MIPS world, is the <c>-mabi=</c> flag. MIPS has |
4193 |
3 different ABIs; <c>32</c> (pure 32-bit, aka <c>o32</c>), <c>64</c> (full |
4194 |
64-bit, aka <c>n64</c>) and <c>n32</c> |
4195 |
(a mix of 32-bit data structures with 64-bit instructions). This |
4196 |
flag selects which of these you wish to use. Note you need libraries for the |
4197 |
ABI you select. In layman's terms, this means, for example, you can't use |
4198 |
<c>-mabi=64</c> on a 32-bit userland (or even a <c>n32</c> userland). |
4199 |
</p> |
4200 |
|
4201 |
<p> |
4202 |
Another popular optimization flag is <c>-pipe</c> (use pipes rather than |
4203 |
temporary files for communication between the various stages of compilation). |
4204 |
</p> |
4205 |
|
4206 |
<p> |
4207 |
Mind you that using <c>-fomit-frame-pointer</c> (which doesn't keep the frame |
4208 |
pointer in a register for functions that don't need one) might have serious |
4209 |
repercussions on the debugging of applications! |
4210 |
</p> |
4211 |
|
4212 |
<p> |
4213 |
When you define the <c>CFLAGS</c> and <c>CXXFLAGS</c>, you should combine |
4214 |
several optimization flags, like in the following example: |
4215 |
</p> |
4216 |
|
4217 |
<pre caption="Defining the CFLAGS and CXXFLAGS variable"> |
4218 |
CFLAGS="-mabi=32 -mips4 -pipe -O2" |
4219 |
CXXFLAGS="${CFLAGS}" <comment># Use the same settings for both variables</comment> |
4220 |
</pre> |
4221 |
|
4222 |
</body> |
4223 |
</subsection> |
4224 |
<subsection> |
4225 |
<title>MAKEOPTS</title> |
4226 |
<body> |
4227 |
|
4228 |
<p> |
4229 |
With <c>MAKEOPTS</c> you define how many parallel compilations should occur when |
4230 |
you install a package. A good choice is the number of CPUs in your system plus |
4231 |
one, but this guideline isn't always perfect. |
4232 |
</p> |
4233 |
|
4234 |
<pre caption="MAKEOPTS for a regular, 1-CPU system"> |
4235 |
MAKEOPTS="-j2" |
4236 |
</pre> |
4237 |
|
4238 |
</body> |
4239 |
</subsection> |
4240 |
<subsection> |
4241 |
<title>Ready, Set, Go!</title> |
4242 |
<body> |
4243 |
|
4244 |
<p> |
4245 |
Update your <path>/gentoo/etc/make.conf</path> to your own preference and |
4246 |
save (<c>nano</c> users would hit <c>Ctrl-X</c>). You are now ready to continue |
4247 |
with <uri link="?part=1&chap=6">Installing the Gentoo Base System</uri>. |
4248 |
</p> |
4249 |
|
4250 |
</body> |
4251 |
</subsection> |
4252 |
</section> |
4253 |
</sections> |
4254 |
|
4255 |
|
4256 |
|
4257 |
-- |
4258 |
gentoo-doc-cvs@g.o mailing list |