contrib/initrd/README

   1 README for mkinitrd-net
   2
   3 mkinitrd-net enables you to use your distribution's stock kernel for
   4 diskless workstations, without having to compile in support for the
   5 relevant network card(s).  It creates an initial ramdisk image containing
   6 the required network-card kernel modules and bootstrap scripts to load the
   7 module, obtain an IP address via DHCP and mount the root filesystem via
   8 NFS.
   9
  10 mkinitrd-net also generates a dhcpd.conf file fragment that can be used to
  11 automate the process of mapping NBI files to clients, based on the PCI IDs
  12 of their network cards.  Etherboot will send the PCI ID of the network
  13 card to the DHCP server in the etherboot-encapsulated-options field
  14 (Etherboot 5.0.7 and newer) and the DHCP server can use this to identify
  15 the correct NBI to point the client towards.
  16
  17 The end result is that:
  18
  19 a) You can avoid the hassle of compiling custom kernels for diskless
  20    workstations.
  21
  22 b) Diskless workstations will automatically download the correct
  23    kernel+initrd.
  24
  25 c) You have an easier life! :-)
  26
  27
  28
  29 mkinitrd-net is Copyright Fen Systems Ltd. 2001.  mkinitrd-net itself is
  30 licensed under the GNU GPL.  It incorporates code from the uClibc,
  31 busybox, udhcpc and Etherboot projects, each of which has its own licence
  32 terms.  Standard disclaimers apply.
  33
  34 The copy of mkinitrd-net in the Etherboot contribs is not the
  35 authoritative copy of mkinitrd-net; please do not make modifications to
  36 this copy.  Patches should be sent to Michael Brown
  37 <mbrown@fensystems.co.uk>.