/[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.154 - (hide annotations) (download) (as text)
Sun Oct 8 21:13:01 2006 UTC (8 years, 2 months ago) by nightmorph
Branch: MAIN
Changes since 1.153: +2 -2 lines
File MIME type: application/xml
proper English fix: s/stadium/state, no content change

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

  ViewVC Help
Powered by ViewVC 1.1.20