[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.
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
slackware:liveslak [2017/05/12 21:07 (UTC)] – [Boot parameters explained] added 'nsh' tweak. alienbob | slackware:liveslak [2023/01/04 11:54 (UTC)] – [Booting the Live OS] Some more specifics alienbob | ||
---|---|---|---|
Line 32: | Line 32: | ||
The " | The " | ||
- | - a complete 64bit Slackware-current Live Edition (in a 2.6 GB ISO); | + | - a complete 64bit Slackware-current Live Edition (in a 4.0 GB ISO); |
- a slimmed-down XFCE ISO (700 MB) with XDM as the graphical login manager. | - a slimmed-down XFCE ISO (700 MB) with XDM as the graphical login manager. | ||
- | - a ISO image (3.1 GB) of Slackware64-current containing Plasma 5 instead of KDE 4, with an addition of several other packages from the alienBOB repositories: | + | - a ISO image (4.3 GB) of Slackware64-current containing |
- | - a Mate variant (1.7 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 Plasma5, containing a rich software collection for musicians, producers 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' | - a Cinnamon flavour (a fork of the Gnome 3 Shell replacing Slackware' | ||
+ | - a [[https:// | ||
+ | - a [[http:// | ||
- a //Custom// variant which you can give your own name, its own package list and custom post-install configuration. | - a //Custom// variant which you can give your own name, its own package list and custom post-install configuration. | ||
Line 44: | Line 47: | ||
Common download locations are: | Common download locations are: | ||
- | * Primary site: http://bear.alienbase.nl/ | + | * Primary site: https://download.liveslak.org/ (%%rsync://liveslak.org/liveslak/%%) |
- | * Darren' | + | * Darren' |
* Willy' | * Willy' | ||
- | * Ryan's https:// | ||
- | * Shasta' | ||
Line 73: | 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 | + | * 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 87: | 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 | + | * 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 96: | Line 97: | ||
Editing a Grub menu before booting it is possible by pressing the " | Editing a Grub menu before booting it is possible by pressing the " | ||
- | 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. | + | 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. |
+ | |||
+ | === UEFI Secure Boot === | ||
+ | |||
+ | |||
+ | On computers with Secure Boot enabled, extra measures may be required to boot an Operating System. | ||
+ | |||
+ | Secure Boot enforces that the first-stage bootloader is signed with an encryption key known to Microsoft. | ||
+ | |||
+ | Signing your Grub bootloader and your kernel also becomes mandatory, because the ' | ||
+ | |||
+ | 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. | ||
+ | |||
+ | To realize this, the Slackware Live ISO ' | ||
+ | |||
+ | A distro ' | ||
+ | |||
+ | 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. | ||
+ | |||
+ | == Add the '' | ||
+ | |||
+ | There are two ways to add or enroll this certificate. | ||
+ | * When you boot a Secure Boot enabled liveslak ISO for the first time, the ' | ||
+ | * If you already have a Linux OS up and running on that computer, you can use the program '' | ||
+ | # mokutil --import liveslak.der</ | ||
+ | |||
+ | 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 '' | ||
+ | |||
+ | 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. | ||
+ | |||
+ | |||
+ | === 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' | ||
+ | menuentry " | ||
+ | set iso='/ | ||
+ | set bootparms=' | ||
+ | |||
+ | search -f $iso --set=root | ||
+ | loopback loop $iso | ||
+ | linux (loop)/ | ||
+ | initrd (loop)/ | ||
+ | }</ | ||
+ | |||
+ | This example will add a ' | ||
==== Transfering ISO content to USB stick ==== | ==== Transfering ISO content to USB stick ==== | ||
Line 104: | Line 150: | ||
A script is available which allows you to transfer the ISO image content to a USB stick, making some modifications depending on the script' | A script is available which allows you to transfer the ISO image content to a USB stick, making some modifications depending on the script' | ||
- | The USB stick will be erased and re-formatted when running this script! | + | The USB stick will be erased and re-formatted when running this script |
This script, called ' | This script, called ' | ||
-c|--crypt size|perc | -c|--crypt size|perc | ||
| | ||
- | or as a percentage of free space. | + | or as a percentage of free space |
- | | + | |
+ | | ||
+ | -d|--devices | ||
-f|--force | -f|--force | ||
-h|--help | -h|--help | ||
Line 116: | Line 164: | ||
-o|--outdev < | -o|--outdev < | ||
-p|--persistence < | -p|--persistence < | ||
+ | If it does not exist yet, create it manually. | ||
-r|--refresh | -r|--refresh | ||
No formatting, do not touch user content. | No formatting, do not touch user content. | ||
+ | -s|--scan | ||
+ | | ||
-u|--unattended | -u|--unattended | ||
-v|--verbose | -v|--verbose | ||
Line 124: | Line 175: | ||
Use a LUKS-encrypted ' | Use a LUKS-encrypted ' | ||
of a directory (for use on FAT filesystem). | of a directory (for use on FAT filesystem). | ||
+ | | ||
+ | as for the ' | ||
-P|--persistfile | -P|--persistfile | ||
of a directory (for use on FAT filesystem). | of a directory (for use on FAT filesystem). | ||
Line 137: | Line 190: | ||
* Create a USB Live with both the /home and the persistent data encrypted (the persistence filesystem will be 300 MB in size): | * Create a USB Live with both the /home and the persistent data encrypted (the persistence filesystem will be 300 MB in size): | ||
# ./ | # ./ | ||
+ | * Refresh the system modules on a USB Live using a Live ISO as the source. | ||
+ | # ./ | ||
You might have noticed that the " | You might have noticed that the " | ||
+ | |||
+ | |||
+ | ==== Using the Live OS to install Slackware to hard disk ==== | ||
+ | |||
+ | All variants of Slackware Live Edition contain a script " | ||
+ | The " | ||
+ | |||
+ | The " | ||
+ | * 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 ==== | ||
+ | |||
+ | |||
+ | A script is available which allows you to tweak the content of a USB Live stick. | ||
+ | |||
+ | Specifically, | ||
+ | * Upgrade the kernel and modules, making a backup of the old kernel and modules. | ||
+ | * Restore the backed-up kernel and modules if the new kernel is not working. | ||
+ | * Add network support modules for PXE boot (if missing). | ||
+ | * Increase (or decrease) USB wait time during boot. | ||
+ | * Replace the Live init script inside the initrd image with a new script that you supply. | ||
+ | * Move current persistence data to a new squashfs module in ' | ||
+ | |||
+ | The script is meant to be used while you are running Slackare Live from that same USB stick but this is not mandatory. With the exception of the ' | ||
+ | |||
+ | Before making any modifications, | ||
+ | |||
+ | This script, called ' | ||
+ | -b|--nobackup | ||
+ | -d|--devices | ||
+ | -h|--help | ||
+ | -i|--init < | ||
+ | -k|--kernel < | ||
+ | -m|--kmoddir < | ||
+ | -n|--netsupport | ||
+ | -o|--outdev < | ||
+ | -p|--persistence | ||
+ | -r|--restore | ||
+ | -s|--scan | ||
+ | | ||
+ | -v|--verbose | ||
+ | -w|--wait< | ||
+ | </ | ||
+ | Examples: | ||
+ | |||
+ | * Get a listing of all available removable devices on the computer: | ||
+ | # ./upslak.sh -d | ||
+ | * Updating kernel and modules, providing two packages as input and assuming the USB stick is known as /dev/sdX: | ||
+ | # ./upslak.sh -o /dev/sdX -m kernel-modules-4.19.0-x86_64-1.txz -k kernel-generic-4.19.0-x86_64-1.txz | ||
+ | * Restore the previous kernel and modules after a failed update, and let the script scan your computer for the insertion of your USB stick: | ||
+ | # ./upslak.sh -s -r | ||
+ | * Replace the Live init script with the latest template taken from the git repository: | ||
+ | # ./upslak.sh -o /dev/sdX -i liveslak/ | ||
Line 287: | Line 398: | ||
=== Media tweaks === | === Media tweaks === | ||
+ | |||
+ | cfg=[skip|write] => | ||
+ | Specify ' | ||
+ | OS parameters; or specify ' | ||
+ | to disk. | ||
+ | |||
+ | domain=your_custom_domain => | ||
+ | Specify a custom domain name. Defaults to ' | ||
hostname=your_custom_hostname[, | hostname=your_custom_hostname[, | ||
Line 301: | Line 420: | ||
Use this if you want to | Use this if you want to | ||
load the live OS from an ISO file on a local harddisk partition. | load the live OS from an ISO file on a local harddisk partition. | ||
+ | |||
+ | livemedia=scandev:/ | ||
+ | Use this if liveslak should | ||
+ | scan all device partitions to locate the ISO file. | ||
livemain=directoryname => | livemain=directoryname => | ||
Line 325: | Line 448: | ||
Use this if you are using a different | Use this if you are using a different | ||
directory/ | directory/ | ||
+ | |||
+ | persistence=/ | ||
+ | persistence=scandev:/ | ||
+ | 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 => | ||
- | | + | |
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=core => Load Console OS modules into RAM. Console-only Slackware | ||
+ | loads fast, contains ' | ||
+ | overwrite it with a Persistent Live OS. | ||
+ | |||
+ | toram=os => | ||
+ | Load OS modules into RAM, but write persistent data to USB. | ||
=== Troubleshooting === | === Troubleshooting === | ||
Line 340: | Line 480: | ||
During init, pause at strategic locations while | During init, pause at strategic locations while | ||
assembling the overlay filesystem and show mount information. | assembling the overlay filesystem and show mount information. | ||
+ | |||
+ | debug=< | ||
+ | ' | ||
+ | ' | ||
rescue => | rescue => | ||
Line 360: | Line 504: | ||
* The boot/ directory contains the syslinux configuration used when the Live OS boots on a computer with a BIOS. This directory also contains the kernel and initrd files which are used to actually boot the OS. | * The boot/ directory contains the syslinux configuration used when the Live OS boots on a computer with a BIOS. This directory also contains the kernel and initrd files which are used to actually boot the OS. | ||
* The liveslak/ directory contains all the squashfs modules which are used to assemble the filesystem of the Live OS, as well as files that are copied directly into the root of the Live filesystem. | * The liveslak/ directory contains all the squashfs modules which are used to assemble the filesystem of the Live OS, as well as files that are copied directly into the root of the Live filesystem. | ||
- | * addons/ - modules which are stored in this directory will always be added t the Live filesystem unless you prevent that with a " | + | * addons/ - modules which are stored in this directory will always be added to the Live filesystem unless you prevent that with a " |
* optional/ - modules in this directory will not be added to the filesystem of the Live OS unless you force this with a " | * optional/ - modules in this directory will not be added to the filesystem of the Live OS unless you force this with a " | ||
* system/ - this directory contains all the modules which were created by the " | * system/ - this directory contains all the modules which were created by the " | ||
Line 389: | Line 533: | ||
* The script reads a package sequence for the Live variant and installs all packages in this sequence to subdirectories of a temporary directory tree. | * The script reads a package sequence for the Live variant and installs all packages in this sequence to subdirectories of a temporary directory tree. | ||
- | * Every Slackware package set (a, ap, d, ... , y) or package list (min, xbase, xapbase, ...) is installed into a separate ' | + | * Every Slackware package set (a, ap, d, ... , y) or package list (min, noxbase, x_base, xapbase, ...) is installed into a separate ' |
* Each of those root directories is " | * Each of those root directories is " | ||
* These module files are subsequently loop-mounted and then combined together into a single read-only directory structure using an " | * These module files are subsequently loop-mounted and then combined together into a single read-only directory structure using an " | ||
Line 408: | Line 552: | ||
* an initial environment for the accounts is configured, | * an initial environment for the accounts is configured, | ||
* the desktop environment is pre-configured for first use, | * the desktop environment is pre-configured for first use, | ||
- | * the liveslak scripts " | + | * the liveslak scripts " |
- | * if the Live system contains a huge kernel (all ISO variants except XFCE) then the " | + | * the " |
* slackpkg is configured, | * slackpkg is configured, | ||
* a locate database is created, | * a locate database is created, | ||
* etc... | * etc... | ||
- | * All these modifications are written to the writable filesystem that was created in the previous section. This filesystem will also be stored on the ISO as a squashfs module and when the Live OS boots, it will be mounted read-only just like all the other modules. Its name will be " | + | * All these modifications are written to the writable filesystem that was created in the previous section. This filesystem will also be stored on the ISO as a squashfs module and when the Live OS boots, it will be mounted read-only just like all the other modules. Its name will be " |
Line 444: | Line 588: | ||
This section explains how the script modifies the ISO for the enhanced USB functionality. | This section explains how the script modifies the ISO for the enhanced USB functionality. | ||
+ | |||
+ | == Layout of the USB stick == | ||
+ | |||
+ | The " | ||
+ | |||
+ | * First partition: a small (1 MB in size) FAT partition which is not used for Slackware Live Edition. | ||
+ | * Second partition: a 100 MB VFAT partition containing the kernel, initrd and all the other stuff required by syslinux and grub2 to boot Slackware Live Edition. | ||
+ | * Third partition: a Linux partition taking up all of the remaining space. It contains the actual liveslak modules, the persistent live storage and optionally your encrypted homedirectory. You can use the remainder of this Linux //ext4// filesystem' | ||
+ | |||
+ | Note that this script is the only supported method of transfering the liveslak ISO content to a USB stick and make that USB stick into a persistent live OS. Several 3rd party tools (like multibootusb, | ||
== Mounting a filesystem in an encrypted container == | == Mounting a filesystem in an encrypted container == | ||
Line 487: | Line 641: | ||
The fourth script: | The fourth script: | ||
- | The " | + | The " |
- | + | * 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), | ||
Line 518: | Line 672: | ||
</ | </ | ||
* Note that when networkbooting, | * Note that when networkbooting, | ||
+ | |||
+ | |||
+ | === upslak.sh === | ||
+ | |||
+ | |||
+ | The sixth script: | ||
+ | |||
+ | The " | ||
+ | |||
+ | This section explains how the script modifies the content of the Live USB stick. | ||
+ | |||
+ | When the script is started, it will do some sanity checks and then extracts the content of the initrd image. Some characteristics of the initrd will be recorded: | ||
+ | * existence of previously backed-up kernel modules is checked, | ||
+ | * template variables and their values are obtained from the init sctript, | ||
+ | * the current USB wait time is checked. | ||
+ | Depending on the parameters passed to the script, it will then perform one or more of the following actions: | ||
+ | |||
+ | == Update the kernel and moules == | ||
+ | |||
+ | You can provide a new kernel and its modules in two ways. The ' | ||
+ | If there is sufficient space on the Linux and EFI partitions, the script will make a backup of the current kernel and modules by renaming the kernel and the module directory with a " | ||
+ | |||
+ | == Restore backed-up kernel and modules == | ||
+ | |||
+ | If a backup was made of kernel and modules, the upslak.sh script is able to restore these using the ' | ||
+ | |||
+ | == Add network support modules == | ||
+ | |||
+ | This should normally not be needed. | ||
+ | |||
+ | == Increase (or decrease) USB wait time == | ||
+ | |||
+ | Similar to the functionality of the " | ||
+ | |||
+ | == Replace the liveslak init script == | ||
+ | |||
+ | The init script inside the initrd image is the core of liveslak. | ||
+ | |||
+ | == Wrap persistence data into a new squashfs module == | ||
+ | |||
+ | Persistence data will accumulate over time on the USB stick. | ||
Line 527: | Line 722: | ||
You also need the " | You also need the " | ||
- | Liveslak is a directory tree containing scripts, bitmaps and configuration files. | + | Liveslak is a directory tree containing scripts, bitmaps and configuration files. |
Line 537: | Line 732: | ||
* 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 " | * graphics/ - squashfs modules for proprietary GPU support (Nvidia) can be placed here. The module(s) will be copied to addons/ by the " | ||
* local64/ , local/ - these directories can contain Slackware packages considered ' | * local64/ , local/ - these directories can contain Slackware packages considered ' | ||
+ | * 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. | * optional/ - squashfs modules placed in this directory will not automatically be loaded into the Live filesystem when the OS boots. | ||
+ | * 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 '' | ||
* skel/ - contains compressed tarballs (whose filenames must match wildcard " | * skel/ - contains compressed tarballs (whose filenames must match wildcard " | ||
* syslinux/ | * syslinux/ | ||
Line 556: | Line 755: | ||
* locale = the locale used in the country | * locale = the locale used in the country | ||
* xkb = optional custom X keyboard variant for the language | * xkb = optional custom X keyboard variant for the language | ||
- | * liveinit - this is the " | + | * liveinit.tpl - this is the template for the " |
* make_slackware_live.conf - the configuration file for the " | * make_slackware_live.conf - the configuration file for the " | ||
* make_slackware_live.sh - the script that generates the Live ISO. | * make_slackware_live.sh - the script that generates the Live ISO. | ||
* makemod - this script creates a squashfs module out of a Slackware package (or out of a directory tree). | * makemod - this script creates a squashfs module out of a Slackware package (or out of a directory tree). | ||
* menu.tpl - template which is used to generate the syslinux boot menu for BIOS computers. | * menu.tpl - template which is used to generate the syslinux boot menu for BIOS computers. | ||
- | * pxeserver - the script that starts a PXE server allowing other computers to boot Slackware Live over the network. | + | * pxeserver.tpl - template to generate |
- | * setup2hd - the script you use to install your Slackware Live to a harddisk. | + | * setup2hd.tpl |
- | * setup2hd.local - here a developer of a custom Live OS can override the default post-installation routine by (re-)defining the function " | + | * setup2hd.local.tpl - here a developer of a custom Live OS can override the default post-installation routine by (re-)defining the function " |
+ | * upslak.sh - a script which allows you to tweak the content of a USB Live stick. | ||
Line 574: | Line 774: | ||
-a arch Machine architecture (default: x86_64). | -a arch Machine architecture (default: x86_64). | ||
Use i586 for a 32bit ISO, x86_64 for 64bit. | Use i586 for a 32bit ISO, x86_64 for 64bit. | ||
- | -d desktoptype | + | -c comp Squashfs compression (default: xz). |
- | XFCE (basic XFCE), | + | Can be any of 'gzip lzma lzo xz zstd' |
- | | + | -d desktoptype |
- | | + | |
+ | stripped), KTOWN (ktown Plasma5 | ||
+ | (Gnome2 fork replaces | ||
+ | replaces | ||
| | ||
where the ISO won't boot otherwise (default: 4). | where the ISO won't boot otherwise (default: 4). | ||
| | ||
custom configurations and new initrd.img. | custom configurations and new initrd.img. | ||
+ | -l < | ||
+ | (script-default is ' | ||
-m pkglst[, | -m pkglst[, | ||
-r series[, | -r series[, | ||
-s slackrepo_dir | -s slackrepo_dir | ||
- | -t < | + | -t <none|doc|mandoc|bloat> |
+ | | ||
| | ||
-z version | -z version | ||
+ | | ||
| | ||
-H < | -H < | ||
Line 593: | Line 800: | ||
-O < | -O < | ||
-R < | -R < | ||
+ | -S privkey: | ||
+ | using the full path to colon-separated | ||
+ | private key and certificate files. | ||
| | ||
</ | </ | ||
The script uses package repositories to create a Live ISO. The packages will be installed into a temporary directory. | The script uses package repositories to create a Live ISO. The packages will be installed into a temporary directory. | ||
- | In order to create a Live ISO for any of these variants, the package repositories that are required must be available as a local directory (this can be a network-mounted directory). | + | In order to create a Live ISO for any of these variants, the package repositories that are required must be available as a local directory (this can be a network-mounted directory). |
When all pre-reqs are met, you issue a single command to generate the ISO. The following example will create a pure Slackware Live Edition: | When all pre-reqs are met, you issue a single command to generate the ISO. The following example will create a pure Slackware Live Edition: | ||
Line 604: | Line 814: | ||
Another example which creates a MATE variant, configuring runlevel ' | Another example which creates a MATE variant, configuring runlevel ' | ||
# ./ | # ./ | ||
+ | |||
+ | 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 ' | ||
+ | # ./ | ||
If you want to know what package sets are included in any of these Desktop Environments, | If you want to know what package sets are included in any of these Desktop Environments, | ||
Line 612: | Line 825: | ||
- | ==== Using the Customization | + | ==== Using the Customization |
+ | === Master configuration file === | ||
You can create your own custom Live OS by changing its characteristics in the configuration file "'' | You can create your own custom Live OS by changing its characteristics in the configuration file "'' | ||
Among the things you can change are: | Among the things you can change are: | ||
- | * The name of the Desktop variant (the script itself knows "// | + | * The name of the Desktop variant (the script itself knows "// |
* 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 "// | ||
* The name of the useraccount (by default that is "// | * The name of the useraccount (by default that is "// | ||
* The name of the distribution (by default that is "// | * The name of the distribution (by default that is "// | ||
Line 633: | Line 849: | ||
# and " | # and " | ||
# respectively): | # respectively): | ||
- | # | + | # |
# OPTIONAL: | # OPTIONAL: | ||
Line 666: | Line 882: | ||
#} | #} | ||
</ | </ | ||
+ | |||
+ | === Customizing the list of used packages === | ||
+ | |||
+ | Any liveslak ISO variant contains a specific set of Slackware packages, as defined in the various '' | ||
+ | |||
+ | 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 '' | ||
+ | # grep ^SEQ_MSB make_slackware_live.sh | ||
+ | SEQ_MSB=" | ||
+ | |||
+ | Three keywords can be identified in the value of a '' | ||
+ | * tagfile - this is an Slackware tagfile for a complete package series. | ||
+ | * pkglist - this is a list of packages to be installed from the Slackware distro itself or from a Slackware-compatible 3rd-party repository. | ||
+ | * local - some packages can not be found in Slackware-compatible repositories. | ||
+ | |||
+ | For the value of a '' | ||
+ | |||
+ | === 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 '' | ||
+ | |||
+ | The " | ||
+ | |||
+ | |||
==== Internals of Slackware Live Edition ==== | ==== Internals of Slackware Live Edition ==== | ||
Line 701: | Line 942: | ||
* The filesystem of the Live media is made available to the user of the Live OS as "/ | * The filesystem of the Live media is made available to the user of the Live OS as "/ | ||
* 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 ''/ | ||
* if you specified " | * if you specified " | ||
* if you specified a custom keyboard layout for the console (and optionally another for X) by using the " | * if you specified a custom keyboard layout for the console (and optionally another for X) by using the " | ||
Line 713: | Line 955: | ||
* 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, / | * 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, / | ||
* From this moment onward, you are booting a ' | * From this moment onward, you are booting a ' | ||
+ | |||
+ | |||
+ | === 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. | ||
+ | * BLACKLIST, KEYMAP, LIVE_HOSTNAME, | ||
+ | Values for the variables defined in this configuration file override the values already set via liveslak' | ||
+ | |||
+ | When booting your persistent //Slackware Live Edition//, the optional boot-time parameter " | ||
+ | * " | ||
+ | * " | ||
+ | |||
+ | The OS configuration file is not present by default. You either create it at boot-time using "'' | ||
+ | KEYMAP=nl | ||
+ | LIVE_HOSTNAME=zelazny | ||
+ | LOCALE=nl_NL.utf8 | ||
+ | TWEAKS=tpb, | ||
+ | TZ=Europe/ | ||
Line 727: | Line 987: | ||
0000 = contains the Slackware /boot directory | 0000 = contains the Slackware /boot directory | ||
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, xbase, 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) |
0030-0039 = a ' | 0030-0039 = a ' | ||
0099 = liveslak configuration module (contaning all the customizations that change the installed packages into a usable Live OS) </ | 0099 = liveslak configuration module (contaning all the customizations that change the installed packages into a usable Live OS) </ | ||
Line 747: | Line 1007: | ||
Website: https:// | Website: https:// | ||
- | SLAX was the original Live variant of Slackware. | + | SLAX was the original Live variant of Slackware. |
The Live functionality of SLAX is based on aufs and unionfs which requires a custom-built kernel with aufs support compiled-in. | The Live functionality of SLAX is based on aufs and unionfs which requires a custom-built kernel with aufs support compiled-in. | ||
Line 781: | Line 1041: | ||
Website: http:// | Website: http:// | ||
- | A website offering Live versions based on many regular Linux distributions. | + | A website offering Live versions based on many regular Linux distributions. |
Line 789: | Line 1049: | ||
Slackware Live Edition is created by the ' | Slackware Live Edition is created by the ' | ||
- | * Git repository: %%git://bear.alienbase.nl/ | + | * Git repository: %%git://git.liveslak.org/ |
- | * Git repository (browsable): | + | * Git repository (browsable): |
* Download mirror: http:// | * Download mirror: http:// | ||
Line 796: | Line 1056: | ||
====== Sources ====== | ====== Sources ====== | ||
<!-- If you copy information from another source, then specify that source --> | <!-- If you copy information from another source, then specify that source --> | ||
- | * Original source: [[http://bear.alienbase.nl/cgit/ | + | * Original source: [[https://git.slackware.nl/ |
+ | * Project landing page: [[https:// | ||
+ | * ISO downloads: [[https:// | ||
<!-- Authors are allowed to give credit to themselves! --> | <!-- Authors are allowed to give credit to themselves! --> | ||
* Originally written by [[wiki: | * Originally written by [[wiki: | ||
- | <!-- * Contrbutions | + | <!-- * Contributions |
<!-- 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 " | <!-- You must also remove the tag-word " | ||
- | {{tag> | + | {{tag> |