[2024-feb-29] Sad news: Eric Layton aka Nocturnal Slacker aka vtel57 passed away on Feb 26th, shortly after hospitalization. He was one of our Wiki's most prominent admins. He will be missed.

Welcome to the Slackware Documentation Project

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
slackware:liveslak [2020/03/25 06:52 (UTC)] – [Downloading ISO images] remove dead mirror. alienbobslackware:liveslak [2023/06/25 19:32 (UTC)] (current) – [Boot parameters explained] Cosmetics. alienbob
Line 32: Line 32:
  
 The "liveslak" scripts can generate a variety of Slackware flavors: The "liveslak" scripts can generate a variety of Slackware flavors:
-  - a complete 64bit Slackware-current Live Edition (in a 3.GB ISO);+  - a complete 64bit Slackware-current Live Edition (in a 4.GB ISO);
   - a slimmed-down XFCE ISO (700 MB) with XDM as the graphical login manager.  It fits on a CDROM medium or a 1 GB USB stick;   - a slimmed-down XFCE ISO (700 MB) with XDM as the graphical login manager.  It fits on a CDROM medium or a 1 GB USB stick;
-  -  a ISO image (4.GB) of Slackware64-current containing Plasma 5 instead of KDE 4with an addition of several other packages from the alienBOB repositories: vlc, libreoffice, calibre, qbittorrent, ffmpeg, chromium, openjdkveracrypt+  -  a ISO image (4.GB) of Slackware64-current containing 'ktown' Plasma 5 instead of Slackware'KDE
-  - a Mate variant (2.2 GB) where KDE 4 has been replaced by Mate (a Gnome 2 fork);+  - A Digital Audio Workstation (DAW) based on a custom Slackware package set plus a basic Plasma5containing a rich software collection for musiciansproducers and live performance artists
 +  - a Mate variant (3.2 GB) where KDE 4 has been replaced by Mate (a Gnome 2 fork);
   - a Cinnamon flavour (a fork of the Gnome 3 Shell replacing Slackware's KDE 4).   - a Cinnamon flavour (a fork of the Gnome 3 Shell replacing Slackware's KDE 4).
   - a [[https://github.com/Dlackware/dlackware|Dlackware]] variant, which is Gnome3 + PAM + systemd on top of Slackware and stripped of KDE4.   - a [[https://github.com/Dlackware/dlackware|Dlackware]] variant, which is Gnome3 + PAM + systemd on top of Slackware and stripped of KDE4.
Line 46: Line 47:
  
 Common download locations are: Common download locations are:
-  * Primary site: http://slackware.nl/slackware-live/ (%%rsync://slackware.nl/mirrors/slackware-live/%%) +  * Primary site: https://download.liveslak.org/ (%%rsync://liveslak.org/liveslak/%%) 
-  * Darren'http://slackware.uk/people/alien-slacklive/ (%%rsync://slackware.uk/people/alien-slacklive/%%)+  * Darren'https://slackware.uk/liveslak/ (%%rsync://slackware.uk/liveslak%%)
   * Willy's http://repo.ukdw.ac.id/slackware-live/   * Willy's http://repo.ukdw.ac.id/slackware-live/
-  * Shasta's http://ftp.slackware.pl/pub/slackware-live/ (%%rsync://ftp.slackware.pl/slackware-live/%%) 
  
  
Line 74: Line 74:
  
 Syslinux shows a graphical boot menu with a nice Slackware-themed background and several options: 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)+  * Start (SLACKWARE | KTOWN | XFCE | MATE | DAW) Live (depending on which of the ISOs you boot)
   * Non-US Keyboard selection   * Non-US Keyboard selection
   * Non-US Language selection   * Non-US Language selection
Line 88: Line 88:
 On UEFI computers, Grub2 handles the boot and it will show a menu similar (and similarly themed) to the Syslinux menu: 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)+  * Start (SLACKWARE | KTOWN | XFCE | MATE | DAW) Live (depending on which of the ISOs you boot)
   * Non-US Keyboard selection   * Non-US Keyboard selection
   * Non-US Language selection   * Non-US Language selection
Line 99: Line 99:
 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. 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.
  
 +
 +=== UEFI Secure Boot ===
 +
 +
 +On computers with Secure Boot enabled, extra measures may be required to boot an Operating System.  Slackware for instance, is unable to boot on a computer that has Secure Boot enabled. Historic liveslak based ISOs are also not able to boot there. From liveslak-1.5.0 and onwards, Secure Boot is supported for the 64-bit ISO images.
 +
 +Secure Boot enforces that the first-stage bootloader is signed with an encryption key known to Microsoft.  For Linux based Operating Systems, the most widely used solution is to place an small single-purpose bootloader before the regular Linux bootloader.  This EFI bootloader is called 'shim' Shim must be cryptographically signed by Microsoft for it to successfully boot a computer.  This is not a trivial process, Microsoft is very strict about the signing process because in essence your signed bootloader will boot anything on a Secure Boot enabled computer, including malware if that was signed by your 'distro key' That would create a huge security hole and defy the purpose of Secure Boot.
 +
 +Signing your Grub bootloader and your kernel also becomes mandatory, because the 'shim' refuses to load un-signed binaries.  This complicates the process of upgrading to a new kernel further.
 +
 +The Slackware Live OS boots on a Secure Boot enabled computer if created with liveslak-1.5.0 or newer, and only for the 64-bit liveslak ISO images.  The Slackware Linux distro does not ship a 'shim' which is signed by Microsoft, so how to get around the dilemma of requiring a signed 'shim'?
 +
 +To realize this, the Slackware Live ISO 'borrows' a 3rd-party 'shim'. The binaryis actually called ''bootx64.efi'' in the ''/EFI/BOOT/'' directory and has been extracted from another distro's officially signed 'shim' package; Fedora by default but the Debian and openSUSE shim are also supported by the ''make_slackware_live.sh'' script.  This 3rd-party 'shim' binary has been signed by 'Microsoft UEFI CA' which will allow it to boot on any computer. We just need to tell it that is OK to load Slackware's Grub and kernel into memory.
 +
 +A distro 'shim' like Fedora's contains an embedded distro SSL certificate and 'shim' will trust the signature of any binary (grub, kernel, etc) which has been signed using that certificate. Of course, 3rd-party 'shim' binaries do not embed a Slackware SSL certificate. Therefore, another means must be used to establish trust.  Secure Boot recognizes additional SSL certificates in the computer's MOK (Machine Owner Key) database as valid.  The 'shim' trusts custom SSL vertificates of signed binaries, if they are present in the MOK database.  It is up to the user (the Machine Owner) to enroll a custom SSL certificate into that database.
 +
 +The Grub and kernel images of Slackware Live Edition are signed with an 'Alien BOB' SSL certificate and private key.  This SSL certificate needs to be added to the MOK database of your Secure Boot enabled computer.  All liveslak ISOs use this specific certificate plus its associated private key. The private key will of course never be distributed but a 'DER-encoded' version of the public certificate is distributed as part of the ISO.  You can find it as ''/EFI/BOOT/liveslak.der'' inside the ISO. On a persistent USB stick which you created from the ISO, this will be on the second partition (the ESP).
 +
 +== Add the ''liveslak.der'' certificate to the MOK database ==
 +
 +There are two ways to add or enroll this certificate.
 +  * When you boot a Secure Boot enabled liveslak ISO for the first time, the 'shim' will fail to validate the certificate of liveslak's Grub. It will then start the 'MokManager' showing you a nice blue screen with a dialog requesting you to enroll a public key (aka the SSL certificate) from disk. You can use the file selector to browse to the 'efi' partition and there to the ''./EFI/BOOT/'' directory. Select the ''liveslak.der'' and confirm that this is the correct certificate. The computer will then reboot and after reboot, you will automatically end up in the Grub boot menu without any further intervention.
 +  * If you already have a Linux OS up and running on that computer, you can use the program ''mokutil'' to enroll the key before you boot a liveslak ISO:<code>
 +# mokutil --import liveslak.der</code> This command will schedule a request to shim, and the first time you boot a liveslak ISO the MokManager will ask confirmation to enroll the scheduled key.  In other words, you won't have to 'enroll from disk'.
 +
 +Note that MOK key enrollment is a one-time action for the official liveslak based ISOs.  All future liveslak ISOs will also be signed using this ''liveslak.der'' certificate and as long as it stays in your computer's MOK database, the 'shim' will load Grub and the kernel without complaint.
 +
 +Note that you can create your own SSL certificate plus private key and use those to generate custom liveslak ISO images with Secure Boot support.  All you need to do is to enroll the public key (the DER-encoded version of your SSL certificate) into the MOK database of your computer.  The MOK database has room for multiple keys so yours as well as liveslak's keys (and more) will fit there.
 +
 +
 +=== Boot from an ISO file on disk ===
 +
 +
 +If you downloaded a liveslak ISO file and want to boot that ISO directly from its location on your computer's hard drive, you can use this Grub configuration block and add it to your ''/boot/grub/grub.cfg'' (the example code assumes you downloaded the XFCE ISO and stored it as "''/data/ISOS/slackware64-live-xfce-current.iso''"):<code>
 +menuentry "LIVESLAK ISO" --class gnu-linux --class os --class icon-linux {
 +  set iso='/data/ISOS/slackware64-live-xfce-current.iso'
 +  set bootparms='load_ramdisk=1 prompt_ramdisk=0 rw printk.time=0 kbd=us tz=Europe/Amsterdam lang=nl'
 + 
 +  search -f $iso --set=root
 +  loopback loop $iso
 +  linux (loop)/boot/generic livemedia=scandev:$iso $bootparms
 +  initrd (loop)/boot/initrd.img
 +}</code>
 +
 +This example will add a 'LIVESLAK ISO' menu entry to your local computer's boot menu, through which you can start a downloaded XFCE Live ISO pre-configured for a US keyboard, Dutch language and Amsterdam timezone. You should of course change the "''bootparms''" string so that it matches your requirements.
  
 ==== Transfering ISO content to USB stick ==== ==== Transfering ISO content to USB stick ====
Line 110: Line 155:
   -c|--crypt size|perc       Add a LUKS encrypted /home ; parameter is the   -c|--crypt size|perc       Add a LUKS encrypted /home ; parameter is the
                              requested size of the container in kB, MB, GB,                              requested size of the container in kB, MB, GB,
-                             or as a percentage of free space. +                             or as a percentage of free space 
-                             Examples: '-c 125M', '-c 1.3G', '-c 20%'.+                             (integer numbers only)
 +                             Examples: '-c 125M', '-c 2G', '-c 20%'.
   -d|--devices               List removable devices on this computer.   -d|--devices               List removable devices on this computer.
   -f|--force                 Ignore most warnings (except the back-out).   -f|--force                 Ignore most warnings (except the back-out).
Line 118: Line 164:
   -o|--outdev <filename>     The device name of your USB drive.   -o|--outdev <filename>     The device name of your USB drive.
   -p|--persistence <name>    Custom name of the 'persistence' directory/file.   -p|--persistence <name>    Custom name of the 'persistence' directory/file.
 +                             If it does not exist yet, create it manually.
   -r|--refresh               Refresh the USB stick with the ISO content.   -r|--refresh               Refresh the USB stick with the ISO content.
                              No formatting, do not touch user content.                              No formatting, do not touch user content.
Line 128: Line 175:
                              Use a LUKS-encrypted 'persistence' file instead                              Use a LUKS-encrypted 'persistence' file instead
                              of a directory (for use on FAT filesystem).                              of a directory (for use on FAT filesystem).
 +                             Format for size/percentage is the same
 +                             as for the '-c' parameter.
   -P|--persistfile           Use an unencrypted 'persistence' file instead   -P|--persistfile           Use an unencrypted 'persistence' file instead
                              of a directory (for use on FAT filesystem).                              of a directory (for use on FAT filesystem).
Line 145: Line 194:
  
 You might have noticed that the "-P" parameter does not accept a size parameter.  This is because the unencrypted container file is created as a 'sparse' file that starts at zero size and is allowed to grow dynmically to a maximum of 90% of the initial free space on the Linux partition of the USB stick. You might have noticed that the "-P" parameter does not accept a size parameter.  This is because the unencrypted container file is created as a 'sparse' file that starts at zero size and is allowed to grow dynmically to a maximum of 90% of the initial free space on the Linux partition of the USB stick.
 +
 +
 +==== Using the Live OS to install Slackware to hard disk ====
 +
 +All variants of Slackware Live Edition contain a script "setup2hd", a tweaked version of the regular Slackware setup program.
 +The "setup2hd" script supports regular Slackware network installations. In addition it allows you to install the Slackware release on which the Live OS is based, to the computer's local hard disk.  You must boot the Live OS first, and then start ''setup2hd'' either in an X Terminal in your graphical Desktop Environment (aka Runlevel 4), or from the console in Runlevel 3.  The fact that you can start "setup2hd" from a graphical terminal means that during installation, you can continue browsing, listening to music, watching video, reading an e-book or whatever else makes you pass the time.
 +
 +The "setup2hd" script has some capabilities that the original Slackware 'setup' lacks:
 +  * It will launch fdisk/gdisk if you forgot to create Linux partitions in advance;
 +  * It will allow you to create a regular user account and set its password;
 +  * It will prompt you to set the root password in a graphical dialog.
 +
  
 ==== Updating the kernel (and more) on a USB stick ==== ==== Updating the kernel (and more) on a USB stick ====
Line 342: Line 403:
   OS parameters; or specify 'write' to write current OS parameters   OS parameters; or specify 'write' to write current OS parameters
   to disk.   to disk.
 +
 +domain=your_custom_domain =>
 +  Specify a custom domain name.  Defaults to 'example.net'.
  
 hostname=your_custom_hostname[,qualifier] => hostname=your_custom_hostname[,qualifier] =>
Line 384: Line 448:
   Use this if you are using a different   Use this if you are using a different
   directory/file than "persistence" for storing persistent data.   directory/file than "persistence" for storing persistent data.
 +
 +persistence=/dev/sdX:/path/to/mypersistence
 +persistence=scandev:/path/to/mypersistence =>
 +  Use this if the persistence directory or container is not located on
 +  the USB stick, but on a local hard disk partition.
 +  Useful for network (PXE) boot where you still want to offer users persistence.
  
 toram => toram =>
-  copy the OS from the media to to RAM before running it.+  Copy the OS from the media to to RAM before running it.
   You can remove the boot media after booting.   You can remove the boot media after booting.
 +
 +toram=all =>
 +  Prevent writes to disk since we are supposed to run from RAM;
 +  equivalent to parameter "toram".
 +
 +toram=core =>
 +  Load Console OS modules into RAM.
 +  Console-only Slackware loads fast, contains 'setup2hd' and frees up your USB drive
 +  so you can overwrite it with a Persistent Live OS.
 +
 +toram=os =>
 +  Load OS modules into RAM, but write persistent data to USB.
  
 === Troubleshooting === === Troubleshooting ===
Line 472: Line 554:
     * the desktop environment is pre-configured for first use,     * the desktop environment is pre-configured for first use,
     * the liveslak scripts "makemod", "iso2usb.sh" and "upslak.sh" are copied to "/usr/local/sbin/" in the ISO for your convenience,     * the liveslak scripts "makemod", "iso2usb.sh" and "upslak.sh" are copied to "/usr/local/sbin/" in the ISO for your convenience,
-    * if the Live system contains a huge kernel (all ISO variants except XFCE) then the "setup2hd" script and the Slackware installer files are copied to "/usr/local/sbin" and "/usr/share/liveslak" respectively,+    * the "setup2hd" script and the Slackware installer files are copied to "/usr/local/sbin" and "/usr/share/liveslak" respectively.
     * slackpkg is configured,     * slackpkg is configured,
     * a locate database is created,     * a locate database is created,
Line 560: Line 642:
 The fourth script: The fourth script:
  
-The "setup2hd" script enables you to install the running Live OS to the computer's local hard disk.  The "setup2hd" is a modified Slackware installer, so you will be comfortable with the process.  There is no 'SOURCE' selection because the script knows where to find the squashfs modules.  After you select the target partition(s), every active module of the Live OS variant (SLACKWARE, PLASMA5, MATE, ...) is extracted to the hard drive.  After extraction has completed, the script summarizes how many modules have been extracted.  It will also show an example command to extract any remaining inactive or disabled modules manually.  The final step in the installation is again the stock Slackware installer which kicks off the Slackware configuration scripts.+The "setup2hd" script is a modified Slackware installer, so you will be comfortable with the process.  The 'SOURCE' section offers two types of choices:  a regular Slackware network installation using a NFS, HTTP, FTP or Samba server, as well as a choice of installing the Live OS which you are running. The script knows where to find the squashfs modules, so the "Install Live OS" selection will not prompt further inputs. 
 +  * The Slackware network installation is identical to that of the official Slackware installation medium. 
 +  * If you chose to install the Live OS, then after you select the target partition(s), every active module of the Live OS variant (SLACKWARE, KTOWN, MATE, ...) is extracted to the hard drive.  After extraction has completed, the script summarizes how many modules have been extracted.  It will also show an example command to extract any remaining inactive or disabled modules manually.  The final step in the installation is again the stock Slackware installer which kicks off the Slackware configuration scripts.
  
  
Line 649: Line 733:
   * README.txt - this documentation.   * README.txt - this documentation.
   * addons/ - squashfs modules placed in this directory will be loaded into the Live filesystem when the OS boots.   * addons/ - squashfs modules placed in this directory will be loaded into the Live filesystem when the OS boots.
 +  * contrib/ - contributed scripts that are not used directly for the creation and usage of a Live ISO.
   * graphics/ - squashfs modules for proprietary GPU support (Nvidia) can be placed here. The module(s) will be copied to addons/ by the "make_slackware_live.sh" script for any Live Desktop Environment (except pure Slackware) that might profit from proprietary driver support.   * graphics/ - squashfs modules for proprietary GPU support (Nvidia) can be placed here. The module(s) will be copied to addons/ by the "make_slackware_live.sh" script for any Live Desktop Environment (except pure Slackware) that might profit from proprietary driver support.
   * local64/ , local/ - these directories can contain Slackware packages considered 'local' i.e. not belonging to any repository.  The package(s) will be converted to squashfs module(s) by the "make_slackware_live.sh" script, copied to the "addons/" subdirectory in the ISO and loaded into the Live filesystem when the OS boots.   * local64/ , local/ - these directories can contain Slackware packages considered 'local' i.e. not belonging to any repository.  The package(s) will be converted to squashfs module(s) by the "make_slackware_live.sh" script, copied to the "addons/" subdirectory in the ISO and loaded into the Live filesystem when the OS boots.
 +  * media/ - scripts and images that are specific to a Live variant.
   * optional/ - squashfs modules placed in this directory will not automatically be loaded into the Live filesystem when the OS boots.  You need to pass "load=[mod]" boot parameter to load any of these.   * optional/ - squashfs modules placed in this directory will not automatically be loaded into the Live filesystem when the OS boots.  You need to pass "load=[mod]" boot parameter to load any of these.
 +  * patches/ - patches for Slackware scripts that need modifications to run inside a Live OS.
   * pkglists/ - definition files of 3rd party repositories (*.conf) and the package lists to be used from those repositories (*.lst) must be placed in this directory.   * pkglists/ - definition files of 3rd party repositories (*.conf) and the package lists to be used from those repositories (*.lst) must be placed in this directory.
 +  * setup2hd/ - script templates used by the ''setup2hd'' disk installer.
   * skel/ - contains compressed tarballs (whose filenames must match wildcard "skel*.txz"). These files will be extracted to the "/etc/skel" directory in the Live filesystem.   * skel/ - contains compressed tarballs (whose filenames must match wildcard "skel*.txz"). These files will be extracted to the "/etc/skel" directory in the Live filesystem.
   * syslinux/  - contains the skeleton for boot support on BIOS computers.  Some of its files are dynamically generated by the "make_slackware_live.sh" script.   * syslinux/  - contains the skeleton for boot support on BIOS computers.  Some of its files are dynamically generated by the "make_slackware_live.sh" script.
Line 675: Line 763:
   * pxeserver.tpl - template to generate the script that starts a PXE server allowing other computers to boot Slackware Live over the network.   * pxeserver.tpl - template to generate the script that starts a PXE server allowing other computers to boot Slackware Live over the network.
   * setup2hd.tpl  - template to generate the script you use to install your Slackware Live to a harddisk.   * setup2hd.tpl  - template to generate the script you use to install your Slackware Live to a harddisk.
-  * setup2hd.local - here a developer of a custom Live OS can override the default post-installation routine by (re-)defining the function "live_post_install()" in the ''setup2hd'' script.+  * setup2hd.local.tpl - here a developer of a custom Live OS can override the default post-installation routine by (re-)defining the function "live_post_install()" in the ''setup2hd'' script
 +  * upslak.sh - a script which allows you to tweak the content of a USB Live stick.
  
  
Line 688: Line 777:
  -c comp            Squashfs compression (default: xz).  -c comp            Squashfs compression (default: xz).
                     Can be any of 'gzip lzma lzo xz zstd'.                     Can be any of 'gzip lzma lzo xz zstd'.
- -d desktoptype     SLACKWARE (full Slack), KDE4 (basic KDE4), + -d desktoptype     SLACKWARE (full Slack), LEAN (basic Plasma5/XFCE), 
-                    XFCE (basic XFCE), PLASMA5 (KDE Plasma5 replaces KDE4), +                    DAW (Digital Audio Workstation), XFCE (basic XFCE
-                    MATE (Gnome2 fork replaces KDE4), CINNAMON (fork of Gnome3 +                    stripped), KTOWN (ktown Plasma5 replacement), MATE 
-                    Shell replaces KDE4), DLACK (adds Gnome3, PAM and systemd).+                    (Gnome2 fork replaces KDE), CINNAMON (fork of Gnome3 Shell 
 +                    replaces KDE), DLACK (Gnome3 replaces KDE).
  -e                 Use ISO boot-load-size of 32 for computers  -e                 Use ISO boot-load-size of 32 for computers
                     where the ISO won't boot otherwise (default: 4).                     where the ISO won't boot otherwise (default: 4).
Line 697: Line 787:
                     custom configurations and new initrd.img.                     custom configurations and new initrd.img.
  -l <localization>  Enable a different default localization  -l <localization>  Enable a different default localization
-                    (script-default is 'us').+                    (script-default is 'en').
  -m pkglst[,pkglst] Add modules defined by pkglists/<pkglst>,...  -m pkglst[,pkglst] Add modules defined by pkglists/<pkglst>,...
  -r series[,series] Refresh only one or a few package series.  -r series[,series] Refresh only one or a few package series.
  -s slackrepo_dir   Directory containing Slackware repository.  -s slackrepo_dir   Directory containing Slackware repository.
- -t <doc|mandoc>    Trim the ISO (remove man and/or doc).+ -t <none|doc|mandoc|bloat> 
 +                    Trim the ISO (remove man and/or doc and/or bloat).
  -v                 Show debug/error output.  -v                 Show debug/error output.
  -z version         Define your Slackware version (default: current).  -z version         Define your Slackware version (default: current).
 + -C                 Add RAM-based Console OS to boot menu.
  -G                 Generate ISO file from existing directory tree  -G                 Generate ISO file from existing directory tree
  -H <hostname>      Hostname of the Live OS (default: darkstar).  -H <hostname>      Hostname of the Live OS (default: darkstar).
Line 709: Line 801:
  -O <outfile>       Custom filename for the ISO.  -O <outfile>       Custom filename for the ISO.
  -R <runlevel>      Runlevel to boot into (default: 4).  -R <runlevel>      Runlevel to boot into (default: 4).
 + -S privkey:cert    Enable SecureBoot support and sign binaries
 +                    using the full path to colon-separated
 +                    private key and certificate files.
  -X                 Use xorriso instead of mkisofs/isohybrid.  -X                 Use xorriso instead of mkisofs/isohybrid.
 </code> </code>
Line 720: Line 815:
 Another example which creates a MATE variant, configuring runlevel '3' as default and specifying a custom path for the Slackware package repository root (note that the script will look for a subdirectory "slackware64-current" below this directory if you are generating this ISO for slackware64-current): Another example which creates a MATE variant, configuring runlevel '3' as default and specifying a custom path for the Slackware package repository root (note that the script will look for a subdirectory "slackware64-current" below this directory if you are generating this ISO for slackware64-current):
   # ./make_slackware_live.sh -d MATE -R 3 -s ~ftp/pub/Slackware   # ./make_slackware_live.sh -d MATE -R 3 -s ~ftp/pub/Slackware
 +
 +An example on how to create a DAW Live ISO which supports UEFI SecureBoot (since liveslak 1.5.0 and only for 64-bit), is compressed using 'zstd' instead of the default 'xz' and is generated using xorriso instead of mkisofs. You need to provide the full path to a SSL private key and certificate file:
 +  # ./make_slackware_live.sh -d DAW -c zstd -X -S /root/liveslak.key:/root/liveslak.pem
  
 If you want to know what package sets are included in any of these Desktop Environments, run the following command: If you want to know what package sets are included in any of these Desktop Environments, run the following command:
Line 728: Line 826:
  
  
-==== Using the Customization Feature of the Live OS ====+==== Using the Customization Features of the Live OS ==== 
  
 +=== Master configuration file ===
  
 You can create your own custom Live OS by changing its characteristics in the configuration file "''make_slackware_live.conf''". You can create your own custom Live OS by changing its characteristics in the configuration file "''make_slackware_live.conf''".
 Among the things you can change are: Among the things you can change are:
-  * The name of the Desktop variant (the script itself knows "//SLACKWARE//", "//PLASMA5//", "//XFCE//", "//MATE//", "//CINNAMON//", "//STUDIOWARE//" and  "//DLACK//"),+  * The name of the Desktop variant (the script itself knows "//SLACKWARE//", "//KTOWN//", "//DAW//", "//XFCE//", "//MATE//", "//CINNAMON//", "//STUDIOWARE//" and  "//DLACK//"),
   * The list(s) of packages used for your custom distribution,   * The list(s) of packages used for your custom distribution,
 +  * The full name of the user (by default that is "//Slackware Live User//"),
   * The name of the useraccount (by default that is "//live//"),   * The name of the useraccount (by default that is "//live//"),
   * The name of the distribution (by default that is "//slackware//"),   * The name of the distribution (by default that is "//slackware//"),
Line 782: Line 883:
 #} #}
 </code> </code>
 +
 +=== Customizing the list of used packages ===
 +
 +Any liveslak ISO variant contains a specific set of Slackware packages, as defined in the various ''SEQ_*'' variables used in the ''make_slackware_live.sh'' script.  Your customized Live OS will be using variable "''SEQ_CUSTOM''".
 +
 +Let's breakdown the definition of such a variable to explain how to customize the package set for your own live ISO.
 +
 +The list of packages in the MATE ISO for instance, is defined by the ''SEQ_MSB'' variable (//MSB// stands for //Mate Slack Build//).  Its value is as follows: <code>
 +# grep ^SEQ_MSB make_slackware_live.sh
 +SEQ_MSB="tagfile:a,ap,d,e,f,k,l,n,t,tcl,x,xap,xfce,y pkglist:slackextra,mate local:slackpkg+"</code>
 +
 +Three keywords can be identified in the value of a ''SEQ_*'' variable, and these determine where the packages to be installed are going to be searched for:
 +  * tagfile - this is an Slackware tagfile for a complete package series.  For instance, using "tagfile:ap" means: install all packages in the **AP** series.
 +  * pkglist - this is a list of packages to be installed from the Slackware distro itself or from a Slackware-compatible 3rd-party repository.  The file containing that package list is searched in the ''./pkglists/'' subdirectory of the liveslak toplevel directory.  For instance, using "pkglist:mate" means: install all packages mentioned in the file ''./pkglists/mate.lst'' If there is no matching ''./pkglists/mate.conf'' file then the packages are assumed to be present in the Slackware distro directory.  Else the ".conf" file is parsed and the variables that are defined in the ".conf" file will be used while generating the ISO.  Most importantly, "''SL_REPO_URL''" will contain the rsync URI pointing to the 3rd-party repository where the requested packages can be downloaded.
 +  * local - some packages can not be found in Slackware-compatible repositories.  The "local" keyword alows you to install packages from a subdirectory of the liveslak toplevel directory.  For instance, using "local:slackpkg+" means: install all packages found in subdirectory ''./local/slackpkg+/'' or if you are generating a 64bit live ISO, install all packages found in directory ''./local64/slackpkg+/''.
 +
 +For the value of a ''SEQ_*'' variable, any combination of these keywords can be used. Every keyword is followed by a colon, and that is followed by a comma-separated list of relevant package definitions. They are all separated by spaces.
 +
 +=== Custom background images ===
 +
 +The Plasma5 based Live variants allow customization of the background image used for the login greeter, the desktop wallpaper and the lock screen. The image you want to use for this purpose, must have a 16:9 aspect ratio and its dimensions should at least be 1920x1080 pixels. You  must store the custom image inside the liveslak source tree: in the subdirectory ''./media/<variant>/bg/'' where "<variant>" is the lower-case name of the Live variant (variant 'KTOWN' equals directory 'ktown', 'DAW' becomes 'daw', etc).
 +
 +The "make_slackware_live.sh" script will look there for a file named either "background.jpg" or "background.png". If you want, that file can be a symlink to the actual bitmap file. The image will be converted into a set of wallpaper images of different aspect ratios and sizes. The different aspect ratios like 16:9, 16:10 and 4:3 will be achieved by cropping the images if needed, to avoid distortion. The image set will be installed as a Plasma5 wallpaper called "Slackware Live", and configured to be the default Live OS background.
 +
 +
 ==== Internals of Slackware Live Edition ==== ==== Internals of Slackware Live Edition ====
  
Line 817: Line 943:
   * The filesystem of the Live media is made available to the user of the Live OS as "/mnt/livemedia" If the media is a USB stick then you will have write access to "/mnt/livemedia".   * The filesystem of the Live media is made available to the user of the Live OS as "/mnt/livemedia" If the media is a USB stick then you will have write access to "/mnt/livemedia".
   * With the root filesystem assembled, the Live OS is configured before it actually boots:   * With the root filesystem assembled, the Live OS is configured before it actually boots:
 +    * if a OS-specific configuration file (by default ''/liveslak/slackware_os.cfg'') exists, its contents will be parsed.  Values of the variables defined in this file overrule any default //liveslak// or boot command-line values.
     * if you specified "swap" on the boot commandline, any available swap partition will be added to "/etc/fstab" in the Live OS.     * if you specified "swap" on the boot commandline, any available swap partition will be added to "/etc/fstab" in the Live OS.
     * if you specified a custom keyboard layout for the console (and optionally another for X) by using the "kbd" and "xkb" boot parameters then these will be confifured in "/etc/rc.d/rc.keymap" and "/etc/X11/xorg.conf.d/30-keyboard.conf" in the Live OS.     * if you specified a custom keyboard layout for the console (and optionally another for X) by using the "kbd" and "xkb" boot parameters then these will be confifured in "/etc/rc.d/rc.keymap" and "/etc/X11/xorg.conf.d/30-keyboard.conf" in the Live OS.
Line 829: Line 956:
     * The init script will end by telling the kernel to swith to our new root filesystem (the overlay) and start the Slackware init program (PID 1, /sbin/init).     * The init script will end by telling the kernel to swith to our new root filesystem (the overlay) and start the Slackware init program (PID 1, /sbin/init).
   * From this moment onward, you are booting a 'normal' Slackware system and the fact that this is actually running in RAM and not from your local harddisk is not noticeable.   * From this moment onward, you are booting a 'normal' Slackware system and the fact that this is actually running in RAM and not from your local harddisk is not noticeable.
 +
 +
 +=== OS configuration file for persistent media ===
 +
 +If present, the liveslak init will load a OS config file from a persistent Live medium such as a USB stick.  In the case of //Slackware Live Edition// this file is called ''/liveslak/slackware_os.cfg'' - i.e. is placed in the "''liveslak''" directory of your USB drive.  For custom non-Slackware Live OS-es based on liveslak, the filename may be different.\\ This file contains one or more "VARIABLE=value" lines, where VARIABLE is one of the following variables that are used in the live init script:
 +  * BLACKLIST, KEYMAP, LIVE_HOSTNAME, LOAD, LOCALE, LUKSVOL, NOLOAD, RUNLEVEL, TWEAKS, TZ, XKB.
 +Values for the variables defined in this configuration file override the values already set via liveslak's own defaults or via boot-up command-line parameters.
 +
 +When booting your persistent //Slackware Live Edition//, the optional boot-time parameter "cfg" deals with this OS configuration file. The "cfg" parameter understands two possible argument values:
 +  * "cfg=write" will (over)write the OS configuration file to your USB drive, using the values for all of the above variables that are valid for that particular boot. So if your timezone is "''PST''" then one of the lines in that file will read "''TZ=PST''".
 +  * "cfg=skip" will skip processing of an existing "''/liveslak/slackware_os.cfg''" file.
 +
 +The OS configuration file is not present by default. You either create it at boot-time using "''cfg=write''" (which is a persistent change) or you create it manually using an ASCII text editor, after mounting the USB partition on a computer.  As an example, here is the content of "''/liveslak/slackware_os.cfg''" on my own USB stick: <code>
 +KEYMAP=nl
 +LIVE_HOSTNAME=zelazny
 +LOCALE=nl_NL.utf8
 +TWEAKS=tpb,syn
 +TZ=Europe/Amsterdam</code>
  
  
Line 842: Line 987:
   * The four digits of a modulename have a meaning.  Some ranges are claimed by the core OS, so please do not use them. Their prefixes are based on the package source: <code>   * The four digits of a modulename have a meaning.  Some ranges are claimed by the core OS, so please do not use them. Their prefixes are based on the package source: <code>
     0000 = contains the Slackware /boot directory     0000 = contains the Slackware /boot directory
 +    0005 = Console OS modules when explicitly enabled for a regular ISO installed otherwise from Slackware tagfiles
     0010-0019 = packages installed from a Slackware tagfile (a,ap,d, ... , y series)     0010-0019 = packages installed from a Slackware tagfile (a,ap,d, ... , y series)
     0020-0029 = packages installed from a package list as found in the ./pkglists subdirectory of the liveslak sources (min, noxbase, x_base, xapbase, xfcebase etc)     0020-0029 = packages installed from a package list as found in the ./pkglists subdirectory of the liveslak sources (min, noxbase, x_base, xapbase, xfcebase etc)
Line 905: Line 1051:
 Slackware Live Edition is created by the 'liveslak' scripts developed and maintained by Eric Hameleers aka Alien BOB [[alien@slackware.com]]. Slackware Live Edition is created by the 'liveslak' scripts developed and maintained by Eric Hameleers aka Alien BOB [[alien@slackware.com]].
  
-  * Git repository: %%git://slackware.nl/liveslak.git%% +  * Git repository: %%git://git.liveslak.org/liveslak.git%% 
-  * Git repository (browsable): http://git.slackware.nl/liveslak/+  * Git repository (browsable): http://git.liveslak.org/liveslak/
   * Download mirror: http://www.slackware.com/~alien/liveslak/   * Download mirror: http://www.slackware.com/~alien/liveslak/
  
Line 913: Line 1059:
 <!-- If you copy information from another source, then specify that source --> <!-- If you copy information from another source, then specify that source -->
   * Original source: [[https://git.slackware.nl/liveslak/tree/README.txt]]   * Original source: [[https://git.slackware.nl/liveslak/tree/README.txt]]
-  * Project landing page: [[https://alien.slackbook.org/blog/slackware-live-edition/]]+  * Project landing page: [[https://liveslak.org/]] 
 +  * ISO downloads: [[https://download.liveslak.org/]]
 <!-- Authors are allowed to give credit to themselves! --> <!-- Authors are allowed to give credit to themselves! -->
   * Originally written by [[wiki:user:alienbob | Eric Hameleers]]   * Originally written by [[wiki:user:alienbob | Eric Hameleers]]
Line 920: Line 1067:
 <!-- Please do not modify anything below, except adding new tags.--> <!-- Please do not modify anything below, except adding new tags.-->
 <!-- You must also remove the tag-word "template" below. Otherwise your page will not show up in the Table of Contents --> <!-- You must also remove the tag-word "template" below. Otherwise your page will not show up in the Table of Contents -->
-{{tag>slackware live author_alienbob}}+{{tag>slackware live overlayfs squashfs author_alienbob}}
 slackware:liveslak ()