/[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.153 - (show annotations) (download) (as text)
Thu Sep 7 08:23:02 2006 UTC (8 years ago) by nightmorph
Branch: MAIN
Changes since 1.152: +6 -3 lines
File MIME type: application/xml
updated stop-start-daemon documentation for bug 122786

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.152 2006/08/30 22:52:28 nightmorph 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.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 <key id="min-cd-size">49</key>
19 <key id="live-cd-name">livecd-i686-installer-2006.1.iso</key>
20 <key id="live-cd-size">697</key>
21 <key id="release-dir">releases/x86/2006.1/</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="Editor">
115 <mail link="nightmorph@gentoo.org">Joshua Saddler</mail>
116 </author>
117 <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 <mail link="dberkholz@gentoo.org">Donnie Berkholz</mail>
125 </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 This is the Gentoo Handbook, an effort to centralize Gentoo/Linux information.
135 This handbook contains the installation instructions for an Internet-based
136 installation on x86 systems and parts about working with Gentoo and Portage.
137 </abstract>
138
139 <!-- The content of this document is licensed under the CC-BY-SA license -->
140 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
141 <license/>
142
143 <version>7.1</version>
144 <date>2006-09-07</date>
145
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 This chapter introduces you to the installation approach documented in this
156 part.
157 </abstract>
158 <include href="hb-install-about.xml"/>
159 </chapter>
160
161 <chapter>
162 <title>Choosing the Right Installation Medium</title>
163 <abstract>
164 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 </abstract>
168 <include href="hb-install-x86+amd64-medium.xml"/>
169 </chapter>
170
171 <chapter>
172 <title>Configuring your Network</title>
173 <abstract>
174 To be able to download the latest source code, you will need to setup
175 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 <include href="hb-install-x86+amd64-disk.xml"/>
187 </chapter>
188
189 <chapter>
190 <title>Installing the Gentoo Installation Files</title>
191 <abstract>
192 Gentoo installs work through a stage3 archive. In this chapter we
193 describe how you extract the stage3 archive and configure Portage.
194 </abstract>
195 <include href="hb-install-stage.xml"/>
196 </chapter>
197
198 <chapter>
199 <title>Installing the Gentoo Base System</title>
200 <abstract>
201 After installing and configuring a stage3, the eventual result is that you
202 have a Gentoo base system at your disposal. This chapter describes how
203 to progress to that stadium.
204 </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 <include href="hb-install-x86+amd64-kernel.xml"/>
215 </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 <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 <title>Configuring the Bootloader</title>
238 <abstract>
239 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 </abstract>
243 <include href="hb-install-x86+amd64-bootloader.xml"/>
244 </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 system.
251 </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 Portage behaviour etc.
269 </abstract>
270
271 <chapter>
272 <title>A Portage Introduction</title>
273 <abstract>
274 This chapter explains the "simple" steps a user definitely needs to know to
275 maintain the software on his system.
276 </abstract>
277 <include href="hb-working-portage.xml"/>
278 </chapter>
279
280 <chapter>
281 <title>USE flags</title>
282 <abstract>
283 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 </abstract>
286 <include href="hb-working-use.xml"/>
287 </chapter>
288
289 <chapter>
290 <title>Portage Features</title>
291 <abstract>
292 Discover the features Portage has, such as support for distributed compiling,
293 ccache and more.
294 </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 <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 Once you want to know Portage in-depth you need to know where it stores its
330 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 <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 </book>

  ViewVC Help
Powered by ViewVC 1.1.20