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