Merge branch 'master' of git://git.etherboot.org/scm/gpxe
[people/xl0/gpxe.git] / contrib / tomsrtbt / tomsrtbt-net.txt
1 Notes on turning tomsrtbt El Torito into a Etherboot image:
2
3 0. Tomsrtbt (http://www.toms.net/) is an all-purpose rescue and utility
4 1-floppy Linux system. You can read all about it at the web site. These
5 notes explain how to turn the El Torito version of it into a netbootable
6 image for Etherboot.  Note that the .img file is not an ISO image, it is
7 a 2.88M floppy emulation image for writing onto a CD-R(W) with mkisofs.
8 It's actually a minix filesystem.  Inside it are the kernel bz2bzImage
9 and initrd.bz2.
10
11 1. First uncompress the .img:
12
13         bunzip2 tomsrtbt-2.0.103.ElTorito.288.img.bz2
14
15 2. Mount the image using loopback. You probably need to be root to do
16 this:
17
18         mount -o ro,loop tomsrtbt-2.0.103.ElTorito.288.img /media/floppy
19
20 I've specified /media/floppy which is the floppy mount point for my
21 system, but any convenient directory will do.
22
23 3. Copy the kernel image and initrd off it:
24
25         cp -p /media/floppy/bz2bzImage /media/floppy/initrd.bz2 .
26
27 4. Use mkelf-linux (or mknbi-linux) to make a netbootable image:
28
29 mkelf-linux --append='root=100' bz2bzImage initrd.bz2 > tomsrtbt.nb
30
31 root=100 means use /dev/ram0 (device 1,0) as the root device.
32
33 5. That's it. Clean up by unmounting the .img:
34
35         umount /media/cdrom
36
37 tomsrtbt.nb can now be loaded with Etherboot. Have fun.