xref: /openbsd-src/share/man/man4/bge.4 (revision 50b7afb2c2c0993b0894d4e34bf857cb13ed9c80)
1.\" $OpenBSD: bge.4,v 1.61 2014/01/29 16:15:12 naddy 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: January 29 2014 $
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.Cd "rgephy* at mii?"
43.Sh DESCRIPTION
44The
45.Nm
46driver provides support for various NICs based on the Broadcom BCM570x,
47571x, 572x, 575x, 576x, 578x, 5776x and 5778x Gigabit Ethernet controller
48chips and the 590x and 5779x Fast Ethernet controller chips,
49including the following:
50.Pp
51.Bl -bullet -compact
52.It
533Com 3c996-T (10/100/1000baseT)
54.It
553Com 3c996-SX (1000baseSX)
56.It
573Com 3c996B-T (10/100/1000baseT)
58.It
59Allied-Telesis AT-2972LX10/LC
60.It
61Fujitsu PW0G8GE1U (1000baseSX)
62.It
63Fujitsu PW0G8GE2U (10/100/1000baseT)
64.It
65Fujitsu PW008GE4 (1000baseSX)
66.It
67Fujitsu PW008GE5 (10/100/1000baseT)
68.It
69Fujitsu PW008QG1U (10/100/1000baseT)
70.It
71HP ProLiant NC320T PCI-E Gigabit NIC (10/100/1000baseT)
72.It
73HP ProLiant NC320m PCI-E Gigabit NIC (10/100/1000baseT)
74.It
75HP ProLiant NC370F PCI-X Gigabit NIC (1000baseSX)
76.It
77HP ProLiant NC370T PCI-X Gigabit NIC (10/100/1000baseT)
78.It
79HP ProLiant NC1020 PCI Gigabit NIC (10/100/1000baseT)
80.It
81HP ProLiant NC6770 PCI-X Gigabit NIC (1000baseSX)
82.It
83HP ProLiant NC7760 embedded PCI Gigabit NIC (10/100/1000baseT)
84.It
85HP ProLiant NC7770 PCI-X Gigabit NIC (10/100/1000baseT)
86.It
87HP ProLiant NC7771 PCI-X Gigabit NIC (10/100/1000baseT)
88.It
89HP ProLiant NC7780 embedded PCI-X Gigabit NIC (10/100/1000baseT)
90.It
91HP ProLiant NC7781 embedded PCI-X Gigabit NIC (10/100/1000baseT)
92.It
93HP ProLiant NC7782 embedded PCI-X Gigabit NIC (10/100/1000baseT)
94.It
95Netgear GA302T (10/100/1000baseT)
96.It
97SysKonnect SK-9D21 (10/100/1000baseT)
98.It
99SysKonnect SK-9D41 (1000baseSX)
100.El
101.Pp
102The
103.Nm
104driver supports IPv4 receive IP/TCP/UDP checksum offload and transmit IP/TCP
105checksum offload, VLAN tag insertion and stripping,
106as well as a 256-bit multicast hash filter.
107The BCM5717, BCM5718, BCM5723, BCM5754, BCM5755, BCM5761, BCM5764, BCM5784,
108BCM5785, BCM5787 and BCM577xx chips also support IPv6 receive TCP/UDP
109checksum offload and IPv6 transmit TCP checksum offload.
110.Pp
111The BCM5700, BCM5701, BCM5703 and BCM5704 chips are capable of
112supporting Jumbo frames, which can be configured via the
113interface MTU setting.
114Selecting an MTU larger than 1500 bytes with the
115.Xr ifconfig 8
116utility configures the adapter to receive and transmit Jumbo frames.
117.Pp
118The
119.Nm
120driver supports the following media types:
121.Bl -tag -width 1000baseSX
122.It Cm autoselect
123Enable autoselection of the media type and options.
124The user can manually override
125the autoselected mode by adding media options to the appropriate
126.Xr hostname.if 5
127file.
128.It Cm 10baseT
129Set 10Mbps operation.
130The
131.Xr ifconfig 8
132.Ic mediaopt
133option can also be used to select either
134.Cm full-duplex
135or
136.Cm half-duplex
137modes.
138.It Cm 100baseTX
139Set 100Mbps (Fast Ethernet) operation.
140The
141.Xr ifconfig 8
142.Ic mediaopt
143option can also be used to select either
144.Cm full-duplex
145or
146.Cm half-duplex
147modes.
148.It Cm 1000baseT
149Set 1000baseT operation over twisted pair.
150Both
151.Cm full-duplex
152and
153.Cm half-dupex
154modes are supported.
155.It Cm 1000baseSX
156Set 1000Mbps (Gigabit Ethernet) operation.
157Both
158.Cm full-duplex
159and
160.Cm half-duplex
161modes are supported.
162.El
163.Pp
164The
165.Nm
166driver supports the following media options:
167.Bl -tag -width full-duplex
168.It Cm full-duplex
169Force full duplex operation.
170.It Cm half-duplex
171Force half duplex operation.
172.El
173.Pp
174For more information on configuring this device, see
175.Xr ifconfig 8 .
176.Sh DIAGNOSTICS
177.Bl -diag
178.It "bge0: can't find mem space"
179A fatal initialization error has occurred.
180.It "bge0: couldn't map interrupt"
181A fatal initialization error has occurred.
182.It "bge0: watchdog timeout -- resetting"
183The device has stopped responding to the network, or there is a problem with
184the network connection (cable).
185.El
186.Sh SEE ALSO
187.Xr arp 4 ,
188.Xr brgphy 4 ,
189.Xr ifmedia 4 ,
190.Xr intro 4 ,
191.Xr netintro 4 ,
192.Xr pci 4 ,
193.Xr rgephy 4 ,
194.Xr hostname.if 5 ,
195.Xr ifconfig 8
196.Sh HISTORY
197The
198.Nm
199device driver first appeared in
200.Ox 3.0 .
201.Sh AUTHORS
202The
203.Nm
204driver was written by
205.An Bill Paul Aq Mt wpaul@windriver.com .
206