| 1 | <?xml version='1.0' encoding='UTF-8'?> |
1 | <?xml version='1.0' encoding='UTF-8'?> |
| 2 | <!DOCTYPE book SYSTEM "/dtd/book.dtd"> |
2 | <!DOCTYPE book SYSTEM "/dtd/book.dtd"> |
| 3 | |
3 | |
| 4 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-alpha.xml,v 1.59 2004/08/01 13:08:35 swift Exp $ --> |
4 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-alpha.xml,v 1.118 2005/11/11 17:27:15 swift Exp $ --> |
| 5 | |
5 | |
| 6 | <book link="handbook-alpha.xml"> |
6 | <book link="handbook-alpha.xml"> |
| 7 | <title>Gentoo Linux/Alpha Handbook</title> |
7 | <title>Gentoo Linux Alpha Handbook</title> |
| 8 | |
8 | |
| 9 | <author title="Chief Architect"> |
|
|
| 10 | <mail link="drobbins@gentoo.org">Daniel Robbins</mail> |
|
|
| 11 | </author> |
|
|
| 12 | <author title="Author"> |
9 | <author title="Author"> |
| 13 | <mail link="swift@gentoo.org">Sven Vermeulen</mail> |
10 | <mail link="swift@gentoo.org">Sven Vermeulen</mail> |
| 14 | </author> |
11 | </author> |
| 15 | <author title="Author"> |
12 | <author title="Author"> |
|
|
13 | <mail link="uberlord@gentoo.org">Roy Marples</mail> |
|
|
14 | </author> |
|
|
15 | <author title="Author"> |
|
|
16 | <mail link="drobbins@gentoo.org">Daniel Robbins</mail> |
|
|
17 | </author> |
|
|
18 | <author title="Author"> |
| 16 | <mail link="chouser@gentoo.org">Chris Houser</mail> |
19 | <mail link="chouser@gentoo.org">Chris Houser</mail> |
| 17 | </author> |
20 | </author> |
| 18 | <author title="Author"> |
21 | <author title="Author"> |
| 19 | <mail link="jerry@gentoo.org">Jerry Alexandratos</mail> |
22 | <mail link="jerry@gentoo.org">Jerry Alexandratos</mail> |
| 20 | </author> |
23 | </author> |
| 21 | <author title="Gentoo x86 Developer"> |
24 | <author title="Gentoo x86 Developer"> |
| 22 | <mail link="seemant@gentoo.org">Seemant Kulleen</mail> |
25 | <mail link="seemant@gentoo.org">Seemant Kulleen</mail> |
| 23 | </author> |
26 | </author> |
| 24 | <author title="Gentoo Alpha Developer"> |
27 | <author title="Gentoo Alpha Developer"> |
| 25 | <mail link="taviso@gentoo.org">Tavis Ormandy</mail> |
28 | <mail link="taviso@gentoo.org">Tavis Ormandy</mail> |
| 26 | </author> |
29 | </author><!-- Does not want to be listed on the rendered page |
| 27 | <author title="Gentoo Alpha Developer"> |
30 | <author title="Gentoo Developer"> |
| 28 | <mail link="agriffis@gentoo.org">Aron Griffis</mail> |
31 | Aron Griffis |
| 29 | </author> |
32 | </author> |
|
|
33 | --> |
| 30 | <author title="Gentoo AMD64 Developer"> |
34 | <author title="Gentoo AMD64 Developer"> |
| 31 | <mail link="jhuebel@gentoo.org">Jason Huebel</mail> |
35 | <mail link="jhuebel@gentoo.org">Jason Huebel</mail> |
| 32 | </author> |
36 | </author> |
| 33 | <author title="Gentoo HPPA developer"> |
37 | <author title="Gentoo HPPA developer"> |
| 34 | <mail link="gmsoft@gentoo.org">Guy Martin</mail> |
38 | <mail link="gmsoft@gentoo.org">Guy Martin</mail> |
| … | |
… | |
| 86 | <mail link="kumba@gentoo.org">Joshua Kinard</mail> |
90 | <mail link="kumba@gentoo.org">Joshua Kinard</mail> |
| 87 | </author> |
91 | </author> |
| 88 | <author title="Editor"> |
92 | <author title="Editor"> |
| 89 | <mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail> |
93 | <mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail> |
| 90 | </author> |
94 | </author> |
|
|
95 | <author title="Editor"> |
|
|
96 | <mail link="neysx@gentoo.org">Xavier Neys</mail> |
|
|
97 | </author> |
| 91 | <author title="Reviewer"> |
98 | <author title="Reviewer"> |
| 92 | <mail link="g2boojum@gentoo.org">Grant Goodyear</mail> |
99 | <mail link="g2boojum@gentoo.org">Grant Goodyear</mail> |
| 93 | </author> |
100 | </author> |
| 94 | <author title="Reviewer"> |
101 | <author title="Reviewer"> |
| 95 | <mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail> |
102 | <mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail> |
| … | |
… | |
| 103 | <author title="Contributor"> |
110 | <author title="Contributor"> |
| 104 | <mail link="pylon@gentoo.org">Lars Weiler</mail> |
111 | <mail link="pylon@gentoo.org">Lars Weiler</mail> |
| 105 | </author> |
112 | </author> |
| 106 | |
113 | |
| 107 | <abstract> |
114 | <abstract> |
| 108 | This is the Gentoo Handbook, an effort to centralise Gentoo/Linux |
115 | This is the Gentoo Handbook, an effort to centralise Gentoo/Linux information. |
| 109 | information. |
116 | This handbook contains the installation instructions for an internet-based |
|
|
117 | installation on Alpha systems and parts about working with Gentoo and Portage. |
| 110 | </abstract> |
118 | </abstract> |
| 111 | |
119 | |
| 112 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
120 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
| 113 | <!-- See http://creativecommons.org/licenses/by-sa/1.0 --> |
121 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
| 114 | <license/> |
122 | <license/> |
| 115 | |
123 | |
| 116 | <version>2.57</version> |
124 | <version>4.2</version> |
| 117 | <date>August 01, 2004</date> |
125 | <date>2005-11-11</date> |
| 118 | |
126 | |
| 119 | <part> |
127 | <part> |
| 120 | <title>Installing Gentoo</title> |
128 | <title>Installing Gentoo</title> |
| 121 | <abstract> |
129 | <abstract> |
| 122 | In this part you learn how to install Gentoo on your system. |
130 | In this part you learn how to install Gentoo on your system. |
| 123 | </abstract> |
131 | </abstract> |
| 124 | |
132 | |
| 125 | <chapter> |
133 | <chapter> |
| 126 | <title>About the Gentoo Linux Installation</title> |
134 | <title>About the Gentoo Linux Installation</title> |
| 127 | <abstract> |
135 | <abstract> |
| 128 | Users not familiar with Gentoo do not always know that choice is what |
136 | This chapter introduces you to the installation approach documented in this |
| 129 | Gentoo is all about. |
137 | part. |
| 130 | </abstract> |
138 | </abstract> |
| 131 | <include href="hb-install-about.xml"/> |
139 | <include href="hb-install-about.xml"/> |
| 132 | </chapter> |
140 | </chapter> |
| 133 | |
141 | |
| 134 | <chapter> |
142 | <chapter> |
| 135 | <title>Choosing the Right Installation Medium</title> |
143 | <title>Choosing the Right Installation Medium</title> |
| 136 | <abstract> |
144 | <abstract> |
| 137 | You can install Gentoo in many ways. In this chapter we explain how to install |
145 | You can install Gentoo in many ways. This chapter explains how to install Gentoo |
| 138 | Gentoo using a Gentoo LiveCD. |
146 | using the minimal Installation CD although installation through the Universal |
|
|
147 | Installation CD is possible as well. |
| 139 | </abstract> |
148 | </abstract> |
| 140 | <include href="hb-install-alpha-medium.xml"/> |
149 | <include href="hb-install-alpha-medium.xml"/> |
| 141 | </chapter> |
150 | </chapter> |
| 142 | |
151 | |
| 143 | <chapter> |
152 | <chapter> |
| 144 | <title>Configuring your Network</title> |
153 | <title>Configuring your Network</title> |
| 145 | <abstract> |
154 | <abstract> |
| 146 | If you want to install Gentoo using the Internet, you need to setup |
155 | To be able to download the latest source code, you will need to setup |
| 147 | networking. |
156 | networking. |
| 148 | </abstract> |
157 | </abstract> |
| 149 | <include href="hb-install-network.xml"/> |
158 | <include href="hb-install-network.xml"/> |
| 150 | </chapter> |
159 | </chapter> |
| 151 | |
160 | |
| … | |
… | |
| 159 | </chapter> |
168 | </chapter> |
| 160 | |
169 | |
| 161 | <chapter> |
170 | <chapter> |
| 162 | <title>Installing the Gentoo Installation Files</title> |
171 | <title>Installing the Gentoo Installation Files</title> |
| 163 | <abstract> |
172 | <abstract> |
| 164 | Gentoo installs work through so-called stage-files. In this chapter we |
173 | Gentoo installs work through a stage3 archive. In this chapter we |
| 165 | describe how you extract a stage-file and configure Portage. |
174 | describe how you extract the stage3 archive and configure Portage. |
| 166 | </abstract> |
175 | </abstract> |
| 167 | <include href="hb-install-stage.xml"/> |
176 | <include href="hb-install-stage.xml"/> |
| 168 | </chapter> |
177 | </chapter> |
| 169 | |
178 | |
| 170 | <chapter> |
179 | <chapter> |
| … | |
… | |
| 192 | You need to edit some important configuration files. In this chapter |
201 | You need to edit some important configuration files. In this chapter |
| 193 | you receive an overview of these files and an explanation on how to |
202 | you receive an overview of these files and an explanation on how to |
| 194 | proceed. |
203 | proceed. |
| 195 | </abstract> |
204 | </abstract> |
| 196 | <include href="hb-install-config.xml"/> |
205 | <include href="hb-install-config.xml"/> |
|
|
206 | </chapter> |
|
|
207 | |
|
|
208 | <chapter> |
|
|
209 | <title>Installing Necessary System Tools</title> |
|
|
210 | <abstract> |
|
|
211 | As mentioned before, Gentoo is about choices. In this chapter we help you |
|
|
212 | choose and install some important tools. |
|
|
213 | </abstract> |
|
|
214 | <include href="hb-install-tools.xml"/> |
| 197 | </chapter> |
215 | </chapter> |
| 198 | |
216 | |
| 199 | <chapter> |
217 | <chapter> |
| 200 | <title>Configuring the Bootloader</title> |
218 | <title>Configuring the Bootloader</title> |
| 201 | <abstract> |
219 | <abstract> |
| … | |
… | |
| 206 | </abstract> |
224 | </abstract> |
| 207 | <include href="hb-install-alpha-bootloader.xml"/> |
225 | <include href="hb-install-alpha-bootloader.xml"/> |
| 208 | </chapter> |
226 | </chapter> |
| 209 | |
227 | |
| 210 | <chapter> |
228 | <chapter> |
| 211 | <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 | <title>Finalizing your Gentoo Installation</title> |
229 | <title>Finalizing your Gentoo Installation</title> |
| 221 | <abstract> |
230 | <abstract> |
| 222 | You're almost done. We'll just create one (or more) users for your |
231 | You're almost done. We'll just create one (or more) users for your |
| 223 | system and leave the installation to reboot into a brand new Gentoo |
|
|
| 224 | system. |
232 | system. |
| 225 | </abstract> |
233 | </abstract> |
| 226 | <include href="hb-install-finalise.xml"/> |
234 | <include href="hb-install-finalise.xml"/> |
| 227 | </chapter> |
235 | </chapter> |
| 228 | |
236 | |
| … | |
… | |
| 237 | |
245 | |
| 238 | <part> |
246 | <part> |
| 239 | <title>Working with Gentoo</title> |
247 | <title>Working with Gentoo</title> |
| 240 | <abstract> |
248 | <abstract> |
| 241 | Learn how to work with Gentoo: installing software, altering variables, changing |
249 | Learn how to work with Gentoo: installing software, altering variables, changing |
| 242 | portage behaviour etc. |
250 | Portage behaviour etc. |
|
|
251 | </abstract> |
|
|
252 | |
|
|
253 | <chapter> |
|
|
254 | <title>A Portage Introduction</title> |
| 243 | </abstract> |
255 | <abstract> |
|
|
256 | This chapter explains the "simple" steps a user definitely needs to know to |
|
|
257 | maintain the software on his system. |
|
|
258 | </abstract> |
|
|
259 | <include href="hb-working-portage.xml"/> |
|
|
260 | </chapter> |
| 244 | |
261 | |
| 245 | <chapter> |
262 | <chapter> |
| 246 | <title>USE flags</title> |
263 | <title>USE flags</title> |
| 247 | <abstract> |
264 | <abstract> |
| 248 | USE-flags are a very important aspect of Gentoo. In this chapter, you learn to |
265 | USE-flags are a very important aspect of Gentoo. In this chapter, you learn to |
| … | |
… | |
| 250 | </abstract> |
267 | </abstract> |
| 251 | <include href="hb-working-use.xml"/> |
268 | <include href="hb-working-use.xml"/> |
| 252 | </chapter> |
269 | </chapter> |
| 253 | |
270 | |
| 254 | <chapter> |
271 | <chapter> |
| 255 | <title>Portage and Software</title> |
|
|
| 256 | <abstract> |
|
|
| 257 | The main reason for portage is to maintain the software on your system. In this |
|
|
| 258 | chapter you learn how to get information from a package, update your package |
|
|
| 259 | database, install/remove/update software and more... |
|
|
| 260 | </abstract> |
|
|
| 261 | <include href="hb-working-portage.xml"/> |
|
|
| 262 | </chapter> |
|
|
| 263 | |
|
|
| 264 | <chapter> |
|
|
| 265 | <title>Portage Features</title> |
272 | <title>Portage Features</title> |
| 266 | <abstract> |
273 | <abstract> |
| 267 | Gentoo's Portage allows for several features that improve portage-related |
274 | Discover the features Portage has, such as support for distributed compiling, |
| 268 | aspects, such as build time. This chapter explains the existing features. |
275 | ccache and more. |
| 269 | </abstract> |
276 | </abstract> |
| 270 | <include href="hb-working-features.xml"/> |
277 | <include href="hb-working-features.xml"/> |
| 271 | </chapter> |
|
|
| 272 | |
|
|
| 273 | <chapter> |
|
|
| 274 | <title>Controlling Portage Behaviour</title> |
|
|
| 275 | <abstract> |
|
|
| 276 | You can tweak Portage to your own needs/environment. Learn how to protect files, |
|
|
| 277 | select mirrors, change directory locations and more. |
|
|
| 278 | </abstract> |
|
|
| 279 | <include href="hb-working-behaviour.xml"/> |
|
|
| 280 | </chapter> |
278 | </chapter> |
| 281 | |
279 | |
| 282 | <chapter> |
280 | <chapter> |
| 283 | <title>Initscripts</title> |
281 | <title>Initscripts</title> |
| 284 | <abstract> |
282 | <abstract> |
| … | |
… | |
| 298 | </abstract> |
296 | </abstract> |
| 299 | <include href="hb-working-variables.xml"/> |
297 | <include href="hb-working-variables.xml"/> |
| 300 | </chapter> |
298 | </chapter> |
| 301 | </part> |
299 | </part> |
| 302 | |
300 | |
|
|
301 | <part> |
|
|
302 | <title>Working with Portage</title> |
|
|
303 | <abstract> |
|
|
304 | "Working with Portage" provides an in-depth coverage of Portage, Gentoo's |
|
|
305 | Software Management Tool. |
|
|
306 | </abstract> |
|
|
307 | |
|
|
308 | <chapter> |
|
|
309 | <title>Files and Directories</title> |
|
|
310 | <abstract> |
|
|
311 | Once you want to know Portage in-depth you need to know where it stores its |
|
|
312 | files and data. |
|
|
313 | </abstract> |
|
|
314 | <include href="hb-portage-files.xml"/> |
|
|
315 | </chapter> |
|
|
316 | |
|
|
317 | <chapter> |
|
|
318 | <title>Configuring through Variables</title> |
|
|
319 | <abstract> |
|
|
320 | Portage is completely configurable through various variables you can set in the |
|
|
321 | configuration file or as environment variable. |
|
|
322 | </abstract> |
|
|
323 | <include href="hb-portage-configuration.xml"/> |
|
|
324 | </chapter> |
|
|
325 | |
|
|
326 | <chapter> |
|
|
327 | <title>Mixing Software Branches</title> |
|
|
328 | <abstract> |
|
|
329 | Gentoo provides software separated in several branches, depending on stability |
|
|
330 | and architectural support. "Mixing Software Branches" inform you how these |
|
|
331 | branches can be configured and how you can override this separation |
|
|
332 | individually. |
|
|
333 | </abstract> |
|
|
334 | <include href="hb-portage-branches.xml"/> |
|
|
335 | </chapter> |
|
|
336 | |
|
|
337 | <chapter> |
|
|
338 | <title>Additional Portage Tools</title> |
|
|
339 | <abstract> |
|
|
340 | Portage comes with a few extra tools that might make your Gentoo experience even |
|
|
341 | better. Read on to discover how to use dispatch-conf and other tools. |
|
|
342 | </abstract> |
|
|
343 | <include href="hb-portage-tools.xml"/> |
|
|
344 | </chapter> |
|
|
345 | |
|
|
346 | <chapter> |
|
|
347 | <title>Diverting from the Official Tree</title> |
|
|
348 | <abstract> |
|
|
349 | "Diverting from the Official Tree" gives you some tips and tricks on how to use |
|
|
350 | your own Portage tree, how to synchronise only the categories you want, inject |
|
|
351 | packages and more. |
|
|
352 | </abstract> |
|
|
353 | <include href="hb-portage-diverttree.xml"/> |
|
|
354 | </chapter> |
|
|
355 | |
|
|
356 | <chapter> |
|
|
357 | <title>The Ebuild Application</title> |
|
|
358 | <abstract> |
|
|
359 | In "The Ebuild Application" you are informed about the steps Portage takes while |
|
|
360 | installing software and how you can do this yourself using the ebuild |
|
|
361 | application. |
|
|
362 | </abstract> |
|
|
363 | <include href="hb-portage-ebuild.xml"/> |
|
|
364 | </chapter> |
|
|
365 | </part> |
|
|
366 | |
|
|
367 | <part> |
|
|
368 | <title>Gentoo Network Configuration</title> |
|
|
369 | <abstract>A comprehensive guide to Networking in Gentoo.</abstract> |
|
|
370 | |
|
|
371 | <chapter> |
|
|
372 | <title>Getting Started</title> |
|
|
373 | <abstract> |
|
|
374 | A guide to quickly get your network interface up and running in most common |
|
|
375 | environments. |
|
|
376 | </abstract> |
|
|
377 | <include href="hb-net-start.xml"/> |
|
|
378 | </chapter> |
|
|
379 | |
|
|
380 | <chapter> |
|
|
381 | <title>Advanced Configuration</title> |
|
|
382 | <abstract> |
|
|
383 | Here we learn about how the configuration works - you need to know this |
|
|
384 | before we learn about modular networking. |
|
|
385 | </abstract> |
|
|
386 | <include href="hb-net-advanced.xml"/> |
|
|
387 | </chapter> |
|
|
388 | |
|
|
389 | <chapter> |
|
|
390 | <title>Modular Networking</title> |
|
|
391 | <abstract> |
|
|
392 | Gentoo provides you flexible networking - here you are told about choosing |
|
|
393 | different DHCP clients, setting up bonding, bridging, VLANs and more. |
|
|
394 | </abstract> |
|
|
395 | <include href="hb-net-modules.xml"/> |
|
|
396 | </chapter> |
|
|
397 | |
|
|
398 | <chapter> |
|
|
399 | <title>Wireless Networking</title> |
|
|
400 | <abstract> |
|
|
401 | Wireless isn't straight-forward. Hopefully we'll get you working! |
|
|
402 | </abstract> |
|
|
403 | <include href="hb-net-wireless.xml"/> |
|
|
404 | </chapter> |
|
|
405 | |
|
|
406 | <chapter> |
|
|
407 | <title>Adding Functionality</title> |
|
|
408 | <abstract> |
|
|
409 | If you're feeling adventurous, you can add your own functions to networking. |
|
|
410 | </abstract> |
|
|
411 | <include href="hb-net-functions.xml"/> |
|
|
412 | </chapter> |
|
|
413 | |
|
|
414 | <chapter> |
|
|
415 | <title>Network Management</title> |
|
|
416 | <abstract> |
|
|
417 | For laptop users or people who move their computer around different networks. |
|
|
418 | </abstract> |
|
|
419 | <include href="hb-net-management.xml"/> |
|
|
420 | </chapter> |
|
|
421 | </part> |
|
|
422 | |
| 303 | </book> |
423 | </book> |