diff options
Diffstat (limited to 'catalyst/examples/README.txt')
-rw-r--r-- | catalyst/examples/README.txt | 113 |
1 files changed, 113 insertions, 0 deletions
diff --git a/catalyst/examples/README.txt b/catalyst/examples/README.txt new file mode 100644 index 0000000..0f052ff --- /dev/null +++ b/catalyst/examples/README.txt @@ -0,0 +1,113 @@ + +This file lists the possible command line options that can be used to tweak +the boot process of this CD. This lists the Gentoo-specific options, along +with a few options that are built-in to the kernel, but that have been proven +very useful to our users. Also, all options that start with "do" have a "no" +inverse, that does the opposite. For example, "doscsi" enables SCSI support +in the initial ramdisk boot, while "noscsi" disables it. + +Hardware options: + +acpi=on This loads support for ACPI and also causes the acpid daemon to + be started by the CD on boot. This is only needed if your + system requires ACPI to function properly. This is not required + for Hyperthreading support. +acpi=off Completely disables ACPI. This is useful on some older systems, + and is also a requirement for using APM. This will disable any + Hyperthreading support of your processor. +console=X This sets up serial console access for the CD. The first + option is the device, usually ttyS0 on x86, followed by any + connection options, which are comma separated. The default + options are 9600,8,n,1. +dmraid=X This allows for passing options to the device-mapper RAID + subsystem. Options should be encapsulated in quotes. +doapm This loads APM driver support. This requires you to also use + acpi=off. +dopcmcia This loads support for PCMCIA and Cardbus hardware and also + causes the pcmcia cardmgr to be started by the CD on boot. + This is only required when booting from a PCMCIA/Cardbus device. +doscsi This loads support for most SCSI controllers. This is also a + requirement for booting most USB devices, as they use the SCSI + subsystem of the kernel. +hda=stroke This allows you to partition the whole hard disk even when your + BIOS is unable to handle large disks. This option is only used + on machines with an older BIOS. Replace hda with the device + that is requiring this option. +ide=nodma This forces the disabling of DMA in the kernel and is required + by some IDE chipsets and also by some CDROM drives. If your + system is having trouble reading from your IDE CDROM, try this + option. This also disables the default hdparm settings from + being executed. +noapic This disables the Advanced Programmable Interrupt Controller + that is present on newer motherboards. It has been known to + cause some problems on older hardware. +nodetect This disables all of the autodetection done by the CD, including + device autodetection and DHCP probing. This is useful for doing + debugging of a failing CD or driver. +nodhcp This disables DHCP probing on detected network cards. This is + useful on networks with only static addresses. +nodmraid Disables support for device-mapper RAID, such as that used for + on-board IDE/SATA RAID controllers. +nofirewire This disables the loading of Firewire modules. This should only + be necessary if your Firewire hardware is causing a problem with + booting the CD. +nogpm This diables gpm console mouse support. +nohotplug This disables the loading of the hotplug and coldplug init + scripts at boot. This is useful for doing debugging of a + failing CD or driver. +nokeymap This disables the keymap selection used to select non-US + keyboard layouts. +nolapic This disables the local APIC on Uniprocessor kernels. +nosata This disables the loading of Serial ATA modules. This is useful + if your system is having problems with the SATA subsystem. +nosmp This disables SMP, or Symmetric Multiprocessing, on SMP-enabled + kernels. This is useful for debugging SMP-related issues with + certain drivers and motherboards. +nosound This disables sound support and volume setting. This is useful + for systems where sound support causes problems. +nousb This disables the autoloading of USB modules. This is useful + for debugging USB issues. + +Volume/Device Management: + +dodevfs This enables the deprecated device filesystem on 2.6 systems. + You will also need to use noudev for this to take effect. + Since devfs is the only option with a 2.4 kernel, this option + has no effect if booting a 2.4 kernel. +doevms2 This enables support for IBM's pluggable EVMS, or Enterprise + Volume Management System. This is not safe to use with lvm2. +dolvm2 This enables support for Linux's Logical Volume Management. + This is not safe to use with evms2. +noudev This disables udev support on 2.6 kernels. This option requires + that dodevfs is used. Since udev is not an option for 2.4 + kernels, this options has no effect if booting a 2.4 kernel. +unionfs Enables support for Unionfs on supported CD images. This will + create a writable Unionfs overlay in a tmpfs, allowing you to + change any file on the CD. +unionfs=X Enables support for Unionfs on supported CD images. This will + create a writable Unionfs overlay on the device you specify. + The device must be formatted with a filesystem recognized and + writable by the kernel. + +Other options: + +debug Enables debugging code. This might get messy, as it displays + a lot of data to the screen. +docache This caches the entire runtime portion of the CD into RAM, which + allows you to umount /mnt/cdrom and mount another CDROM. This + option requires that you have at least twice as much available + RAM as the size of the CD. +noload=X This causes the initial ramdisk to skip the loading of a + specific driver that may be causing a problem. Replace X with + the driver name. Multiple drivers can be specified by a + comma-separated list. +nox This causes an X-enabled LiveCD to not automatically start X, + but rather, to drop to the command line instead. +scandelay This causes the CD to pause for 10 seconds during certain + portions the boot process to allow for devices that are slow to + initialize to be ready for use. +scandelay=X This allows you to specify a given delay, in seconds, to be + added to certain portions of the boot process to allow for + devices that are slow to initialize to be ready for use. + Replace X with the number of seconds to pause. + |