Merge remote-tracking branch 'origin/github/pr/148'
[grml-live.git] / templates / GRML / grml-cheatcodes.txt
index c2c1fe9..3dd33bf 100644 (file)
@@ -25,7 +25,6 @@ dos                                   Boot FreeDOS
 hdt                                   Boot Hardware Detection Tool (from syslinux project)
 
 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.7.en.html
 * https://www.kernel.org/doc/html/latest/admin-guide/kernel-parameters.html
@@ -104,11 +103,12 @@ grml toram=filename.squashfs          Copy the specified file to RAM and run fro
                                       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
-                                      Setup can be done booting 'grml tohd=/dev/sda1' or
-                                      running 'rsync -a --progress /run/live/medium/live /media/sda1/'
+                                      Setup can be done by executing:
+                                        rsync -a --progress /run/live/medium/live /media/sda1/
+                                      NOTE: you can can also use bootfrom=/dev/disk/by-label/yourlabel
+                                      (adjust yourlabel as needed), which should prevent choosing the
+                                      wrong block device (e.g. if more than one disk is present).
 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=[fs:][/device]/grml.iso  Use specified ISO image for booting.
@@ -122,8 +122,11 @@ grml isofrom=[fs:][/device]/grml.iso  Use specified ISO image for booting.
                                       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
+                                      NOTE: "fromiso" does the same as "isofrom", it's just there
                                       to prevent any typing errors
+                                      NOTE: you can can also use isofrom=/dev/disk/by-label/yourlabel
+                                      (adjust yourlabel as needed), which should prevent choosing the
+                                      wrong block device (e.g. if more than one disk is present).
 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=....).
@@ -206,9 +209,9 @@ Hardware related settings:
 grml swap                             Activate present/detected swap partitions
 grml noswraid                         Disable scanning for software raid arrays (creates /etc/mdadm/mdadm.conf)
 grml swraid                           Enable automatic assembling of software raid arrays
-grml nodmraid                         Do not enable present dmraid devices.
-grml dmraid=on                        Automatically enable any present dmraid devices.
-grml dmraid=off                       Actively try to stop any present dmraid devices.
+grml nodmraid                         Do not enable present dmraid devices (deprecated as of releases in 2024)
+grml dmraid=on                        Automatically enable any present dmraid devices (deprecated as of releases in 2024)
+grml dmraid=off                       Actively try to stop any present dmraid devices (deprecated as of releases in 2024)
 grml nolvm                            Disable scanning for Logical Volumes (LVM)
 grml lvm                              Automatically activate Logival Volumes (LVM) during boot
 grml read-only                        Make sure all harddisk devices (/dev/hd* /dev/sd*) are forced to read-only mode