xref: /illumos-gate/usr/src/grub/grub-0.97/netboot/README.netboot (revision 2a8bcb4efb45d99ac41c94a75c396b362c414f7f)
1You can use the netboot support to download OS images from a network.
2Nearly all the device drivers are coming from the network-based boot
3loader, Etherboot. Please visit its web page. They have rich
4documentations so you will be able to get useful information from there.
5The URL is <http://etherboot.sourceforge.net/>.
6
7These below are common options for configure. Perhaps you may not need
8to 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
25Here is the information about the device drivers. They are all disabled
26by default, so you must specify configure options to enable drivers you
27want to use. Some drivers have extra per-driver options, so the extra
28options are also described below.
29
30Caution: You should enable them as you need. Don't enable any
31unnecessary driver, because GRUB might crash if you include too many
32drivers at the same time.
33
343Com509, ISA/EISA
35  --enable-3c509
36
373Com529 == MCA 3c509
38  --enable-3c529
39
403Com59x and 3Com900
41  --enable-3c595
42
433Com90x
44  --enable-3c90x
45
46Crystal 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
54Davicom DM9102 and 9009
55  --enable-davicom
56
57Digital DE100 and DE200
58  --enable-depca
59
60Intel Etherexpress Pro/10 (ISA card)
61  --enable-eepro
62
63Intel Etherexpress Pro/100
64  --enable-eepro100
65
66SMC 83c170 EPIC/100
67  --enable-epic100
68
693Com507
70  --enable-3c507
71
72EXOS205
73  --enable-exos205
74
75Racal-Interlan NI5210
76  --enable-ni5210
77
78Lance PCI PCNet/32
79AMD HomePNA
80  --enable-lance
81
82Novell NE2100 and NE1500
83  --enable-ne2100
84
85Racal-Interlan NI6510
86  --enable-ni6510
87
88National Semiconductor DP8381x (Netgear FA311 and FA312)
89  --enable-natsemi
90
91Racal-Interlan NI5010
92  --enable-ni5010
93
943Com503, 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
101NE1000/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
107NE2000 PCI clone (RTL8029)
108Winbond 86C940
109Compex RL2000
110KTI ET32P2
111NetVin 5000SC
112Holtek 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
119WD8003/8013, SMC8216/8416
120  --enable-wd
121  --enable-wd-default-mem=MEM (0xCC000)
122    Default memory location for WD/SMC cards.
123
124Old base driver for Tulip clones
125  --enable-otulip
126
127Realtek 8139
128SMC 1211
129D-Link DFE530TX+ and DFE538TX
130  --enable-rtl8139
131
132SIS 900 and SIS 7016
133  --enable-sis900
134
135Schneider and Koch G16
136  --enable-sk-g16
137
138SMC9000
139  --enable-smc9000
140  --enable-smc9000-scan=LIST
141    List of I/O addresses to probe.
142
143Tiara, Fujitsu Lancard
144  --enable-tiara
145
146Linksys LNE100TX and other NICs using this Tulip clone chip
147Netgear FA310TX and other NICs using this Tulip clone chip
148Tulip clones based on the ADMtek Centaur-P
149Tulip clones based on the Macronix 987x5
150Tulip-Fast
151Tulip+
152Tulip 21142
153ASIX AX88140
154Intel Tulip
155Compex RL100-TX
156  --enable-tulip
157
158Rhine-I, e.g. D-Link DFE-530TX
159Rhine-II
160  --enable-via-rhine
161
162Winbond W89c840
163Compex RL100-ATX
164  --enable-w89c840
165
166
167The description about how to use the support can be found in the GRUB
168manual. Run "info grub" in the shell prompt.
169