| 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.135 2006/10/10 20:00:46 neysx Exp $ --> |
4 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-amd64.xml,v 1.139 2006/11/29 15:35:24 nightmorph Exp $ --> |
| 5 | |
5 | |
| 6 | <book link="/doc/en/handbook/handbook-amd64.xml"> |
6 | <book link="/doc/en/handbook/handbook-amd64.xml"> |
| 7 | <title>Gentoo Linux AMD64 Handbook</title> |
7 | <title>Gentoo Linux AMD64 Handbook</title> |
| 8 | |
8 | |
| 9 | <values> |
9 | <values> |
| … | |
… | |
| 13 | <key id="kernel-version">2.6.17-r5</key> |
13 | <key id="kernel-version">2.6.17-r5</key> |
| 14 | <key id="kernel-name">kernel-2.6.17-gentoo-r5</key> |
14 | <key id="kernel-name">kernel-2.6.17-gentoo-r5</key> |
| 15 | <key id="genkernel-name">kernel-genkernel-amd64-2.6.17-gentoo-r5</key> |
15 | <key id="genkernel-name">kernel-genkernel-amd64-2.6.17-gentoo-r5</key> |
| 16 | <key id="genkernel-initrd">initramfs-genkernel-amd64-2.6.17-gentoo-r5</key> |
16 | <key id="genkernel-initrd">initramfs-genkernel-amd64-2.6.17-gentoo-r5</key> |
| 17 | <key id="min-cd-name">install-amd64-minimal-2006.1.iso</key> |
17 | <key id="min-cd-name">install-amd64-minimal-2006.1.iso</key> |
| 18 | <key id="min-cd-size">45</key> |
18 | <key id="min-cd-size">50</key> |
| 19 | <key id="uni-cd-name">livecd-amd64-installer-2006.1.iso></key> |
19 | <key id="live-cd-name">livecd-amd64-installer-2006.1.iso</key> |
| 20 | <key id="uni-cd-size">401</key> |
20 | <key id="live-cd-size">696</key> |
| 21 | <key id="release-dir">releases/amd64/2006.1/</key> |
21 | <key id="release-dir">releases/amd64/2006.1/</key> |
| 22 | <key id="online-book">handbook-amd64.xml</key> |
22 | <key id="online-book">handbook-amd64.xml</key> |
| 23 | </values> |
23 | </values> |
| 24 | |
24 | |
| 25 | <author title="Author"> |
25 | <author title="Author"> |
| … | |
… | |
| 135 | |
135 | |
| 136 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
136 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
| 137 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
137 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
| 138 | <license/> |
138 | <license/> |
| 139 | |
139 | |
| 140 | <version>7.1</version> |
140 | <version>7.2</version> |
| 141 | <date>2006-08-30</date> |
141 | <date>2006-10-24</date> |
| 142 | |
142 | |
| 143 | <part> |
143 | <part> |
| 144 | <title>Installing Gentoo</title> |
144 | <title>Installing Gentoo</title> |
| 145 | <abstract> |
145 | <abstract> |
| 146 | In this part you learn how to install Gentoo on your system. |
146 | In this part you learn how to install Gentoo on your system. |
| 147 | </abstract> |
147 | </abstract> |
| 148 | |
148 | |
| 149 | <chapter> |
149 | <chapter> |
| 150 | <title>About the Gentoo Linux Installation</title> |
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"/> |
151 | <include href="hb-install-about.xml"/> |
| 156 | </chapter> |
152 | </chapter> |
| 157 | |
153 | |
| 158 | <chapter> |
154 | <chapter> |
| 159 | <title>Choosing the Right Installation Medium</title> |
155 | <title>Choosing the Right Installation Medium</title> |
| 160 | <abstract> |
|
|
| 161 | You can install Gentoo in many ways. This chapter explains how to install |
|
|
| 162 | Gentoo using the minimal Installation CD although installation through the |
|
|
| 163 | Installer LiveCD is possible as well. |
|
|
| 164 | </abstract> |
|
|
| 165 | <include href="hb-install-x86+amd64-medium.xml"/> |
156 | <include href="hb-install-x86+amd64-medium.xml"/> |
| 166 | </chapter> |
157 | </chapter> |
| 167 | |
158 | |
| 168 | <chapter> |
159 | <chapter> |
| 169 | <title>Configuring your Network</title> |
160 | <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"/> |
161 | <include href="hb-install-network.xml"/> |
| 175 | </chapter> |
162 | </chapter> |
| 176 | |
163 | |
| 177 | <chapter> |
164 | <chapter> |
| 178 | <title>Preparing the Disks</title> |
165 | <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"/> |
166 | <include href="hb-install-x86+amd64-disk.xml"/> |
| 184 | </chapter> |
167 | </chapter> |
| 185 | |
168 | |
| 186 | <chapter> |
169 | <chapter> |
| 187 | <title>Installing the Gentoo Installation Files</title> |
170 | <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"/> |
171 | <include href="hb-install-stage.xml"/> |
| 193 | </chapter> |
172 | </chapter> |
| 194 | |
173 | |
| 195 | <chapter> |
174 | <chapter> |
| 196 | <title>Installing the Gentoo Base System</title> |
175 | <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 state. |
|
|
| 201 | </abstract> |
|
|
| 202 | <include href="hb-install-system.xml"/> |
176 | <include href="hb-install-system.xml"/> |
| 203 | </chapter> |
177 | </chapter> |
| 204 | |
178 | |
| 205 | <chapter> |
179 | <chapter> |
| 206 | <title>Configuring the Kernel</title> |
180 | <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"/> |
181 | <include href="hb-install-x86+amd64-kernel.xml"/> |
| 212 | </chapter> |
182 | </chapter> |
| 213 | |
183 | |
| 214 | <chapter> |
184 | <chapter> |
| 215 | <title>Configuring your System</title> |
185 | <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"/> |
186 | <include href="hb-install-config.xml"/> |
| 222 | </chapter> |
187 | </chapter> |
| 223 | |
188 | |
| 224 | <chapter> |
189 | <chapter> |
| 225 | <title>Installing Necessary System Tools</title> |
190 | <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"/> |
191 | <include href="hb-install-tools.xml"/> |
| 231 | </chapter> |
192 | </chapter> |
| 232 | |
193 | |
| 233 | <chapter> |
194 | <chapter> |
| 234 | <title>Configuring the Bootloader</title> |
195 | <title>Configuring the Bootloader</title> |
| … | |
… | |
| 240 | <include href="hb-install-x86+amd64-bootloader.xml"/> |
201 | <include href="hb-install-x86+amd64-bootloader.xml"/> |
| 241 | </chapter> |
202 | </chapter> |
| 242 | |
203 | |
| 243 | <chapter> |
204 | <chapter> |
| 244 | <title>Finalizing your Gentoo Installation</title> |
205 | <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"/> |
206 | <include href="hb-install-finalise.xml"/> |
| 250 | </chapter> |
207 | </chapter> |
| 251 | |
208 | |
| 252 | <chapter> |
209 | <chapter> |
| 253 | <title>Where to go from here?</title> |
210 | <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"/> |
211 | <include href="hb-install-next.xml"/> |
| 258 | </chapter> |
212 | </chapter> |
| 259 | </part> |
213 | </part> |
| 260 | |
214 | |
| 261 | <part> |
215 | <part> |
| … | |
… | |
| 265 | Portage behaviour etc. |
219 | Portage behaviour etc. |
| 266 | </abstract> |
220 | </abstract> |
| 267 | |
221 | |
| 268 | <chapter> |
222 | <chapter> |
| 269 | <title>A Portage Introduction</title> |
223 | <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"/> |
224 | <include href="hb-working-portage.xml"/> |
| 275 | </chapter> |
225 | </chapter> |
| 276 | |
226 | |
| 277 | <chapter> |
227 | <chapter> |
| 278 | <title>USE flags</title> |
228 | <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"/> |
229 | <include href="hb-working-use.xml"/> |
| 284 | </chapter> |
230 | </chapter> |
| 285 | |
231 | |
| 286 | <chapter> |
232 | <chapter> |
| 287 | <title>Portage Features</title> |
233 | <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"/> |
234 | <include href="hb-working-features.xml"/> |
| 293 | </chapter> |
235 | </chapter> |
| 294 | |
236 | |
| 295 | <chapter> |
237 | <chapter> |
| 296 | <title>Initscripts</title> |
238 | <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"/> |
239 | <include href="hb-working-rcscripts.xml"/> |
| 303 | </chapter> |
240 | </chapter> |
| 304 | |
241 | |
| 305 | <chapter> |
242 | <chapter> |
| 306 | <title>Environment Variables</title> |
243 | <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"/> |
244 | <include href="hb-working-variables.xml"/> |
| 313 | </chapter> |
245 | </chapter> |
| 314 | </part> |
246 | </part> |
| 315 | |
247 | |
| 316 | <part> |
248 | <part> |
| … | |
… | |
| 320 | Software Management Tool. |
252 | Software Management Tool. |
| 321 | </abstract> |
253 | </abstract> |
| 322 | |
254 | |
| 323 | <chapter> |
255 | <chapter> |
| 324 | <title>Files and Directories</title> |
256 | <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"/> |
257 | <include href="hb-portage-files.xml"/> |
| 330 | </chapter> |
258 | </chapter> |
| 331 | |
259 | |
| 332 | <chapter> |
260 | <chapter> |
| 333 | <title>Configuring through Variables</title> |
261 | <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"/> |
262 | <include href="hb-portage-configuration.xml"/> |
| 339 | </chapter> |
263 | </chapter> |
| 340 | |
264 | |
| 341 | <chapter> |
265 | <chapter> |
| 342 | <title>Mixing Software Branches</title> |
266 | <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"/> |
267 | <include href="hb-portage-branches.xml"/> |
| 350 | </chapter> |
268 | </chapter> |
| 351 | |
269 | |
| 352 | <chapter> |
270 | <chapter> |
| 353 | <title>Additional Portage Tools</title> |
271 | <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"/> |
272 | <include href="hb-portage-tools.xml"/> |
| 359 | </chapter> |
273 | </chapter> |
| 360 | |
274 | |
| 361 | <chapter> |
275 | <chapter> |
| 362 | <title>Diverting from the Official Tree</title> |
276 | <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"/> |
277 | <include href="hb-portage-diverttree.xml"/> |
| 369 | </chapter> |
278 | </chapter> |
| 370 | </part> |
279 | </part> |
| 371 | |
280 | |
| 372 | <part> |
281 | <part> |
| 373 | <title>Gentoo Network Configuration</title> |
282 | <title>Gentoo Network Configuration</title> |
| 374 | <abstract>A comprehensive guide to Networking in Gentoo.</abstract> |
283 | <abstract>A comprehensive guide to Networking in Gentoo.</abstract> |
| 375 | |
284 | |
| 376 | <chapter> |
285 | <chapter> |
| 377 | <title>Getting Started</title> |
286 | <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"/> |
287 | <include href="hb-net-start.xml"/> |
| 383 | </chapter> |
288 | </chapter> |
| 384 | |
289 | |
| 385 | <chapter> |
290 | <chapter> |
| 386 | <title>Advanced Configuration</title> |
291 | <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"/> |
292 | <include href="hb-net-advanced.xml"/> |
| 392 | </chapter> |
293 | </chapter> |
| 393 | |
294 | |
| 394 | <chapter> |
295 | <chapter> |
| 395 | <title>Modular Networking</title> |
296 | <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"/> |
297 | <include href="hb-net-modules.xml"/> |
| 401 | </chapter> |
298 | </chapter> |
| 402 | |
299 | |
| 403 | <chapter> |
300 | <chapter> |
| 404 | <title>Wireless Networking</title> |
301 | <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"/> |
302 | <include href="hb-net-wireless.xml"/> |
| 409 | </chapter> |
303 | </chapter> |
| 410 | |
304 | |
| 411 | <chapter> |
305 | <chapter> |
| 412 | <title>Adding Functionality</title> |
306 | <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"/> |
307 | <include href="hb-net-functions.xml"/> |
| 417 | </chapter> |
308 | </chapter> |
| 418 | |
309 | |
| 419 | <chapter> |
310 | <chapter> |
| 420 | <title>Network Management</title> |
311 | <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"/> |
312 | <include href="hb-net-management.xml"/> |
| 425 | </chapter> |
313 | </chapter> |
| 426 | </part> |
314 | </part> |
| 427 | |
315 | |
| 428 | </book> |
316 | </book> |