xref: /openbsd-src/share/man/man4/bnx.4 (revision 2b0358df1d88d06ef4139321dd05bd5e05d91eaf)
1.\"	$OpenBSD: bnx.4,v 1.24 2008/10/28 06:27:28 brad Exp $
2.\"
3.\"Copyright (c) 2006 Broadcom Corporation
4.\" David Christensen <davidch@broadcom.com>.  All rights reserved.
5.\"
6.\"Redistribution and use in source and binary forms, with or without
7.\"modification, are permitted provided that the following conditions
8.\"are met:
9.\"
10.\"1. Redistributions of source code must retain the above copyright
11.\"   notice, this list of conditions and the following disclaimer.
12.\"2. Redistributions in binary form must reproduce the above copyright
13.\"   notice, this list of conditions and the following disclaimer in the
14.\"   documentation and/or other materials provided with the distribution.
15.\"3. Neither the name of Broadcom Corporation nor the name of its contributors
16.\"   may be used to endorse or promote products derived from this software
17.\"   without specific prior written consent.
18.\"
19.\"THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS'
20.\"AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21.\"IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22.\"ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS
23.\"BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24.\"CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25.\"SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26.\"INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27.\"CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28.\"ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
29.\"THE POSSIBILITY OF SUCH DAMAGE.
30.\"
31.\" $FreeBSD: /repoman/r/ncvs/src/share/man/man4/bce.4,v 1.2 2006/04/10 20:12:17 brueffer Exp $
32.\"
33.Dd $Mdocdate: October 28 2008 $
34.Dt BNX 4
35.Os
36.Sh NAME
37.Nm bnx
38.Nd Broadcom NetXtreme II 10/100/Gigabit Ethernet device
39.Sh SYNOPSIS
40.Cd "bnx* at pci?"
41.Cd "brgphy* at mii?"
42.Sh DESCRIPTION
43The
44.Nm
45driver supports Broadcom's NetXtreme II product family, such as the
46BCM5706 PCI-X and BCM5708 PCI Express Ethernet controllers, which
47includes the following:
48.Pp
49.Bl -bullet -compact
50.It
51Dell PowerEdge 1950 integrated BCM5708 NIC (10/100/1000baseT)
52.It
53Dell PowerEdge 2950 integrated BCM5708 NIC (10/100/1000baseT)
54.It
55Dell PowerEdge 2970 integrated BCM5708 NIC (10/100/1000baseT)
56.It
57HP NC370F PCI-X Multifunction Gigabit server adapter (1000baseSX)
58.It
59HP NC370T PCI-X Multifunction Gigabit server adapter (10/100/1000baseT)
60.It
61HP Dual NC370i Multifunction Gigabit embedded server adapter (10/100/1000baseT)
62.It
63HP NC373F PCI Express Multifunction Gigabit server adapter (1000baseSX)
64.It
65HP NC373i PCI Express Multifunction Gigabit embedded server adapter (10/100/1000baseT)
66.It
67HP NC374m PCI Express Multifunction Gigabit embedded server adapter (10/100/1000baseT)
68.It
69HP NC380T PCI Express Dual Port Multifunction Gigabit server adapter (10/100/1000baseT)
70.It
71IBM xSeries 3550 integrated BCM5708 NIC (10/100/1000baseT)
72.It
73IBM xSeries 3650 integrated BCM5708 NIC (10/100/1000baseT)
74.El
75.Pp
76The NetXtreme II product family is composed of various Converged NIC (or CNIC)
77Ethernet controllers which support a TCP Offload Engine (TOE),
78Remote DMA (RDMA), and iSCSI acceleration,
79in addition to standard L2 Ethernet traffic,
80all on the same controller.
81The following features are supported in the
82.Nm
83driver under
84.Ox :
85.Bd -literal -offset indent
86IPv4 receive IP/TCP/UDP checksum offload
87.\"Jumbo frames (up to 9022 bytes)
88VLAN tag insertion and stripping
89Interrupt coalescing
9010/100/1000Mbps operation in full-duplex mode
9110/100Mbps operation in half-duplex mode
92.Ed
93.Pp
94The
95.Nm
96driver supports the following media types:
97.Bl -tag -width ".Cm 10baseT/UTP"
98.It Cm autoselect
99Enable autoselection of the media type and options.
100The user can manually override
101the autoselected mode via
102.Xr ifconfig 8 .
103.It Cm 10baseT/UTP
104Set 10Mbps operation.
105The
106.Xr ifconfig 8
107.Ic mediaopt
108option can also be used to select either
109.Cm full-duplex
110or
111.Cm half-duplex
112modes.
113.It Cm 100baseTX
114Set 100Mbps (Fast Ethernet) operation.
115The
116.Xr ifconfig 8
117.Ic mediaopt
118option can also be used to select either
119.Cm full-duplex
120or
121.Cm half-duplex
122modes.
123.It Cm 1000baseT
124Set 1000baseT operation over twisted pair.
125Only
126.Cm full-duplex
127mode is supported.
128.It Cm 1000baseSX
129Set 1000Mbps (Gigabit Ethernet) operation.
130Only
131.Cm full-duplex
132mode is supported.
133.It Cm 2500baseSX
134Set 2500Mbps operation.
135Only
136.Cm full-duplex
137mode is supported.
138.El
139.Pp
140The
141.Nm
142driver supports the following media options:
143.Bl -tag -width ".Cm full-duplex"
144.It Cm full-duplex
145Force full duplex operation.
146.It Cm half-duplex
147Force half duplex operation.
148.El
149.Pp
150For more information on configuring this device, see
151.Xr ifconfig 8 .
152.Sh FILES
153The adapter needs a firmware file, which is loaded on demand by the
154driver when the device is attached:
155.Pp
156.Bl -tag -width Ds -offset indent -compact
157.It Pa /etc/firmware/bnx
158.El
159.Sh SEE ALSO
160.Xr arp 4 ,
161.Xr brgphy 4 ,
162.Xr ifmedia 4 ,
163.Xr intro 4 ,
164.Xr netintro 4 ,
165.Xr pci 4 ,
166.Xr hostname.if 5 ,
167.Xr ifconfig 8
168.Sh HISTORY
169The
170.Nm
171device driver first appeared in
172.Ox 4.0 .
173.Sh AUTHORS
174.An -nosplit
175The
176.Nm
177driver was written by
178.An David Christensen Aq davidch@broadcom.com
179and ported to
180.Ox
181by
182.An Brad Smith Aq brad@openbsd.org .
183