/[gentoo]/xml/htdocs/doc/en/handbook/handbook-amd64.xml
Gentoo

Diff of /xml/htdocs/doc/en/handbook/handbook-amd64.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.129 Revision 1.152
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.129 2006/03/06 09:18:31 neysx Exp $ --> 4<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-amd64.xml,v 1.152 2009/12/29 19:59:18 nightmorph Exp $ -->
5 5
6<book link="/doc/en/handbook/handbook-amd64.xml"> 6<book>
7<title>Gentoo Linux AMD64 Handbook</title> 7<title>Gentoo Linux AMD64 Handbook</title>
8 8
9<values>
10 <key id="arch">AMD64</key>
11 <key id="arch-sub">x86_64</key>
12 <key id="/boot">/dev/sda1</key>
13 <key id="kernel-version">2.6.31-r6</key>
14 <key id="kernel-name">kernel-2.6.31-gentoo-r6</key>
15 <key id="genkernel-name">kernel-genkernel-amd64-2.6.31-gentoo-r6</key>
16 <key id="genkernel-initrd">initramfs-genkernel-amd64-2.6.31-gentoo-r6</key>
17 <key id="min-cd-name">install-amd64-minimal-&lt;release&gt;.iso</key>
18 <key id="min-cd-size">119</key>
19 <key id="release-dir">releases/amd64/autobuilds/</key>
20 <key id="stage3">stage3-amd64-&lt;release&gt;.tar.bz2</key>
21 <key id="profile">default/linux/amd64/10.0</key>
22 <key id="CFLAGS">-march=k8 -O2 -pipe</key>
23 <key id="online-book">handbook-amd64.xml</key>
24</values>
25
9<author title="Author"> 26<author title="Author">
10 <mail link="swift@gentoo.org">Sven Vermeulen</mail> 27 <mail link="swift@gentoo.org">Sven Vermeulen</mail>
28</author>
29<author title="Author">
30 <mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
11</author> 31</author>
12<author title="Author"> 32<author title="Author">
13 <mail link="uberlord@gentoo.org">Roy Marples</mail> 33 <mail link="uberlord@gentoo.org">Roy Marples</mail>
14</author> 34</author>
15<author title="Author"> 35<author title="Author">
… …
93 <mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail> 113 <mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
94</author> 114</author>
95<author title="Editor"> 115<author title="Editor">
96 <mail link="neysx@gentoo.org">Xavier Neys</mail> 116 <mail link="neysx@gentoo.org">Xavier Neys</mail>
97</author> 117</author>
98<author title="Reviewer"> 118<author title="Editor">
99 <mail link="g2boojum@gentoo.org">Grant Goodyear</mail> 119 <mail link="nightmorph@gentoo.org">Joshua Saddler</mail>
100</author> 120</author>
101<author title="Reviewer"> 121<author title="Reviewer">
102 <mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail> 122 <mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail>
103</author> 123</author>
104<author title="Reviewer"> 124<author title="Reviewer">
105 <mail link="spyderous@gentoo.org">Donnie Berkholz</mail> 125 <mail link="dberkholz@gentoo.org">Donnie Berkholz</mail>
106</author> 126</author>
107<author title="Reviewer"> 127<author title="Reviewer">
108 <mail link="antifa@gentoo.org">Ken Nowack</mail> 128 <mail link="antifa@gentoo.org">Ken Nowack</mail>
109</author> 129</author>
110<author title="Contributor"> 130<author title="Contributor">
… …
119 139
120<!-- The content of this document is licensed under the CC-BY-SA license --> 140<!-- The content of this document is licensed under the CC-BY-SA license -->
121<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 141<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
122<license/> 142<license/>
123 143
124<version>4.3</version> 144<version>10.1</version>
125<date>2005-12-19</date> 145<date>2009-12-29</date>
126 146
127<part> 147<part>
128<title>Installing Gentoo</title> 148<title>Installing Gentoo</title>
129<abstract> 149<abstract>
130In this part you learn how to install Gentoo on your system. 150In this part you learn how to install Gentoo on your system.
131</abstract> 151</abstract>
132 152
133<chapter> 153<chapter>
134<title>About the Gentoo Linux Installation</title> 154<title>About the Gentoo Linux Installation</title>
135<abstract>
136This chapter introduces you to the installation approach documented in this
137part.
138</abstract>
139 <include href="hb-install-about.xml"/> 155 <include href="hb-install-about.xml"/>
140</chapter> 156</chapter>
141 157
142<chapter> 158<chapter>
143<title>Choosing the Right Installation Medium</title> 159<title>Choosing the Right Installation Medium</title>
144<abstract>
145You can install Gentoo in many ways. This chapter explains how to install Gentoo
146using the minimal Installation CD although installation through the Universal
147Installation CD is possible as well.
148</abstract>
149 <include href="hb-install-amd64-medium.xml"/> 160 <include href="hb-install-x86+amd64-medium.xml"/>
150</chapter> 161</chapter>
151 162
152<chapter> 163<chapter>
153<title>Configuring your Network</title> 164<title>Configuring your Network</title>
154<abstract>
155To be able to download the latest source code, you will need to setup
156networking.
157</abstract>
158 <include href="hb-install-network.xml"/> 165 <include href="hb-install-network.xml"/>
159</chapter> 166</chapter>
160 167
161<chapter> 168<chapter>
162<title>Preparing the Disks</title> 169<title>Preparing the Disks</title>
163<abstract>
164To be able to install Gentoo, you must create the necessary partitions.
165This chapter describes how to partition a disk for future usage.
166</abstract>
167 <include href="hb-install-amd64-disk.xml"/> 170 <include href="hb-install-x86+amd64-disk.xml"/>
168</chapter> 171</chapter>
169 172
170<chapter> 173<chapter>
171<title>Installing the Gentoo Installation Files</title> 174<title>Installing the Gentoo Installation Files</title>
172<abstract>
173Gentoo installs work through a stage3 archive. In this chapter we
174describe how you extract the stage3 archive and configure Portage.
175</abstract>
176 <include href="hb-install-stage.xml"/> 175 <include href="hb-install-stage.xml"/>
177</chapter> 176</chapter>
178 177
179<chapter> 178<chapter>
180<title>Installing the Gentoo Base System</title> 179<title>Installing the Gentoo Base System</title>
181<abstract>
182After installing and configuring a stage3, the eventual result is that you
183have a Gentoo base system at your disposal. This chapter describes how
184to progress to that stadium.
185</abstract>
186 <include href="hb-install-system.xml"/> 180 <include href="hb-install-system.xml"/>
187</chapter> 181</chapter>
188 182
189<chapter> 183<chapter>
190<title>Configuring the Kernel</title> 184<title>Configuring the Kernel</title>
191<abstract>
192The Linux kernel is the core of every distribution. This chapter
193explains how to configure your kernel.
194</abstract>
195 <include href="hb-install-amd64-kernel.xml"/> 185 <include href="hb-install-x86+amd64-kernel.xml"/>
196</chapter> 186</chapter>
197 187
198<chapter> 188<chapter>
199<title>Configuring your System</title> 189<title>Configuring your System</title>
200<abstract>
201You need to edit some important configuration files. In this chapter
202you receive an overview of these files and an explanation on how to
203proceed.
204</abstract>
205 <include href="hb-install-config.xml"/> 190 <include href="hb-install-config.xml"/>
206</chapter> 191</chapter>
207 192
208<chapter> 193<chapter>
209<title>Installing Necessary System Tools</title> 194<title>Installing Necessary System Tools</title>
210<abstract>
211As mentioned before, Gentoo is about choices. In this chapter we help you
212choose and install some important tools.
213</abstract>
214 <include href="hb-install-tools.xml"/> 195 <include href="hb-install-tools.xml"/>
215</chapter> 196</chapter>
216 197
217<chapter> 198<chapter>
218<title>Configuring the Bootloader</title> 199<title>Configuring the Bootloader</title>
219<abstract> 200<abstract>
220In this chapter we'll describe the GRUB bootloader 201In this chapter we'll describe the GRUB bootloader
221and step you through the process of configuring GRUB to your 202and step you through the process of configuring GRUB to your
222needs. 203needs.
223</abstract> 204</abstract>
224 <include href="hb-install-amd64-bootloader.xml"/> 205 <include href="hb-install-x86+amd64-bootloader.xml"/>
225</chapter> 206</chapter>
226 207
227<chapter> 208<chapter>
228<title>Finalizing your Gentoo Installation</title> 209<title>Finalizing your Gentoo Installation</title>
229<abstract>
230You're almost done. We'll just create one (or more) users for your
231system.
232</abstract>
233 <include href="hb-install-finalise.xml"/> 210 <include href="hb-install-finalise.xml"/>
234</chapter> 211</chapter>
235 212
236<chapter> 213<chapter>
237<title>Where to go from here?</title> 214<title>Where to go from here?</title>
238<abstract>
239Now you have your Gentoo system, but what's next?
240</abstract>
241 <include href="hb-install-next.xml"/> 215 <include href="hb-install-next.xml"/>
242</chapter> 216</chapter>
243</part> 217</part>
244 218
245<part> 219<part>
… …
249Portage behaviour etc. 223Portage behaviour etc.
250</abstract> 224</abstract>
251 225
252<chapter> 226<chapter>
253<title>A Portage Introduction</title> 227<title>A Portage Introduction</title>
254<abstract>
255This chapter explains the "simple" steps a user definitely needs to know to
256maintain the software on his system.
257</abstract>
258 <include href="hb-working-portage.xml"/> 228 <include href="hb-working-portage.xml"/>
259</chapter> 229</chapter>
260 230
261<chapter> 231<chapter>
262<title>USE flags</title> 232<title>USE flags</title>
263<abstract>
264USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
265work with USE-flags and understand how USE-flags interact with your system.
266</abstract>
267 <include href="hb-working-use.xml"/> 233 <include href="hb-working-use.xml"/>
268</chapter> 234</chapter>
269 235
270<chapter> 236<chapter>
271<title>Portage Features</title> 237<title>Portage Features</title>
272<abstract>
273Discover the features Portage has, such as support for distributed compiling,
274ccache and more.
275</abstract>
276 <include href="hb-working-features.xml"/> 238 <include href="hb-working-features.xml"/>
277</chapter> 239</chapter>
278 240
279<chapter> 241<chapter>
280<title>Initscripts</title> 242<title>Initscripts</title>
281<abstract>
282Gentoo uses a special initscript format which, amongst other features, allows
283dependency-driven decisions and virtual initscripts. This chapter explains all
284these aspects and explains how to deal with these scripts.
285</abstract>
286 <include href="hb-working-rcscripts.xml"/> 243 <include href="hb-working-rcscripts.xml"/>
287</chapter> 244</chapter>
288 245
289<chapter> 246<chapter>
290<title>Environment Variables</title> 247<title>Environment Variables</title>
291<abstract>
292With Gentoo you can easily manage the environment variables for your system.
293This chapter explains how you do that, and also describes frequently used
294variables.
295</abstract>
296 <include href="hb-working-variables.xml"/> 248 <include href="hb-working-variables.xml"/>
297</chapter> 249</chapter>
298</part> 250</part>
299 251
300<part> 252<part>
… …
304Software Management Tool. 256Software Management Tool.
305</abstract> 257</abstract>
306 258
307<chapter> 259<chapter>
308<title>Files and Directories</title> 260<title>Files and Directories</title>
309<abstract>
310Once you want to know Portage in-depth you need to know where it stores its
311files and data.
312</abstract>
313 <include href="hb-portage-files.xml"/> 261 <include href="hb-portage-files.xml"/>
314</chapter> 262</chapter>
315 263
316<chapter> 264<chapter>
317<title>Configuring through Variables</title> 265<title>Configuring through Variables</title>
318<abstract>
319Portage is completely configurable through various variables you can set in the
320configuration file or as environment variable.
321</abstract>
322 <include href="hb-portage-configuration.xml"/> 266 <include href="hb-portage-configuration.xml"/>
323</chapter> 267</chapter>
324 268
325<chapter> 269<chapter>
326<title>Mixing Software Branches</title> 270<title>Mixing Software Branches</title>
327<abstract>
328Gentoo provides software separated in several branches, depending on stability
329and architectural support. "Mixing Software Branches" inform you how these
330branches can be configured and how you can override this separation
331individually.
332</abstract>
333 <include href="hb-portage-branches.xml"/> 271 <include href="hb-portage-branches.xml"/>
334</chapter> 272</chapter>
335 273
336<chapter> 274<chapter>
337<title>Additional Portage Tools</title> 275<title>Additional Portage Tools</title>
338<abstract>
339Portage comes with a few extra tools that might make your Gentoo experience even
340better. Read on to discover how to use dispatch-conf and other tools.
341</abstract>
342 <include href="hb-portage-tools.xml"/> 276 <include href="hb-portage-tools.xml"/>
343</chapter> 277</chapter>
344 278
345<chapter> 279<chapter>
346<title>Diverting from the Official Tree</title> 280<title>Diverting from the Official Tree</title>
347<abstract>
348"Diverting from the Official Tree" gives you some tips and tricks on how to use
349your own Portage tree, how to synchronise only the categories you want, inject
350packages and more.
351</abstract>
352 <include href="hb-portage-diverttree.xml"/> 281 <include href="hb-portage-diverttree.xml"/>
353</chapter>
354
355<chapter>
356<title>The Ebuild Application</title>
357<abstract>
358In "The Ebuild Application" you are informed about the steps Portage takes while
359installing software and how you can do this yourself using the ebuild
360application.
361</abstract>
362 <include href="hb-portage-ebuild.xml"/>
363</chapter> 282</chapter>
364</part> 283</part>
365 284
366<part> 285<part>
367<title>Gentoo Network Configuration</title> 286<title>Gentoo Network Configuration</title>
368<abstract>A comprehensive guide to Networking in Gentoo.</abstract> 287<abstract>A comprehensive guide to Networking in Gentoo.</abstract>
369 288
370<chapter> 289<chapter>
371<title>Getting Started</title> 290<title>Getting Started</title>
372<abstract>
373A guide to quickly get your network interface up and running in most common
374environments.
375</abstract>
376<include href="hb-net-start.xml"/> 291<include href="hb-net-start.xml"/>
377</chapter> 292</chapter>
378 293
379<chapter> 294<chapter>
380<title>Advanced Configuration</title> 295<title>Advanced Configuration</title>
381<abstract>
382Here we learn about how the configuration works - you need to know this
383before we learn about modular networking.
384</abstract>
385<include href="hb-net-advanced.xml"/> 296<include href="hb-net-advanced.xml"/>
386</chapter> 297</chapter>
387 298
388<chapter> 299<chapter>
389<title>Modular Networking</title> 300<title>Modular Networking</title>
390<abstract>
391Gentoo provides you flexible networking - here you are told about choosing
392different DHCP clients, setting up bonding, bridging, VLANs and more.
393</abstract>
394<include href="hb-net-modules.xml"/> 301<include href="hb-net-modules.xml"/>
395</chapter> 302</chapter>
396 303
397<chapter> 304<chapter>
398<title>Wireless Networking</title> 305<title>Wireless Networking</title>
399<abstract>
400Wireless isn't straight-forward. Hopefully we'll get you working!
401</abstract>
402<include href="hb-net-wireless.xml"/> 306<include href="hb-net-wireless.xml"/>
403</chapter> 307</chapter>
404 308
405<chapter> 309<chapter>
406<title>Adding Functionality</title> 310<title>Adding Functionality</title>
407<abstract>
408If you're feeling adventurous, you can add your own functions to networking.
409</abstract>
410<include href="hb-net-functions.xml"/> 311<include href="hb-net-functions.xml"/>
411</chapter> 312</chapter>
412 313
413<chapter> 314<chapter>
414<title>Network Management</title> 315<title>Network Management</title>
415<abstract>
416For laptop users or people who move their computer around different networks.
417</abstract>
418<include href="hb-net-management.xml"/> 316<include href="hb-net-management.xml"/>
419</chapter> 317</chapter>
420</part> 318</part>
421 319
422</book> 320</book>
Legend:
Removed from v.1.129  
changed lines
  Added in v.1.152
  ViewVC Help
Powered by ViewVC 1.1.20