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

Contents of /xml/htdocs/doc/en/handbook/handbook-x86.xml

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.151 - (show annotations) (download) (as text)
Wed Aug 9 22:32:56 2006 UTC (7 years, 8 months ago) by rane
Branch: MAIN
Changes since 1.150: +3 -13 lines
File MIME type: application/xml
#109302, ebuild documentation was moved to devmanual.gentoo.org

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

  ViewVC Help
Powered by ViewVC 1.1.20