| 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.24 2004/05/09 11:12:35 swift Exp $ --> |
4 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-alpha.xml,v 1.134 2007/10/24 13:18:26 neysx Exp $ --> |
| 5 | |
5 | |
| 6 | <book link="handbook-alpha.xml"> |
6 | <book link="/doc/en/handbook/handbook-alpha.xml"> |
| 7 | <title>Gentoo Linux/Alpha Handbook</title> |
7 | <title>Gentoo Linux Alpha Handbook</title> |
| 8 | |
8 | |
| 9 | <author title="Chief Architect"> |
9 | <values> |
|
|
10 | <key id="arch">Alpha</key> |
|
|
11 | <key id="/boot">/dev/sda1</key> |
|
|
12 | <key id="kernel-version">2.6.19-r5</key> |
|
|
13 | <key id="kernel-name">kernel-2.6.19-gentoo-r5</key> |
|
|
14 | <key id="online-book">handbook-alpha.xml</key> |
|
|
15 | <key id="release-dir">releases/alpha/2007.0/</key> |
|
|
16 | <key id="stage3">stage3-alpha-2007.0.tar.bz2</key> |
|
|
17 | <key id="profile">default-linux/alpha/2007.0</key> |
|
|
18 | <key id="CFLAGS">-mieee -pipe -O2 -mcpu=ev6</key> |
|
|
19 | </values> |
|
|
20 | |
|
|
21 | <author title="Author"> |
|
|
22 | <mail link="swift@gentoo.org">Sven Vermeulen</mail> |
|
|
23 | </author> |
|
|
24 | <author title="Author"> |
|
|
25 | <mail link="g2boojum@gentoo.org">Grant Goodyear</mail> |
|
|
26 | </author> |
|
|
27 | <author title="Author"> |
|
|
28 | <mail link="uberlord@gentoo.org">Roy Marples</mail> |
|
|
29 | </author> |
|
|
30 | <author title="Author"> |
| 10 | <mail link="drobbins@gentoo.org">Daniel Robbins</mail> |
31 | <mail link="drobbins@gentoo.org">Daniel Robbins</mail> |
| 11 | </author> |
|
|
| 12 | <author title="Author"> |
|
|
| 13 | <mail link="swift@gentoo.org">Sven Vermeulen</mail> |
|
|
| 14 | </author> |
32 | </author> |
| 15 | <author title="Author"> |
33 | <author title="Author"> |
| 16 | <mail link="chouser@gentoo.org">Chris Houser</mail> |
34 | <mail link="chouser@gentoo.org">Chris Houser</mail> |
| 17 | </author> |
35 | </author> |
| 18 | <author title="Author"> |
36 | <author title="Author"> |
| … | |
… | |
| 21 | <author title="Gentoo x86 Developer"> |
39 | <author title="Gentoo x86 Developer"> |
| 22 | <mail link="seemant@gentoo.org">Seemant Kulleen</mail> |
40 | <mail link="seemant@gentoo.org">Seemant Kulleen</mail> |
| 23 | </author> |
41 | </author> |
| 24 | <author title="Gentoo Alpha Developer"> |
42 | <author title="Gentoo Alpha Developer"> |
| 25 | <mail link="taviso@gentoo.org">Tavis Ormandy</mail> |
43 | <mail link="taviso@gentoo.org">Tavis Ormandy</mail> |
| 26 | </author> |
44 | </author><!-- Does not want to be listed on the rendered page |
| 27 | <author title="Gentoo Alpha Developer"> |
45 | <author title="Gentoo Developer"> |
| 28 | <mail link="agriffis@gentoo.org">Aron Griffis</mail> |
46 | Aron Griffis |
| 29 | </author> |
47 | </author> |
|
|
48 | --> |
| 30 | <author title="Gentoo AMD64 Developer"> |
49 | <author title="Gentoo AMD64 Developer"> |
| 31 | <mail link="brad_mssw@gentoo.org">Brad House</mail> |
50 | <mail link="jhuebel@gentoo.org">Jason Huebel</mail> |
| 32 | </author> |
51 | </author> |
| 33 | <author title="Gentoo HPPA developer"> |
52 | <author title="Gentoo HPPA developer"> |
| 34 | <mail link="gmsoft@gentoo.org">Guy Martin</mail> |
53 | <mail link="gmsoft@gentoo.org">Guy Martin</mail> |
| 35 | </author> |
54 | </author> |
| 36 | <author title="Gentoo PPC developer"> |
55 | <author title="Gentoo PPC developer"> |
| … | |
… | |
| 83 | <mail link="erwin@gentoo.org">Erwin</mail> |
102 | <mail link="erwin@gentoo.org">Erwin</mail> |
| 84 | </author> |
103 | </author> |
| 85 | <author title="Editor"> |
104 | <author title="Editor"> |
| 86 | <mail link="kumba@gentoo.org">Joshua Kinard</mail> |
105 | <mail link="kumba@gentoo.org">Joshua Kinard</mail> |
| 87 | </author> |
106 | </author> |
| 88 | <author title="Reviewer"> |
107 | <author title="Editor"> |
| 89 | <mail link="g2boojum@gentoo.org">Grant Goodyear</mail> |
108 | <mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail> |
|
|
109 | </author> |
|
|
110 | <author title="Editor"> |
|
|
111 | <mail link="neysx@gentoo.org">Xavier Neys</mail> |
|
|
112 | </author> |
|
|
113 | <author title="Editor"> |
|
|
114 | <mail link="nightmorph@gentoo.org">Joshua Saddler</mail> |
| 90 | </author> |
115 | </author> |
| 91 | <author title="Reviewer"> |
116 | <author title="Reviewer"> |
| 92 | <mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail> |
117 | <mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail> |
| 93 | </author> |
118 | </author> |
| 94 | <author title="Reviewer"> |
119 | <author title="Reviewer"> |
| 95 | <mail link="spyderous@gentoo.org">Donnie Berkholz</mail> |
120 | <mail link="dberkholz@gentoo.org">Donnie Berkholz</mail> |
| 96 | </author> |
121 | </author> |
| 97 | <author title="Reviewer"> |
122 | <author title="Reviewer"> |
| 98 | <mail link="antifa@gentoo.org">Ken Nowack</mail> |
123 | <mail link="antifa@gentoo.org">Ken Nowack</mail> |
| 99 | </author> |
124 | </author> |
| 100 | <author title="Contributor"> |
125 | <author title="Contributor"> |
| 101 | <mail link="pylon@gentoo.org">Lars Weiler</mail> |
126 | <mail link="pylon@gentoo.org">Lars Weiler</mail> |
| 102 | </author> |
127 | </author> |
| 103 | |
128 | |
| 104 | <abstract> |
129 | <abstract> |
| 105 | This is the Gentoo Handbook, an effort to centralise Gentoo/Linux |
130 | This is the Gentoo Handbook, an effort to centralize Gentoo/Linux information. |
| 106 | information. |
131 | This handbook contains the installation instructions for an Internet-based |
|
|
132 | installation on Alpha systems and parts about working with Gentoo and Portage. |
| 107 | </abstract> |
133 | </abstract> |
| 108 | |
134 | |
| 109 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
135 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
| 110 | <!-- See http://creativecommons.org/licenses/by-sa/1.0 --> |
136 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
| 111 | <license/> |
137 | <license/> |
| 112 | |
138 | |
| 113 | <version>2.22</version> |
139 | <version>8.1</version> |
| 114 | <date>May 09, 2004</date> |
140 | <date>2007-10-24</date> |
| 115 | |
141 | |
| 116 | <part> |
142 | <part> |
| 117 | <title>Installing Gentoo</title> |
143 | <title>Installing Gentoo</title> |
| 118 | <abstract> |
144 | <abstract> |
| 119 | In this part you learn how to install Gentoo on your system. |
145 | In this part you learn how to install Gentoo on your system. |
| 120 | </abstract> |
146 | </abstract> |
| 121 | |
147 | |
| 122 | <chapter> |
148 | <chapter> |
| 123 | <title>About the Gentoo Linux Installation</title> |
149 | <title>About the Gentoo Linux Installation</title> |
| 124 | <abstract> |
|
|
| 125 | Users not familiar with Gentoo do not always know that choice is what |
|
|
| 126 | Gentoo is all about. |
|
|
| 127 | </abstract> |
|
|
| 128 | <include href="hb-install-about.xml"/> |
150 | <include href="hb-install-about.xml"/> |
| 129 | </chapter> |
151 | </chapter> |
| 130 | |
152 | |
| 131 | <chapter> |
153 | <chapter> |
| 132 | <title>Choosing the Right Installation Medium</title> |
154 | <title>Choosing the Right Installation Medium</title> |
| 133 | <abstract> |
155 | <abstract> |
| 134 | You can install Gentoo in many ways. In this chapter we explain how to install |
156 | You can install Gentoo in many ways. This chapter explains how to install Gentoo |
| 135 | Gentoo using a Gentoo LiveCD. |
157 | using the minimal Installation CD although installation through the Universal |
|
|
158 | Installation CD is possible as well. |
| 136 | </abstract> |
159 | </abstract> |
| 137 | <include href="hb-install-alpha-medium.xml"/> |
160 | <include href="hb-install-alpha-medium.xml"/> |
| 138 | </chapter> |
161 | </chapter> |
| 139 | |
162 | |
| 140 | <chapter> |
163 | <chapter> |
| 141 | <title>Configuring your Network</title> |
164 | <title>Configuring your Network</title> |
| 142 | <abstract> |
|
|
| 143 | If you want to install Gentoo using the Internet, you need to setup |
|
|
| 144 | networking. |
|
|
| 145 | </abstract> |
|
|
| 146 | <include href="hb-install-network.xml"/> |
165 | <include href="hb-install-network.xml"/> |
| 147 | </chapter> |
166 | </chapter> |
| 148 | |
167 | |
| 149 | <chapter> |
168 | <chapter> |
| 150 | <title>Preparing the Disks</title> |
169 | <title>Preparing the Disks</title> |
| … | |
… | |
| 155 | <include href="hb-install-alpha-disk.xml"/> |
174 | <include href="hb-install-alpha-disk.xml"/> |
| 156 | </chapter> |
175 | </chapter> |
| 157 | |
176 | |
| 158 | <chapter> |
177 | <chapter> |
| 159 | <title>Installing the Gentoo Installation Files</title> |
178 | <title>Installing the Gentoo Installation Files</title> |
| 160 | <abstract> |
|
|
| 161 | Gentoo installs work through socalled stage-files. In this chapter we |
|
|
| 162 | describe how you extract a stage-file and configure Portage. |
|
|
| 163 | </abstract> |
|
|
| 164 | <include href="hb-install-stage.xml"/> |
179 | <include href="hb-install-stage.xml"/> |
| 165 | </chapter> |
180 | </chapter> |
| 166 | |
181 | |
| 167 | <chapter> |
182 | <chapter> |
| 168 | <title>Installing the Gentoo Base System</title> |
183 | <title>Installing the Gentoo Base System</title> |
| 169 | <abstract> |
|
|
| 170 | Independent of what stage you chose, the eventual result is that you |
|
|
| 171 | have a Gentoo base system at your disposal. This chapter describes how |
|
|
| 172 | to progress to that stadium. |
|
|
| 173 | </abstract> |
|
|
| 174 | <include href="hb-install-system.xml"/> |
184 | <include href="hb-install-system.xml"/> |
| 175 | </chapter> |
185 | </chapter> |
| 176 | |
186 | |
| 177 | <chapter> |
187 | <chapter> |
| 178 | <title>Configuring the Kernel</title> |
188 | <title>Configuring the Kernel</title> |
| … | |
… | |
| 183 | <include href="hb-install-alpha-kernel.xml"/> |
193 | <include href="hb-install-alpha-kernel.xml"/> |
| 184 | </chapter> |
194 | </chapter> |
| 185 | |
195 | |
| 186 | <chapter> |
196 | <chapter> |
| 187 | <title>Configuring your System</title> |
197 | <title>Configuring your System</title> |
| 188 | <abstract> |
|
|
| 189 | You need to edit some important configuration files. In this chapter |
|
|
| 190 | you receive an overview of these files and an explanation on how to |
|
|
| 191 | proceed. |
|
|
| 192 | </abstract> |
|
|
| 193 | <include href="hb-install-config.xml"/> |
198 | <include href="hb-install-config.xml"/> |
|
|
199 | </chapter> |
|
|
200 | |
|
|
201 | <chapter> |
|
|
202 | <title>Installing Necessary System Tools</title> |
|
|
203 | <include href="hb-install-tools.xml"/> |
| 194 | </chapter> |
204 | </chapter> |
| 195 | |
205 | |
| 196 | <chapter> |
206 | <chapter> |
| 197 | <title>Configuring the Bootloader</title> |
207 | <title>Configuring the Bootloader</title> |
| 198 | <abstract> |
208 | <abstract> |
| … | |
… | |
| 203 | </abstract> |
213 | </abstract> |
| 204 | <include href="hb-install-alpha-bootloader.xml"/> |
214 | <include href="hb-install-alpha-bootloader.xml"/> |
| 205 | </chapter> |
215 | </chapter> |
| 206 | |
216 | |
| 207 | <chapter> |
217 | <chapter> |
| 208 | <title>Installing Necessary System Tools</title> |
|
|
| 209 | <abstract> |
|
|
| 210 | As mentioned before, Gentoo is about choices. In this chapter we help you |
|
|
| 211 | choose and install some important tools. |
|
|
| 212 | </abstract> |
|
|
| 213 | <include href="hb-install-tools.xml"/> |
|
|
| 214 | </chapter> |
|
|
| 215 | |
|
|
| 216 | <chapter> |
|
|
| 217 | <title>Finalizing your Gentoo Installation</title> |
218 | <title>Finalizing your Gentoo Installation</title> |
| 218 | <abstract> |
|
|
| 219 | You're almost done. We'll just create one (or more) users for your |
|
|
| 220 | system and leave the installation to reboot into a brand new Gentoo |
|
|
| 221 | system. |
|
|
| 222 | </abstract> |
|
|
| 223 | <include href="hb-install-finalise.xml"/> |
219 | <include href="hb-install-finalise.xml"/> |
| 224 | </chapter> |
220 | </chapter> |
| 225 | |
221 | |
| 226 | <chapter> |
222 | <chapter> |
| 227 | <title>Where to go from here?</title> |
223 | <title>Where to go from here?</title> |
| 228 | <abstract> |
|
|
| 229 | Now you have your Gentoo system, but what's next? |
|
|
| 230 | </abstract> |
|
|
| 231 | <include href="hb-install-next.xml"/> |
224 | <include href="hb-install-next.xml"/> |
| 232 | </chapter> |
225 | </chapter> |
| 233 | </part> |
226 | </part> |
| 234 | |
227 | |
| 235 | <part> |
228 | <part> |
| 236 | <title>Working with Gentoo</title> |
229 | <title>Working with Gentoo</title> |
| 237 | <abstract> |
230 | <abstract> |
| 238 | Learn how to work with Gentoo: installing software, altering variables, changing |
231 | Learn how to work with Gentoo: installing software, altering variables, changing |
| 239 | portage behaviour etc. |
232 | Portage behaviour etc. |
| 240 | </abstract> |
233 | </abstract> |
|
|
234 | |
|
|
235 | <chapter> |
|
|
236 | <title>A Portage Introduction</title> |
|
|
237 | <include href="hb-working-portage.xml"/> |
|
|
238 | </chapter> |
| 241 | |
239 | |
| 242 | <chapter> |
240 | <chapter> |
| 243 | <title>USE flags</title> |
241 | <title>USE flags</title> |
| 244 | <abstract> |
|
|
| 245 | USE-flags are a very important aspect of Gentoo. In this chapter, you learn to |
|
|
| 246 | work with USE-flags and understand how USE-flags interact with your system. |
|
|
| 247 | </abstract> |
|
|
| 248 | <include href="hb-working-use.xml"/> |
242 | <include href="hb-working-use.xml"/> |
| 249 | </chapter> |
243 | </chapter> |
| 250 | |
244 | |
| 251 | <chapter> |
245 | <chapter> |
| 252 | <title>Portage and Software</title> |
|
|
| 253 | <abstract> |
|
|
| 254 | The main reason for portage is to maintain the software on your system. In this |
|
|
| 255 | chapter you learn how to get information from a package, update your package |
|
|
| 256 | database, install/remove/update software and more... |
|
|
| 257 | </abstract> |
|
|
| 258 | <include href="hb-working-portage.xml"/> |
|
|
| 259 | </chapter> |
|
|
| 260 | |
|
|
| 261 | <chapter> |
|
|
| 262 | <title>Portage Features</title> |
246 | <title>Portage Features</title> |
| 263 | <abstract> |
|
|
| 264 | Gentoo's Portage allows for several features that improve portage-related |
|
|
| 265 | aspects, such as build time. This chapter explains the existing features. |
|
|
| 266 | </abstract> |
|
|
| 267 | <include href="hb-working-features.xml"/> |
247 | <include href="hb-working-features.xml"/> |
| 268 | </chapter> |
248 | </chapter> |
| 269 | |
249 | |
| 270 | <chapter> |
250 | <chapter> |
| 271 | <title>Controlling Portage Behaviour</title> |
|
|
| 272 | <abstract> |
|
|
| 273 | You can tweak Portage to your own needs/environment. Learn how to protect files, |
|
|
| 274 | select mirrors, change directory locations and more. |
|
|
| 275 | </abstract> |
|
|
| 276 | <include href="hb-working-behaviour.xml"/> |
|
|
| 277 | </chapter> |
|
|
| 278 | |
|
|
| 279 | <chapter> |
|
|
| 280 | <title>Initscripts</title> |
251 | <title>Initscripts</title> |
| 281 | <abstract> |
|
|
| 282 | Gentoo uses a special initscript format which, amongst other features, allows |
|
|
| 283 | dependency-driven decisions and virtual initscripts. This chapter explains all |
|
|
| 284 | these aspects and explains how to deal with these scripts. |
|
|
| 285 | </abstract> |
|
|
| 286 | <include href="hb-working-rcscripts.xml"/> |
252 | <include href="hb-working-rcscripts.xml"/> |
| 287 | </chapter> |
253 | </chapter> |
| 288 | |
254 | |
| 289 | <chapter> |
255 | <chapter> |
| 290 | <title>Environment Variables</title> |
256 | <title>Environment Variables</title> |
| 291 | <abstract> |
|
|
| 292 | With Gentoo you can easily manage the environment variables for your system. |
|
|
| 293 | This chapter explains how you do that, and also describes frequently used |
|
|
| 294 | variables. |
|
|
| 295 | </abstract> |
|
|
| 296 | <include href="hb-working-variables.xml"/> |
257 | <include href="hb-working-variables.xml"/> |
| 297 | </chapter> |
258 | </chapter> |
| 298 | </part> |
259 | </part> |
| 299 | |
260 | |
|
|
261 | <part> |
|
|
262 | <title>Working with Portage</title> |
|
|
263 | <abstract> |
|
|
264 | "Working with Portage" provides an in-depth coverage of Portage, Gentoo's |
|
|
265 | Software Management Tool. |
|
|
266 | </abstract> |
|
|
267 | |
|
|
268 | <chapter> |
|
|
269 | <title>Files and Directories</title> |
|
|
270 | <include href="hb-portage-files.xml"/> |
|
|
271 | </chapter> |
|
|
272 | |
|
|
273 | <chapter> |
|
|
274 | <title>Configuring through Variables</title> |
|
|
275 | <include href="hb-portage-configuration.xml"/> |
|
|
276 | </chapter> |
|
|
277 | |
|
|
278 | <chapter> |
|
|
279 | <title>Mixing Software Branches</title> |
|
|
280 | <include href="hb-portage-branches.xml"/> |
|
|
281 | </chapter> |
|
|
282 | |
|
|
283 | <chapter> |
|
|
284 | <title>Additional Portage Tools</title> |
|
|
285 | <include href="hb-portage-tools.xml"/> |
|
|
286 | </chapter> |
|
|
287 | |
|
|
288 | <chapter> |
|
|
289 | <title>Diverting from the Official Tree</title> |
|
|
290 | <include href="hb-portage-diverttree.xml"/> |
|
|
291 | </chapter> |
|
|
292 | </part> |
|
|
293 | |
|
|
294 | <part> |
|
|
295 | <title>Gentoo Network Configuration</title> |
|
|
296 | <abstract>A comprehensive guide to Networking in Gentoo.</abstract> |
|
|
297 | |
|
|
298 | <chapter> |
|
|
299 | <title>Getting Started</title> |
|
|
300 | <include href="hb-net-start.xml"/> |
|
|
301 | </chapter> |
|
|
302 | |
|
|
303 | <chapter> |
|
|
304 | <title>Advanced Configuration</title> |
|
|
305 | <include href="hb-net-advanced.xml"/> |
|
|
306 | </chapter> |
|
|
307 | |
|
|
308 | <chapter> |
|
|
309 | <title>Modular Networking</title> |
|
|
310 | <include href="hb-net-modules.xml"/> |
|
|
311 | </chapter> |
|
|
312 | |
|
|
313 | <chapter> |
|
|
314 | <title>Wireless Networking</title> |
|
|
315 | <include href="hb-net-wireless.xml"/> |
|
|
316 | </chapter> |
|
|
317 | |
|
|
318 | <chapter> |
|
|
319 | <title>Adding Functionality</title> |
|
|
320 | <include href="hb-net-functions.xml"/> |
|
|
321 | </chapter> |
|
|
322 | |
|
|
323 | <chapter> |
|
|
324 | <title>Network Management</title> |
|
|
325 | <include href="hb-net-management.xml"/> |
|
|
326 | </chapter> |
|
|
327 | </part> |
|
|
328 | |
| 300 | </book> |
329 | </book> |