1 |
neysx |
1.1 |
<?xml version='1.0' encoding='UTF-8'?> |
2 |
|
|
<!DOCTYPE book SYSTEM "/dtd/book.dtd"> |
3 |
|
|
|
4 |
neysx |
1.104 |
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-mips.xml,v 1.103 2005/07/28 14:33:43 swift Exp $ --> |
5 |
neysx |
1.1 |
|
6 |
|
|
<book link="handbook-mips.xml"> |
7 |
|
|
<title>Gentoo Linux/MIPS Handbook</title> |
8 |
|
|
|
9 |
swift |
1.86 |
<author title="Author"> |
10 |
swift |
1.91 |
<mail link="swift@gentoo.org">Sven Vermeulen</mail> |
11 |
neysx |
1.1 |
</author> |
12 |
|
|
<author title="Author"> |
13 |
swift |
1.102 |
<mail link="uberlord@gentoo.org">Roy Marples</mail> |
14 |
|
|
</author> |
15 |
|
|
<author title="Author"> |
16 |
swift |
1.91 |
<mail link="drobbins@gentoo.org">Daniel Robbins</mail> |
17 |
neysx |
1.1 |
</author> |
18 |
|
|
<author title="Author"> |
19 |
|
|
<mail link="chouser@gentoo.org">Chris Houser</mail> |
20 |
|
|
</author> |
21 |
|
|
<author title="Author"> |
22 |
|
|
<mail link="jerry@gentoo.org">Jerry Alexandratos</mail> |
23 |
|
|
</author> |
24 |
|
|
<author title="Gentoo x86 Developer"> |
25 |
|
|
<mail link="seemant@gentoo.org">Seemant Kulleen</mail> |
26 |
|
|
</author> |
27 |
|
|
<author title="Gentoo Alpha Developer"> |
28 |
|
|
<mail link="taviso@gentoo.org">Tavis Ormandy</mail> |
29 |
swift |
1.103 |
</author><!-- Does not want to be listed on the rendered page |
30 |
|
|
<author title="Gentoo Developer"> |
31 |
|
|
Aron Griffis |
32 |
neysx |
1.1 |
</author> |
33 |
swift |
1.103 |
--> |
34 |
neysx |
1.1 |
<author title="Gentoo AMD64 Developer"> |
35 |
dertobi123 |
1.36 |
<mail link="jhuebel@gentoo.org">Jason Huebel</mail> |
36 |
neysx |
1.1 |
</author> |
37 |
|
|
<author title="Gentoo HPPA developer"> |
38 |
|
|
<mail link="gmsoft@gentoo.org">Guy Martin</mail> |
39 |
|
|
</author> |
40 |
|
|
<author title="Gentoo PPC developer"> |
41 |
|
|
<mail link="pvdabeel@gentoo.org">Pieter Van den Abeele</mail> |
42 |
|
|
</author> |
43 |
|
|
<author title="Gentoo SPARC developer"> |
44 |
|
|
<mail link="blademan@gentoo.org">Joe Kallar</mail> |
45 |
|
|
</author> |
46 |
|
|
<author title="Editor"> |
47 |
|
|
<mail link="zhen@gentoo.org">John P. Davis</mail> |
48 |
|
|
</author> |
49 |
|
|
<author title="Editor">Pierre-Henri Jondot</author> |
50 |
|
|
<author title="Editor"> |
51 |
|
|
<mail link="stocke2@gentoo.org">Eric Stockbridge</mail> |
52 |
|
|
</author> |
53 |
|
|
<author title="Editor"> |
54 |
|
|
<mail link="rajiv@gentoo.org">Rajiv Manglani</mail> |
55 |
|
|
</author> |
56 |
|
|
<author title="Editor"> |
57 |
|
|
<mail link="seo@gentoo.org">Jungmin Seo</mail> |
58 |
|
|
</author> |
59 |
|
|
<author title="Editor"> |
60 |
|
|
<mail link="zhware@gentoo.org">Stoyan Zhekov</mail> |
61 |
|
|
</author> |
62 |
|
|
<author title="Editor"> |
63 |
|
|
<mail link="jhhudso@gentoo.org">Jared Hudson</mail> |
64 |
|
|
</author> |
65 |
|
|
<author title="Editor"> |
66 |
|
|
<mail link="peitolm@gentoo.org">Colin Morey</mail> |
67 |
|
|
</author> |
68 |
|
|
<author title="Editor"> |
69 |
|
|
<mail link="peesh@gentoo.org">Jorge Paulo</mail> |
70 |
|
|
</author> |
71 |
|
|
<author title="Editor"> |
72 |
|
|
<mail link="carl@gentoo.org">Carl Anderson</mail> |
73 |
|
|
</author> |
74 |
|
|
<author title="Editor"> |
75 |
|
|
<mail link="avenj@gentoo.org">Jon Portnoy</mail> |
76 |
|
|
</author> |
77 |
|
|
<author title="Editor"> |
78 |
|
|
<mail link="klasikahl@gentoo.org">Zack Gilburd</mail> |
79 |
|
|
</author> |
80 |
|
|
<author title="Editor"> |
81 |
|
|
<mail link="jmorgan@gentoo.org">Jack Morgan</mail> |
82 |
|
|
</author> |
83 |
|
|
<author title="Editor"> |
84 |
|
|
<mail link="bennyc@gentoo.org">Benny Chuang</mail> |
85 |
|
|
</author> |
86 |
|
|
<author title="Editor"> |
87 |
|
|
<mail link="erwin@gentoo.org">Erwin</mail> |
88 |
|
|
</author> |
89 |
|
|
<author title="Editor"> |
90 |
|
|
<mail link="kumba@gentoo.org">Joshua Kinard</mail> |
91 |
|
|
</author> |
92 |
dertobi123 |
1.36 |
<author title="Editor"> |
93 |
swift |
1.101 |
<mail link="stuartl@longlandclan.hopto.org">Stuart Longland</mail> |
94 |
|
|
</author> |
95 |
|
|
<author title="Editor"> |
96 |
dertobi123 |
1.36 |
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail> |
97 |
|
|
</author> |
98 |
neysx |
1.104 |
<author title="Editor"> |
99 |
|
|
<mail link="neysx@gentoo.org">Xavier Neys</mail> |
100 |
|
|
</author> |
101 |
neysx |
1.1 |
<author title="Reviewer"> |
102 |
|
|
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail> |
103 |
|
|
</author> |
104 |
|
|
<author title="Reviewer"> |
105 |
|
|
<mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail> |
106 |
|
|
</author> |
107 |
|
|
<author title="Reviewer"> |
108 |
|
|
<mail link="spyderous@gentoo.org">Donnie Berkholz</mail> |
109 |
|
|
</author> |
110 |
|
|
<author title="Reviewer"> |
111 |
|
|
<mail link="antifa@gentoo.org">Ken Nowack</mail> |
112 |
|
|
</author> |
113 |
|
|
<author title="Contributor"> |
114 |
|
|
<mail link="pylon@gentoo.org">Lars Weiler</mail> |
115 |
|
|
</author> |
116 |
|
|
|
117 |
|
|
<abstract> |
118 |
neysx |
1.104 |
This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information. |
119 |
|
|
This handbook contains the installation instructions for an internet-based |
120 |
|
|
installation on MIPS systems and parts about working with Gentoo and Portage. |
121 |
neysx |
1.1 |
</abstract> |
122 |
|
|
|
123 |
|
|
<!-- The content of this document is licensed under the CC-BY-SA license --> |
124 |
neysx |
1.104 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
125 |
neysx |
1.1 |
<license/> |
126 |
|
|
|
127 |
neysx |
1.104 |
<version>4.1</version> |
128 |
|
|
<date>2005-10-13</date> |
129 |
neysx |
1.1 |
|
130 |
|
|
<part> |
131 |
|
|
<title>Installing Gentoo</title> |
132 |
|
|
<abstract> |
133 |
|
|
In this part you learn how to install Gentoo on your system. |
134 |
|
|
</abstract> |
135 |
|
|
|
136 |
|
|
<chapter> |
137 |
|
|
<title>About the Gentoo Linux Installation</title> |
138 |
|
|
<abstract> |
139 |
swift |
1.100 |
This chapter introduces you to the installation approach documented in this |
140 |
|
|
part. |
141 |
neysx |
1.1 |
</abstract> |
142 |
|
|
<include href="hb-install-about.xml"/> |
143 |
|
|
</chapter> |
144 |
|
|
|
145 |
|
|
<chapter> |
146 |
|
|
<title>Choosing the Right Installation Medium</title> |
147 |
|
|
<abstract> |
148 |
swift |
1.3 |
You can install Gentoo in many ways. In this chapter we explain how to install |
149 |
|
|
Gentoo using the MIPS Netboot images. |
150 |
neysx |
1.1 |
</abstract> |
151 |
|
|
<include href="hb-install-mips-medium.xml"/> |
152 |
|
|
</chapter> |
153 |
|
|
|
154 |
|
|
<chapter> |
155 |
|
|
<title>Configuring your Network</title> |
156 |
|
|
<abstract> |
157 |
swift |
1.100 |
To be able to download the latest source code, you will need to setup |
158 |
neysx |
1.1 |
networking. |
159 |
|
|
</abstract> |
160 |
|
|
<include href="hb-install-network.xml"/> |
161 |
|
|
</chapter> |
162 |
|
|
|
163 |
|
|
<chapter> |
164 |
|
|
<title>Preparing the Disks</title> |
165 |
|
|
<abstract> |
166 |
|
|
To be able to install Gentoo, you must create the necessary partitions. |
167 |
|
|
This chapter describes how to partition a disk for future usage. |
168 |
|
|
</abstract> |
169 |
|
|
<include href="hb-install-mips-disk.xml"/> |
170 |
|
|
</chapter> |
171 |
|
|
|
172 |
|
|
<chapter> |
173 |
|
|
<title>Installing the Gentoo Installation Files</title> |
174 |
|
|
<abstract> |
175 |
neysx |
1.33 |
Gentoo installs work through so-called stage-files. In this chapter we |
176 |
neysx |
1.1 |
describe how you extract a stage-file and configure Portage. |
177 |
|
|
</abstract> |
178 |
|
|
<include href="hb-install-stage.xml"/> |
179 |
|
|
</chapter> |
180 |
|
|
|
181 |
|
|
<chapter> |
182 |
|
|
<title>Installing the Gentoo Base System</title> |
183 |
|
|
<abstract> |
184 |
|
|
Independent of what stage you chose, the eventual result is that you |
185 |
|
|
have a Gentoo base system at your disposal. This chapter describes how |
186 |
|
|
to progress to that stadium. |
187 |
|
|
</abstract> |
188 |
|
|
<include href="hb-install-system.xml"/> |
189 |
|
|
</chapter> |
190 |
|
|
|
191 |
|
|
<chapter> |
192 |
|
|
<title>Configuring the Kernel</title> |
193 |
|
|
<abstract> |
194 |
|
|
The Linux kernel is the core of every distribution. This chapter |
195 |
|
|
explains how to configure your kernel. |
196 |
|
|
</abstract> |
197 |
|
|
<include href="hb-install-mips-kernel.xml"/> |
198 |
|
|
</chapter> |
199 |
|
|
|
200 |
|
|
<chapter> |
201 |
|
|
<title>Configuring your System</title> |
202 |
|
|
<abstract> |
203 |
|
|
You need to edit some important configuration files. In this chapter |
204 |
|
|
you receive an overview of these files and an explanation on how to |
205 |
|
|
proceed. |
206 |
|
|
</abstract> |
207 |
|
|
<include href="hb-install-config.xml"/> |
208 |
|
|
</chapter> |
209 |
|
|
|
210 |
|
|
<chapter> |
211 |
swift |
1.56 |
<title>Installing Necessary System Tools</title> |
212 |
|
|
<abstract> |
213 |
|
|
As mentioned before, Gentoo is about choices. In this chapter we help you |
214 |
|
|
choose and install some important tools. |
215 |
|
|
</abstract> |
216 |
|
|
<include href="hb-install-tools.xml"/> |
217 |
|
|
</chapter> |
218 |
|
|
|
219 |
|
|
<chapter> |
220 |
neysx |
1.1 |
<title>Configuring the Bootloader</title> |
221 |
|
|
<abstract> |
222 |
swift |
1.101 |
On both Silicon Graphics machines, and on Cobalt servers, both require the use |
223 |
|
|
of a bootloader to load the kernel. This section covers setting up |
224 |
|
|
arcboot (for SGI machines) and colo for Cobalt servers. |
225 |
neysx |
1.1 |
</abstract> |
226 |
|
|
<include href="hb-install-mips-bootloader.xml"/> |
227 |
|
|
</chapter> |
228 |
|
|
|
229 |
|
|
<chapter> |
230 |
|
|
<title>Finalizing your Gentoo Installation</title> |
231 |
|
|
<abstract> |
232 |
|
|
You're almost done. We'll just create one (or more) users for your |
233 |
swift |
1.100 |
system. |
234 |
neysx |
1.1 |
</abstract> |
235 |
|
|
<include href="hb-install-finalise.xml"/> |
236 |
|
|
</chapter> |
237 |
|
|
|
238 |
|
|
<chapter> |
239 |
|
|
<title>Where to go from here?</title> |
240 |
|
|
<abstract> |
241 |
|
|
Now you have your Gentoo system, but what's next? |
242 |
|
|
</abstract> |
243 |
|
|
<include href="hb-install-next.xml"/> |
244 |
|
|
</chapter> |
245 |
|
|
</part> |
246 |
|
|
|
247 |
|
|
<part> |
248 |
|
|
<title>Working with Gentoo</title> |
249 |
|
|
<abstract> |
250 |
|
|
Learn how to work with Gentoo: installing software, altering variables, changing |
251 |
swift |
1.90 |
Portage behaviour etc. |
252 |
neysx |
1.1 |
</abstract> |
253 |
|
|
|
254 |
|
|
<chapter> |
255 |
swift |
1.89 |
<title>A Portage Introduction</title> |
256 |
neysx |
1.1 |
<abstract> |
257 |
swift |
1.89 |
This chapter explains the "simple" steps a user definitely needs to know to |
258 |
|
|
maintain the software on his system. |
259 |
neysx |
1.1 |
</abstract> |
260 |
swift |
1.89 |
<include href="hb-working-portage.xml"/> |
261 |
neysx |
1.1 |
</chapter> |
262 |
|
|
|
263 |
|
|
<chapter> |
264 |
swift |
1.89 |
<title>USE flags</title> |
265 |
neysx |
1.1 |
<abstract> |
266 |
swift |
1.89 |
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to |
267 |
|
|
work with USE-flags and understand how USE-flags interact with your system. |
268 |
neysx |
1.1 |
</abstract> |
269 |
swift |
1.89 |
<include href="hb-working-use.xml"/> |
270 |
neysx |
1.1 |
</chapter> |
271 |
|
|
|
272 |
|
|
<chapter> |
273 |
|
|
<title>Portage Features</title> |
274 |
|
|
<abstract> |
275 |
swift |
1.89 |
Discover the features Portage has, such as support for distributed compiling, |
276 |
|
|
ccache and more. |
277 |
neysx |
1.1 |
</abstract> |
278 |
|
|
<include href="hb-working-features.xml"/> |
279 |
|
|
</chapter> |
280 |
|
|
|
281 |
|
|
<chapter> |
282 |
|
|
<title>Initscripts</title> |
283 |
|
|
<abstract> |
284 |
|
|
Gentoo uses a special initscript format which, amongst other features, allows |
285 |
|
|
dependency-driven decisions and virtual initscripts. This chapter explains all |
286 |
|
|
these aspects and explains how to deal with these scripts. |
287 |
|
|
</abstract> |
288 |
|
|
<include href="hb-working-rcscripts.xml"/> |
289 |
|
|
</chapter> |
290 |
|
|
|
291 |
|
|
<chapter> |
292 |
|
|
<title>Environment Variables</title> |
293 |
|
|
<abstract> |
294 |
|
|
With Gentoo you can easily manage the environment variables for your system. |
295 |
|
|
This chapter explains how you do that, and also describes frequently used |
296 |
|
|
variables. |
297 |
|
|
</abstract> |
298 |
|
|
<include href="hb-working-variables.xml"/> |
299 |
|
|
</chapter> |
300 |
|
|
</part> |
301 |
|
|
|
302 |
swift |
1.89 |
<part> |
303 |
|
|
<title>Working with Portage</title> |
304 |
|
|
<abstract> |
305 |
|
|
"Working with Portage" provides an in-depth coverage of Portage, Gentoo's |
306 |
|
|
Software Management Tool. |
307 |
|
|
</abstract> |
308 |
|
|
|
309 |
|
|
<chapter> |
310 |
|
|
<title>Files and Directories</title> |
311 |
|
|
<abstract> |
312 |
swift |
1.91 |
Once you want to know Portage in-depth you need to know where it stores its |
313 |
swift |
1.89 |
files and data. |
314 |
|
|
</abstract> |
315 |
|
|
<include href="hb-portage-files.xml"/> |
316 |
|
|
</chapter> |
317 |
|
|
|
318 |
|
|
<chapter> |
319 |
|
|
<title>Configuring through Variables</title> |
320 |
|
|
<abstract> |
321 |
|
|
Portage is completely configurable through various variables you can set in the |
322 |
|
|
configuration file or as environment variable. |
323 |
|
|
</abstract> |
324 |
|
|
<include href="hb-portage-configuration.xml"/> |
325 |
|
|
</chapter> |
326 |
|
|
|
327 |
|
|
<chapter> |
328 |
|
|
<title>Mixing Software Branches</title> |
329 |
|
|
<abstract> |
330 |
|
|
Gentoo provides software separated in several branches, depending on stability |
331 |
|
|
and architectural support. "Mixing Software Branches" inform you how these |
332 |
|
|
branches can be configured and how you can override this separation |
333 |
|
|
individually. |
334 |
|
|
</abstract> |
335 |
|
|
<include href="hb-portage-branches.xml"/> |
336 |
|
|
</chapter> |
337 |
|
|
|
338 |
|
|
<chapter> |
339 |
|
|
<title>Additional Portage Tools</title> |
340 |
|
|
<abstract> |
341 |
|
|
Portage comes with a few extra tools that might make your Gentoo experience even |
342 |
|
|
better. Read on to discover how to use dispatch-conf and other tools. |
343 |
|
|
</abstract> |
344 |
|
|
<include href="hb-portage-tools.xml"/> |
345 |
|
|
</chapter> |
346 |
|
|
|
347 |
|
|
<chapter> |
348 |
|
|
<title>Diverting from the Official Tree</title> |
349 |
|
|
<abstract> |
350 |
|
|
"Diverting from the Official Tree" gives you some tips and tricks on how to use |
351 |
|
|
your own Portage tree, how to synchronise only the categories you want, inject |
352 |
|
|
packages and more. |
353 |
|
|
</abstract> |
354 |
|
|
<include href="hb-portage-diverttree.xml"/> |
355 |
|
|
</chapter> |
356 |
|
|
|
357 |
|
|
<chapter> |
358 |
|
|
<title>The Ebuild Application</title> |
359 |
|
|
<abstract> |
360 |
|
|
In "The Ebuild Application" you are informed about the steps Portage takes while |
361 |
|
|
installing software and how you can do this yourself using the ebuild |
362 |
|
|
application. |
363 |
|
|
</abstract> |
364 |
|
|
<include href="hb-portage-ebuild.xml"/> |
365 |
|
|
</chapter> |
366 |
|
|
</part> |
367 |
|
|
|
368 |
swift |
1.102 |
<part> |
369 |
|
|
<title>Gentoo Network Configuration</title> |
370 |
|
|
<abstract>A comprehensive guide to Networking in Gentoo.</abstract> |
371 |
|
|
|
372 |
|
|
<chapter> |
373 |
|
|
<title>Getting Started</title> |
374 |
|
|
<abstract> |
375 |
|
|
A guide to quickly get your network interface up and running in most common |
376 |
|
|
environments. |
377 |
|
|
</abstract> |
378 |
|
|
<include href="hb-net-start.xml"/> |
379 |
|
|
</chapter> |
380 |
|
|
|
381 |
|
|
<chapter> |
382 |
|
|
<title>Advanced Configuration</title> |
383 |
|
|
<abstract> |
384 |
|
|
Here we learn about how the configuration works - you need to know this |
385 |
|
|
before we learn about modular networking. |
386 |
|
|
</abstract> |
387 |
|
|
<include href="hb-net-advanced.xml"/> |
388 |
|
|
</chapter> |
389 |
|
|
|
390 |
|
|
<chapter> |
391 |
|
|
<title>Modular Networking</title> |
392 |
|
|
<abstract> |
393 |
|
|
Gentoo provides you flexible networking - here you are told about choosing |
394 |
|
|
different DHCP clients, setting up bonding, bridging, VLANs and more. |
395 |
|
|
</abstract> |
396 |
|
|
<include href="hb-net-modules.xml"/> |
397 |
|
|
</chapter> |
398 |
|
|
|
399 |
|
|
<chapter> |
400 |
|
|
<title>Wireless Networking</title> |
401 |
|
|
<abstract> |
402 |
|
|
Wireless isn't straight-forward. Hopefully we'll get you working! |
403 |
|
|
</abstract> |
404 |
|
|
<include href="hb-net-wireless.xml"/> |
405 |
|
|
</chapter> |
406 |
|
|
|
407 |
|
|
<chapter> |
408 |
|
|
<title>Adding Functionality</title> |
409 |
|
|
<abstract> |
410 |
|
|
If you're feeling adventurous, you can add your own functions to networking. |
411 |
|
|
</abstract> |
412 |
|
|
<include href="hb-net-functions.xml"/> |
413 |
|
|
</chapter> |
414 |
|
|
|
415 |
|
|
<chapter> |
416 |
|
|
<title>Network Management</title> |
417 |
|
|
<abstract> |
418 |
|
|
For laptop users or people who move their computer around different networks. |
419 |
|
|
</abstract> |
420 |
|
|
<include href="hb-net-management.xml"/> |
421 |
|
|
</chapter> |
422 |
|
|
</part> |
423 |
|
|
|
424 |
neysx |
1.1 |
</book> |