1 |
neysx |
1.1 |
<?xml version='1.0' encoding='UTF-8'?> |
2 |
|
|
<!DOCTYPE book SYSTEM "/dtd/book.dtd"> |
3 |
|
|
|
4 |
nightmorph |
1.134 |
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-amd64.xml,v 1.133 2006/08/30 22:52:28 nightmorph Exp $ --> |
5 |
neysx |
1.1 |
|
6 |
neysx |
1.129 |
<book link="/doc/en/handbook/handbook-amd64.xml"> |
7 |
swift |
1.121 |
<title>Gentoo Linux AMD64 Handbook</title> |
8 |
neysx |
1.1 |
|
9 |
neysx |
1.131 |
<values> |
10 |
|
|
<key id="arch">AMD64</key> |
11 |
|
|
<key id="arch-sub">x86_64</key> |
12 |
|
|
<key id="/boot">/dev/hda1</key> |
13 |
nightmorph |
1.133 |
<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 |
neysx |
1.131 |
<key id="min-cd-size">45</key> |
19 |
nightmorph |
1.133 |
<key id="uni-cd-name">livecd-amd64-installer-2006.1.iso></key> |
20 |
neysx |
1.131 |
<key id="uni-cd-size">401</key> |
21 |
nightmorph |
1.133 |
<key id="release-dir">releases/amd64/2006.1/</key> |
22 |
neysx |
1.131 |
<key id="online-book">handbook-amd64.xml</key> |
23 |
|
|
</values> |
24 |
|
|
|
25 |
swift |
1.105 |
<author title="Author"> |
26 |
swift |
1.112 |
<mail link="swift@gentoo.org">Sven Vermeulen</mail> |
27 |
neysx |
1.1 |
</author> |
28 |
|
|
<author title="Author"> |
29 |
swift |
1.123 |
<mail link="uberlord@gentoo.org">Roy Marples</mail> |
30 |
|
|
</author> |
31 |
|
|
<author title="Author"> |
32 |
swift |
1.112 |
<mail link="drobbins@gentoo.org">Daniel Robbins</mail> |
33 |
neysx |
1.1 |
</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 |
swift |
1.124 |
</author><!-- Does not want to be listed on the rendered page |
46 |
|
|
<author title="Gentoo Developer"> |
47 |
|
|
Aron Griffis |
48 |
neysx |
1.1 |
</author> |
49 |
swift |
1.124 |
--> |
50 |
neysx |
1.1 |
<author title="Gentoo AMD64 Developer"> |
51 |
dertobi123 |
1.47 |
<mail link="jhuebel@gentoo.org">Jason Huebel</mail> |
52 |
neysx |
1.1 |
</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 |
dertobi123 |
1.47 |
<author title="Editor"> |
109 |
|
|
<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail> |
110 |
|
|
</author> |
111 |
neysx |
1.125 |
<author title="Editor"> |
112 |
|
|
<mail link="neysx@gentoo.org">Xavier Neys</mail> |
113 |
|
|
</author> |
114 |
neysx |
1.1 |
<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 |
neysx |
1.130 |
<mail link="dberkholz@gentoo.org">Donnie Berkholz</mail> |
122 |
neysx |
1.1 |
</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 |
jkt |
1.127 |
This is the Gentoo Handbook, an effort to centralize Gentoo/Linux information. |
132 |
|
|
This handbook contains the installation instructions for an Internet-based |
133 |
neysx |
1.125 |
installation on AMD64 systems and parts about working with Gentoo and Portage. |
134 |
neysx |
1.1 |
</abstract> |
135 |
|
|
|
136 |
|
|
<!-- The content of this document is licensed under the CC-BY-SA license --> |
137 |
neysx |
1.125 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
138 |
neysx |
1.1 |
<license/> |
139 |
|
|
|
140 |
nightmorph |
1.133 |
<version>7.0</version> |
141 |
|
|
<date>2006-08-30</date> |
142 |
neysx |
1.1 |
|
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 |
swift |
1.121 |
This chapter introduces you to the installation approach documented in this |
153 |
|
|
part. |
154 |
neysx |
1.1 |
</abstract> |
155 |
|
|
<include href="hb-install-about.xml"/> |
156 |
|
|
</chapter> |
157 |
|
|
|
158 |
|
|
<chapter> |
159 |
|
|
<title>Choosing the Right Installation Medium</title> |
160 |
|
|
<abstract> |
161 |
nightmorph |
1.133 |
You can install Gentoo in many ways. This chapter explains how to install |
162 |
|
|
Gentoo using the minimal Installation CD although installation through the |
163 |
|
|
Installer LiveCD is possible as well. |
164 |
neysx |
1.1 |
</abstract> |
165 |
neysx |
1.131 |
<include href="hb-install-x86+amd64-medium.xml"/> |
166 |
neysx |
1.1 |
</chapter> |
167 |
|
|
|
168 |
|
|
<chapter> |
169 |
|
|
<title>Configuring your Network</title> |
170 |
|
|
<abstract> |
171 |
swift |
1.121 |
To be able to download the latest source code, you will need to setup |
172 |
neysx |
1.1 |
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 |
neysx |
1.131 |
<include href="hb-install-x86+amd64-disk.xml"/> |
184 |
neysx |
1.1 |
</chapter> |
185 |
|
|
|
186 |
|
|
<chapter> |
187 |
|
|
<title>Installing the Gentoo Installation Files</title> |
188 |
|
|
<abstract> |
189 |
swift |
1.126 |
Gentoo installs work through a stage3 archive. In this chapter we |
190 |
|
|
describe how you extract the stage3 archive and configure Portage. |
191 |
neysx |
1.1 |
</abstract> |
192 |
|
|
<include href="hb-install-stage.xml"/> |
193 |
|
|
</chapter> |
194 |
|
|
|
195 |
|
|
<chapter> |
196 |
|
|
<title>Installing the Gentoo Base System</title> |
197 |
|
|
<abstract> |
198 |
jkt |
1.128 |
After installing and configuring a stage3, the eventual result is that you |
199 |
neysx |
1.1 |
have a Gentoo base system at your disposal. This chapter describes how |
200 |
nightmorph |
1.134 |
to progress to that state. |
201 |
neysx |
1.1 |
</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 |
neysx |
1.131 |
<include href="hb-install-x86+amd64-kernel.xml"/> |
212 |
neysx |
1.1 |
</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 |
swift |
1.70 |
<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 |
neysx |
1.1 |
<title>Configuring the Bootloader</title> |
235 |
|
|
<abstract> |
236 |
swift |
1.4 |
In this chapter we'll describe the GRUB bootloader |
237 |
|
|
and step you through the process of configuring GRUB to your |
238 |
neysx |
1.1 |
needs. |
239 |
|
|
</abstract> |
240 |
neysx |
1.131 |
<include href="hb-install-x86+amd64-bootloader.xml"/> |
241 |
neysx |
1.1 |
</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 |
swift |
1.121 |
system. |
248 |
neysx |
1.1 |
</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 |
swift |
1.111 |
Portage behaviour etc. |
266 |
neysx |
1.1 |
</abstract> |
267 |
|
|
|
268 |
|
|
<chapter> |
269 |
swift |
1.110 |
<title>A Portage Introduction</title> |
270 |
neysx |
1.1 |
<abstract> |
271 |
swift |
1.110 |
This chapter explains the "simple" steps a user definitely needs to know to |
272 |
|
|
maintain the software on his system. |
273 |
neysx |
1.1 |
</abstract> |
274 |
swift |
1.110 |
<include href="hb-working-portage.xml"/> |
275 |
neysx |
1.1 |
</chapter> |
276 |
|
|
|
277 |
|
|
<chapter> |
278 |
swift |
1.110 |
<title>USE flags</title> |
279 |
neysx |
1.1 |
<abstract> |
280 |
swift |
1.110 |
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 |
neysx |
1.1 |
</abstract> |
283 |
swift |
1.110 |
<include href="hb-working-use.xml"/> |
284 |
neysx |
1.1 |
</chapter> |
285 |
|
|
|
286 |
|
|
<chapter> |
287 |
|
|
<title>Portage Features</title> |
288 |
|
|
<abstract> |
289 |
swift |
1.110 |
Discover the features Portage has, such as support for distributed compiling, |
290 |
|
|
ccache and more. |
291 |
neysx |
1.1 |
</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 |
swift |
1.110 |
<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 |
swift |
1.112 |
Once you want to know Portage in-depth you need to know where it stores its |
327 |
swift |
1.110 |
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 |
swift |
1.123 |
<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 |
|
|
|
428 |
neysx |
1.1 |
</book> |