templates/GRML/grml-cheatcodes.txt: document KMS and add URL for Documentation/kernel...
[grml-live.git] / templates / GRML / grml-cheatcodes.txt
index edcd6a7..c21af17 100644 (file)
@@ -20,20 +20,20 @@ failsafe                            Boot with (almost) no HW-detection
 debug                               Get shells during process of booting for debugging
 bootchart                           Create chart of booting sequence in /var/log/bootchart.tgz
 forensic                            Do not touch any harddisks during hardware recognition
-serial                              Activate ttyS0 and start mgetty
+serial                              Activate ttyS0 and start getty
 grub                                Boot Grub bootloader (special all-in-one-image)
 dos                                 Boot FreeDOS
 bsd                                 Boot MirOS BSD
 hdt                                 Boot Hardware Detection Tool (from syslinux project)
-qemu                                Boot with special options for use in Qemu
-vmware                              Boot with special options for use in VMware
 
-Further documentation regarding the init process can be found at:
+Further documentation regarding the boot process can be found at:
 * http://git.grml.org/?p=live-initramfs-grml.git;a=blob_plain;f=manpages/live-initramfs.en.7.txt;hb=HEAD
+* http://git.grml.org/?p=live-boot-grml.git;a=blob;f=manpages/en/live-boot.7;hb=HEAD
 * http://git.debian.org/?p=kernel/initramfs-tools.git;a=blob_plain;f=initramfs-tools.8;hb=HEAD
+* http://www.kernel.org/doc/Documentation/kernel-parameters.txt
 
 The following boot options can be combined.
-Notice: not all of the them are available on all the Grml flavours.
+Notice: not all of them are available on all the Grml flavours.
 For example the X window system is not part of grml-small.
 
 Regional settings:
@@ -63,11 +63,15 @@ grml file=foobar.tbz                Use specified file as name for configuration
                                     instead of the default one (config.tbz)
 grml extract=/etc                   Extract only /etc from configuration archive,
                                     use it in combination with myconfig or netconfig
-grml persistent                     Enable persistency feature, more details available at
+grml persistent=nofiles             Enable persistency feature, more details available at
                                     http://wiki.grml.org/doku.php?id=persistency
-grml hostname=...                   Set hostname
+                                    Notice that the "=nofiles" argument is optional, though recommended
+                                    as default setting.
+grml hostname=...                   Set hostname to given argument
 grml hostname                       Set a random hostname
+                                    [Note: only available with releases newer than 2010.04]
 grml nodhcphostname                 Do not to set the hostname according to the dns information
+grml nonetworking                   Do not create/overwrite /etc/network/interface during startup
 grml distri=...                     Set distribution name to given argument. If a jpg file named like the
                                     given distri name can be found in directory desktop on the ISO
                                     (/cdrom/desktop/"$DISTRI") it will be taken as wallpaper for grml
@@ -76,26 +80,30 @@ grml debnet                         Search through local partitions for file /et
 grml mypath=...                     Add specified option into $PATH of Zsh
                                     For example when using "grml mypath=/foobar" then /foobar
                                     will be added to the end of $PATH inside Zsh
-grml debs=path-name-wildcard        install Debian packages matching the path-name-wildcard in the
-                                    DCS dir
-grml scripts=path-name              execute script (defaulting to grml.sh) inside DCS dir. Path names
+grml debs                           Install all Debian packages from the "debs" directory of your DCS
+                                    directory (see myconfig=, typically the root of your ISO image).
+grml debs=path-name-wildcard        Install Debian packages from DCS directory (see myconfig=,
+                                    typically the root of your ISO image). If path does not contain a
+                                    "/" the package(s) will be installed from directory "debs" of the
+                                   DCS directory instead.  The "path-name-wildcard" can contain
+                                   wildcards (e.g. debs=rat* will install a packages starting with "rat"
+                                   from directory debs/).
+grml scripts=path-name              Execute script (defaulting to grml.sh) inside DCS dir. Path names
                                     allowed. If path-name points to a directory, all scripts found in
                                     the directory are executed.
-grml config=path-name               unpack archive that path-name points to
+grml config=path-name               Unpack archive that path-name points to
 grml noautoconfig                   Disable searching for device labeled GRMLCFG
 
 Notice: Take a look at http://grml.org/config/ and 'man 1 grml-autoconfig'
-for more information regarding the configuration framework of grml.
+for more information regarding the configuration framework of Grml.
 
 Booting related options:
 ------------------------
-grml2ram                            Copy Grml's squashfs file to RAM and run from there
 grml toram                          Copy the whole CD/medium to RAM and run from there
 grml toram=filename.squashfs        Copy the specified file to RAM and run from there
                                     Usage example: grml toram=grml-medium.squashfs
                                     Notice: grml2ram is an alias for this option which
                                     corresponds with the grml flavour settings by default
-
 grml tohd=/dev/sda1                 Copy Grml's squashfs file to harddisk partition for later
                                     use via "grml bootfrom=/dev/sda1"
 grml bootfrom=/dev/sda1             Use the squashfs file from directory 'live' of the specified device
@@ -109,7 +117,7 @@ grml isofrom=/dev/sda1/grml.iso     Use specified ISO image for booting
                                     "boot=live isofrom=/dev/sda1/grml.iso"
                                     Notice: "fromiso" does the same as "isofrom", it's just there
                                     to prevent any typing errors
-grml findiso=/grml_2010.04.iso      Look for the specified ISO file on all disks where it usually
+grml findiso=/grml_2010.12.iso      Look for the specified ISO file on all disks where it usually
                                     looks for the .squashfs file (so you don't have to know the device name
                                     as in isofrom=....).
 grml fetch=$IP/filename.squashfs    Download a squashfs image from a given url, copying to ram and booting it.
@@ -131,7 +139,6 @@ grml ignore_bootid                  Disable bootid verification.
 
 Debugging related settings:
 ---------------------------
-debug                               Get shells during process of booting, using GNU screen, be very verbose
 grml debug                          Get shells during process of booting, using GNU screen, be verbose
 grml debug=1                        Get shells during process of booting, using GNU screen, be verbose and
                                     display shell code being executed in initramfs.
@@ -222,8 +229,11 @@ grml libata.force=[ID:]VAL          Force configurations for libata.
                                     to force pio4 mode on device "ata1:00:"
 grml libata.dma=0                   Disable DMA on PATA and SATA devices
 grml libata.ignore_hpa=1            Disable host protected area (which should enable the whole disk)
-grml vga=normal [video=ofonly]      No-framebuffer mode (does not influence X)
-grml vga=ask [video=ofonly]         Display menu for framebuffer mode
+grml vga=normal                     No-framebuffer mode (does not influence X)
+grml vga=ask                        Display menu for framebuffer mode
+grml radeon.modeset=0  nomodeset    Disable Kernel Mode Setting (KMS) for Radeon driver.
+grml i915.modeset=0    nomodeset    Disable Kernel Mode Setting (KMS) for Intel driver.
+grml nouveau.modeset=0 nomodeset    Disable Kernel Mode Setting (KMS) for Nouveau driver.
 
 Installation related settings:
 ------------------------------