summaryrefslogtreecommitdiffstats
path: root/README.txt
diff options
context:
space:
mode:
Diffstat (limited to 'README.txt')
-rw-r--r--README.txt89
1 files changed, 57 insertions, 32 deletions
diff --git a/README.txt b/README.txt
index 9b9cfda..243a40c 100644
--- a/README.txt
+++ b/README.txt
@@ -63,6 +63,41 @@ Slackware Live Edition knows two user accounts: "root" and "live". They have pa
Slackware Live Edition deviates as little as possible from a regular Slackware boot. Once you have passed the initial Liveboot stage and brought up the actual OS, you login as user "live". From that moment onwards, you are in a regular Slackware environment.
+==== Booting the Live OS ====
+
+
+=== BIOS boot ===
+
+
+Slackware Live Edition uses syslinux to boot the Linux kernel on BIOS computers. To be precise, the "isolinux" variant is installed to the ISO image and the "extlinux" variant is installed into the Linux partition of the USB Live version.
+
+Syslinux shows a graphical boot menu with a nice Slackware-themed background and several options:
+ * Start (SLACKWARE | PLASMA5 | XFCE | MATE) Live (depending on which of the ISOs you boot)
+ * Non-US Keyboard selection
+ * Non-US Language selection
+ * Memory test with memtest86+
+
+You can select a keyboard mapping that matches your computer's. Also you can boot Slackware in another language than US English.
+If you stick to US English interface language you will probably still want to change the timezone because it will default to UTC. You have to specify a custom timezone manually by adding "tz=YourGeography/YourLocation" because the syslinux bootmenu does not offer you a selection of timezones. Syslinux allows you to edit the boot commandline by pressing <TAB>. Press <ENTER> to boot after you made your changes or <ESC> to discard your edit and return to the menu.
+
+
+=== UEFI boot ===
+
+
+On UEFI computers, Grub2 handles the boot and it will show a menu similar (and similarly themed) to the Syslinux menu:
+
+ * Start (SLACKWARE | PLASMA5 | XFCE | MATE) Live (depending on which of the ISOs you boot)
+ * Non-US Keyboard selection
+ * Non-US Language selection
+ * Non-US Timezone selection
+ * Memory test with memtest86+
+ * Help on boot parameters
+
+Editing a Grub menu before booting it is possible by pressing the "e" key. After making your changes to the boot commandline, press <F10> to boot. To discard your changes, press <ESC>.
+
+Another difference between Syslinux and Grub2 menus: in Grub2 you can select a non-US keyboard, language and/or timezone and you will return to the main menu every time. You still have to select "Start SLACKWARE Live" to boot the computer. In the Syslinux menu, only the keyboard selection menu will return you to the main menu. Any non-US *language* selection on the other hand will boot you into Slackware Live immediately; without returning to the main menu. This is a limitation of syslinux which would require exponentially more menu files to construct a menu with more choices. Grub2 supports variables which make it easy to modify a menu entry's characteristics.
+
+
==== Transfering ISO content to USB stick ====
@@ -80,6 +115,8 @@ This script, called 'iso2usb.sh', accepts the following parameters: <code>
-i|--infile <filename> Full path to the ISO image file.
-o|--outdev <filename> The device name of your USB drive.
-p|--persistence <name> Custom name of the 'persistence' directory/file.
+ -r|--refresh Refresh the USB stick with the ISO content.
+ No formatting, do not touch user content.
-u|--unattended Do not ask any questions.
-v|--verbose Show verbose messages.
-w|--wait<number> Add <number> seconds wait time to initialize USB.
@@ -167,8 +204,18 @@ The following parameters are recognized by Slackware Live Edition. To boot with
The default is 4 for graphical login.
kbd=fr xkb=ch,fr => Example of custom X keyboard layout.
+ The parameter xkb can be set to "XkbLayout,XkbVariant,XkbOptions".
The boot menus will configure some of these for you but you can
of course always modify the values.
+ Note that the optional XkbOptions can be several comma-separated values.
+ The XkbLayout and XkbVariant values must not contain commas.
+ You can set just the XkbVariant by adding something like "kbd=ch xkb=,fr"
+
+For example "xkb=ch,fr,compose:sclk,grp:alt_shift_toggle"
+Note that the XkbOptions can be several comma-separated values.
+The XkbLayout and XkbVariant values must not contain commas.
+
+You can still set just the XkbVariant by adding something like "kbd=ch xkb=,fr"
livepw="somestring" => Change the password for user "live".
The password is passed as a cleartext string.
@@ -256,6 +303,9 @@ nop => No persistence, i.e. boot the virgin installation in
If you want to ignore any persistent data during boot,
including LUKS data, specify "nop luksvol=" .
+nop=wipe => Wipe all data from persistence directory or container.
+ Useful in cases where your persistent data got corrupted.
+
persistence=name => Use this if you are using a different
directory/file than "persistence" for storing persistent data.
@@ -513,7 +563,9 @@ The script's parameters are:
-t <doc|mandoc> Trim the ISO (remove man and/or doc).
-v Show debug/error output.
-z version Define your Slackware version (default: current).
+ -G Generate ISO file from existing directory tree
-H hostname Hostname of the Live OS (default: darkstar).
+ -M Add multilib (x86_64 only).
-O outfile Custom filename for the ISO.
-R runlevel Runlevel to boot into (default: 4).
-X Use xorriso instead of mkisofs/isohybrid.
@@ -542,6 +594,7 @@ You can create your own custom Live OS by changing its characteristics in the co
* The name of the Desktop variant (the script itself knows SLACKWARE, PLASMA5, XFCE, MATE and CINNAMON),
* The list(s) of packages used for your custom distribution,
+ * The name of the useraccount (by default that is "live"),
* The name of the distribution (by default that is "slackware"),
* And finally you can define a function "custom_config()" where you can add all your costom post-installation steps that are not covered in the "make_slackware_live.sh" script itself.
@@ -561,6 +614,10 @@ This is the section in ''make_slackware_live.conf'' which deals with these custo
# Your custom distro name (will reflect in boot screen & filenames):
#DISTRO="cinelerra"
+#OPTIONAL:
+# Name of the 'live' user account in the Live image:
+#LIVEUID="live"
+
# OPTIONAL:
# Marker used for finding the Slackware Live files:
#MARKER="CINELERRA"
@@ -651,38 +708,6 @@ Slackware Live Edition expects its modules to adhere to a particularly loose fil
- Example of an optional module: 0060-nvidia-352.79_4.4.1-current-x86_64.sxz
-=== BIOS boot ===
-
-
-Slackware Live Edition uses syslinux to boot the Linux kernel on BIOS computers. To be precise, the "isolinux" variant is installed to the ISO image and the "extlinux" variant is installed into the Linux partition of the USB Live version.
-
-Syslinux shows a graphical boot menu with a nice Slackware-themed background and several options:
- * Start (SLACKWARE | PLASMA5 | XFCE | MATE) Live (depending on which of the ISOs you boot)
- * Non-US Keyboard selection
- * Non-US Language selection
- * Memory test with memtest86+
-
-You can select a keyboard mapping that matches your computer's. Also you can boot Slackware in another language than US English.
-If you stick to US English interface language you will probably still want to change the timezone because it will default to UTC. You have to specify a custom timezone manually by adding "tz=YourGeography/YourLocation" because the syslinux bootmenu does not offer you a selection of timezones. Syslinux allows you to edit the boot commandline by pressing <TAB>. Press <ENTER> to boot after you made your changes or <ESC> to discard your edit and return to the menu.
-
-
-=== UEFI boot ===
-
-
-On UEFI computers, Grub2 handles the boot and it will show a menu similar (and similarly themed) to the Syslinux menu:
-
- * Start (SLACKWARE | PLASMA5 | XFCE | MATE) Live (depending on which of the ISOs you boot)
- * Non-US Keyboard selection
- * Non-US Language selection
- * Non-US Timezone selection
- * Memory test with memtest86+
- * Help on boot parameters
-
-Editing a Grub menu before booting it is possible by pressing the "e" key. After making your changes to the boot commandline, press <F10> to boot. To discard your changes, press <ESC>.
-
-Another difference between Syslinux and Grub2 menus: in Grub2 you can select a non-US keyboard, language and/or timezone and you will return to the main menu every time. You still have to select "Start SLACKWARE Live" to boot the computer. In the Syslinux menu, only the keyboard selection menu will return you to the main menu. Any non-US *language* selection on the other hand will boot you into Slackware Live immediately; without returning to the main menu. This is a limitation of syslinux which would require exponentially more menu files to construct a menu with more choices. Grub2 supports variables which make it easy to modify a menu entry's characteristics.
-
-
===== Other Slackware based Live distros =====