1 |
neysx 08/04/01 17:21:03 |
2 |
|
3 |
Modified: hb-install-x86+amd64-medium.xml |
4 |
Log: |
5 |
Use <dl> for all kernel options and various formatting edits. |
6 |
|
7 |
The only actual content change is the tiny extra bit about EM64T in the table |
8 |
|
9 |
Revision Changes Path |
10 |
1.11 xml/htdocs/doc/en/handbook/hb-install-x86+amd64-medium.xml |
11 |
|
12 |
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-medium.xml?rev=1.11&view=markup |
13 |
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-medium.xml?rev=1.11&content-type=text/plain |
14 |
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-medium.xml?r1=1.10&r2=1.11 |
15 |
|
16 |
Index: hb-install-x86+amd64-medium.xml |
17 |
=================================================================== |
18 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-medium.xml,v |
19 |
retrieving revision 1.10 |
20 |
retrieving revision 1.11 |
21 |
diff -u -r1.10 -r1.11 |
22 |
--- hb-install-x86+amd64-medium.xml 1 Apr 2008 08:53:46 -0000 1.10 |
23 |
+++ hb-install-x86+amd64-medium.xml 1 Apr 2008 17:21:03 -0000 1.11 |
24 |
@@ -4,7 +4,7 @@ |
25 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
26 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
27 |
|
28 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-medium.xml,v 1.10 2008/04/01 08:53:46 nightmorph Exp $ --> |
29 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-medium.xml,v 1.11 2008/04/01 17:21:03 neysx Exp $ --> |
30 |
|
31 |
<sections> |
32 |
|
33 |
@@ -14,7 +14,7 @@ |
34 |
Installer LiveCD is possible as well. |
35 |
</abstract> |
36 |
|
37 |
-<version>6.0</version> |
38 |
+<version>6.1</version> |
39 |
<date>2008-04-01</date> |
40 |
|
41 |
<section> |
42 |
@@ -25,7 +25,7 @@ |
43 |
|
44 |
<p> |
45 |
Before we start, we first list what hardware requirements you need to |
46 |
-successfully install Gentoo on your box. |
47 |
+successfully install Gentoo on your box. |
48 |
</p> |
49 |
|
50 |
</body> |
51 |
@@ -71,7 +71,11 @@ |
52 |
</tr> |
53 |
<tr> |
54 |
<th>CPU</th> |
55 |
- <ti colspan="2">Any AMD64 CPU or EM64T CPU</ti> |
56 |
+ <ti colspan="2"> |
57 |
+ Any AMD64 CPU or <uri |
58 |
+ link="http://en.wikipedia.org/wiki/EMT64#Intel_64">EM64T CPU</uri> (Core 2 |
59 |
+ Duo & Quad processors are EM64T) |
60 |
+ </ti> |
61 |
</tr> |
62 |
<tr> |
63 |
<th>Memory</th> |
64 |
@@ -115,7 +119,7 @@ |
65 |
All Installation CDs allow you to boot, set up networking, initialize your |
66 |
partitions and start installing Gentoo from the Internet. We currently provide |
67 |
two Installation CDs which are equally suitable to install Gentoo from, as long |
68 |
-as you're planning on performing an Internet-based installation using the |
69 |
+as you're planning on performing an Internet-based installation using the |
70 |
latest version of the available packages. |
71 |
</p> |
72 |
|
73 |
@@ -132,8 +136,8 @@ |
74 |
|
75 |
<ul> |
76 |
<li> |
77 |
- The Gentoo <e>Minimal</e> Installation CD, a small, no-nonsense, bootable |
78 |
- CD which sole purpose is to boot the system, prepare the networking and |
79 |
+ The Gentoo <e>Minimal</e> Installation CD, a small, no-nonsense, bootable |
80 |
+ CD which sole purpose is to boot the system, prepare the networking and |
81 |
continue with the Gentoo installation. |
82 |
</li> |
83 |
<li> |
84 |
@@ -247,9 +251,9 @@ |
85 |
<body> |
86 |
|
87 |
<p> |
88 |
-You have chosen to use a Gentoo Installation CD. We'll first start by |
89 |
-downloading and burning the chosen Installation CD. We previously discussed |
90 |
-the several available Installation CDs, but where can you find them? |
91 |
+You have chosen to use a Gentoo Installation CD. We'll first start by |
92 |
+downloading and burning the chosen Installation CD. We previously discussed |
93 |
+the several available Installation CDs, but where can you find them? |
94 |
</p> |
95 |
|
96 |
<p> |
97 |
@@ -298,8 +302,8 @@ |
98 |
|
99 |
<ul> |
100 |
<li> |
101 |
- With cdrecord, you simply type <c>cdrecord dev=/dev/hdc <downloaded iso |
102 |
- file></c> (replace <path>/dev/hdc</path> with your CD-RW drive's |
103 |
+ With cdrecord, you simply type <c>cdrecord dev=/dev/hdc <downloaded iso |
104 |
+ file></c> (replace <path>/dev/hdc</path> with your CD-RW drive's |
105 |
device path). |
106 |
</li> |
107 |
<li> |
108 |
@@ -316,10 +320,10 @@ |
109 |
|
110 |
<p> |
111 |
Once you have burnt your installation CD, it is time to boot it. |
112 |
-Remove all CDs from your CD drives, reboot your system and enter the BIOS. |
113 |
-This is usually done by hitting DEL, F1 or ESC, depending on your BIOS. Inside |
114 |
-the BIOS, change the boot order so that the CD-ROM is tried before the hard |
115 |
-disk. This is often found under "CMOS Setup". If you don't do this, your system |
116 |
+Remove all CDs from your CD drives, reboot your system and enter the BIOS. |
117 |
+This is usually done by hitting DEL, F1 or ESC, depending on your BIOS. Inside |
118 |
+the BIOS, change the boot order so that the CD-ROM is tried before the hard |
119 |
+disk. This is often found under "CMOS Setup". If you don't do this, your system |
120 |
will just reboot from the hard disk, ignoring the CD-ROM. |
121 |
</p> |
122 |
|
123 |
@@ -331,7 +335,7 @@ |
124 |
</p> |
125 |
|
126 |
<p> |
127 |
-Specifying a kernel? Yes, we provide several kernels on our Installation CDs. |
128 |
+Specifying a kernel? Yes, we provide several kernels on our Installation CDs. |
129 |
The default one is <c>gentoo</c>. Other kernels are for specific hardware needs |
130 |
and the <c>-nofb</c> variants which disable framebuffer. |
131 |
</p> |
132 |
@@ -387,142 +391,214 @@ |
133 |
|
134 |
<p> |
135 |
You can also provide kernel options. They represent optional settings you can |
136 |
-(de)activate at will. The following list is the same as the one you receive |
137 |
-when you press F2 at the bootscreen. |
138 |
+(de)activate at will. The following options are available when you press F2 at |
139 |
+the bootscreen. |
140 |
</p> |
141 |
|
142 |
-<pre caption="Options available to pass to your kernel of choice"> |
143 |
-<comment>Hardware options:</comment> |
144 |
- |
145 |
-acpi=on This loads support for ACPI and also causes the acpid daemon to |
146 |
- be started by the CD on boot. This is only needed if your |
147 |
- system requires ACPI to function properly. This is not |
148 |
- required for Hyperthreading support. |
149 |
- |
150 |
-acpi=off Completely disables ACPI. This is useful on some older systems |
151 |
- and is also a requirement for using APM. This will disable any |
152 |
- Hyperthreading support of your processor. |
153 |
- |
154 |
-console=X This sets up serial console access for the CD. The first |
155 |
- option is the device, usually ttyS0 on x86, followed by any |
156 |
- connection options, which are comma separated. The default |
157 |
- options are 9600,8,n,1. |
158 |
- |
159 |
-dmraid=X This allows for passing options to the device-mapper RAID |
160 |
- subsystem. Options should be encapsulated in quotes. |
161 |
-doapm This loads APM driver support. This requires you to also use |
162 |
- acpi=off. |
163 |
- |
164 |
-dopcmcia This loads support for PCMCIA and Cardbus hardware and also |
165 |
- causes the pcmcia cardmgr to be started by the CD on boot. |
166 |
- This is only required when booting from PCMCIA/Cardbus devices. |
167 |
- |
168 |
-doscsi This loads support for most SCSI controllers. This is also a |
169 |
- requirement for booting most USB devices, as they use the SCSI |
170 |
- subsystem of the kernel. |
171 |
- |
172 |
-hda=stroke This allows you to partition the whole hard disk even when your |
173 |
- BIOS is unable to handle large disks. This option is only used |
174 |
- on machines with an older BIOS. Replace hda with the device |
175 |
- that is requiring this option. |
176 |
- |
177 |
-ide=nodma This forces the disabling of DMA in the kernel and is required |
178 |
- by some IDE chipsets and also by some CDROM drives. If your |
179 |
- system is having trouble reading from your IDE CDROM, try this |
180 |
- option. This also disables the default hdparm settings from |
181 |
- being executed. |
182 |
- |
183 |
-noapic This disables the Advanced Programmable Interrupt Controller |
184 |
- that is present on newer motherboards. It has been known to |
185 |
- cause some problems on older hardware. |
186 |
- |
187 |
-nodetect This disables all of the autodetection done by the CD, |
188 |
- including device autodetection and DHCP probing. This is |
189 |
- useful for doing debugging of a failing CD or driver. |
190 |
- |
191 |
-nodhcp This disables DHCP probing on detected network cards. This is |
192 |
- useful on networks with only static addresses. |
193 |
- |
194 |
-nodmraid Disables support for device-mapper RAID, such as that used for |
195 |
- on-board IDE/SATA RAID controllers. |
196 |
- |
197 |
-nofirewire This disables the loading of Firewire modules. This should |
198 |
- only be necessary if your Firewire hardware is causing |
199 |
- a problem with booting the CD. |
200 |
- |
201 |
-nogpm This diables gpm console mouse support. |
202 |
- |
203 |
-nohotplug This disables the loading of the hotplug and coldplug init |
204 |
- scripts at boot. This is useful for doing debugging of a |
205 |
- failing CD or driver. |
206 |
- |
207 |
-nokeymap This disables the keymap selection used to select non-US |
208 |
- keyboard layouts. |
209 |
- |
210 |
-nolapic This disables the local APIC on Uniprocessor kernels. |
211 |
- |
212 |
-nosata This disables the loading of Serial ATA modules. This is used |
213 |
- if your system is having problems with the SATA subsystem. |
214 |
- |
215 |
-nosmp This disables SMP, or Symmetric Multiprocessing, on SMP-enabled |
216 |
- kernels. This is useful for debugging SMP-related issues with |
217 |
- certain drivers and motherboards. |
218 |
- |
219 |
-nosound This disables sound support and volume setting. This is useful |
220 |
- for systems where sound support causes problems. |
221 |
- |
222 |
-nousb This disables the autoloading of USB modules. This is useful |
223 |
- for debugging USB issues. |
224 |
- |
225 |
-slowusb This adds some extra pauses into the boot process for slow |
226 |
- USB CDROMs, like in the IBM BladeCenter. |
227 |
- |
228 |
-<comment>Volume/Device Management:</comment> |
229 |
- |
230 |
-doevms This enables support for IBM's pluggable EVMS, or Enterprise |
231 |
- Volume Management System. This is not safe to use with lvm. |
232 |
- |
233 |
-dolvm This enables support for Linux's Logical Volume Management. |
234 |
- This is not safe to use with evms. |
235 |
- |
236 |
-<comment>Other options:</comment> |
237 |
- |
238 |
-debug Enables debugging code. This might get messy, as it displays |
239 |
- a lot of data to the screen. |
240 |
- |
241 |
-docache This caches the entire runtime portion of the CD into RAM, |
242 |
- which allows you to umount /mnt/cdrom and mount another CDROM. |
243 |
- This option requires that you have at least twice as much |
244 |
- available RAM as the size of the CD. |
245 |
- |
246 |
-doload=X This causes the initial ramdisk to load any module listed, as |
247 |
- well as dependencies. Replace X with the module name. |
248 |
- |
249 |
- Multiple modules can be specified by a comma-separated list. |
250 |
- |
251 |
-dosshd Starts sshd on boot, which is useful for unattended installs. |
252 |
- |
253 |
-passwd=foo Sets whatever follows the equals as the root password, which |
254 |
- is required for dosshd since we scramble the root password. |
255 |
- |
256 |
-noload=X This causes the initial ramdisk to skip the loading of a |
257 |
- specific module that may be causing a problem. Syntax matches |
258 |
- that of doload. |
259 |
- |
260 |
-nonfs Disables the starting of portmap/nfsmount on boot. |
261 |
- |
262 |
-nox This causes an X-enabled LiveCD to not automatically start X, |
263 |
- but rather, to drop to the command line instead. |
264 |
- |
265 |
-scandelay This causes the CD to pause for 10 seconds during certain |
266 |
- portions the boot process to allow for devices that are slow to |
267 |
- initialize to be ready for use. |
268 |
+<p> |
269 |
+<brite>Hardware options:</brite> |
270 |
+</p> |
271 |
|
272 |
-scandelay=X This allows you to specify a given delay, in seconds, to be |
273 |
- added to certain portions of the boot process to allow for |
274 |
- devices that are slow to initialize to be ready for use. |
275 |
- Replace X with the number of seconds to pause. |
276 |
-</pre> |
277 |
+<dl> |
278 |
+<dt>acpi=on</dt> |
279 |
+<dd> |
280 |
+ This loads support for ACPI and also causes the acpid daemon to be started by |
281 |
+ the CD on boot. This is only needed if your system requires ACPI to function |
282 |
+ properly. This is not required for Hyperthreading support. |
283 |
+</dd> |
284 |
+<dt>acpi=off</dt> |
285 |
+<dd> |
286 |
+ Completely disables ACPI. This is useful on some older systems and is also a |
287 |
+ requirement for using APM. This will disable any Hyperthreading support of |
288 |
+ your processor. |
289 |
+</dd> |
290 |
+<dt>console=X</dt> |
291 |
+<dd> |
292 |
+ This sets up serial console access for the CD. The first option is the |
293 |
+ device, usually ttyS0 on x86, followed by any connection options, which are |
294 |
+ comma separated. The default options are 9600,8,n,1. |
295 |
+</dd> |
296 |
+<dt>dmraid=X</dt> |
297 |
+<dd> |
298 |
+ This allows for passing options to the device-mapper RAID subsystem. Options |
299 |
+ should be encapsulated in quotes. |
300 |
+</dd> |
301 |
+<dt>doapm</dt> |
302 |
+<dd> |
303 |
+ This loads APM driver support. This requires you to also use acpi=off. |
304 |
+</dd> |
305 |
+<dt>dopcmcia</dt> |
306 |
+<dd> |
307 |
+ This loads support for PCMCIA and Cardbus hardware and also causes the pcmcia |
308 |
+ cardmgr to be started by the CD on boot. This is only required when booting |
309 |
+ from PCMCIA/Cardbus devices. |
310 |
+</dd> |
311 |
+<dt>doscsi</dt> |
312 |
+<dd> |
313 |
+ This loads support for most SCSI controllers. This is also a requirement for |
314 |
+ booting most USB devices, as they use the SCSI subsystem of the kernel. |
315 |
+</dd> |
316 |
+<dt>hda=stroke</dt> |
317 |
+<dd> |
318 |
+ This allows you to partition the whole hard disk even when your BIOS is unable |
319 |
+ to handle large disks. This option is only used on machines with an older BIOS. |
320 |
+ Replace hda with the device that is requiring this option. |
321 |
+</dd> |
322 |
+<dt>ide=nodma</dt> |
323 |
+<dd> |
324 |
+ This forces the disabling of DMA in the kernel and is required by some IDE |
325 |
+ chipsets and also by some CDROM drives. If your system is having trouble |
326 |
+ reading from your IDE CDROM, try this option. This also disables the default |
327 |
+ hdparm settings from being executed. |
328 |
+</dd> |
329 |
+<dt>noapic</dt> |
330 |
+<dd> |
331 |
+ This disables the Advanced Programmable Interrupt Controller that is present |
332 |
+ on newer motherboards. It has been known to cause some problems on older |
333 |
+ hardware. |
334 |
+</dd> |
335 |
+<dt>nodetect</dt> |
336 |
+<dd> |
337 |
+ This disables all of the autodetection done by the CD, including device |
338 |
+ autodetection and DHCP probing. This is useful for doing debugging of a |
339 |
+ failing CD or driver. |
340 |
+</dd> |
341 |
+<dt>nodhcp</dt> |
342 |
+<dd> |
343 |
+ This disables DHCP probing on detected network cards. This is useful on |
344 |
+ networks with only static addresses. |
345 |
+</dd> |
346 |
+<dt>nodmraid</dt> |
347 |
+<dd> |
348 |
+ Disables support for device-mapper RAID, such as that used for on-board |
349 |
+ IDE/SATA RAID controllers. |
350 |
+</dd> |
351 |
+<dt>nofirewire</dt> |
352 |
+<dd> |
353 |
+ This disables the loading of Firewire modules. This should only be necessary |
354 |
+ if your Firewire hardware is causing a problem with booting the CD. |
355 |
+</dd> |
356 |
+<dt>nogpm</dt> |
357 |
+<dd> |
358 |
+ This diables gpm console mouse support. |
359 |
+</dd> |
360 |
+<dt>nohotplug</dt> |
361 |
+<dd> |
362 |
+ This disables the loading of the hotplug and coldplug init scripts at boot. |
363 |
+ This is useful for doing debugging of a failing CD or driver. |
364 |
+</dd> |
365 |
+<dt>nokeymap</dt> |
366 |
+<dd> |
367 |
+ This disables the keymap selection used to select non-US keyboard layouts. |
368 |
+</dd> |
369 |
+<dt>nolapic</dt> |
370 |
+<dd> |
371 |
+ This disables the local APIC on Uniprocessor kernels. |
372 |
+</dd> |
373 |
+<dt>nosata</dt> |
374 |
+<dd> |
375 |
+ This disables the loading of Serial ATA modules. This is used if your system |
376 |
+ is having problems with the SATA subsystem. |
377 |
+</dd> |
378 |
+<dt>nosmp</dt> |
379 |
+<dd> |
380 |
+ This disables SMP, or Symmetric Multiprocessing, on SMP-enabled kernels. This |
381 |
+ is useful for debugging SMP-related issues with certain drivers and |
382 |
+ motherboards. |
383 |
+</dd> |
384 |
+<dt>nosound</dt> |
385 |
+<dd> |
386 |
+ This disables sound support and volume setting. This is useful for systems |
387 |
+ where sound support causes problems. |
388 |
+</dd> |
389 |
+<dt>nousb</dt> |
390 |
+<dd> |
391 |
+ This disables the autoloading of USB modules. This is useful for debugging |
392 |
+ USB issues. |
393 |
+</dd> |
394 |
+<dt>slowusb</dt> |
395 |
+<dd> |
396 |
+ This adds some extra pauses into the boot process for slow USB CDROMs, like |
397 |
+ in the IBM BladeCenter. |
398 |
+</dd> |
399 |
+</dl> |
400 |
+ |
401 |
+<p> |
402 |
+<brite>Volume/Device Management:</brite> |
403 |
+</p> |
404 |
+ |
405 |
+<dl> |
406 |
+<dt>doevms</dt> |
407 |
+<dd> |
408 |
+ This enables support for IBM's pluggable EVMS, or Enterprise Volume |
409 |
+ Management System. This is not safe to use with lvm. |
410 |
+</dd> |
411 |
+<dt>dolvm</dt> |
412 |
+<dd> |
413 |
+ This enables support for Linux's Logical Volume Management. This is not safe |
414 |
+ to use with evms. |
415 |
+</dd> |
416 |
+</dl> |
417 |
+ |
418 |
+<p> |
419 |
+<brite>Other options:</brite> |
420 |
+</p> |
421 |
+ |
422 |
+<dl> |
423 |
+<dt>debug</dt> |
424 |
+<dd> |
425 |
+ Enables debugging code. This might get messy, as it displays a lot of data to |
426 |
+ the screen. |
427 |
+</dd> |
428 |
+<dt>docache</dt> |
429 |
+<dd> |
430 |
+ This caches the entire runtime portion of the CD into RAM, which allows you |
431 |
+ to umount /mnt/cdrom and mount another CDROM. This option requires that you |
432 |
+ have |
433 |
+ at least twice as much available RAM as the size of the CD. |
434 |
+</dd> |
435 |
+<dt>doload=X</dt> |
436 |
+<dd> |
437 |
+ This causes the initial ramdisk to load any module listed, as well as |
438 |
+ dependencies. Replace X with the module name. |
439 |
+<br/> |
440 |
+ Multiple modules can be specified by a comma-separated list. |
441 |
+</dd> |
442 |
+<dt>dosshd</dt> |
443 |
+<dd> |
444 |
+ Starts sshd on boot, which is useful for unattended installs. |
445 |
+</dd> |
446 |
+<dt>passwd=foo</dt> |
447 |
+<dd> |
448 |
+ Sets whatever follows the equals as the root password, which is required for |
449 |
+ dosshd since we scramble the root password. |
450 |
+</dd> |
451 |
+<dt>noload=X</dt> |
452 |
+<dd> |
453 |
+ This causes the initial ramdisk to skip the loading of a specific module that |
454 |
+ may be causing a problem. Syntax matches that of doload. |
455 |
+</dd> |
456 |
+<dt>nonfs</dt> |
457 |
+<dd> |
458 |
+ Disables the starting of portmap/nfsmount on boot. |
459 |
+</dd> |
460 |
+<dt>nox</dt> |
461 |
+<dd> |
462 |
+ This causes an X-enabled LiveCD to not automatically start X, but rather, to |
463 |
+ drop to the command line instead. |
464 |
+</dd> |
465 |
+<dt>scandelay</dt> |
466 |
+<dd> |
467 |
+ This causes the CD to pause for 10 seconds during certain portions the boot |
468 |
+ process to allow for devices that are slow to initialize to be ready for use. |
469 |
+</dd> |
470 |
+<dt>scandelay=X</dt> |
471 |
+<dd> |
472 |
+ This allows you to specify a given delay, in seconds, to be added to certain |
473 |
+ portions of the boot process to allow for devices that are slow to initialize |
474 |
+ to be ready for use. Replace X with the number of seconds to pause. |
475 |
+</dd> |
476 |
+</dl> |
477 |
|
478 |
<note> |
479 |
The CD will check for "no*" options before "do*" options, so that you can |
480 |
@@ -568,11 +644,11 @@ |
481 |
majority of cases, it does a very good job. However, in some cases it may not |
482 |
auto-load the kernel modules you need. If the PCI auto-detection missed some of |
483 |
your system's hardware, you will have to load the appropriate kernel modules |
484 |
-manually. |
485 |
+manually. |
486 |
</p> |
487 |
|
488 |
<p> |
489 |
-In the next example we try to load the <c>8139too</c> module (support for |
490 |
+In the next example we try to load the <c>8139too</c> module (support for |
491 |
certain kinds of network interfaces): |
492 |
</p> |
493 |
|
494 |
@@ -620,7 +696,7 @@ |
495 |
<p> |
496 |
If you plan on giving other people access to your installation |
497 |
environment or you want to chat using <c>irssi</c> without root privileges (for |
498 |
-security reasons), you need to create the necessary user accounts and change |
499 |
+security reasons), you need to create the necessary user accounts and change |
500 |
the root password. |
501 |
</p> |
502 |
|
503 |
@@ -704,7 +780,7 @@ |
504 |
If you want to allow other users to access your computer during the |
505 |
Gentoo installation (perhaps because those users are going to help you |
506 |
install Gentoo, or even do it for you), you need to create a user |
507 |
-account for them and perhaps even provide them with your root password |
508 |
+account for them and perhaps even provide them with your root password |
509 |
(<e>only</e> do that <e>if</e> you <b>fully trust</b> that user). |
510 |
</p> |
511 |
|
512 |
|
513 |
|
514 |
|
515 |
-- |
516 |
gentoo-doc-cvs@l.g.o mailing list |