xref: /openbsd-src/share/man/man4/bge.4 (revision a28daedfc357b214be5c701aa8ba8adb29a7f1c2)
1.\" $OpenBSD: bge.4,v 1.40 2008/10/28 06:27:28 brad Exp $
2.\" Copyright (c) 2001 Wind River Systems
3.\" Copyright (c) 1997, 1998, 1999, 2000, 2001
4.\"	Bill Paul <wpaul@windriver.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.\" 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.
14.\" 3. All advertising materials mentioning features or use of this software
15.\"    must display the following acknowledgement:
16.\"	This product includes software developed by Bill Paul.
17.\" 4. Neither the name of the author nor the names of any co-contributors
18.\"    may be used to endorse or promote products derived from this software
19.\"   without specific prior written permission.
20.\"
21.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND
22.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24.\" ARE DISCLAIMED.  IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD
25.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
26.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
27.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
28.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
29.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
30.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
31.\" THE POSSIBILITY OF SUCH DAMAGE.
32.\"
33.Dd $Mdocdate: October 28 2008 $
34.Dt BGE 4
35.Os
36.Sh NAME
37.Nm bge
38.Nd Broadcom BCM57xx/BCM590x 10/100/Gigabit Ethernet device
39.Sh SYNOPSIS
40.Cd "bge* at pci?"
41.Cd "brgphy* at mii?"
42.Sh DESCRIPTION
43The
44.Nm
45driver provides support for various NICs based on the Broadcom BCM570x,
46571x, 572x, 575x and 578x families of Gigabit Ethernet controller
47chips and the 590x family of Fast Ethernet controller chips, including
48the following:
49.Pp
50.Bl -bullet -compact
51.It
523Com 3c996-T (10/100/1000baseT)
53.It
543Com 3c996-SX (1000baseSX)
55.It
563Com 3c996B-T (10/100/1000baseT)
57.It
58Dell PowerEdge 1750 integrated BCM5704C NIC (10/100/1000baseT)
59.It
60Dell PowerEdge 2550 integrated BCM5700 NIC (10/100/1000baseT)
61.It
62Dell PowerEdge 2650 integrated BCM5703 NIC (10/100/1000baseT)
63.It
64Fujitsu PRIMEPOWER 250/450 LAN (10/100/1000baseT)
65.It
66Fujitsu PW0G8GE1U (1000baseSX)
67.It
68Fujitsu PW0G8GE2U (10/100/1000baseT)
69.It
70Fujitsu PW008GE4 (1000baseSX)
71.It
72Fujitsu PW008GE5 (10/100/1000baseT)
73.It
74Fujitsu PW008QG1U (10/100/1000baseT)
75.It
76HP ProLiant NC320T PCI-E Gigabit NIC (10/100/1000baseT)
77.It
78HP ProLiant NC320m PCI-E Gigabit NIC (10/100/1000baseT)
79.It
80HP ProLiant NC370F PCI-X Gigabit NIC (1000baseSX)
81.It
82HP ProLiant NC370T PCI-X Gigabit NIC (10/100/1000baseT)
83.It
84HP ProLiant NC1020 PCI Gigabit NIC (10/100/1000baseT)
85.It
86HP ProLiant NC6770 PCI-X Gigabit NIC (1000baseSX)
87.It
88HP ProLiant NC7760 embedded PCI Gigabit NIC (10/100/1000baseT)
89.It
90HP ProLiant NC7770 PCI-X Gigabit NIC (10/100/1000baseT)
91.It
92HP ProLiant NC7771 PCI-X Gigabit NIC (10/100/1000baseT)
93.It
94HP ProLiant NC7780 embedded PCI-X Gigabit NIC (10/100/1000baseT)
95.It
96HP ProLiant NC7781 embedded PCI-X Gigabit NIC (10/100/1000baseT)
97.It
98HP ProLiant NC7782 embedded PCI-X Gigabit NIC (10/100/1000baseT)
99.It
100IBM ThinkPad T43/T43p integrated BCM5751M NIC (10/100/1000baseT)
101.It
102IBM xSeries 235 integrated BCM5703X NIC (10/100/1000baseT)
103.It
104IBM xSeries 305 integrated BCM5703X NIC (10/100/1000baseT)
105.It
106Netgear GA302T (10/100/1000baseT)
107.It
108SysKonnect SK-9D21 (10/100/1000baseT)
109.It
110SysKonnect SK-9D41 (1000baseSX)
111.El
112.Pp
113The
114.Nm
115driver supports
116.\"IP, TCP
117.\"and UDP checksum offload for both receive and transmit,
118VLAN tag insertion and stripping as well as a 256-bit multicast hash
119filter.
120.Pp
121The BCM5700, BCM5701, BCM5703 and BCM5704 chips are capable of
122supporting Jumbo frames, which can be configured via the
123interface MTU setting.
124Selecting an MTU larger than 1500 bytes with the
125.Xr ifconfig 8
126utility configures the adapter to receive and transmit Jumbo frames.
127Using Jumbo frames can greatly improve performance for certain tasks,
128such as file transfers and data streaming.
129.Pp
130The
131.Nm
132driver supports the following media types:
133.Bl -tag -width 1000baseSX
134.It Cm autoselect
135Enable autoselection of the media type and options.
136The user can manually override
137the autoselected mode by adding media options to the appropriate
138.Xr hostname.if 5
139file.
140.It Cm 10baseT
141Set 10Mbps operation.
142The
143.Xr ifconfig 8
144.Ic mediaopt
145option can also be used to select either
146.Cm full-duplex
147or
148.Cm half-duplex
149modes.
150.It Cm 100baseTX
151Set 100Mbps (Fast Ethernet) operation.
152The
153.Xr ifconfig 8
154.Ic mediaopt
155option can also be used to select either
156.Cm full-duplex
157or
158.Cm half-duplex
159modes.
160.It Cm 1000baseT
161Set 1000baseT operation over twisted pair.
162Both
163.Cm full-duplex
164and
165.Cm half-dupex
166modes are supported.
167.It Cm 1000baseSX
168Set 1000Mbps (Gigabit Ethernet) operation.
169Both
170.Cm full-duplex
171and
172.Cm half-duplex
173modes are supported.
174.El
175.Pp
176The
177.Nm
178driver supports the following media options:
179.Bl -tag -width full-duplex
180.It Cm full-duplex
181Force full duplex operation.
182.It Cm half-duplex
183Force half duplex operation.
184.El
185.Pp
186For more information on configuring this device, see
187.Xr ifconfig 8 .
188.Sh DIAGNOSTICS
189.Bl -diag
190.It "bge%d: can't find mem space"
191A fatal initialization error has occurred.
192.It "bge%d: couldn't map interrupt"
193A fatal initialization error has occurred.
194.It "bge%d: no memory for jumbo buffer queue!"
195The driver failed to allocate memory for jumbo frames during
196initialization.
197.It "bge%d: watchdog timeout"
198The device has stopped responding to the network, or there is a problem with
199the network connection (cable).
200.El
201.Sh SEE ALSO
202.Xr arp 4 ,
203.Xr brgphy 4 ,
204.Xr ifmedia 4 ,
205.Xr intro 4 ,
206.Xr netintro 4 ,
207.Xr pci 4 ,
208.Xr hostname.if 5 ,
209.Xr ifconfig 8
210.Sh HISTORY
211The
212.Nm
213device driver first appeared in
214.Ox 3.0 .
215.Sh AUTHORS
216The
217.Nm
218driver was written by
219.An Bill Paul Aq wpaul@windriver.com .
220