arch/all-pc/boot/grub/netboot/README.netboot

   1 You can use the netboot support to download OS images from a network.
   2 Nearly all the device drivers are coming from the network-based boot
   3 loader, Etherboot. Please visit its web page. They have rich
   4 documentations so you will be able to get useful information from there.
   5 The URL is <http://etherboot.sourceforge.net/>.
   6
   7 These below are common options for configure. Perhaps you may not need
   8 to specify them.
   9
  10 --disable-packet-retransmission
  11   Turns off packet retransmission. Use it on an empty network, where
  12   no packet collision can happen.
  13
  14 --enable-pci-direct
  15   Define this for PCI BIOSes that do not implement BIOS32 or not
  16   correctly.
  17
  18 --enable-diskless
  19   Enable the diskless support. If specified, you will get two optional
  20   images, called "nbgrub" and "pxegrub". The former is the ``Net Boot
  21   Image Proposal'' format, which is used by Etherboot and Netboot, while
  22   the latter is the ``Preboot Execution Environment" format, which is
  23   used by a PXE ROM. You may buy a PXE ROM from some companies.
  24
  25 Here is the information about the device drivers. They are all disabled
  26 by default, so you must specify configure options to enable drivers you
  27 want to use. Some drivers have extra per-driver options, so the extra
  28 options are also described below.
  29
  30 Caution: You should enable them as you need. Don't enable any
  31 unnecessary driver, because GRUB might crash if you include too many
  32 drivers at the same time.
  33
  34 3Com509, ISA/EISA
  35   --enable-3c509
  36
  37 3Com529 == MCA 3c509
  38   --enable-3c529
  39
  40 3Com59x and 3Com900
  41   --enable-3c595
  42
  43 3Com90x
  44   --enable-3c90x
  45
  46 Crystal Semiconductor CS89x0
  47   --enable-cs89x0
  48   --enable-cs-scan=LIST
  49     Probe for CS89x0 base address using LIST of comma separated hex
  50     addresses; increasing the address by one (0x300 -> 0x301) will force
  51     a more aggressive probing algorithm. This might be neccessary after
  52     a soft-reset of the NIC.
  53
  54 Davicom DM9102 and 9009
  55   --enable-davicom
  56
  57 Digital DE100 and DE200
  58   --enable-depca
  59
  60 Intel Etherexpress Pro/10 (ISA card)
  61   --enable-eepro
  62
  63 Intel Etherexpress Pro/100
  64   --enable-eepro100
  65
  66 SMC 83c170 EPIC/100
  67   --enable-epic100
  68
  69 3Com507
  70   --enable-3c507
  71
  72 EXOS205
  73   --enable-exos205
  74
  75 Racal-Interlan NI5210
  76   --enable-ni5210
  77
  78 Lance PCI PCNet/32
  79 AMD HomePNA
  80   --enable-lance
  81
  82 Novell NE2100 and NE1500
  83   --enable-ne2100
  84
  85 Racal-Interlan NI6510
  86   --enable-ni6510
  87
  88 National Semiconductor DP8381x (Netgear FA311 and FA312)
  89   --enable-natsemi
  90
  91 Racal-Interlan NI5010
  92   --enable-ni5010
  93
  94 3Com503, aka Etherlink II, also /16 model
  95   --enable-3c503
  96   --enable-3c503-shmem
  97     Use 3c503 shared memory mode.
  98   --enable-3c503-aui
  99     Use AUI by default on 3c503 cards.
 100
 101 NE1000/2000 and clones (ISA)
 102   --enable-ne
 103   --enable-ne-scan=LIST (0x280,0x300,0x320,0x340)
 104     Probe for NE base address using LIST of comma separated hex
 105     addresses.
 106
 107 NE2000 PCI clone (RTL8029)
 108 Winbond 86C940
 109 Compex RL2000
 110 KTI ET32P2
 111 NetVin 5000SC
 112 Holtek 80232
 113   --enable-ns8390
 114   --enable-compex-rl2000-fix
 115     If you have a Compex RL2000 PCI 32-bit (11F6:1401), and the probe
 116     hangs in "Probing...[NE*000/PCI]", try enabling this fix... it
 117     worked for me :).
 118
 119 WD8003/8013, SMC8216/8416
 120   --enable-wd
 121   --enable-wd-default-mem=MEM (0xCC000)
 122     Default memory location for WD/SMC cards.
 123
 124 Old base driver for Tulip clones
 125   --enable-otulip
 126
 127 Realtek 8139
 128 SMC 1211
 129 D-Link DFE530TX+ and DFE538TX
 130   --enable-rtl8139
 131
 132 SIS 900 and SIS 7016
 133   --enable-sis900
 134
 135 Schneider and Koch G16
 136   --enable-sk-g16
 137
 138 SMC9000
 139   --enable-smc9000
 140   --enable-smc9000-scan=LIST
 141     List of I/O addresses to probe.
 142
 143 Tiara, Fujitsu Lancard
 144   --enable-tiara
 145
 146 Linksys LNE100TX and other NICs using this Tulip clone chip
 147 Netgear FA310TX and other NICs using this Tulip clone chip
 148 Tulip clones based on the ADMtek Centaur-P
 149 Tulip clones based on the Macronix 987x5
 150 Tulip-Fast
 151 Tulip+
 152 Tulip 21142
 153 ASIX AX88140
 154 Intel Tulip
 155 Compex RL100-TX
 156   --enable-tulip
 157
 158 Rhine-I, e.g. D-Link DFE-530TX
 159 Rhine-II
 160   --enable-via-rhine
 161
 162 Winbond W89c840
 163 Compex RL100-ATX
 164   --enable-w89c840
 165
 166
 167 The description about how to use the support can be found in the GRUB
 168 manual. Run "info grub" in the shell prompt.