Gentoo Archives: gentoo-doc-cvs

From: Xavier Neys <neysx@××××××××××××.org>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] cvs commit: hb-install-kernelparams.xml hb-install-x86+amd64-medium.xml
Date: Wed, 02 Apr 2008 16:43:06
Message-Id: E1Jh63C-0000cM-Lb@stork.gentoo.org
1 neysx 08/04/02 16:43:02
2
3 Modified: hb-install-x86+amd64-medium.xml
4 Added: hb-install-kernelparams.xml
5 Log:
6 Extracted kernel parameters into hb-install-kernelparams.xml which is
7 used by handbook/hb-install-x86+amd64-medium.xml and
8 handbook/2008.0/hb-install-gli-medium.xml
9
10 Revision Changes Path
11 1.12 xml/htdocs/doc/en/handbook/hb-install-x86+amd64-medium.xml
12
13 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-medium.xml?rev=1.12&view=markup
14 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-medium.xml?rev=1.12&content-type=text/plain
15 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-medium.xml?r1=1.11&r2=1.12
16
17 Index: hb-install-x86+amd64-medium.xml
18 ===================================================================
19 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-medium.xml,v
20 retrieving revision 1.11
21 retrieving revision 1.12
22 diff -u -r1.11 -r1.12
23 --- hb-install-x86+amd64-medium.xml 1 Apr 2008 17:21:03 -0000 1.11
24 +++ hb-install-x86+amd64-medium.xml 2 Apr 2008 16:43:02 -0000 1.12
25 @@ -4,7 +4,7 @@
26 <!-- The content of this document is licensed under the CC-BY-SA license -->
27 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
28
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 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-medium.xml,v 1.12 2008/04/02 16:43:02 neysx Exp $ -->
31
32 <sections>
33
34 @@ -386,219 +386,19 @@
35 </tr>
36 </table>
37
38 -</body>
39 -<body>
40 -
41 <p>
42 You can also provide kernel options. They represent optional settings you can
43 (de)activate at will. The following options are available when you press F2 at
44 the bootscreen.
45 </p>
46
47 -<p>
48 -<brite>Hardware options:</brite>
49 -</p>
50 +</body>
51
52 -<dl>
53 -<dt>acpi=on</dt>
54 -<dd>
55 - This loads support for ACPI and also causes the acpid daemon to be started by
56 - the CD on boot. This is only needed if your system requires ACPI to function
57 - properly. This is not required for Hyperthreading support.
58 -</dd>
59 -<dt>acpi=off</dt>
60 -<dd>
61 - Completely disables ACPI. This is useful on some older systems and is also a
62 - requirement for using APM. This will disable any Hyperthreading support of
63 - your processor.
64 -</dd>
65 -<dt>console=X</dt>
66 -<dd>
67 - This sets up serial console access for the CD. The first option is the
68 - device, usually ttyS0 on x86, followed by any connection options, which are
69 - comma separated. The default options are 9600,8,n,1.
70 -</dd>
71 -<dt>dmraid=X</dt>
72 -<dd>
73 - This allows for passing options to the device-mapper RAID subsystem. Options
74 - should be encapsulated in quotes.
75 -</dd>
76 -<dt>doapm</dt>
77 -<dd>
78 - This loads APM driver support. This requires you to also use acpi=off.
79 -</dd>
80 -<dt>dopcmcia</dt>
81 -<dd>
82 - This loads support for PCMCIA and Cardbus hardware and also causes the pcmcia
83 - cardmgr to be started by the CD on boot. This is only required when booting
84 - from PCMCIA/Cardbus devices.
85 -</dd>
86 -<dt>doscsi</dt>
87 -<dd>
88 - This loads support for most SCSI controllers. This is also a requirement for
89 - booting most USB devices, as they use the SCSI subsystem of the kernel.
90 -</dd>
91 -<dt>hda=stroke</dt>
92 -<dd>
93 - This allows you to partition the whole hard disk even when your BIOS is unable
94 - to handle large disks. This option is only used on machines with an older BIOS.
95 - Replace hda with the device that is requiring this option.
96 -</dd>
97 -<dt>ide=nodma</dt>
98 -<dd>
99 - This forces the disabling of DMA in the kernel and is required by some IDE
100 - chipsets and also by some CDROM drives. If your system is having trouble
101 - reading from your IDE CDROM, try this option. This also disables the default
102 - hdparm settings from being executed.
103 -</dd>
104 -<dt>noapic</dt>
105 -<dd>
106 - This disables the Advanced Programmable Interrupt Controller that is present
107 - on newer motherboards. It has been known to cause some problems on older
108 - hardware.
109 -</dd>
110 -<dt>nodetect</dt>
111 -<dd>
112 - This disables all of the autodetection done by the CD, including device
113 - autodetection and DHCP probing. This is useful for doing debugging of a
114 - failing CD or driver.
115 -</dd>
116 -<dt>nodhcp</dt>
117 -<dd>
118 - This disables DHCP probing on detected network cards. This is useful on
119 - networks with only static addresses.
120 -</dd>
121 -<dt>nodmraid</dt>
122 -<dd>
123 - Disables support for device-mapper RAID, such as that used for on-board
124 - IDE/SATA RAID controllers.
125 -</dd>
126 -<dt>nofirewire</dt>
127 -<dd>
128 - This disables the loading of Firewire modules. This should only be necessary
129 - if your Firewire hardware is causing a problem with booting the CD.
130 -</dd>
131 -<dt>nogpm</dt>
132 -<dd>
133 - This diables gpm console mouse support.
134 -</dd>
135 -<dt>nohotplug</dt>
136 -<dd>
137 - This disables the loading of the hotplug and coldplug init scripts at boot.
138 - This is useful for doing debugging of a failing CD or driver.
139 -</dd>
140 -<dt>nokeymap</dt>
141 -<dd>
142 - This disables the keymap selection used to select non-US keyboard layouts.
143 -</dd>
144 -<dt>nolapic</dt>
145 -<dd>
146 - This disables the local APIC on Uniprocessor kernels.
147 -</dd>
148 -<dt>nosata</dt>
149 -<dd>
150 - This disables the loading of Serial ATA modules. This is used if your system
151 - is having problems with the SATA subsystem.
152 -</dd>
153 -<dt>nosmp</dt>
154 -<dd>
155 - This disables SMP, or Symmetric Multiprocessing, on SMP-enabled kernels. This
156 - is useful for debugging SMP-related issues with certain drivers and
157 - motherboards.
158 -</dd>
159 -<dt>nosound</dt>
160 -<dd>
161 - This disables sound support and volume setting. This is useful for systems
162 - where sound support causes problems.
163 -</dd>
164 -<dt>nousb</dt>
165 -<dd>
166 - This disables the autoloading of USB modules. This is useful for debugging
167 - USB issues.
168 -</dd>
169 -<dt>slowusb</dt>
170 -<dd>
171 - This adds some extra pauses into the boot process for slow USB CDROMs, like
172 - in the IBM BladeCenter.
173 -</dd>
174 -</dl>
175 -
176 -<p>
177 -<brite>Volume/Device Management:</brite>
178 -</p>
179 -
180 -<dl>
181 -<dt>doevms</dt>
182 -<dd>
183 - This enables support for IBM's pluggable EVMS, or Enterprise Volume
184 - Management System. This is not safe to use with lvm.
185 -</dd>
186 -<dt>dolvm</dt>
187 -<dd>
188 - This enables support for Linux's Logical Volume Management. This is not safe
189 - to use with evms.
190 -</dd>
191 -</dl>
192 -
193 -<p>
194 -<brite>Other options:</brite>
195 -</p>
196 -
197 -<dl>
198 -<dt>debug</dt>
199 -<dd>
200 - Enables debugging code. This might get messy, as it displays a lot of data to
201 - the screen.
202 -</dd>
203 -<dt>docache</dt>
204 -<dd>
205 - This caches the entire runtime portion of the CD into RAM, which allows you
206 - to umount /mnt/cdrom and mount another CDROM. This option requires that you
207 - have
208 - at least twice as much available RAM as the size of the CD.
209 -</dd>
210 -<dt>doload=X</dt>
211 -<dd>
212 - This causes the initial ramdisk to load any module listed, as well as
213 - dependencies. Replace X with the module name.
214 -<br/>
215 - Multiple modules can be specified by a comma-separated list.
216 -</dd>
217 -<dt>dosshd</dt>
218 -<dd>
219 - Starts sshd on boot, which is useful for unattended installs.
220 -</dd>
221 -<dt>passwd=foo</dt>
222 -<dd>
223 - Sets whatever follows the equals as the root password, which is required for
224 - dosshd since we scramble the root password.
225 -</dd>
226 -<dt>noload=X</dt>
227 -<dd>
228 - This causes the initial ramdisk to skip the loading of a specific module that
229 - may be causing a problem. Syntax matches that of doload.
230 -</dd>
231 -<dt>nonfs</dt>
232 -<dd>
233 - Disables the starting of portmap/nfsmount on boot.
234 -</dd>
235 -<dt>nox</dt>
236 -<dd>
237 - This causes an X-enabled LiveCD to not automatically start X, but rather, to
238 - drop to the command line instead.
239 -</dd>
240 -<dt>scandelay</dt>
241 -<dd>
242 - This causes the CD to pause for 10 seconds during certain portions the boot
243 - process to allow for devices that are slow to initialize to be ready for use.
244 -</dd>
245 -<dt>scandelay=X</dt>
246 -<dd>
247 - This allows you to specify a given delay, in seconds, to be added to certain
248 - portions of the boot process to allow for devices that are slow to initialize
249 - to be ready for use. Replace X with the number of seconds to pause.
250 -</dd>
251 -</dl>
252 +<body>
253 + <include href="hb-install-kernelparams.xml"/>
254 +</body>
255 +
256 +<body>
257
258 <note>
259 The CD will check for "no*" options before "do*" options, so that you can
260
261
262
263 1.1 xml/htdocs/doc/en/handbook/hb-install-kernelparams.xml
264
265 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-install-kernelparams.xml?rev=1.1&view=markup
266 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-install-kernelparams.xml?rev=1.1&content-type=text/plain
267
268 Index: hb-install-kernelparams.xml
269 ===================================================================
270 <?xml version='1.0' encoding="UTF-8"?>
271 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-kernelparams.xml,v 1.1 2008/04/02 16:43:02 neysx Exp $ -->
272 <!DOCTYPE included SYSTEM "/dtd/guide.dtd">
273
274 <included>
275
276 <version>1</version>
277 <date>2008-04-01</date>
278
279 <body>
280 <p>
281 <brite>Hardware options:</brite>
282 </p>
283
284 <dl>
285 <dt>acpi=on</dt>
286 <dd>
287 This loads support for ACPI and also causes the acpid daemon to be started by
288 the CD on boot. This is only needed if your system requires ACPI to function
289 properly. This is not required for Hyperthreading support.
290 </dd>
291 <dt>acpi=off</dt>
292 <dd>
293 Completely disables ACPI. This is useful on some older systems and is also a
294 requirement for using APM. This will disable any Hyperthreading support of
295 your processor.
296 </dd>
297 <dt>console=X</dt>
298 <dd>
299 This sets up serial console access for the CD. The first option is the
300 device, usually ttyS0 on x86, followed by any connection options, which are
301 comma separated. The default options are 9600,8,n,1.
302 </dd>
303 <dt>dmraid=X</dt>
304 <dd>
305 This allows for passing options to the device-mapper RAID subsystem. Options
306 should be encapsulated in quotes.
307 </dd>
308 <dt>doapm</dt>
309 <dd>
310 This loads APM driver support. This requires you to also use acpi=off.
311 </dd>
312 <dt>dopcmcia</dt>
313 <dd>
314 This loads support for PCMCIA and Cardbus hardware and also causes the pcmcia
315 cardmgr to be started by the CD on boot. This is only required when booting
316 from PCMCIA/Cardbus devices.
317 </dd>
318 <dt>doscsi</dt>
319 <dd>
320 This loads support for most SCSI controllers. This is also a requirement for
321 booting most USB devices, as they use the SCSI subsystem of the kernel.
322 </dd>
323 <dt>hda=stroke</dt>
324 <dd>
325 This allows you to partition the whole hard disk even when your BIOS is unable
326 to handle large disks. This option is only used on machines with an older BIOS.
327 Replace hda with the device that is requiring this option.
328 </dd>
329 <dt>ide=nodma</dt>
330 <dd>
331 This forces the disabling of DMA in the kernel and is required by some IDE
332 chipsets and also by some CDROM drives. If your system is having trouble
333 reading from your IDE CDROM, try this option. This also disables the default
334 hdparm settings from being executed.
335 </dd>
336 <dt>noapic</dt>
337 <dd>
338 This disables the Advanced Programmable Interrupt Controller that is present
339 on newer motherboards. It has been known to cause some problems on older
340 hardware.
341 </dd>
342 <dt>nodetect</dt>
343 <dd>
344 This disables all of the autodetection done by the CD, including device
345 autodetection and DHCP probing. This is useful for doing debugging of a
346 failing CD or driver.
347 </dd>
348 <dt>nodhcp</dt>
349 <dd>
350 This disables DHCP probing on detected network cards. This is useful on
351 networks with only static addresses.
352 </dd>
353 <dt>nodmraid</dt>
354 <dd>
355 Disables support for device-mapper RAID, such as that used for on-board
356 IDE/SATA RAID controllers.
357 </dd>
358 <dt>nofirewire</dt>
359 <dd>
360 This disables the loading of Firewire modules. This should only be necessary
361 if your Firewire hardware is causing a problem with booting the CD.
362 </dd>
363 <dt>nogpm</dt>
364 <dd>
365 This diables gpm console mouse support.
366 </dd>
367 <dt>nohotplug</dt>
368 <dd>
369 This disables the loading of the hotplug and coldplug init scripts at boot.
370 This is useful for doing debugging of a failing CD or driver.
371 </dd>
372 <dt>nokeymap</dt>
373 <dd>
374 This disables the keymap selection used to select non-US keyboard layouts.
375 </dd>
376 <dt>nolapic</dt>
377 <dd>
378 This disables the local APIC on Uniprocessor kernels.
379 </dd>
380 <dt>nosata</dt>
381 <dd>
382 This disables the loading of Serial ATA modules. This is used if your system
383 is having problems with the SATA subsystem.
384 </dd>
385 <dt>nosmp</dt>
386 <dd>
387 This disables SMP, or Symmetric Multiprocessing, on SMP-enabled kernels. This
388 is useful for debugging SMP-related issues with certain drivers and
389 motherboards.
390 </dd>
391 <dt>nosound</dt>
392 <dd>
393 This disables sound support and volume setting. This is useful for systems
394 where sound support causes problems.
395 </dd>
396 <dt>nousb</dt>
397 <dd>
398 This disables the autoloading of USB modules. This is useful for debugging
399 USB issues.
400 </dd>
401 <dt>slowusb</dt>
402 <dd>
403 This adds some extra pauses into the boot process for slow USB CDROMs, like
404 in the IBM BladeCenter.
405 </dd>
406 </dl>
407
408 <p>
409 <brite>Volume/Device Management:</brite>
410 </p>
411
412 <dl>
413 <dt>doevms</dt>
414 <dd>
415 This enables support for IBM's pluggable EVMS, or Enterprise Volume
416 Management System. This is not safe to use with lvm.
417 </dd>
418 <dt>dolvm</dt>
419 <dd>
420 This enables support for Linux's Logical Volume Management. This is not safe
421 to use with evms.
422 </dd>
423 </dl>
424
425 <p>
426 <brite>Other options:</brite>
427 </p>
428
429 <dl>
430 <dt>debug</dt>
431 <dd>
432 Enables debugging code. This might get messy, as it displays a lot of data to
433 the screen.
434 </dd>
435 <dt>docache</dt>
436 <dd>
437 This caches the entire runtime portion of the CD into RAM, which allows you
438 to umount /mnt/cdrom and mount another CDROM. This option requires that you
439 have
440 at least twice as much available RAM as the size of the CD.
441 </dd>
442 <dt>doload=X</dt>
443 <dd>
444 This causes the initial ramdisk to load any module listed, as well as
445 dependencies. Replace X with the module name.
446 <br/>
447 Multiple modules can be specified by a comma-separated list.
448 </dd>
449 <dt>dosshd</dt>
450 <dd>
451 Starts sshd on boot, which is useful for unattended installs.
452 </dd>
453 <dt>passwd=foo</dt>
454 <dd>
455 Sets whatever follows the equals as the root password, which is required for
456 dosshd since we scramble the root password.
457 </dd>
458 <dt>noload=X</dt>
459 <dd>
460 This causes the initial ramdisk to skip the loading of a specific module that
461 may be causing a problem. Syntax matches that of doload.
462 </dd>
463 <dt>nonfs</dt>
464 <dd>
465 Disables the starting of portmap/nfsmount on boot.
466 </dd>
467 <dt>nox</dt>
468 <dd>
469 This causes an X-enabled LiveCD to not automatically start X, but rather, to
470 drop to the command line instead.
471 </dd>
472 <dt>scandelay</dt>
473 <dd>
474 This causes the CD to pause for 10 seconds during certain portions the boot
475 process to allow for devices that are slow to initialize to be ready for use.
476 </dd>
477 <dt>scandelay=X</dt>
478 <dd>
479 This allows you to specify a given delay, in seconds, to be added to certain
480 portions of the boot process to allow for devices that are slow to initialize
481 to be ready for use. Replace X with the number of seconds to pause.
482 </dd>
483 </dl>
484
485 </body>
486
487 </included>
488
489
490
491 --
492 gentoo-doc-cvs@l.g.o mailing list