Package: bootsplash
Version: 3.3-5
Severity: wishlist
Tags: patch

After spending a day or so trying to create a proper bootsplash
initrd image I've tried to document the procedure for (Debian user-)
posteriority in otder to spare them the trouble.

It'd again be nice if you could include the attached patch or something
in that direction.

Thanks a lot,
*t

-- System Information:
Debian Release: 3.1
  APT prefers unstable
  APT policy: (500, 'unstable')
Architecture: i386 (i686)
Kernel: Linux 2.6.8-3-686
Locale: LANG=en_US, LC_CTYPE=en_US (charmap=ISO-8859-1)

Versions of packages bootsplash depends on:
ii  bootsplash-theme-debia 0.5-7.1           The bootsplash theme debian
ii  debconf [debconf-2.0]  1.4.30.13         Debian configuration management sy
ii  initramfs-tools        0.85e             tools for generating an initramfs
ii  libc6                  2.3.6.ds1-8       GNU C Library: Shared libraries
ii  libfreetype6           2.2.1-5           FreeType 2 font engine, shared lib
ii  libmng1                1.0.8-1           Multiple-image Network Graphics li
ii  zlib1g                 1:1.2.2-4.sarge.2 compression library - runtime

-- debconf information excluded
--- /usr/share/doc/bootsplash/README.Debian     2007-01-02 12:03:23.000000000 
+0100
+++ /tmp/README.Debian  2007-01-25 22:09:46.000000000 +0100
@@ -1,5 +1,5 @@
-bootsplah for Debian
-====================
+bootsplash for Debian
+=====================
 
 To activate the bootsplash you need to pass some command line
 parameters to the kernel. This can be done by configuring
@@ -42,4 +42,55 @@
 These display modes can also be found in the FrameBuffer HOWTO.  Any
 16bit mode should work.
 
+
+Bootsplash loads the boot image at two points in the boot process:
+
+  1. when it loads the initrd image the kernel part of bootsplash will
+     try to find the image in the initrd image and if successfull display it
+
+  2. when starting to execute /etc/init.d/* then /etc/init.d/bootsplash will
+     look for the image under /etc/bootsplash/ depending on how bootsplash
+     it set up through /etc/defaults/bootsplash
+
+ATTENTION:
+
+If you want to create a new initrd image you need to take extra care since
+traditional method described all over on the internet:
+
+  splash -s -f /etc/bootsplash/../bootsplash-XxY.jpeg >> /boot/initrd.img
+
+only works with cramfs based initrd images and WILL NOT work wth initramfs
+based initrd images, which are the default for the 2.6er Debian kernels.
+If you want to include an image in the initrd image then the following
+two methods to do it are suggested:
+
+  1. in case you want to include a Debian provided bootsplash theme then
+     just issue dpkg-reconfigure bootsplash and choose the desired theme
+     accordingly
+
+  2. when making a theme yourself then take care to correctly configure
+     /etc/defaults/bootsplash and /etc/bootsplash/themes/your_theme and
+     then call:
+     
+       update-initramfs -u -k your_kernel
+
+     This will recreate a working /boot/initrd-* image for your kernel.
+
+Customizing the GRUB bootscreen
+===============================
+
+It is also possible to customize the GRUB bootscreen. You need to create
+and gzip (!) an image in XPM format with a resolution of 640x480 and
+14 colours. Put that image under the name splash.xpm.gz under /boot/grub
+and issue:
+
+   update-grub
+
+Further reference:
+
+  * GRUB documentation
+  * Bootsplash configuration (german only):
+    http://wiki.debianforum.de/Bootsplash?highlight=%28bootsplash%29
+  * GRUB configuration: http://ubuntuforums.org/showthread.php?t=30341
+
  -- Free Ekanayaka <[EMAIL PROTECTED]>, Thu, 25 May 2006 10:20:14 z

Reply via email to