r896 - in trunk: . MAINTAINER OLD PREVIOUS_FORMAT

tushar at linuxfromscratch.org tushar at linuxfromscratch.org
Sun Sep 19 12:36:42 PDT 2004


Author: tushar
Date: 2004-09-19 13:36:40 -0600 (Sun, 19 Sep 2004)
New Revision: 896

Added:
   trunk/OLD/bootsplash.txt
   trunk/bootsplash.txt
Removed:
   trunk/PREVIOUS_FORMAT/bootsplash.txt
Modified:
   trunk/MAINTAINER/STATUS
Log:
New Hint: bootsplash

Modified: trunk/MAINTAINER/STATUS
===================================================================
--- trunk/MAINTAINER/STATUS	2004-09-19 19:34:03 UTC (rev 895)
+++ trunk/MAINTAINER/STATUS	2004-09-19 19:36:40 UTC (rev 896)
@@ -11,7 +11,6 @@
    * bootcd: Orphaned. Should be merged with boot-cd_easy.
    * bootlfscd: Conversion in progress.
    * bootlogo: No response from author.
-   * bootsplash: No response from author.
    * chrony_time: Conversion in progress.
    * ckermit+lrzsz: No response from author.
    * devfs: Adopted.

Added: trunk/OLD/bootsplash.txt
===================================================================
--- trunk/OLD/bootsplash.txt	2004-09-19 19:34:03 UTC (rev 895)
+++ trunk/OLD/bootsplash.txt	2004-09-19 19:36:40 UTC (rev 896)
@@ -0,0 +1,358 @@
+TITLE:		Installing a bootsplash screen with progress bar
+LFS VERSION:	3.3+
+AUTHOR:		Bryan Gale <bryan at 2dz.co.uk>
+
+SYNOPIS:
+	How to beautify the boot process with splash screen, progress bar and
+	animation. Will also give you a pretty background on text consoles
+
+HINT:
+
+Required Packages
+-----------------
+
+The SuSE bootsplash kernel patch (versions available for 2.4.18 and 2.4.20
+kernels):
+	ftp://ftp.suse.com/pub/people/stepan/bootsplash/kernel/
+	bootsplash-3.0.7-2.4.18-vanilla.diff
+	
+Or
+	ftp://ftp.suse.com/pub/people/stepan/bootsplash/kernel/
+	bootsplash-3.0.7-2.4.20-vanilla.diff
+
+The splashutils package:
+	ftp://ftp.suse.com/pub/people/stepan/bootsplash/rpm-sources/bootsplash/
+	splashutils.tar.bz2
+
+The frame-buffer mng player:
+	ftp://ftp.suse.com/pub/people/stepan/bootsplash/rpm-sources/bootsplash/
+	fbmngplay-0.5a.tar.bz2
+
+Some helper scripts:
+	ftp://ftp.suse.com/pub/people/stepan/bootsplash/rpm-sources/bootsplash/
+	scripts.tar.bz2
+
+A sample theme:
+	ftp://ftp.suse.com/pub/people/stepan/bootsplash/themes/
+	Theme-Linux.tar.bz2
+	
+This hint will assume these have been downloaded to /tmp
+
+You should also have installed libmng and libjpeg and as described in the Beyond
+Linux From Scratch book
+
+
+Installing the kernel patch
+---------------------------
+
+Change to the directory containing your kernel sources, and apply the patch. You
+will then need to configure your kernel
+
+	cd /usr/src/linux &&
+	patch -p1 < /tmp/bootsplash-3.0.7-2.4.*-vanilla.diff &&
+	make menuconfig
+	
+You should enable the following options. Make sure they are compiled into the
+kernel, and not as modules
+
+	Code maturity level options  --->
+		Prompt for development and/or incomplete code/drivers
+	Block devices  ---> RAM disk support
+	Block devices  ---> Initial RAM disk (initrd) support
+	Console drivers  ---> Video mode selection support
+	Console drivers  ---> Frame-buffer support --->
+		Support for frame buffer devices
+		VESA VGA graphics console
+		Use splash screen instead of boot logo
+		
+Now compile and install the kernel
+
+	make dep &&
+	make bzImage &&
+	make modules &&
+	make modules_install &&
+	cp arch/i386/boot/bzImage /boot/lfskernel
+
+
+Installing user space stuff
+---------------------------
+
+Unpack splashutils.tar.bz2, compile and copy the required binaries to /sbin
+
+	cd /tmp &&
+	tar xvjf splashutils.tar.bz2 &&
+	cd splashutils &&
+	make &&
+	cp splash fbresolution /sbin &&
+	cd ..
+
+The two binaries we need are splash and fbresolution, so the rest can be
+deleted. We also need one script from the scripts.tar.bz2 package
+
+	tar xvjf scripts.tar.bz2 &&
+	cd scripts &&
+	chmod +x bootanim &&
+	cp bootanim /sbin &&
+	cd ..
+	
+The rest of the scripts are largely distro specific, so they can be deleted. The
+one we save, bootanim, is used by splash to start and stop animations. The mng
+player will also neeed to be installed to actually play the animations
+
+	tar xvjf fbmngplay-0.5a.tar.bz2 &&
+	cd fbmngplay &&
+	make
+	
+You may get compile errors, but hopefully the fbmngplay binary will be there
+
+	cp fbmngplay /sbin
+	
+If you do experence build errors they probably occured while building
+fbmngplay.static. If you want a static version of fbmngplay, see the note at the
+end of this hint
+	
+
+Installing a bootsplash theme
+-----------------------------
+
+We need to create a directory for our themes
+
+	mkdir -p /etc/bootsplash/themes
+
+Move the sample theme (or any other theme from http://www.bootsplash.og) to this
+directory, and un-tar it
+
+	cd /etc/bootsplash/themes &&
+	tar xvjf /tmp/Theme-Linux.tar.bz2
+
+The programs installed earlier will search for the theme in
+/etc/bootsplash/themes/current, so we need to create a symlink
+
+	ln -s Linux current
+
+When you want to use a different theme you should delete this symlink and create
+another one to your new un-tarred theme
+
+	rm current &&
+	ln -s MYNEWTHEME current
+	
+
+Updating Lilo and rebooting
+---------------------------
+
+You will need to edit /etc/lilo.conf. Under the entry for your linux kernel add
+the line
+
+	vga=791
+	
+This is so linux boots into a screen resolution that matches the size of the
+bootsplash screen. You will also need to add
+
+	initrd=/boot/initrd
+
+To boot into silent mode (i.e. boot messages hidden), you will need also to add
+
+	append="splash=silent"
+	
+Not all themes have a silent mode, so this will not always apply.
+
+The following will need to be done now, and everytime you want to change theme.
+Use splash to create a ram disk image of the bootsplash screen
+
+	splash -s -f \
+	/etc/bootsplash/themes/current/config/bootsplash-1024x768.cfg > \
+	/boot/initrd
+
+Now update the mbr and reboot, and you should see your new splash screen
+
+	lilo &&
+	shutdown -r now
+	
+
+Utilising the progress bar
+--------------------------
+
+If your theme is enabled with a progress bar, you will need to make some changes
+to your bootscripts to get it to work. The progress bar can be contolled by
+echoing commands to /proc/splash. For a tidy way to use this, you should add the
+following code to your /etc/rc.d/init.d/functions script
+
+	progressbar()
+	{
+
+		if [ $# != 1 ]
+       		then
+                	echo "Usage: progressbar {progress}"
+        		exit 1
+        	fi
+		
+		echo "show $(( 65534 * $1 / 100 ))" > /proc/splash
+
+	}
+
+Now edit your bootscripts in /etc/rc.d/rcsysinit.d and (by default)
+/etc/rc.d/rc3.d to use this function. In general, before each instance of
+loadproc, you should add
+
+	progressbar XXX
+
+Where XXX is boot progress out of 100. The LFS book explains the order in
+which the scripts will be run, and it will take some trial and error to get a
+smooth running progress bar. Remeber not to use this function before /proc
+has been mounted
+
+
+Utilising animation
+-------------------
+
+The splash program handles animation, examining the
+/etc/bootsplash/themes/current/config/animations.cfg file, if your theme has
+one. Again, a function should be added to /etc/rc.d/init.d/functions file
+
+	animate()
+	{
+
+		if [ $# = 0 ]
+       		then
+                	echo "Usage: animate {hook}"
+        		exit 1
+        	fi
+
+		splash "$*"
+
+	}
+
+To use it place the following line in your bootscripts wherever an animation
+should be played
+
+	animate HOOK
+
+To determine values for HOOK, you need to look at
+/etc/bootsplash/themes/current/config/animations.cfg. The file takes the format
+
+	HOOK:command
+	HOOK:command
+
+This is from the Redmond theme at http://www.bootsplash.org
+	
+	fsck start:bootanim start bounce.mng
+	master:bootanim stop
+	shutdown: bootanim start bounce.mng
+	
+The command bootanim is the script we installed earlier, which handles the
+animations, and uses the fbmngplay command to actually play the things. To see
+a full list of paramemters, simply run bootanim. In this example we should add
+the following to the bootscript where fsck is run
+
+	animate fsck start
+
+You should place the line
+
+	animate master
+
+just before the bootscripts finish, as this will stop all animations.
+
+The line
+	
+	animate shutdown
+
+should be placed somewhere in the shutdown scripts. Look in
+/etc/rc.d/rc6.d to see what will be run, and insert the line somewhere
+before the killproc-ing begins.
+
+There is consistency between theme about these hooks, so once you have them in
+place, they should not need changing. No harm should come from trying to play a
+non existent animation.
+
+
+Miscellaneous
+-------------
+
+Using splash, you can add or change a background on any of your terminals
+
+	splash -n -s -u 1 \
+	/etc/bootsplash/themes/tty2-theme/config/bootsplash-1024x768.cfg
+
+	splash -n -s -u 2 \
+	/etc/bootsplash/themes/tty3-theme/config/bootsplash-1024x768.cfg
+
+	splash -n -s -u 3 \
+	/etc/bootsplash/themes/tty4-theme/config/bootsplash-1024x768.cfg
+	
+	splash -n -s -u 4 \
+	/etc/bootsplash/themes/tty5-theme/config/bootsplash-1024x768.cfg
+	
+	splash -n -s -u 5 \
+	/etc/bootsplash/themes/tty6-theme/config/bootsplash-1024x768.cfg
+	
+You can remove the background with
+
+	splash -s -n -u CONSOLENUMBER
+	
+You can retrun to silent mode using
+
+	echo "silent" > /proc/splash
+
+This may be useful for creating a shutdown screen
+
+Verbose mode can be triggered with F2 or
+	
+	echo "verbose" > /proc/splash
+
+You may want to place this in the print_status function of
+/etc/rc.d/init.d/functions, inside the failure case, or use it when your hard
+drive is being scanned for errors. You may also want to insert it somewhere
+into your bootscripts if silent mode doesn't automatically give way to verbose
+when your system finishes booting.
+
+If you want to boot into a resolution other than 1024x768, simply follow the
+instructions as usual, but replace each mention of bootsplash-1024x768.cfg with
+bootsplash-XRESxYRES.cfg (you will of course need to make sure this file exists
+within your theme). You will also need to change the vga=791 line in lilo.conf
+appropriately. Here's a table I borrowed from the Gentoo forums:
+
+Colors-----640x480-----800x600-----1024x768-----1280x1024
+
+256----------769---------771----------773----------775
+32000--------784---------787----------790----------793
+65000--------785---------788----------791----------794
+16.7 Mill.---786---------789----------792----------795
+
+
+Compiling a static fbmngplay
+----------------------------
+
+If you keep /usr on a different partition to /, then you will need to use the
+static version of fbmngplay. This is so it does not depend on any libraries that
+are on a partition that may not have yet been mounted. To rid yourself of the
+compile error, edit the line in /tmp/fbmngplay/Makefile
+
+	LIBSS    = $(LIBDIR)/libmng-mini.a $(LIBDIR)/libz.a -lm
+
+To
+
+	LIBSS    = $(LIBDIR)/libmng.a $(LIBDIR)/libjpeg.a $(LIBDIR)/libz.a -lm
+
+Then copy /tmp/fbmngplay/fbmngplay.static to /sbin/fbmngplay
+
+The splash command does not have any such dependencies problems, as it links
+only to glibc.
+
+(Thanks to Dagmar d'Surreal for this bit)
+
+Sources
+-------
+
+http://www.bootsplash.org
+http://forums.gentoo.org/viewtopic.php?t=26494 (Thanks to kachaffeous)
+The blfs-support mailing list
+
+
+
+
+
+
+	
+
+
+

Deleted: trunk/PREVIOUS_FORMAT/bootsplash.txt
===================================================================
--- trunk/PREVIOUS_FORMAT/bootsplash.txt	2004-09-19 19:34:03 UTC (rev 895)
+++ trunk/PREVIOUS_FORMAT/bootsplash.txt	2004-09-19 19:36:40 UTC (rev 896)
@@ -1,358 +0,0 @@
-TITLE:		Installing a bootsplash screen with progress bar
-LFS VERSION:	3.3+
-AUTHOR:		Bryan Gale <bryan at 2dz.co.uk>
-
-SYNOPIS:
-	How to beautify the boot process with splash screen, progress bar and
-	animation. Will also give you a pretty background on text consoles
-
-HINT:
-
-Required Packages
------------------
-
-The SuSE bootsplash kernel patch (versions available for 2.4.18 and 2.4.20
-kernels):
-	ftp://ftp.suse.com/pub/people/stepan/bootsplash/kernel/
-	bootsplash-3.0.7-2.4.18-vanilla.diff
-	
-Or
-	ftp://ftp.suse.com/pub/people/stepan/bootsplash/kernel/
-	bootsplash-3.0.7-2.4.20-vanilla.diff
-
-The splashutils package:
-	ftp://ftp.suse.com/pub/people/stepan/bootsplash/rpm-sources/bootsplash/
-	splashutils.tar.bz2
-
-The frame-buffer mng player:
-	ftp://ftp.suse.com/pub/people/stepan/bootsplash/rpm-sources/bootsplash/
-	fbmngplay-0.5a.tar.bz2
-
-Some helper scripts:
-	ftp://ftp.suse.com/pub/people/stepan/bootsplash/rpm-sources/bootsplash/
-	scripts.tar.bz2
-
-A sample theme:
-	ftp://ftp.suse.com/pub/people/stepan/bootsplash/themes/
-	Theme-Linux.tar.bz2
-	
-This hint will assume these have been downloaded to /tmp
-
-You should also have installed libmng and libjpeg and as described in the Beyond
-Linux From Scratch book
-
-
-Installing the kernel patch
----------------------------
-
-Change to the directory containing your kernel sources, and apply the patch. You
-will then need to configure your kernel
-
-	cd /usr/src/linux &&
-	patch -p1 < /tmp/bootsplash-3.0.7-2.4.*-vanilla.diff &&
-	make menuconfig
-	
-You should enable the following options. Make sure they are compiled into the
-kernel, and not as modules
-
-	Code maturity level options  --->
-		Prompt for development and/or incomplete code/drivers
-	Block devices  ---> RAM disk support
-	Block devices  ---> Initial RAM disk (initrd) support
-	Console drivers  ---> Video mode selection support
-	Console drivers  ---> Frame-buffer support --->
-		Support for frame buffer devices
-		VESA VGA graphics console
-		Use splash screen instead of boot logo
-		
-Now compile and install the kernel
-
-	make dep &&
-	make bzImage &&
-	make modules &&
-	make modules_install &&
-	cp arch/i386/boot/bzImage /boot/lfskernel
-
-
-Installing user space stuff
----------------------------
-
-Unpack splashutils.tar.bz2, compile and copy the required binaries to /sbin
-
-	cd /tmp &&
-	tar xvjf splashutils.tar.bz2 &&
-	cd splashutils &&
-	make &&
-	cp splash fbresolution /sbin &&
-	cd ..
-
-The two binaries we need are splash and fbresolution, so the rest can be
-deleted. We also need one script from the scripts.tar.bz2 package
-
-	tar xvjf scripts.tar.bz2 &&
-	cd scripts &&
-	chmod +x bootanim &&
-	cp bootanim /sbin &&
-	cd ..
-	
-The rest of the scripts are largely distro specific, so they can be deleted. The
-one we save, bootanim, is used by splash to start and stop animations. The mng
-player will also neeed to be installed to actually play the animations
-
-	tar xvjf fbmngplay-0.5a.tar.bz2 &&
-	cd fbmngplay &&
-	make
-	
-You may get compile errors, but hopefully the fbmngplay binary will be there
-
-	cp fbmngplay /sbin
-	
-If you do experence build errors they probably occured while building
-fbmngplay.static. If you want a static version of fbmngplay, see the note at the
-end of this hint
-	
-
-Installing a bootsplash theme
------------------------------
-
-We need to create a directory for our themes
-
-	mkdir -p /etc/bootsplash/themes
-
-Move the sample theme (or any other theme from http://www.bootsplash.og) to this
-directory, and un-tar it
-
-	cd /etc/bootsplash/themes &&
-	tar xvjf /tmp/Theme-Linux.tar.bz2
-
-The programs installed earlier will search for the theme in
-/etc/bootsplash/themes/current, so we need to create a symlink
-
-	ln -s Linux current
-
-When you want to use a different theme you should delete this symlink and create
-another one to your new un-tarred theme
-
-	rm current &&
-	ln -s MYNEWTHEME current
-	
-
-Updating Lilo and rebooting
----------------------------
-
-You will need to edit /etc/lilo.conf. Under the entry for your linux kernel add
-the line
-
-	vga=791
-	
-This is so linux boots into a screen resolution that matches the size of the
-bootsplash screen. You will also need to add
-
-	initrd=/boot/initrd
-
-To boot into silent mode (i.e. boot messages hidden), you will need also to add
-
-	append="splash=silent"
-	
-Not all themes have a silent mode, so this will not always apply.
-
-The following will need to be done now, and everytime you want to change theme.
-Use splash to create a ram disk image of the bootsplash screen
-
-	splash -s -f \
-	/etc/bootsplash/themes/current/config/bootsplash-1024x768.cfg > \
-	/boot/initrd
-
-Now update the mbr and reboot, and you should see your new splash screen
-
-	lilo &&
-	shutdown -r now
-	
-
-Utilising the progress bar
---------------------------
-
-If your theme is enabled with a progress bar, you will need to make some changes
-to your bootscripts to get it to work. The progress bar can be contolled by
-echoing commands to /proc/splash. For a tidy way to use this, you should add the
-following code to your /etc/rc.d/init.d/functions script
-
-	progressbar()
-	{
-
-		if [ $# != 1 ]
-       		then
-                	echo "Usage: progressbar {progress}"
-        		exit 1
-        	fi
-		
-		echo "show $(( 65534 * $1 / 100 ))" > /proc/splash
-
-	}
-
-Now edit your bootscripts in /etc/rc.d/rcsysinit.d and (by default)
-/etc/rc.d/rc3.d to use this function. In general, before each instance of
-loadproc, you should add
-
-	progressbar XXX
-
-Where XXX is boot progress out of 100. The LFS book explains the order in
-which the scripts will be run, and it will take some trial and error to get a
-smooth running progress bar. Remeber not to use this function before /proc
-has been mounted
-
-
-Utilising animation
--------------------
-
-The splash program handles animation, examining the
-/etc/bootsplash/themes/current/config/animations.cfg file, if your theme has
-one. Again, a function should be added to /etc/rc.d/init.d/functions file
-
-	animate()
-	{
-
-		if [ $# = 0 ]
-       		then
-                	echo "Usage: animate {hook}"
-        		exit 1
-        	fi
-
-		splash "$*"
-
-	}
-
-To use it place the following line in your bootscripts wherever an animation
-should be played
-
-	animate HOOK
-
-To determine values for HOOK, you need to look at
-/etc/bootsplash/themes/current/config/animations.cfg. The file takes the format
-
-	HOOK:command
-	HOOK:command
-
-This is from the Redmond theme at http://www.bootsplash.org
-	
-	fsck start:bootanim start bounce.mng
-	master:bootanim stop
-	shutdown: bootanim start bounce.mng
-	
-The command bootanim is the script we installed earlier, which handles the
-animations, and uses the fbmngplay command to actually play the things. To see
-a full list of paramemters, simply run bootanim. In this example we should add
-the following to the bootscript where fsck is run
-
-	animate fsck start
-
-You should place the line
-
-	animate master
-
-just before the bootscripts finish, as this will stop all animations.
-
-The line
-	
-	animate shutdown
-
-should be placed somewhere in the shutdown scripts. Look in
-/etc/rc.d/rc6.d to see what will be run, and insert the line somewhere
-before the killproc-ing begins.
-
-There is consistency between theme about these hooks, so once you have them in
-place, they should not need changing. No harm should come from trying to play a
-non existent animation.
-
-
-Miscellaneous
--------------
-
-Using splash, you can add or change a background on any of your terminals
-
-	splash -n -s -u 1 \
-	/etc/bootsplash/themes/tty2-theme/config/bootsplash-1024x768.cfg
-
-	splash -n -s -u 2 \
-	/etc/bootsplash/themes/tty3-theme/config/bootsplash-1024x768.cfg
-
-	splash -n -s -u 3 \
-	/etc/bootsplash/themes/tty4-theme/config/bootsplash-1024x768.cfg
-	
-	splash -n -s -u 4 \
-	/etc/bootsplash/themes/tty5-theme/config/bootsplash-1024x768.cfg
-	
-	splash -n -s -u 5 \
-	/etc/bootsplash/themes/tty6-theme/config/bootsplash-1024x768.cfg
-	
-You can remove the background with
-
-	splash -s -n -u CONSOLENUMBER
-	
-You can retrun to silent mode using
-
-	echo "silent" > /proc/splash
-
-This may be useful for creating a shutdown screen
-
-Verbose mode can be triggered with F2 or
-	
-	echo "verbose" > /proc/splash
-
-You may want to place this in the print_status function of
-/etc/rc.d/init.d/functions, inside the failure case, or use it when your hard
-drive is being scanned for errors. You may also want to insert it somewhere
-into your bootscripts if silent mode doesn't automatically give way to verbose
-when your system finishes booting.
-
-If you want to boot into a resolution other than 1024x768, simply follow the
-instructions as usual, but replace each mention of bootsplash-1024x768.cfg with
-bootsplash-XRESxYRES.cfg (you will of course need to make sure this file exists
-within your theme). You will also need to change the vga=791 line in lilo.conf
-appropriately. Here's a table I borrowed from the Gentoo forums:
-
-Colors-----640x480-----800x600-----1024x768-----1280x1024
-
-256----------769---------771----------773----------775
-32000--------784---------787----------790----------793
-65000--------785---------788----------791----------794
-16.7 Mill.---786---------789----------792----------795
-
-
-Compiling a static fbmngplay
-----------------------------
-
-If you keep /usr on a different partition to /, then you will need to use the
-static version of fbmngplay. This is so it does not depend on any libraries that
-are on a partition that may not have yet been mounted. To rid yourself of the
-compile error, edit the line in /tmp/fbmngplay/Makefile
-
-	LIBSS    = $(LIBDIR)/libmng-mini.a $(LIBDIR)/libz.a -lm
-
-To
-
-	LIBSS    = $(LIBDIR)/libmng.a $(LIBDIR)/libjpeg.a $(LIBDIR)/libz.a -lm
-
-Then copy /tmp/fbmngplay/fbmngplay.static to /sbin/fbmngplay
-
-The splash command does not have any such dependencies problems, as it links
-only to glibc.
-
-(Thanks to Dagmar d'Surreal for this bit)
-
-Sources
--------
-
-http://www.bootsplash.org
-http://forums.gentoo.org/viewtopic.php?t=26494 (Thanks to kachaffeous)
-The blfs-support mailing list
-
-
-
-
-
-
-	
-
-
-

Added: trunk/bootsplash.txt
===================================================================
--- trunk/bootsplash.txt	2004-09-19 19:34:03 UTC (rev 895)
+++ trunk/bootsplash.txt	2004-09-19 19:36:40 UTC (rev 896)
@@ -0,0 +1,269 @@
+AUTHOR:	     Joachim Beckers <jbeckers at linuxfromscratch.org>
+DATE:        2004-09-19
+LICENSE:     GNU Free Documentation License version 1.2
+
+SYNOPSIS:    How to beautify the kernel 2.4/2.6 boot process using bootsplash.
+
+PRIMARY URI: http://jbeckers.webhop.org/en/lfs/bootsplash/
+
+DESCRIPTION:
+This hint describes how to create your own graphical boot using bootsplash.
+Bootsplash is a packages that allows you to display background pictures with or
+without animations on your consoles, during kernel boot and during init. It's
+fully themeable and it uses the framebuffer. Hence it works with both kernels
+2.4 and 2.6 and you can use hardware graphics acceleration.
+
+PREREQUISITES:
+This hint was written for LFS-5.1.1 with kernel-2.6.8.1. This combination is
+tested, but others will probably work too. Just download the patches that match
+your kernel version.
+The fbmngplay package requires that libmng is installed. See the BLFS book for
+build instructions.
+
+HINT:
+
+    How things are to be done:
+    ==========================
+Setting up bootsplash is to be done in six stages:
+1. Patching the kernel with the bootsplash patch, configuring and recompiling.
+2. Installing the bootsplash package.
+3. Installing a theme.
+4. Creating a initial ramdisk.
+5. Configuring bootsplash and configuring your bootloader.
+6. Adapting bootscripts.
+
+Before we can start however, we'll need to download some packages.
+
+
+    Required Packages:
+    ==================
+The bootsplash kernel patch:
+     http://www.bootsplash.de/files/ (for kernel 2.6 patches)
+or:
+     http://www.bootsplash.de/files/old (for kernel 2.4 patches)
+
+The bootsplash package:
+     http://www.bootsplash.de/files/splashutils/bootsplash-3.1.tar.bz2
+
+A theme:
+     http://www.bootsplash.de/files/themes/
+
+If you don't have your kernel's sources, get them from:
+     ftp://ftp.kernel.org/pub/linux/kernel/
+
+
+    Patching, configuring and recompiling the kernel:
+    =================================================
+If you just downloaded the kernel sources, unpack them in the right place by
+running the following commands:
+     cd /usr/src/
+     tar -xvjf /path/to/kernel-tarball
+
+Now cd to the directory containing your kernel sources, and apply the patch:
+     cd /usr/src/linux-2.*
+     patch -p1 -i /path/to/bootsplash-kernel-patch
+
+Now configure your kernel using your favorite configuration tool:
+     make *config
+
+Make sure you compile these things into your kernel, not as a module:
+-for kernel 2.4:
+      Code maturity level options 
+           --> Prompt for development and/or incomplete code/drivers
+      Block devices
+           --> RAM disk support
+           --> Initial RAM disk (initrd) support
+      Console drivers
+           --> Video mode selection support
+           --> Frame-buffer support
+                    -->	Support for frame buffer devices
+                    --> VESA VGA graphics console
+                    --> Use splash screen instead of boot logo
+
+- for kernel 2.6:
+     Device drivers 
+          --> Block devices
+                   --> RAM disk support
+                   --> Initial Ram disk (initrd) support
+          --> Graphics support
+                   --> Support for framebuffer devices
+                            --> VESA VGA graphics support
+                            --> Console display driver support
+                                     --> Video mode selection support
+                                     --> Framebuffer console support
+                            --> Bootsplash configuration
+                                     --> Bootup splash screen
+
+Note: If there is a framebuffer driver for your graphics card in the kernel,
+you may want to select the matching entry. This will allow you to use hardware
+acceleration.
+
+Finish off by compiling and installing the new kernel:
+- for kernel 2.4:
+     make dep
+     make bzImage
+     make modules
+     make modules_install
+     cp ./arch/i386/boot/bzImage /boot/lfskernel-2.4.*
+
+- for kernel 2.6:
+     make all
+     make modules_install
+     cp ./arch/i386/boot/bzImage /boot/lfskernel-2.6.*
+
+
+    Installing the bootsplash package:
+    ==================================
+Install the bootsplash package by running the following commands:
+     tar -xvjf bootsplash-3.1.tar.bz2
+     cd ./bootsplash-3.1/Utilities/
+     make
+     cp splash fbresolution fbmngplay /sbin
+     cd ../Scripts/
+     cp bootanim /sbin
+     chmod +x /sbin/bootanim
+
+Note: We only need three programs and one script from the bootsplash package.
+The others are Suse-specific bootscripts. Take a look at the documentation in
+bootsplash-3.1/Documentation to learn more.
+
+
+    Installing a theme:
+    ===================
+Install a bootsplash theme by running the following commands:
+     mkdir -p /etc/bootsplash/themes
+     cd /etc/bootsplash/themes
+     tar -xvjf /path/to/your/theme
+
+Now create a symlink that points to the default theme that will be used:
+     ln -s /path/to/your/theme current
+
+
+    Creating an initial ramdisk:
+    ============================
+To show a splashimage on kernel startup, bootsplash uses an initial ramdisk.
+Create an initial ramdisk by running the following command:
+     /sbin/splash -s -f \
+       /etc/bootsplash/themes/current/config/bootsplash-1024x768.cfg > \
+       /boot/bootsplash-initrd
+
+Note: If you want to boot into a resolution other than 1024x768, simply replace
+1024x768 by your favorite resolution. Remember to do the same during the
+following sections. Also make sure that your theme supports the resolution that
+you choose.
+
+
+    Configuring bootsplash and the bootloader:
+    ==========================================
+Bootsplash can display a picture on the background of your terminals, but this
+is only automatically done for tty1. To add a background to tty2, tty3, tty4,
+tty5 and tty6, run the following command, where * is the tty number minus 1:
+     splash -n -s -u * \
+       /etc/bootsplash/themes/current/config/bootsplash-1024x768.cfg
+
+Note: To have all your tty's get a nice background on startup, you can put this
+command into a bootscript.
+
+Now configure your bootloader. This hint provides the instructions for lilo and
+grub. If you're using another bootloader, check out its documentation. The
+instructions will probably be very similar.
+- for lilo:
+     Edit /etc/lilo.conf
+     Make sure to change the kernel entry to match your new kernel. Under the
+     entry for your kernel, add:
+       vga=791
+       initrd=/boot/bootsplash-initrd
+       append="splash=silent"
+     Now apply your changes by running the following command:
+       lilo
+
+- for grub:
+     Edit /boot/grub/menu.lst
+     Make sure to change the kernel entry to match your new kernel. Add the
+     following to the kernel entry:
+       vga=791 splash=silent
+     Below the kernel entry, add:
+       initrd /boot/bootsplash-initrd
+
+Note: If you want to boot into a resolution other than 1024x768, change
+"vga=791" to the number that matches your setup:
++---------+---------+---------+----------+-----------+
+|         | 640x480 | 600x800 | 1024x768 | 1280x1024 |
++---------+---------+---------+----------+-----------+
+|  8 bit  |   769   |   771   |    773   |    775    |
+|  15 bit |   784   |   787   |    790   |    793    |
+|  16 bit |   785   |   788   |    791   |    794    |
+|  24 bit |   786   |   789   |    792   |    795    |
++---------+---------+---------+----------+-----------+
+
+
+    Adapting the bootscripts:
+    =========================
+Bootsplash can not only display pictures, it also supports animations. You can
+adapt your bootscripts to make a progressbar move during startup, or to display
+an animation when an event occurs. For a tidy way to use this, add the
+following code to your /etc/rc.d/init.d/functions script:
+
+     progressbar()
+     {
+
+          if [ $# != 1 ]
+          then
+               echo "Usage: progressbar {progress}"
+               exit 1
+          fi
+		
+          echo "show $(( 65534 * $1 / 100 ))" > /proc/splash
+
+     }
+
+     animate()
+     {
+
+          if [ $# = 0 ]
+          then
+               echo "Usage: animate {hook}"
+               exit 1
+          fi
+
+          splash "$*"
+
+     }
+
+To use the progressbar, edit your bootscripts in /etc/rc.d/init.d.
+Whenever you see "evaluate_retval", add "progressbar XXX" (where XXX is a
+number between 000 and 100 that matches the boot progress). Take a look at
+/etc/rc.d/rcsysinit and /etc/rc.d/rc3.d to get to know the order in which the
+bootscripts are executed.
+
+To use animation, you need to know on which events your theme can play an
+animation. Take a look at /etc/bootsplash/themes/current/config/animations.cfg
+to determine this. The animations.cfg file will probably look like this:
+
+     fsck start:bootanim start bounce.mng
+     master:bootanim stop
+     shutdown: bootanim start bounce.mng
+
+Now add the following to the bootscript that runs fsck:
+     animate fsck start
+
+Place the following just before the bootscripts finish, as this will
+stop all animations:
+     animate master
+
+The following should be placed somewhere in the shutdown scripts:
+     animate shutdown
+
+
+Congratulations: that's it. You can now reboot and enjoy your new splashimage.
+
+
+ACKNOWLEDGEMENTS:
+Thanks to Bryan Gale, the previous author of this hint.
+
+CHANGELOG:
+[2004-09-19]
+* Maintainership taken over.
+* Converted to new hint format.
+* Updated to include instructions for kernel 2.6 and grub.
+* Published the hint on my website.




More information about the hints mailing list