1 .\" Copyright (c) 2006 Broadcom Corporation
2 .\" David Christensen <davidch@broadcom.com>. All rights reserved.
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
8 .\" 1. Redistributions of source code must retain the above copyright
9 .\" notice, this list of conditions and the following disclaimer.
10 .\" 2. Redistributions in binary form must reproduce the above copyright
11 .\" notice, this list of conditions and the following disclaimer in the
12 .\" documentation and/or other materials provided with the distribution.
13 .\" 3. Neither the name of Broadcom Corporation nor the name of its contributors
14 .\" may be used to endorse or promote products derived from this software
15 .\" without specific prior written consent.
17 .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS'
18 .\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS
21 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
22 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
23 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
24 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
25 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
26 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
27 .\" THE POSSIBILITY OF SUCH DAMAGE.
36 .Nd "Broadcom NetXtreme II (BCM5706/5708/5709/5716) PCI/PCIe Gigabit Ethernet adapter driver"
38 To compile this driver into the kernel,
39 place the following lines in your
40 kernel configuration file:
41 .Bd -ragged -offset indent
46 Alternatively, to load the driver as a
47 module at boot time, place the following line in
49 .Bd -literal -offset indent
55 driver supports Broadcom's NetXtreme II product family, including the
56 BCM5706, BCM5708, BCM5709 and BCM5716 Ethernet controllers.
58 The NetXtreme II product family is composed of various Converged NIC (or CNIC)
59 Ethernet controllers which support a TCP Offload Engine (TOE), Remote DMA (RDMA),
60 and iSCSI acceleration, in addition to standard L2 Ethernet traffic, all on the
63 The following features are supported in the
68 .Bl -item -offset indent -compact
70 IP/TCP/UDP checksum offload
72 Jumbo frames (up to 9022 bytes)
78 10/100/1000Mbps operation in full-duplex mode
80 10/100Mbps operation in half-duplex mode
85 driver supports the following media types:
86 .Bl -tag -width ".Cm 10baseT/UTP"
88 Enable autoselection of the media type and options.
89 The user can manually override
90 the autoselected mode by adding media options to
97 option can also be used to select either
103 Set 100Mbps (Fast Ethernet) operation.
107 option can also be used to select either
113 Sets 1000Mbps operation.
116 mode is supported at this speed.
118 Set 1000baseT operation over twisted pair.
123 Set 2500Mbps operation.
131 driver supports the following media options:
132 .Bl -tag -width ".Cm full-duplex"
134 Force full duplex operation.
136 Force half duplex operation.
139 For more information on configuring this device, see
144 driver provides support for various NICs based on the Broadcom NetXtreme II
145 family of Gigabit Ethernet controllers, including the
150 Broadcom NetXtreme II BCM5706 1000Base-SX
152 Broadcom NetXtreme II BCM5706 1000Base-T
154 Broadcom NetXtreme II BCM5708 1000Base-SX
156 Broadcom NetXtreme II BCM5708 1000Base-T
158 Broadcom NetXtreme II BCM5709 1000Base-SX
160 Broadcom NetXtreme II BCM5709 1000Base-T
162 Broadcom NetXtreme II BCM5716 1000Base-T
164 Dell PowerEdge 1950 integrated BCM5708 NIC
166 Dell PowerEdge 2950 integrated BCM5708 NIC
168 Dell PowerEdge R710 integrated BCM5709 NIC
170 HP NC370F Multifunction Gigabit Server Adapter
172 HP NC370T Multifunction Gigabit Server Adapter
174 HP NC370i Multifunction Gigabit Server Adapter
176 HP NC371i Multifunction Gigabit Server Adapter
178 HP NC373F PCIe Multifunc Giga Server Adapter
180 HP NC373T PCIe Multifunction Gig Server Adapter
182 HP NC373i Multifunction Gigabit Server Adapter
184 HP NC373m Multifunction Gigabit Server Adapter
186 HP NC374m PCIe Multifunction Adapter
188 HP NC380T PCIe DP Multifunc Gig Server Adapter
190 HP NC382T PCIe DP Multifunction Gigabit Server Adapter
192 HP NC382i DP Multifunction Gigabit Server Adapter
194 HP NC382m DP 1GbE Multifunction BL-c Adapter
197 The following variables are available as both
202 .Bl -tag -width indent
203 .It Va hw.bce.msi_enable
204 Whether or not MSI support is enabled in the driver.
205 The default value is 1.
209 .It "bce%d: PCI memory allocation failed!"
210 The driver has encountered a fatal initialization error.
211 .It "bce%d: PCI map interrupt failed!"
212 The driver has encountered a fatal initialization error.
213 .It "bce%d: Unsupported controller revision (%c%d)"
214 The driver does not support the controller revision in use.
215 .It "bce%d: Controller initialization failed!"
216 The driver has encountered a fatal initialization error.
217 .It "bce%d: NVRAM test failed!"
218 The driver could not access the controller NVRAM correctly.
219 .It "bce%d: DMA resource allocation failed!"
220 The driver could not allocate DMA memory to setup the controllers
221 host memory data structures.
222 .It "bce%d: Interface allocation failed!"
223 The driver could not create a network interface for the controller.
224 .It "bce%d: PHY probe failed!"
225 The driver could not access the PHY used by the controller.
226 .It "bce%d: Failed to setup IRQ!"
227 The driver could not initialize the IRQ handler.
228 .It "bce%d: Error: PHY read timeout!"
229 The driver could not read a PHY register before the timeout period expired.
230 .It "bce%d: PHY write timeout!"
231 The driver could not write to the PHY register because a timeout occurred.
232 .It "bce%d: Timeout error reading NVRAM at offset 0x%08X!"
233 The driver could not write to NVRAM because a timeout occurred.
234 .It "bce%d: Unknown Flash NVRAM found!"
235 The driver does not recognize the NVRAM device being used and therefore
236 cannot access it correctly.
237 .It "bce%d: Invalid NVRAM magic value!"
238 The driver cannot read NVRAM or the NVRAM is corrupt.
239 .It "bce%d: Invalid Manufacturing Information NVRAM CRC!"
240 The driver cannot read NVRAM or the NVRAM is corrupt.
241 .It "bce%d: Invalid Feature Configuration Information NVRAM CRC!"
242 The driver cannot read NVRAM or the NVRAM is corrupt.
243 .It "bce%d: DMA mapping error!"
244 The driver was unable to map memory into DMA addressable space required
246 .It "bce%d: Could not allocate parent DMA tag!"
247 The driver could not allocate a PCI compatible DMA tag.
248 .It "bce%d: Could not allocate status block DMA tag!"
249 The driver could not allocate a DMA tag for the controller's
251 .It "bce%d: Could not allocate status block DMA memory!"
252 The driver could not allocate DMA addressable memory for the controller's
254 .It "bce_d: Could not map status block DMA memory!"
255 The driver could not map the status block memory into the controller's DMA
257 .It "bce%d: Could not allocate statistics block DMA tag!"
258 The driver could not allocate a DMA tag for the controller's
260 .It "bce%d: Could not allocate statistics block DMA memory!"
261 The driver could not allocate DMA addressable memory for the controller's
263 .It "bce%d: Could not map statistics block DMA memory!"
264 The driver could not map the statistics block memory into the controller's DMA
266 .It "bce%d: Could not allocate TX descriptor chain DMA tag!"
267 The driver could not allocate a DMA tag for the controller's
269 .It "bce%d: Could not allocate TX descriptor chain DMA memory!
270 The driver could not allocate DMA addressable memory for the controller's
272 .It "bce%d: Could not map TX descriptor chain DMA memory!"
273 The driver could not map the TX descriptor chain memory into the controller's DMA
275 .It "bce%d: Could not allocate TX mbuf DMA tag!"
276 The driver could not allocate a DMA tag for the controller's
278 .It "bce%d: Unable to create TX mbuf DMA map!"
279 The driver could not map the TX mbuf memory into the controller's DMA
281 .It "bce%d: Could not allocate RX descriptor chain DMA tag!"
282 The driver could not allocate a DMA tag for the controller's
284 .It "bce%d: Could not allocate RX descriptor chain "
285 The driver could not allocate DMA addressable memory for the controller's
287 .It "bce%d: Could not map RX descriptor chain DMA memory!"
288 The driver could not map the RX descriptor chain memory into the controller's DMA
290 .It "bce%d: Could not allocate RX mbuf DMA tag!"
291 The driver could not allocate a DMA tag for the controller's
293 .It "bce%d: Unable to create RX mbuf DMA map!"
294 The driver could not map the RX mbuf memory into the controller's DMA
296 .It "bce%d: Firmware synchronization timeout!"
297 The driver was not able to synchronize with the firmware running on the
299 The firmware may be stopped or hung.
300 .It "bce%d: Invalid Ethernet address!"
301 The driver was not able to read a valid Ethernet MAC address from NVRAM.
302 .It "bce%d: Reset failed!"
303 The driver has encountered a fatal initialization error.
304 .It "bce%d: Byte swap is incorrect!"
305 The driver has encountered a fatal initialization error.
307 with details of the CPU architecture and system chipset in use.
308 .It "bce%d: Firmware did not complete initialization!"
309 The driver has encountered a fatal initialization error.
310 .It "bce%d: Bootcode not running!"
311 The driver has encountered a fatal initialization error.
312 .It "bce%d: Error mapping mbuf into RX chain!"
313 The driver could not map a RX mbuf into DMA addressable memory.
314 .It "bce%d: Error filling RX chain: rx_bd[0x%04X]!"
315 The driver was unable to allocate enough mbufs to fill the RX chain
316 during initialization.
317 Try increasing the number of mbufs available in
318 the system, increase system memory, or if using jumbo frames, make sure
319 enough 9KB mbufs are available.
320 .It "bce%d: Failed to allocate new mbuf, incoming frame dropped!"
321 The driver was unable to allocate a new mbuf for the RX chain and reused
322 the mbuf for the received frame, dropping the incoming frame in the process.
323 Try increasing the number of mbufs available in the system or increase system
325 .It "bce%d: Controller reset failed!"
326 A fatal initialization error has occurred.
327 .It "bce%d: Controller initialization failed!"
328 A fatal initialization error has occurred.
329 .It "bce%d: Block initialization failed!"
330 A fatal initialization error has occurred.
331 .It "bce%d: Error mapping mbuf into TX chain!"
332 The driver could not map a TX mbuf into DMA addressable memory.
333 .It "bce%d: Error registering poll function!"
334 The driver received an error while attempting to register the poll function.
335 .It "bce%d: Changing VLAN_MTU not supported."
336 Changing the VLAN MTU is not currently supported by the driver.
337 .It "bce%d: Cannot change VLAN_HWTAGGING while management firmware (ASF/IPMI/UMP) is running!"
338 Management firmware to support ASF/IPMI/UMP requires that VLAN
339 tag stripping be enabled in the controller.
340 .It "bce%d: Changing VLAN_HWTAGGING not supported!"
341 Disabling VLAN tag stripping is not currently supported by the driver.
342 .It "bce%d: Watchdog timeout occurred, resetting!"
343 The device has stopped responding to the network, there is a problem
344 with the cable connection, or a driver logic problem has occurred..
345 .It "bce%d: Fatal attention detected: 0x%08X!"
346 A controller hardware failure has occurred.
347 If the problem continues replace the controller.
360 device driver first appeared in
365 driver was written by
366 .An David Christensen Aq davidch@broadcom.com .