aboutsummaryrefslogtreecommitdiffstats
path: root/plymouth/README
diff options
context:
space:
mode:
authorDanilo M. <danix@danix.xyz>2026-08-08 17:08:48 +0200
committerDanilo M. <danix@danix.xyz>2026-08-08 17:08:48 +0200
commit7540c7a53f7bc8907b264994f440089a6fb85446 (patch)
tree97d962e989e38215ec363b78fa9d973e0c63dd22 /plymouth/README
parentec0170f34e7a6c1074c253a282785e87e045a4ed (diff)
downloadmy-slackbuilds-7540c7a53f7bc8907b264994f440089a6fb85446.tar.gz
my-slackbuilds-7540c7a53f7bc8907b264994f440089a6fb85446.zip
plymouth: add version 26.134.222
SBo ships 22.02.122, four years behind upstream and predating SimpleDRM support. Written from the meson template rather than bumped, since upstream switched from autotools to meson. systemd-integration now defaults to true in meson and has to be disabled explicitly, and release-file defaults to /etc/system-release. All build deps are satisfied by stock -current, so REQUIRES is empty. -current only: PANGO_ATTR_FONT_SCALE needs pango >= 1.50 and 15.0 ships 1.48.11, so label-pango fails to compile there. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Diffstat (limited to 'plymouth/README')
-rw-r--r--plymouth/README51
1 files changed, 51 insertions, 0 deletions
diff --git a/plymouth/README b/plymouth/README
new file mode 100644
index 0000000..5dc8ef4
--- /dev/null
+++ b/plymouth/README
@@ -0,0 +1,51 @@
+Plymouth provides a flicker-free graphical boot process. It relies on
+kernel mode setting (KMS) to set the native resolution of the display as
+early as possible, then shows a splash screen leading up to the login
+manager.
+
+Installing this package is not enough to get a splash screen. Plymouth
+runs as a daemon started from the initrd, and Slackware's mkinitrd has
+no hook for it, so the wiring is manual:
+
+ 1. Add "splash" to the kernel command line (and "quiet" for a silent
+ boot). With GRUB, edit GRUB_CMDLINE_LINUX_DEFAULT in
+ /etc/default/grub and run grub-mkconfig -o /boot/grub/grub.cfg
+
+ 2. Copy plymouthd, the plymouth client, the renderers in
+ /usr/lib*/plymouth/renderers, the theme directory, /etc/plymouth,
+ and every library they link against into the initrd, then start
+ plymouthd from /init before the root filesystem is mounted.
+ Upstream ships /usr/libexec/plymouth/plymouth-populate-initrd, but
+ it assumes a dracut or initramfs-tools layout and needs adapting.
+
+ 3. Nothing tears the splash down without systemd. Call
+ "plymouth quit --retain-splash" before the display manager starts,
+ or "plymouth quit" at the end of /etc/rc.d/rc.M for a console boot.
+
+On UEFI systems Plymouth uses the SimpleDRM driver by default to draw on
+the EFI framebuffer, so the GPU driver need not be in the initrd.
+Pass plymouth.use-simpledrm=0 to disable that. Note that with SimpleDRM
+secondary monitors stay dark during boot, which matters if an encryption
+passphrase prompt could land on one.
+
+Boot messages are shown by pressing Esc during boot, and are logged to
+/var/log/boot.log. Add plymouth.nolog to disable logging and console
+redirection, or plymouth.debug to write debug output to
+/var/log/plymouth-debug.log. If Plymouth prevents a successful boot,
+disable it with plymouth.enable=0 on the kernel command line.
+
+The theme is set in /etc/plymouth/plymouthd.conf, which this package
+installs empty for administrator overrides. Distribution defaults are in
+/usr/share/plymouth/plymouthd.defaults and select the "spinner" theme.
+Ten themes are shipped; list them with "plymouth-set-default-theme -l".
+The "bgrt" theme reuses the vendor logo the UEFI firmware already
+painted, if the firmware provides one.
+
+To preview the configured theme from a console without rebooting:
+
+ plymouthd; plymouth --show-splash; sleep 5; plymouth --quit
+
+Keep that as one chained command, the sleep is what returns control.
+
+The initrd must be repopulated after every kernel update, and after any
+theme change.