2 .\" Copyright (c) 1997 David E. O'Brien
4 .\" All rights reserved.
6 .\" Redistribution and use in source and binary forms, with or without
7 .\" modification, are permitted provided that the following conditions
9 .\" 1. Redistributions of source code must retain the above copyright
10 .\" notice, this list of conditions and the following disclaimer.
11 .\" 2. Redistributions in binary form must reproduce the above copyright
12 .\" notice, this list of conditions and the following disclaimer in the
13 .\" documentation and/or other materials provided with the distribution.
15 .\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR
16 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
17 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
18 .\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT,
19 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
20 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
21 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
22 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
24 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
33 .Nd "Intel EtherExpress PRO/100 Ethernet device driver"
35 To compile this driver into the kernel,
36 place the following lines in your
37 kernel configuration file:
38 .Bd -ragged -offset indent
43 Alternatively, to load the driver as a
44 module at boot time, place the following line in
46 .Bd -literal -offset indent
52 driver provides support for Ethernet adapters based on the Intel
53 i82557, i82558, i82559, i82550, and i82562 chips.
54 The driver supports TCP/UDP/IP checksum offload for both transmit
55 and receive on i82550 and i82551.
56 On i82559 only TCP/UDP checksum offload for receive is supported.
57 TCP segmentation offload (TSO) for IPv4 as well as VLAN hardware
58 tag insertion/stripping is supported on i82550 and i82551.
59 Wake On Lan (WOL) support is provided on all controllers
60 except i82557, i82259ER and early i82558 revisions.
64 driver supports the following media types:
65 .Bl -tag -width "10baseT/UTP"
67 Enable autoselection of the media type and options.
68 The autoselected mode can be overridden by adding the media options to
73 Set 100Mbps (Fast Ethernet) operation.
78 driver supports the following media options:
79 .Bl -tag -width "full-duplex"
81 Force full duplex operation.
83 Force half duplex operation.
86 Note that 100baseTX media type is not available on the Pro/10.
87 For further information on configuring this device, see
92 driver supports reception and transmission of extended frames
97 can be controlled by means of the
105 driver also supports a special link option:
106 .Bl -tag -width link0
108 Some chip revisions have loadable microcode which can be used to reduce the
109 interrupt load on the host cpu.
110 Not all boards have microcode support.
115 will download the microcode to the chip if it is available.
118 Adapters supported by the
124 Intel EtherExpress PRO/10
126 Intel InBusiness 10/100
128 Intel PRO/100B / EtherExpressPRO/100 B PCI Adapter
130 Intel PRO/100+ Management Adapter
132 Intel PRO/100 VE Desktop Adapter
134 Intel PRO/100 VM Network Connection
136 Intel PRO/100 M Desktop Adapter
138 Intel PRO/100 S Desktop, Server and Dual-Port Server Adapters
140 Many on-board network interfaces on Intel motherboards
143 Tunables can be set at the
145 prompt before booting the kernel or stored in
147 The following variables are available as both
152 .Bl -tag -width "xxxxxx"
153 .It Va dev.fxp.%d.int_delay
154 Maximum amount of time, in microseconds, that an interrupt may
155 be delayed in an attempt to coalesce interrupts.
156 This is only effective if the Intel microcode is loaded.
157 The accepted range is 300 to 3000, the default is 1000.
158 .It Va dev.fxp.%d.bundle_max
159 Number of packets that will be bundled, before an interrupt is
161 This is only effective if the Intel microcode is loaded.
162 The accepted range is 1 to 65535, the default is 6.
165 The following variables are available as
168 .Bl -tag -width "xxxxxx"
169 .It Va dev.fxp.%d.rnr
170 This is a read-only variable and shows the number of events of
171 RNR (resource not ready).
172 .It Va dev.fxp.%d.stats
173 This is a read-only variable and displays useful MAC counters
174 maintained in the driver.
178 .It "fxp%d: couldn't map memory"
179 A fatal initialization error has occurred.
180 .It "fxp%d: couldn't map interrupt"
181 A fatal initialization error has occurred.
182 .It "fxp%d: Failed to malloc memory"
183 There are not enough mbuf's available for allocation.
184 .It "fxp%d: device timeout"
185 The device has stopped responding to the network, or there is a problem with
186 the network connection (cable).
187 .It "fxp%d: Microcode loaded, int_delay: %d usec bundle_max: %d"
188 The chip has successfully downloaded the microcode, and changed the
189 parameterized values to the given settings.
203 device driver first appeared in
209 device driver was written by
211 It has then been updated to use the busdma API and made endian-clean by
213 This manual page was written by
214 .An David E. O'Brien .