Add a readme to the lilo package explaining how to make a bootable usb stick
authorGerry Rozema <groz@openwrt.org>
Thu, 17 Aug 2006 07:43:43 +0000 (07:43 +0000)
committerGerry Rozema <groz@openwrt.org>
Thu, 17 Aug 2006 07:43:43 +0000 (07:43 +0000)
SVN-Revision: 4583

utils/lilo/README [new file with mode: 0755]

diff --git a/utils/lilo/README b/utils/lilo/README
new file mode 100755 (executable)
index 0000000..de3bf95
--- /dev/null
@@ -0,0 +1,36 @@
+Using this package to create a bootable usb stick for openwrt.
+
+The status of this package is currently 'it works for me', and it will
+require more effort before it's generic across the board.  Currently
+only tested to be working on x86-2.4, there are some issues with devfs
+that need to be addressed yet in 2.6 before this will be clean with
+x86-2.6. My development environment for this is a via epia with a
+serial console (no monitors or keyboards attached).
+
+To create the images that are bootable, configure your buildroot to include
+the lilo package in the image, as well as e2fsprogs.  Have it create an
+ext2 file system as the target file system.  Let it build the works.
+
+When the build is finished, you will need to run the script 'mkbootable'
+located in the lilo package directory, it requires root privileges to
+loop mount the fs for installing lilo.  When it's done, you have an
+8 meg ext2fs root file system ready to run.
+
+To use the image, dd it directly onto a usb stick.  It should go onto
+/dev/sda not /dev/sda1, it's assuming the stick is not partitioned.
+When you boot the stick, you will get a lilo menu on the serial terminal.
+The two options allow you to boot with the stick itself as the root file
+system, or, to boot into a ramdisk, and not mount the stick at all.  The
+stick will likely show up at /dev/discs/disc0/disc
+
+Boot the unit, and select the ramdisk.  Once up in the ramdisk, you can
+use the e2fstools to expand the image to fill the stick and add a journal
+to use it as ext3.
+
+e2fsck -f /dev/discs/disc0/disc
+tune2fs -j /dev/discs/disc0/disc
+resize2fs /dev/discs/disc0/disc
+
+Reboot the box, and, have fun with openwrt on your x86 using the usb
+stick to boot and run from.
+