1 |
<?xml version='1.0' encoding='UTF-8'?> |
2 |
<!DOCTYPE book SYSTEM "/dtd/book.dtd"> |
3 |
|
4 |
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-amd64.xml,v 1.129 2006/03/06 09:18:31 neysx Exp $ --> |
5 |
|
6 |
<book link="/doc/en/handbook/handbook-amd64.xml"> |
7 |
<title>Gentoo Linux AMD64 Handbook</title> |
8 |
|
9 |
<values> |
10 |
<key id="arch">AMD64</key> |
11 |
<key id="arch-sub">x86_64</key> |
12 |
<key id="/boot">/dev/hda1</key> |
13 |
<key id="kernel-version">2.6.12-r10</key> |
14 |
<key id="kernel-name">kernel-2.6.12-gentoo-r10</key> |
15 |
<key id="genkernel-name">kernel-genkernel-amd64-2.6.12-gentoo-r10</key> |
16 |
<key id="genkernel-initrd">initramfs-genkernel-amd64-2.6.12-gentoo-r10</key> |
17 |
<key id="min-cd-name">install-amd64-minimal-2006.0.iso</key> |
18 |
<key id="min-cd-size">45</key> |
19 |
<key id="uni-cd-name">install-amd64-universal-2006.0.iso</key> |
20 |
<key id="uni-cd-size">401</key> |
21 |
<key id="release-dir">releases/amd64/2006.0/</key> |
22 |
<key id="online-book">handbook-amd64.xml</key> |
23 |
</values> |
24 |
|
25 |
<author title="Author"> |
26 |
<mail link="swift@gentoo.org">Sven Vermeulen</mail> |
27 |
</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"> |
35 |
<mail link="chouser@gentoo.org">Chris Houser</mail> |
36 |
</author> |
37 |
<author title="Author"> |
38 |
<mail link="jerry@gentoo.org">Jerry Alexandratos</mail> |
39 |
</author> |
40 |
<author title="Gentoo x86 Developer"> |
41 |
<mail link="seemant@gentoo.org">Seemant Kulleen</mail> |
42 |
</author> |
43 |
<author title="Gentoo Alpha Developer"> |
44 |
<mail link="taviso@gentoo.org">Tavis Ormandy</mail> |
45 |
</author><!-- Does not want to be listed on the rendered page |
46 |
<author title="Gentoo Developer"> |
47 |
Aron Griffis |
48 |
</author> |
49 |
--> |
50 |
<author title="Gentoo AMD64 Developer"> |
51 |
<mail link="jhuebel@gentoo.org">Jason Huebel</mail> |
52 |
</author> |
53 |
<author title="Gentoo HPPA developer"> |
54 |
<mail link="gmsoft@gentoo.org">Guy Martin</mail> |
55 |
</author> |
56 |
<author title="Gentoo PPC developer"> |
57 |
<mail link="pvdabeel@gentoo.org">Pieter Van den Abeele</mail> |
58 |
</author> |
59 |
<author title="Gentoo SPARC developer"> |
60 |
<mail link="blademan@gentoo.org">Joe Kallar</mail> |
61 |
</author> |
62 |
<author title="Editor"> |
63 |
<mail link="zhen@gentoo.org">John P. Davis</mail> |
64 |
</author> |
65 |
<author title="Editor">Pierre-Henri Jondot</author> |
66 |
<author title="Editor"> |
67 |
<mail link="stocke2@gentoo.org">Eric Stockbridge</mail> |
68 |
</author> |
69 |
<author title="Editor"> |
70 |
<mail link="rajiv@gentoo.org">Rajiv Manglani</mail> |
71 |
</author> |
72 |
<author title="Editor"> |
73 |
<mail link="seo@gentoo.org">Jungmin Seo</mail> |
74 |
</author> |
75 |
<author title="Editor"> |
76 |
<mail link="zhware@gentoo.org">Stoyan Zhekov</mail> |
77 |
</author> |
78 |
<author title="Editor"> |
79 |
<mail link="jhhudso@gentoo.org">Jared Hudson</mail> |
80 |
</author> |
81 |
<author title="Editor"> |
82 |
<mail link="peitolm@gentoo.org">Colin Morey</mail> |
83 |
</author> |
84 |
<author title="Editor"> |
85 |
<mail link="peesh@gentoo.org">Jorge Paulo</mail> |
86 |
</author> |
87 |
<author title="Editor"> |
88 |
<mail link="carl@gentoo.org">Carl Anderson</mail> |
89 |
</author> |
90 |
<author title="Editor"> |
91 |
<mail link="avenj@gentoo.org">Jon Portnoy</mail> |
92 |
</author> |
93 |
<author title="Editor"> |
94 |
<mail link="klasikahl@gentoo.org">Zack Gilburd</mail> |
95 |
</author> |
96 |
<author title="Editor"> |
97 |
<mail link="jmorgan@gentoo.org">Jack Morgan</mail> |
98 |
</author> |
99 |
<author title="Editor"> |
100 |
<mail link="bennyc@gentoo.org">Benny Chuang</mail> |
101 |
</author> |
102 |
<author title="Editor"> |
103 |
<mail link="erwin@gentoo.org">Erwin</mail> |
104 |
</author> |
105 |
<author title="Editor"> |
106 |
<mail link="kumba@gentoo.org">Joshua Kinard</mail> |
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> |
114 |
<author title="Reviewer"> |
115 |
<mail link="g2boojum@gentoo.org">Grant Goodyear</mail> |
116 |
</author> |
117 |
<author title="Reviewer"> |
118 |
<mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail> |
119 |
</author> |
120 |
<author title="Reviewer"> |
121 |
<mail link="dberkholz@gentoo.org">Donnie Berkholz</mail> |
122 |
</author> |
123 |
<author title="Reviewer"> |
124 |
<mail link="antifa@gentoo.org">Ken Nowack</mail> |
125 |
</author> |
126 |
<author title="Contributor"> |
127 |
<mail link="pylon@gentoo.org">Lars Weiler</mail> |
128 |
</author> |
129 |
|
130 |
<abstract> |
131 |
This is the Gentoo Handbook, an effort to centralize Gentoo/Linux 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. |
134 |
</abstract> |
135 |
|
136 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
137 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
138 |
<license/> |
139 |
|
140 |
<version>4.4</version> |
141 |
<date>2006-07-26</date> |
142 |
|
143 |
<part> |
144 |
<title>Installing Gentoo</title> |
145 |
<abstract> |
146 |
In this part you learn how to install Gentoo on your system. |
147 |
</abstract> |
148 |
|
149 |
<chapter> |
150 |
<title>About the Gentoo Linux Installation</title> |
151 |
<abstract> |
152 |
This chapter introduces you to the installation approach documented in this |
153 |
part. |
154 |
</abstract> |
155 |
<include href="hb-install-about.xml"/> |
156 |
</chapter> |
157 |
|
158 |
<chapter> |
159 |
<title>Choosing the Right Installation Medium</title> |
160 |
<abstract> |
161 |
You can install Gentoo in many ways. This chapter explains how to install Gentoo |
162 |
using the minimal Installation CD although installation through the Universal |
163 |
Installation CD is possible as well. |
164 |
</abstract> |
165 |
<include href="hb-install-x86+amd64-medium.xml"/> |
166 |
</chapter> |
167 |
|
168 |
<chapter> |
169 |
<title>Configuring your Network</title> |
170 |
<abstract> |
171 |
To be able to download the latest source code, you will need to setup |
172 |
networking. |
173 |
</abstract> |
174 |
<include href="hb-install-network.xml"/> |
175 |
</chapter> |
176 |
|
177 |
<chapter> |
178 |
<title>Preparing the Disks</title> |
179 |
<abstract> |
180 |
To be able to install Gentoo, you must create the necessary partitions. |
181 |
This chapter describes how to partition a disk for future usage. |
182 |
</abstract> |
183 |
<include href="hb-install-x86+amd64-disk.xml"/> |
184 |
</chapter> |
185 |
|
186 |
<chapter> |
187 |
<title>Installing the Gentoo Installation Files</title> |
188 |
<abstract> |
189 |
Gentoo installs work through a stage3 archive. In this chapter we |
190 |
describe how you extract the stage3 archive and configure Portage. |
191 |
</abstract> |
192 |
<include href="hb-install-stage.xml"/> |
193 |
</chapter> |
194 |
|
195 |
<chapter> |
196 |
<title>Installing the Gentoo Base System</title> |
197 |
<abstract> |
198 |
After installing and configuring a stage3, the eventual result is that you |
199 |
have a Gentoo base system at your disposal. This chapter describes how |
200 |
to progress to that stadium. |
201 |
</abstract> |
202 |
<include href="hb-install-system.xml"/> |
203 |
</chapter> |
204 |
|
205 |
<chapter> |
206 |
<title>Configuring the Kernel</title> |
207 |
<abstract> |
208 |
The Linux kernel is the core of every distribution. This chapter |
209 |
explains how to configure your kernel. |
210 |
</abstract> |
211 |
<include href="hb-install-x86+amd64-kernel.xml"/> |
212 |
</chapter> |
213 |
|
214 |
<chapter> |
215 |
<title>Configuring your System</title> |
216 |
<abstract> |
217 |
You need to edit some important configuration files. In this chapter |
218 |
you receive an overview of these files and an explanation on how to |
219 |
proceed. |
220 |
</abstract> |
221 |
<include href="hb-install-config.xml"/> |
222 |
</chapter> |
223 |
|
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> |
234 |
<title>Configuring the Bootloader</title> |
235 |
<abstract> |
236 |
In this chapter we'll describe the GRUB bootloader |
237 |
and step you through the process of configuring GRUB to your |
238 |
needs. |
239 |
</abstract> |
240 |
<include href="hb-install-x86+amd64-bootloader.xml"/> |
241 |
</chapter> |
242 |
|
243 |
<chapter> |
244 |
<title>Finalizing your Gentoo Installation</title> |
245 |
<abstract> |
246 |
You're almost done. We'll just create one (or more) users for your |
247 |
system. |
248 |
</abstract> |
249 |
<include href="hb-install-finalise.xml"/> |
250 |
</chapter> |
251 |
|
252 |
<chapter> |
253 |
<title>Where to go from here?</title> |
254 |
<abstract> |
255 |
Now you have your Gentoo system, but what's next? |
256 |
</abstract> |
257 |
<include href="hb-install-next.xml"/> |
258 |
</chapter> |
259 |
</part> |
260 |
|
261 |
<part> |
262 |
<title>Working with Gentoo</title> |
263 |
<abstract> |
264 |
Learn how to work with Gentoo: installing software, altering variables, changing |
265 |
Portage behaviour etc. |
266 |
</abstract> |
267 |
|
268 |
<chapter> |
269 |
<title>A Portage Introduction</title> |
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> |
276 |
|
277 |
<chapter> |
278 |
<title>USE flags</title> |
279 |
<abstract> |
280 |
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to |
281 |
work with USE-flags and understand how USE-flags interact with your system. |
282 |
</abstract> |
283 |
<include href="hb-working-use.xml"/> |
284 |
</chapter> |
285 |
|
286 |
<chapter> |
287 |
<title>Portage Features</title> |
288 |
<abstract> |
289 |
Discover the features Portage has, such as support for distributed compiling, |
290 |
ccache and more. |
291 |
</abstract> |
292 |
<include href="hb-working-features.xml"/> |
293 |
</chapter> |
294 |
|
295 |
<chapter> |
296 |
<title>Initscripts</title> |
297 |
<abstract> |
298 |
Gentoo uses a special initscript format which, amongst other features, allows |
299 |
dependency-driven decisions and virtual initscripts. This chapter explains all |
300 |
these aspects and explains how to deal with these scripts. |
301 |
</abstract> |
302 |
<include href="hb-working-rcscripts.xml"/> |
303 |
</chapter> |
304 |
|
305 |
<chapter> |
306 |
<title>Environment Variables</title> |
307 |
<abstract> |
308 |
With Gentoo you can easily manage the environment variables for your system. |
309 |
This chapter explains how you do that, and also describes frequently used |
310 |
variables. |
311 |
</abstract> |
312 |
<include href="hb-working-variables.xml"/> |
313 |
</chapter> |
314 |
</part> |
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 |
|
371 |
<chapter> |
372 |
<title>The Ebuild Application</title> |
373 |
<abstract> |
374 |
In "The Ebuild Application" you are informed about the steps Portage takes while |
375 |
installing software and how you can do this yourself using the ebuild |
376 |
application. |
377 |
</abstract> |
378 |
<include href="hb-portage-ebuild.xml"/> |
379 |
</chapter> |
380 |
</part> |
381 |
|
382 |
<part> |
383 |
<title>Gentoo Network Configuration</title> |
384 |
<abstract>A comprehensive guide to Networking in Gentoo.</abstract> |
385 |
|
386 |
<chapter> |
387 |
<title>Getting Started</title> |
388 |
<abstract> |
389 |
A guide to quickly get your network interface up and running in most common |
390 |
environments. |
391 |
</abstract> |
392 |
<include href="hb-net-start.xml"/> |
393 |
</chapter> |
394 |
|
395 |
<chapter> |
396 |
<title>Advanced Configuration</title> |
397 |
<abstract> |
398 |
Here we learn about how the configuration works - you need to know this |
399 |
before we learn about modular networking. |
400 |
</abstract> |
401 |
<include href="hb-net-advanced.xml"/> |
402 |
</chapter> |
403 |
|
404 |
<chapter> |
405 |
<title>Modular Networking</title> |
406 |
<abstract> |
407 |
Gentoo provides you flexible networking - here you are told about choosing |
408 |
different DHCP clients, setting up bonding, bridging, VLANs and more. |
409 |
</abstract> |
410 |
<include href="hb-net-modules.xml"/> |
411 |
</chapter> |
412 |
|
413 |
<chapter> |
414 |
<title>Wireless Networking</title> |
415 |
<abstract> |
416 |
Wireless isn't straight-forward. Hopefully we'll get you working! |
417 |
</abstract> |
418 |
<include href="hb-net-wireless.xml"/> |
419 |
</chapter> |
420 |
|
421 |
<chapter> |
422 |
<title>Adding Functionality</title> |
423 |
<abstract> |
424 |
If you're feeling adventurous, you can add your own functions to networking. |
425 |
</abstract> |
426 |
<include href="hb-net-functions.xml"/> |
427 |
</chapter> |
428 |
|
429 |
<chapter> |
430 |
<title>Network Management</title> |
431 |
<abstract> |
432 |
For laptop users or people who move their computer around different networks. |
433 |
</abstract> |
434 |
<include href="hb-net-management.xml"/> |
435 |
</chapter> |
436 |
</part> |
437 |
|
438 |
</book> |