Add a readme to the lilo package explaining how to make a bootable usb stick
[openwrt/svn-archive/archive.git] / utils / lilo / README
1 Using this package to create a bootable usb stick for openwrt.
2
3 The status of this package is currently 'it works for me', and it will
4 require more effort before it's generic across the board. Currently
5 only tested to be working on x86-2.4, there are some issues with devfs
6 that need to be addressed yet in 2.6 before this will be clean with
7 x86-2.6. My development environment for this is a via epia with a
8 serial console (no monitors or keyboards attached).
9
10 To create the images that are bootable, configure your buildroot to include
11 the lilo package in the image, as well as e2fsprogs. Have it create an
12 ext2 file system as the target file system. Let it build the works.
13
14 When the build is finished, you will need to run the script 'mkbootable'
15 located in the lilo package directory, it requires root privileges to
16 loop mount the fs for installing lilo. When it's done, you have an
17 8 meg ext2fs root file system ready to run.
18
19 To use the image, dd it directly onto a usb stick. It should go onto
20 /dev/sda not /dev/sda1, it's assuming the stick is not partitioned.
21 When you boot the stick, you will get a lilo menu on the serial terminal.
22 The two options allow you to boot with the stick itself as the root file
23 system, or, to boot into a ramdisk, and not mount the stick at all. The
24 stick will likely show up at /dev/discs/disc0/disc
25
26 Boot the unit, and select the ramdisk. Once up in the ramdisk, you can
27 use the e2fstools to expand the image to fill the stick and add a journal
28 to use it as ext3.
29
30 e2fsck -f /dev/discs/disc0/disc
31 tune2fs -j /dev/discs/disc0/disc
32 resize2fs /dev/discs/disc0/disc
33
34 Reboot the box, and, have fun with openwrt on your x86 using the usb
35 stick to boot and run from.
36