Improve package description to clarify usage scenarios
[grml-rescueboot.git] / debian / README
1 The Debian Package grml-rescueboot
2 ----------------------------------
3
4 Usually systems are rescued with CD or usb stick. grml-rescueboot makes
5 it possible to simply copy an ISO image to the harddisk and boot the
6 rescue image. This eliminates the need to carry around a usb stick
7 to rescue a system as long as the hard disk and the boot manager still
8 work.
9
10 grml-rescueboot includes the script 42_grml which is installed in
11 /etc/grub.d and run when update-grub is executed. The script looks for
12 ISO images in /boot/grml/ and adds an entry for each image found.
13
14 Howto:
15 ------
16
17 - Get a recent Grml image from http://grml.org/download/
18 - Copy the image to /boot/grml
19 - Run update-grub
20 - Reboot and enjoy your new rescue system
21
22 Limitations:
23 ------------
24
25 grml-rescueboot uses the loopback feature of grub2, so it won't work
26 with legacy grub. Furthermore the ISO image needs to support
27 loopback.cfg, a file which is placed in /boot/grub/. Grml supports
28 loopback.cfg beginning with release version 2010.04.
29
30 More technical details can be found here: 
31 http://www.supergrubdisk.org/wiki/Loopback.cfg
32
33  -- Andreas "Jimmy" Gredler <jimmy@grml.org>  Sat, 06 Nov 2010 12:28:45 +0100