path: root/EFI/BOOT/help.txt
diff options
author Eric Hameleers <>2016-01-10 13:50:35 +0100
committer Eric Hameleers <>2016-01-10 13:50:35 +0100
commit710dea0bae3979d084021c910af3f53388e72603 (patch)
treea803c4fc60931c0068b350741c48022b4fda2dd2 /EFI/BOOT/help.txt
parent517c42b8aa7ef23d2f897aeb1e840dc0dca8d673 (diff)
BIOS (syslinux) and UEFI (grub2) boot: enhance the experience.
- generate the grub fonts (.pf2) ourselves instead of using the Slackware-provided grub font file. - expand the help text about the boot parameters. - show the liveslak version number in the boot menu. - remove the 'boot any OS' menu item in Grub because it never worked for me. - add a bit of Grub help text at the bottom of the screen. NOTES: - I do not like the way how I had to implement the Grub2 help menu, it is ugly. Perhaps the text artefacts and understrikes are caused by the fact that the grub console has to paint on top of the graphical boot menu? - In any case, the grub console (the black rectangle in the middle) has its coordinates hard-coded in the grub2 source so it is not configurable. - the grub fonts look better than in Beta3 but I am still not happy with them. Research on Grub boot menu enhancements done by Didier Spaier.
Diffstat (limited to 'EFI/BOOT/help.txt')
1 files changed, 66 insertions, 0 deletions
diff --git a/EFI/BOOT/help.txt b/EFI/BOOT/help.txt
new file mode 100644
index 0000000..2b1b54a
--- /dev/null
+++ b/EFI/BOOT/help.txt
@@ -0,0 +1,66 @@
+== Tweaks for the boot commandline ==
+To boot with default values just press ENTER.
+=== Desktop Environment ===
+0|1|2|3|4|5|6|S|s|single => Select a runlevel to start with.
+ The default is 4 for graphical login.
+kbd=fr xkb=ch,fr => Example of custom X keyboard layout.
+livepw="somestring" => Change the password for user "live".
+locale=nl_NL kbd=nl tz=Europe/Amsterdam => Example of language,
+ keyboard and/or timezone customization.
+rootpw="somestring" => Change the password for user "root".
+=== Custom software ===
+load=nvidia => Load and configure Nvidia drivers if available
+ in the ISO.
+load=mod1[,mod2[...]] => Load one or more squashfs modules
+ from the directory: "/liveslack/optional".
+ By default none of these modules is loaded on boot.
+noload=mod1[,mod2[...]] => Prevent loading of one or more
+ squashfs modules from the directory "/liveslack/addons".
+ By default all these modules are loaded on boot.
+=== Hardware related ===
+nomodeset => Boot without kernel mode setting, needed with
+ some machines.
+rootdelay=10 => Add 10 second delay to give the kernel more
+ time to initialize USB. Try this if booting fails.
+swap => Allow the Live OS to activate all swap partitions on
+ on the local hardware. By default, none is touched.
+=== Media tweaks ===
+livemedia=/dev/sdX => Tell the init script which partition
+ contains the Slackware Live OS you want to boot. This can
+ become necessary if you have another copy of Slackware Live
+ installed in another partition.
+livemain=directoryname => Use this if you copied the content
+ of the ISO to a different directory than "liveslak".
+nop => No persistence, i.e. boot the virgin installation in
+ case your "persistence" directory got corrupted.
+persistence=directoryname => Use this if you want to use
+ a different directory than "persistence" for storing
+ persistent data.
+=== Troubleshooting ===
+debug => During init, pause at specifiuc locations while as-
+ sembling the overlay filesystem and show mount information.
+rescue => After initialization, you will be dropped in a
+ rescue shell to perform lowlevel maintenance.