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