Adjust memory layout for 2.6.22+ kernels with 32KB setup code
[mknbi.git] / mklnim.1
1 .TH MKLNIM 1 "25 April 2000"
2 .SH NAME
3 mklnim \- make Linux Netinstall Image
4 .SH SYNOPSIS
5 .B mklnim
6 outputfile
7 [\fBpath-to-cdrom\fR]
8 .SH DESCRIPTION
9 .I mklnim
10 is a shell script that takes a SuSE, TurboLinux or a RedHat CDROM, or
11 equivalent disk directory, and creates a network bootable image (NBI)
12 that can be used with Etherboot (http://etherboot.sourceforge.net/)
13 or Netboot (http://www.han.de/~gero/netboot.html).
14 This NBI, when booted via the network, will make the target computer
15 behave just as if a CDROM boot (TurboLinux), or a floppy boot (RedHat
16 and SuSE) had been selected.  A conventional install can be done from
17 this point onwards.
18 .LP
19 There are several occasions when this technique is useful: 1. It
20 can be used to quickly boot a target computer when the floppy
21 loading is very slow. 2. In the case of TurboLinux, it loads
22 the CDROM initial ramdisk which does not require any further
23 floppy loading. In the case of RedHat, it only loads the floppy
24 initial ramdisk which does not contain the material in the
25 supplementary floppy, and may require more floppy insertion.
26 3. It can start the install from a floppy of any size, not just
27 1.4 MB, or even from a floppyless machine, if one has a boot
28 ROM (providing no further floppy access is required).
29 4. It could be used as part of an automatic installation process.
30 .LP
31 Naturally, all this assumes that the infrastructure for diskless
32 booting (bootp and tftp servers) has been set up.
33 .SH BUGS
34 If supplementary floppies are required, this script doesn't include
35 that material in the network boot image. Please feel welcome to fix
36 this problem.
37 .SH "SEE ALSO"
38 Etherboot tutorial at http://etherboot.sourceforge.net/
39 .SH COPYRIGHT
40 .I mklnim
41 is under the GNU Public License
42 .SH AUTHOR
43 Ken Yap (ken_yap@users.sourceforge.net)
44 .SH DATE
45 Version 0.4 April 2000