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

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

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

Removed from v.1.124  
changed lines
  Added in v.1.141

  ViewVC Help
Powered by ViewVC 1.1.20