/[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.120 Revision 1.155
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.120 2004/11/20 22:23:30 neysx Exp $ --> 4<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-amd64.xml,v 1.155 2012/02/26 09:49:46 swift Exp $ -->
5 5
6<book link="handbook-amd64.xml"> 6<book>
7<title>Gentoo Linux 2004.3 AMD64 Handbook</title> 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/sda1</key>
13 <key id="kernel-version">2.6.34-r1</key>
14 <key id="kernel-name">kernel-2.6.34-gentoo-r1</key>
15 <key id="genkernel-name">kernel-genkernel-amd64-2.6.34-gentoo-r1</key>
16 <key id="genkernel-initrd">initramfs-genkernel-amd64-2.6.34-gentoo-r1</key>
17 <key id="min-cd-name">install-amd64-minimal-&lt;release&gt;.iso</key>
18 <key id="min-cd-size">150</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>
8 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>
31</author>
32<author title="Author">
33 <mail link="uberlord@gentoo.org">Roy Marples</mail>
11</author> 34</author>
12<author title="Author"> 35<author title="Author">
13 <mail link="drobbins@gentoo.org">Daniel Robbins</mail> 36 <mail link="drobbins@gentoo.org">Daniel Robbins</mail>
14</author> 37</author>
15<author title="Author"> 38<author title="Author">
21<author title="Gentoo x86 Developer"> 44<author title="Gentoo x86 Developer">
22 <mail link="seemant@gentoo.org">Seemant Kulleen</mail> 45 <mail link="seemant@gentoo.org">Seemant Kulleen</mail>
23</author> 46</author>
24<author title="Gentoo Alpha Developer"> 47<author title="Gentoo Alpha Developer">
25 <mail link="taviso@gentoo.org">Tavis Ormandy</mail> 48 <mail link="taviso@gentoo.org">Tavis Ormandy</mail>
26</author> 49</author><!-- Does not want to be listed on the rendered page
27<author title="Gentoo Alpha Developer"> 50<author title="Gentoo Developer">
28 <mail link="agriffis@gentoo.org">Aron Griffis</mail> 51 Aron Griffis
29</author> 52</author>
53-->
30<author title="Gentoo AMD64 Developer"> 54<author title="Gentoo AMD64 Developer">
31 <mail link="jhuebel@gentoo.org">Jason Huebel</mail> 55 <mail link="jhuebel@gentoo.org">Jason Huebel</mail>
32</author> 56</author>
33<author title="Gentoo HPPA developer"> 57<author title="Gentoo HPPA developer">
34 <mail link="gmsoft@gentoo.org">Guy Martin</mail> 58 <mail link="gmsoft@gentoo.org">Guy Martin</mail>
86 <mail link="kumba@gentoo.org">Joshua Kinard</mail> 110 <mail link="kumba@gentoo.org">Joshua Kinard</mail>
87</author> 111</author>
88<author title="Editor"> 112<author title="Editor">
89 <mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail> 113 <mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
90</author> 114</author>
91<author title="Reviewer"> 115<author title="Editor">
92 <mail link="g2boojum@gentoo.org">Grant Goodyear</mail> 116 <mail link="neysx@gentoo.org">Xavier Neys</mail>
117</author>
118<author title="Editor">
119 <mail link="nightmorph@gentoo.org">Joshua Saddler</mail>
93</author> 120</author>
94<author title="Reviewer"> 121<author title="Reviewer">
95 <mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail> 122 <mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail>
96</author> 123</author>
97<author title="Reviewer"> 124<author title="Reviewer">
98 <mail link="spyderous@gentoo.org">Donnie Berkholz</mail> 125 <mail link="dberkholz@gentoo.org">Donnie Berkholz</mail>
99</author> 126</author>
100<author title="Reviewer"> 127<author title="Reviewer">
101 <mail link="antifa@gentoo.org">Ken Nowack</mail> 128 <mail link="antifa@gentoo.org">Ken Nowack</mail>
102</author> 129</author>
103<author title="Contributor"> 130<author title="Contributor">
104 <mail link="pylon@gentoo.org">Lars Weiler</mail> 131 <mail link="pylon@gentoo.org">Lars Weiler</mail>
105</author> 132</author>
106 133
107<abstract> 134<abstract>
108This is the Gentoo Handbook, an effort to centralise Gentoo/Linux 135This is the Gentoo Handbook, an effort to centralize Gentoo/Linux information.
109information. 136This handbook contains the installation instructions for an Internet-based
137installation on AMD64 systems and parts about working with Gentoo and Portage.
110</abstract> 138</abstract>
111 139
112<!-- 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 -->
113<!-- See http://creativecommons.org/licenses/by-sa/2.0 --> 141<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
114<license/> 142<license/>
115 143
116<version>3.13</version> 144<version>12</version>
117<date>2004-11-09</date> 145<date>2012-02-26</date>
118 146
119<part> 147<part>
120<title>Installing Gentoo</title> 148<title>Installing Gentoo</title>
121<abstract> 149<abstract>
122In this part you learn how to install Gentoo on your system. 150In this part you learn how to install Gentoo on your system.
123</abstract> 151</abstract>
124 152
125<chapter> 153<chapter>
126<title>About the Gentoo Linux Installation</title> 154<title>About the Gentoo Linux Installation</title>
127<abstract>
128Users not familiar with Gentoo do not always know that choice is what
129Gentoo is all about.
130</abstract>
131 <include href="hb-install-about.xml"/> 155 <include href="hb-install-about.xml"/>
132</chapter> 156</chapter>
133 157
134<chapter> 158<chapter>
135<title>Choosing the Right Installation Medium</title> 159<title>Choosing the Right Installation Medium</title>
136<abstract>
137You can install Gentoo in many ways. This chapter explains how to install Gentoo
138using a Gentoo LiveCD.
139</abstract>
140 <include href="hb-install-amd64-medium.xml"/> 160 <include href="hb-install-x86+amd64-medium.xml"/>
141</chapter> 161</chapter>
142 162
143<chapter> 163<chapter>
144<title>Configuring your Network</title> 164<title>Configuring your Network</title>
145<abstract>
146If you want to install Gentoo using the Internet, you need to set up
147networking.
148</abstract>
149 <include href="hb-install-network.xml"/> 165 <include href="hb-install-network.xml"/>
150</chapter> 166</chapter>
151 167
152<chapter> 168<chapter>
153<title>Preparing the Disks</title> 169<title>Preparing the Disks</title>
154<abstract>
155To be able to install Gentoo, you must create the necessary partitions.
156This chapter describes how to partition a disk for future usage.
157</abstract>
158 <include href="hb-install-amd64-disk.xml"/> 170 <include href="hb-install-x86+amd64-disk.xml"/>
159</chapter> 171</chapter>
160 172
161<chapter> 173<chapter>
162<title>Installing the Gentoo Installation Files</title> 174<title>Installing the Gentoo Installation Files</title>
163<abstract>
164Gentoo installs work through so-called stage-files. In this chapter we
165describe how you extract a stage-file and configure Portage.
166</abstract>
167 <include href="hb-install-stage.xml"/> 175 <include href="hb-install-stage.xml"/>
168</chapter> 176</chapter>
169 177
170<chapter> 178<chapter>
171<title>Installing the Gentoo Base System</title> 179<title>Installing the Gentoo Base System</title>
172<abstract>
173Independent of what stage you chose, the eventual result is that you
174have a Gentoo base system at your disposal. This chapter describes how
175to progress to that stadium.
176</abstract>
177 <include href="hb-install-system.xml"/> 180 <include href="hb-install-system.xml"/>
178</chapter> 181</chapter>
179 182
180<chapter> 183<chapter>
181<title>Configuring the Kernel</title> 184<title>Configuring the Kernel</title>
182<abstract>
183The Linux kernel is the core of every distribution. This chapter
184explains how to configure your kernel.
185</abstract>
186 <include href="hb-install-amd64-kernel.xml"/> 185 <include href="hb-install-x86+amd64-kernel.xml"/>
187</chapter> 186</chapter>
188 187
189<chapter> 188<chapter>
190<title>Configuring your System</title> 189<title>Configuring your System</title>
191<abstract>
192You need to edit some important configuration files. In this chapter
193you receive an overview of these files and an explanation on how to
194proceed.
195</abstract>
196 <include href="hb-install-config.xml"/> 190 <include href="hb-install-config.xml"/>
197</chapter> 191</chapter>
198 192
199<chapter> 193<chapter>
200<title>Installing Necessary System Tools</title> 194<title>Installing Necessary System Tools</title>
201<abstract>
202As mentioned before, Gentoo is about choices. In this chapter we help you
203choose and install some important tools.
204</abstract>
205 <include href="hb-install-tools.xml"/> 195 <include href="hb-install-tools.xml"/>
206</chapter> 196</chapter>
207 197
208<chapter> 198<chapter>
209<title>Configuring the Bootloader</title> 199<title>Configuring the Bootloader</title>
210<abstract> 200<abstract>
211In this chapter we'll describe the GRUB bootloader 201In this chapter we'll describe the GRUB bootloader
212and step you through the process of configuring GRUB to your 202and step you through the process of configuring GRUB to your
213needs. 203needs.
214</abstract> 204</abstract>
215 <include href="hb-install-amd64-bootloader.xml"/> 205 <include href="hb-install-x86+amd64-bootloader.xml"/>
216</chapter> 206</chapter>
217 207
218<chapter> 208<chapter>
219<title>Finalizing your Gentoo Installation</title> 209<title>Finalizing your Gentoo Installation</title>
220<abstract>
221You're almost done. We'll just create one (or more) users for your
222system and (optionally) install the prebuild packages.
223</abstract>
224 <include href="hb-install-finalise.xml"/> 210 <include href="hb-install-finalise.xml"/>
225</chapter> 211</chapter>
226 212
227<chapter> 213<chapter>
228<title>Where to go from here?</title> 214<title>Where to go from here?</title>
229<abstract>
230Now you have your Gentoo system, but what's next?
231</abstract>
232 <include href="hb-install-next.xml"/> 215 <include href="hb-install-next.xml"/>
233</chapter> 216</chapter>
234</part> 217</part>
235 218
236<part> 219<part>
240Portage behaviour etc. 223Portage behaviour etc.
241</abstract> 224</abstract>
242 225
243<chapter> 226<chapter>
244<title>A Portage Introduction</title> 227<title>A Portage Introduction</title>
245<abstract>
246This chapter explains the "simple" steps a user definitely needs to know to
247maintain the software on his system.
248</abstract>
249 <include href="hb-working-portage.xml"/> 228 <include href="hb-working-portage.xml"/>
250</chapter> 229</chapter>
251 230
252<chapter> 231<chapter>
253<title>USE flags</title> 232<title>USE flags</title>
254<abstract>
255USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
256work with USE-flags and understand how USE-flags interact with your system.
257</abstract>
258 <include href="hb-working-use.xml"/> 233 <include href="hb-working-use.xml"/>
259</chapter> 234</chapter>
260 235
261<chapter> 236<chapter>
262<title>Portage Features</title> 237<title>Portage Features</title>
263<abstract>
264Discover the features Portage has, such as support for distributed compiling,
265ccache and more.
266</abstract>
267 <include href="hb-working-features.xml"/> 238 <include href="hb-working-features.xml"/>
268</chapter> 239</chapter>
269 240
270<chapter> 241<chapter>
271<title>Initscripts</title> 242<title>Initscripts</title>
272<abstract>
273Gentoo uses a special initscript format which, amongst other features, allows
274dependency-driven decisions and virtual initscripts. This chapter explains all
275these aspects and explains how to deal with these scripts.
276</abstract>
277 <include href="hb-working-rcscripts.xml"/> 243 <include href="hb-working-rcscripts.xml"/>
278</chapter> 244</chapter>
279 245
280<chapter> 246<chapter>
281<title>Environment Variables</title> 247<title>Environment Variables</title>
282<abstract>
283With Gentoo you can easily manage the environment variables for your system.
284This chapter explains how you do that, and also describes frequently used
285variables.
286</abstract>
287 <include href="hb-working-variables.xml"/> 248 <include href="hb-working-variables.xml"/>
288</chapter> 249</chapter>
289</part> 250</part>
290 251
291<part> 252<part>
295Software Management Tool. 256Software Management Tool.
296</abstract> 257</abstract>
297 258
298<chapter> 259<chapter>
299<title>Files and Directories</title> 260<title>Files and Directories</title>
300<abstract>
301Once you want to know Portage in-depth you need to know where it stores its
302files and data.
303</abstract>
304 <include href="hb-portage-files.xml"/> 261 <include href="hb-portage-files.xml"/>
305</chapter> 262</chapter>
306 263
307<chapter> 264<chapter>
308<title>Configuring through Variables</title> 265<title>Configuring through Variables</title>
309<abstract>
310Portage is completely configurable through various variables you can set in the
311configuration file or as environment variable.
312</abstract>
313 <include href="hb-portage-configuration.xml"/> 266 <include href="hb-portage-configuration.xml"/>
314</chapter> 267</chapter>
315 268
316<chapter> 269<chapter>
317<title>Mixing Software Branches</title> 270<title>Mixing Software Branches</title>
318<abstract>
319Gentoo provides software separated in several branches, depending on stability
320and architectural support. "Mixing Software Branches" inform you how these
321branches can be configured and how you can override this separation
322individually.
323</abstract>
324 <include href="hb-portage-branches.xml"/> 271 <include href="hb-portage-branches.xml"/>
325</chapter> 272</chapter>
326 273
327<chapter> 274<chapter>
328<title>Additional Portage Tools</title> 275<title>Additional Portage Tools</title>
329<abstract>
330Portage comes with a few extra tools that might make your Gentoo experience even
331better. Read on to discover how to use dispatch-conf and other tools.
332</abstract>
333 <include href="hb-portage-tools.xml"/> 276 <include href="hb-portage-tools.xml"/>
334</chapter> 277</chapter>
335 278
336<chapter> 279<chapter>
337<title>Diverting from the Official Tree</title> 280<title>Diverting from the Official Tree</title>
338<abstract>
339"Diverting from the Official Tree" gives you some tips and tricks on how to use
340your own Portage tree, how to synchronise only the categories you want, inject
341packages and more.
342</abstract>
343 <include href="hb-portage-diverttree.xml"/> 281 <include href="hb-portage-diverttree.xml"/>
344</chapter> 282</chapter>
345 283
346<chapter> 284<chapter>
347<title>The Ebuild Application</title> 285<title>Advanced Portage Features</title>
348<abstract>
349In "The Ebuild Application" you are informed about the steps Portage takes while
350installing software and how you can do this yourself using the ebuild
351application.
352</abstract>
353 <include href="hb-portage-ebuild.xml"/> 286 <include href="hb-portage-advanced.xml" />
354</chapter> 287</chapter>
355</part> 288</part>
356 289
290<part>
291<title>Gentoo Network Configuration</title>
292<abstract>A comprehensive guide to Networking in Gentoo.</abstract>
293
294<chapter>
295<title>Getting Started</title>
296<include href="hb-net-start.xml"/>
297</chapter>
298
299<chapter>
300<title>Advanced Configuration</title>
301<include href="hb-net-advanced.xml"/>
302</chapter>
303
304<chapter>
305<title>Modular Networking</title>
306<include href="hb-net-modules.xml"/>
307</chapter>
308
309<chapter>
310<title>Wireless Networking</title>
311<include href="hb-net-wireless.xml"/>
312</chapter>
313
314<chapter>
315<title>Adding Functionality</title>
316<include href="hb-net-functions.xml"/>
317</chapter>
318
319<chapter>
320<title>Network Management</title>
321<include href="hb-net-management.xml"/>
322</chapter>
323</part>
324
357</book> 325</book>

Legend:
Removed from v.1.120  
changed lines
  Added in v.1.155

  ViewVC Help
Powered by ViewVC 1.1.20