bin/generate-zbm: support including a splash image in unified EFI bun…

…dles

Makefile

@@ -15,6 +15,7 @@ install: core dracut initcpio zbm-release
 core: zbm-release
 	./install-tree.sh zfsbootmenu "$(DESTDIR)/$(MODDIR)/zfsbootmenu"
 	install -m 0644 -t "$(DESTDIR)/$(CONFDIR)" -D etc/zfsbootmenu/config.yaml
+	install -m 0644 -t "$(DESTDIR)/$(CONFDIR)" -D etc/zfsbootmenu/splash.bmp
 	install -m 0755 -t "$(DESTDIR)/$(BINDIR)" -D bin/*
 	install -m 0644 -t "$(DESTDIR)/$(MANDIR)/man5" -D docs/man/dist/man5/*.5
 	install -m 0644 -t "$(DESTDIR)/$(MANDIR)/man7" -D docs/man/dist/man7/*.7

bin/generate-zbm

@@ -762,6 +762,12 @@ sub createUEFIBundle {
     $uki_offset = addBundleSection( \@cmd, ".cmdline", $cmdline, $uki_offset, $uki_alignment );
   }
 
+  if ( nonempty $config{EFI}{SplashImage} and -f $config{EFI}{SplashImage} ) {
+    # only supported with systemd-boot's efistub,
+    # but gummiboot doesn't care if the section exists
+    $uki_offset = addBundleSection( \@cmd, ".splash", $config{EFI}{SplashImage}, $uki_offset, $uki_alignment );
+  }
+
   $uki_offset = addBundleSection( \@cmd, ".initrd", $initramfs, $uki_offset, $uki_alignment );
 
   # Add the kernel last, so that it can decompress without overflowing other sections

docs/man/generate-zbm.5.rst

@@ -122,6 +122,10 @@ EFI
 
   The path to the EFI stub loader used to boot the unified bundle. If not set, a default of either ``/usr/lib/systemd/boot/efi/linuxx64.efi.stub`` or ``/usr/lib/gummiboot/linuxx64.efi.stub`` is assumed.
 
+**SplashImage**
+
+  The path to a bitmap image file (BMP) to use as a splash image before ZFSBootMenu loads. Only works if using systemd-boot's EFI stub loader.
+
 EXAMPLE
 =======
 

etc/zfsbootmenu/config.yaml

@@ -13,5 +13,6 @@ EFI:
   ImageDir: /boot/efi/EFI/zbm
   Versions: false
   Enabled: false
+  SplashImage: /etc/zfsbootmenu/splash.bmp
 Kernel:
   CommandLine: ro quiet loglevel=0