/[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.24 Revision 1.129
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.24 2004/05/09 10:36:49 swift Exp $ --> 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 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">
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="brad_mssw@gentoo.org">Brad House</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>
35</author> 39</author>
36<author title="Gentoo PPC developer"> 40<author title="Gentoo PPC developer">
… …
83 <mail link="erwin@gentoo.org">Erwin</mail> 87 <mail link="erwin@gentoo.org">Erwin</mail>
84</author> 88</author>
85<author title="Editor"> 89<author title="Editor">
86 <mail link="kumba@gentoo.org">Joshua Kinard</mail> 90 <mail link="kumba@gentoo.org">Joshua Kinard</mail>
87</author> 91</author>
92<author title="Editor">
93 <mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
94</author>
95<author title="Editor">
96 <mail link="neysx@gentoo.org">Xavier Neys</mail>
97</author>
88<author title="Reviewer"> 98<author title="Reviewer">
89 <mail link="g2boojum@gentoo.org">Grant Goodyear</mail> 99 <mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
90</author> 100</author>
91<author title="Reviewer"> 101<author title="Reviewer">
92 <mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail> 102 <mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail>
… …
100<author title="Contributor"> 110<author title="Contributor">
101 <mail link="pylon@gentoo.org">Lars Weiler</mail> 111 <mail link="pylon@gentoo.org">Lars Weiler</mail>
102</author> 112</author>
103 113
104<abstract> 114<abstract>
105This is the Gentoo Handbook, an effort to centralise Gentoo/Linux 115This is the Gentoo Handbook, an effort to centralize Gentoo/Linux information.
106information. 116This handbook contains the installation instructions for an Internet-based
117installation on AMD64 systems and parts about working with Gentoo and Portage.
107</abstract> 118</abstract>
108 119
109<!-- 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 -->
110<!-- See http://creativecommons.org/licenses/by-sa/1.0 --> 121<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
111<license/> 122<license/>
112 123
113<version>2.22</version> 124<version>4.3</version>
114<date>May 09, 2004</date> 125<date>2005-12-19</date>
115 126
116<part> 127<part>
117<title>Installing Gentoo</title> 128<title>Installing Gentoo</title>
118<abstract> 129<abstract>
119In this part you learn how to install Gentoo on your system. 130In this part you learn how to install Gentoo on your system.
120</abstract> 131</abstract>
121 132
122<chapter> 133<chapter>
123<title>About the Gentoo Linux Installation</title> 134<title>About the Gentoo Linux Installation</title>
124<abstract> 135<abstract>
125Users not familiar with Gentoo do not always know that choice is what 136This chapter introduces you to the installation approach documented in this
126Gentoo is all about. 137part.
127</abstract> 138</abstract>
128 <include href="hb-install-about.xml"/> 139 <include href="hb-install-about.xml"/>
129</chapter> 140</chapter>
130 141
131<chapter> 142<chapter>
132<title>Choosing the Right Installation Medium</title> 143<title>Choosing the Right Installation Medium</title>
133<abstract> 144<abstract>
134You can install Gentoo in many ways. This chapter explains how to install Gentoo 145You can install Gentoo in many ways. This chapter explains how to install Gentoo
135using a Gentoo LiveCD. 146using the minimal Installation CD although installation through the Universal
147Installation CD is possible as well.
136</abstract> 148</abstract>
137 <include href="hb-install-amd64-medium.xml"/> 149 <include href="hb-install-amd64-medium.xml"/>
138</chapter> 150</chapter>
139 151
140<chapter> 152<chapter>
141<title>Configuring your Network</title> 153<title>Configuring your Network</title>
142<abstract> 154<abstract>
143If you want to install Gentoo using the Internet, you need to setup 155To be able to download the latest source code, you will need to setup
144networking. 156networking.
145</abstract> 157</abstract>
146 <include href="hb-install-network.xml"/> 158 <include href="hb-install-network.xml"/>
147</chapter> 159</chapter>
148 160
… …
156</chapter> 168</chapter>
157 169
158<chapter> 170<chapter>
159<title>Installing the Gentoo Installation Files</title> 171<title>Installing the Gentoo Installation Files</title>
160<abstract> 172<abstract>
161Gentoo installs work through socalled stage-files. In this chapter we 173Gentoo installs work through a stage3 archive. In this chapter we
162describe how you extract a stage-file and configure Portage. 174describe how you extract the stage3 archive and configure Portage.
163</abstract> 175</abstract>
164 <include href="hb-install-stage.xml"/> 176 <include href="hb-install-stage.xml"/>
165</chapter> 177</chapter>
166 178
167<chapter> 179<chapter>
168<title>Installing the Gentoo Base System</title> 180<title>Installing the Gentoo Base System</title>
169<abstract> 181<abstract>
170Independent of what stage you chose, the eventual result is that you 182After installing and configuring a stage3, the eventual result is that you
171have a Gentoo base system at your disposal. This chapter describes how 183have a Gentoo base system at your disposal. This chapter describes how
172to progress to that stadium. 184to progress to that stadium.
173</abstract> 185</abstract>
174 <include href="hb-install-system.xml"/> 186 <include href="hb-install-system.xml"/>
175</chapter> 187</chapter>
… …
192</abstract> 204</abstract>
193 <include href="hb-install-config.xml"/> 205 <include href="hb-install-config.xml"/>
194</chapter> 206</chapter>
195 207
196<chapter> 208<chapter>
209<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"/>
215</chapter>
216
217<chapter>
197<title>Configuring the Bootloader</title> 218<title>Configuring the Bootloader</title>
198<abstract> 219<abstract>
199In this chapter we'll describe the GRUB bootloader 220In this chapter we'll describe the GRUB bootloader
200and step you through the process of configuring GRUB to your 221and step you through the process of configuring GRUB to your
201needs. 222needs.
202</abstract> 223</abstract>
203 <include href="hb-install-amd64-bootloader.xml"/> 224 <include href="hb-install-amd64-bootloader.xml"/>
204</chapter> 225</chapter>
205 226
206<chapter> 227<chapter>
207<title>Installing Necessary System Tools</title>
208<abstract>
209As mentioned before, Gentoo is about choices. In this chapter we help you
210choose and install some important tools.
211</abstract>
212 <include href="hb-install-tools.xml"/>
213</chapter>
214
215<chapter>
216<title>Finalizing your Gentoo Installation</title> 228<title>Finalizing your Gentoo Installation</title>
217<abstract> 229<abstract>
218You're almost done. We'll just create one (or more) users for your 230You're almost done. We'll just create one (or more) users for your
219system and leave the installation to reboot into a brand new Gentoo
220system. 231system.
221</abstract> 232</abstract>
222 <include href="hb-install-finalise.xml"/> 233 <include href="hb-install-finalise.xml"/>
223</chapter> 234</chapter>
224 235
… …
233 244
234<part> 245<part>
235<title>Working with Gentoo</title> 246<title>Working with Gentoo</title>
236<abstract> 247<abstract>
237Learn how to work with Gentoo: installing software, altering variables, changing 248Learn how to work with Gentoo: installing software, altering variables, changing
238portage behaviour etc. 249Portage behaviour etc.
250</abstract>
251
252<chapter>
253<title>A Portage Introduction</title>
239</abstract> 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"/>
259</chapter>
240 260
241<chapter> 261<chapter>
242<title>USE flags</title> 262<title>USE flags</title>
243<abstract> 263<abstract>
244USE-flags are a very important aspect of Gentoo. In this chapter, you learn to 264USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
… …
246</abstract> 266</abstract>
247 <include href="hb-working-use.xml"/> 267 <include href="hb-working-use.xml"/>
248</chapter> 268</chapter>
249 269
250<chapter> 270<chapter>
251<title>Portage and Software</title>
252<abstract>
253The main reason for portage is to maintain the software on your system. In this
254chapter you learn how to get information from a package, update your package
255database, 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> 271<title>Portage Features</title>
262<abstract> 272<abstract>
263Gentoo's Portage allows for several features that improve portage-related 273Discover the features Portage has, such as support for distributed compiling,
264aspects, such as build time. This chapter explains the existing features. 274ccache and more.
265</abstract> 275</abstract>
266 <include href="hb-working-features.xml"/> 276 <include href="hb-working-features.xml"/>
267</chapter>
268
269<chapter>
270<title>Controlling Portage Behaviour</title>
271<abstract>
272You can tweak Portage to your own needs/environment. Learn how to protect files,
273select mirrors, change directory locations and more.
274</abstract>
275 <include href="hb-working-behaviour.xml"/>
276</chapter> 277</chapter>
277 278
278<chapter> 279<chapter>
279<title>Initscripts</title> 280<title>Initscripts</title>
280<abstract> 281<abstract>
… …
294</abstract> 295</abstract>
295 <include href="hb-working-variables.xml"/> 296 <include href="hb-working-variables.xml"/>
296</chapter> 297</chapter>
297</part> 298</part>
298 299
300<part>
301<title>Working with Portage</title>
302<abstract>
303"Working with Portage" provides an in-depth coverage of Portage, Gentoo's
304Software Management Tool.
305</abstract>
306
307<chapter>
308<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"/>
314</chapter>
315
316<chapter>
317<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"/>
323</chapter>
324
325<chapter>
326<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"/>
334</chapter>
335
336<chapter>
337<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"/>
343</chapter>
344
345<chapter>
346<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"/>
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>
364</part>
365
366<part>
367<title>Gentoo Network Configuration</title>
368<abstract>A comprehensive guide to Networking in Gentoo.</abstract>
369
370<chapter>
371<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"/>
377</chapter>
378
379<chapter>
380<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"/>
386</chapter>
387
388<chapter>
389<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"/>
395</chapter>
396
397<chapter>
398<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"/>
403</chapter>
404
405<chapter>
406<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"/>
411</chapter>
412
413<chapter>
414<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"/>
419</chapter>
420</part>
421
299</book> 422</book>
Legend:
Removed from v.1.24  
changed lines
  Added in v.1.129
  ViewVC Help
Powered by ViewVC 1.1.13