grml-cheatcodes.txt: update fromiso doc.
[grml-live.git] / templates / GRML / grml-cheatcodes.txt
index fabc281..08da580 100644 (file)
@@ -18,7 +18,6 @@ nofb                                Disable framebuffer
 floppy                              Boot from floppydisk
 hd / hd1 / hd2 / hd3                Boot from (local) primary / secondary /... harddisk
 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 a getty
 grub                                Boot Grub bootloader (special all-in-one-image)
@@ -28,7 +27,7 @@ hdt                                 Boot Hardware Detection Tool (from syslinux
 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
 * https://manpages.debian.org/live-boot-doc/live-boot.7.en.html
-* https://manpages.debian.org/initramfs-tools-core/initramfs-tools.8.en.html
+* https://manpages.debian.org/initramfs-tools-core/initramfs-tools.7.en.html
 * https://www.kernel.org/doc/html/latest/admin-guide/kernel-parameters.html
 
 The following boot options can be combined.
@@ -39,12 +38,10 @@ Regional settings:
 ------------------
 grml lang=at|de|cn|da|es|fr|it      Specify language ($LANG, $LC_ALL, $LANGUAGE - utf8) + keyboard
 grml lang=nl|pl|ru|sk|tr|tw|us      Specify language ($LANG, $LC_ALL, $LANGUAGE - utf8) + keyboard
-grml lang=$LANG-iso                 Activate $LANG (use like in lines above) with iso-mode instead of utf8
-grml gmt                            Use GMT-based time (UTC=yes)
-grml utc                            Use Coordinated Universal Time (UTC=yes)
-grml localtime                      Use local time (UTC=no)
-grml tz=Europe/Vienna               Use specified timezone for TZ
-grml keyboard=us xkeyboard=us       Use different keyboard layout (text-console/X)
+grml utc                            Hardware Clock is set to Coordinated Universal Time (UTC)
+grml localtime                      Hardware Clock is set to local time (LOCAL), this is the default
+grml tz=Europe/Vienna               Use specified timezone for TZ, defaults to TZ=UTC
+grml keyboard=us                    Use different keyboard layout
 
 Configuration settings:
 -----------------------
@@ -111,13 +108,20 @@ grml tohd=/dev/sda1                 Copy Grml's squashfs file to harddisk partit
                                     use via "grml bootfrom=/dev/sda1"
 grml bootfrom=/dev/sda1             Use the squashfs file from directory 'live' of the specified device
                                     Setup can be done booting 'grml tohd=/dev/sda1' or
-                                    running 'rsync -a --progress /lib/live/mount/medium/live /media/sda1/'
+                                    running 'rsync -a --progress /run/live/medium/live /media/sda1/'
 grml bootfrom=removable             Restrict search for the live media to removable type only.
 grml bootfrom=removable-usb         Restrict search for the live media to usb mass storage only.
-grml isofrom=/dev/sda1/grml.iso     Use specified ISO image for booting
-                                    Useful when booting as a rescue system from harddisk - just boot
-                                    the according grml kernel and initrd using the bootoptions
-                                    "boot=live isofrom=/dev/sda1/grml.iso"
+grml isofrom=[fs:][/device]/grml.iso  Use specified ISO image for booting.
+                                    Useful when booting as a rescue system from a different device.
+                                    If you want to load the image from a device different from the root device
+                                    specified through the bootloader, prefix its device path to the path, like
+                                    in "/dev/sda1/grml.iso".
+                                    Internally, the initrd will mount the given device, automatically detecting
+                                    the file system.
+                                    If needed, prefix the file system separated with a colon character to
+                                    override the automatic detection, like in "reiserfs:/dev/sda1/grml.iso".
+                                    As an example, boot the according grml kernel and initrd using the
+                                    bootoptions "boot=live isofrom=btrfs:/dev/vda40/path/to/grml.iso"
                                     Notice: "fromiso" does the same as "isofrom", it's just there
                                     to prevent any typing errors
 grml findiso=/grml_2010.12.iso      Look for the specified ISO file on all disks where it usually
@@ -174,10 +178,6 @@ grml services={postfix,mysql,...}   Start service(s) which have an init-script (
 grml welcome                        Welcome message via soundoutput
 grml noeject                        Do NOT eject CD after halt/reboot
 grml noprompt                       Do NOT prompt to remove the CD when halting/rebooting the system
-grml distcc=$NETWORK,$INTERFACE     Activate distcc-daemon to listen on specified network
-                                    and interface, usage example:
-                                    distcc=192.168.0.1/24,eth0
-grml gcc=3.4 gpp=3.4                Link /usr/bin/gcc, /usr/bin/cpp and /usr/bin/c++ to specified version
 grml startx{=windowmanager}         Start X window system automatically
                                     Default window manager (if not provided): wm-ng (wrapper around fluxbox)
 grml nostartx                       If using startx as default bootoption the nostartx *disables* automatic
@@ -192,6 +192,9 @@ grml vnc_connect=host[:port]        Connect to a listening VNC client ("vncviewe
                                     initiated from the VNC server instead of the VNC client. Has to be
                                     combined with the vnc bootoption.
                                     [Note: Grml 2011.12+ doesn't include a VNC client.]
+grml getfile.retries=$NUM           Retry the download of the files specified in the netconfig=... +
+                                    netscript=... options up to $NUM times
+
 
 Accessibility related settings:
 -------------------------------
@@ -214,22 +217,15 @@ grml ethdevice-timeout=...          Use specified network configuration timeout
 grml xmodule=ati|fbdev|i810|mga     Use specified X.org-Module (1)
 grml xmodule=nv|radeon|savage|s3    Use specified X.org-Module (2)
 grml xmodule=radeon|svga|i810       Use specified X.org-Module (3)
-grml no{acpi,agp,cpu,dhcp}          Skip parts of HW-detection (1)
-grml no{dma,fstab,modem}            Skip parts of HW-detection (2)
-grml no{pcmcia,scsi,swap,usb}       Skip parts of HW-detection (3)
+grml no{acpi,cpu,dhcp,fstab,swap}   Skip parts of HW-detection
 grml blacklist=modulename[,module2] Completely disable loading of specified module(s) via
                                     blacklisting through udev's /etc/modprobe.d/grml
-grml fwtimeout=50                   Set firmware timeout via /sys/class/firmware/timeout to specified value
 grml nosound                        Mute sound devices (notice: this does not deactivate loading of sound drivers!)
 grml vol=number                     Set mixer volumes to level $number
 grml micvol=number                  Set mixer volume of microphone to level $number (default: 0)
-grml pnpbios=off                    No PnP Bios initialization
 grml acpi=off                       Disable ACPI Bios completely
-grml nofirewire                     Disable initialization of firewire devices in booting sequence
 grml pci=irqmask=0x0e98             Try this, if PS/2 mouse doesn't work *)
 grml pci=bios                       Workaround for bad PCI controllers
-grml ide2=0x180 nopcmcia            Boot from PCMCIA-CD-ROM (some notebooks)
-grml mem=128M                       Specify Memory size in MByte
 grml libata.force=[ID:]VAL          Force configurations for libata.
                                     Usage example: grml libata.force=1:pio4
                                     to force pio4 mode on device "ata1:00:"
@@ -283,12 +279,6 @@ the "no-" options as shown in the table above, like in
    grml noagp noapic acpi=off nodma
 to skip some critical parts of the autodetection system.
 
-*) Some boards (especially those with E-ISA slots) apparently don't pass
-the proper memory size to the linux-kernel. It may cause the message
-"Panic: cannot mount root file system" and the system hangs. Use "grml
-mem=128M" to solve that problem if your system has 128MByte memory for
-example (caution: you MUST use a capital "M" here).
-
 *) The "myconfig=/dev/partition" option allows you to reconfigure the
 system after autoconfiguration by running a bourne shell script called
 "grml.sh" and/or extracting configuration files from a file named