xref: /openbsd-src/share/man/man4/nge.4 (revision 2b0358df1d88d06ef4139321dd05bd5e05d91eaf)
1.\"	$OpenBSD: nge.4,v 1.34 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@bsdi.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.\" $FreeBSD: nge.4,v 1.11 2002/08/08 18:30:39 ambrisko Exp $
34.\"
35.Dd $Mdocdate: October 28 2008 $
36.Dt NGE 4
37.Os
38.Sh NAME
39.Nm nge
40.Nd National Semiconductor PCI 10/100/Gigabit Ethernet device
41.Sh SYNOPSIS
42.Cd "nge* at pci?"
43.Cd "nsgphy* at mii?"
44.Sh DESCRIPTION
45The
46.Nm
47driver provides support for various NICs based on the National Semiconductor
48DP83820 and DP83821 Gigabit Ethernet controller chips, including the
49following:
50.Pp
51.Bl -bullet -compact
52.It
53Addtron AEG320T
54.It
55Ark PC SOHO-GA2500T (32-bit PCI) and SOHO-GA2000T (64-bit PCI)
56.It
57Asante FriendlyNet GigaNIX 1000TA and 1000TPC
58.It
59D-Link DGE-500T
60.It
61Linksys EG1032v1 (32-bit PCI) and EG1064v1 (64-bit PCI)
62.It
63Netgear GA621
64.It
65Netgear GA622T
66.It
67SMC EZ Card 1000 (SMC9462TX)
68.It
69Surecom Technology EP-320G-TX
70.It
71TRENDnet TEG-PCITX (32-bit PCI) and TEG-PCITX2 (64-bit PCI)
72.El
73.Pp
74The
75.Nm
76driver supports IPv4 receive IP/TCP/UDP checksum offload, VLAN tag
77insertion and stripping, as well as a 2048-bit multicast hash filter
78and up to 4 pattern match buffers.
79.Pp
80The
81.Nm
82driver also supports Jumbo frames, which can be configured via the
83interface MTU setting.
84Selecting an MTU larger than 1500 bytes with the
85.Xr ifconfig 8
86utility configures the adapter to receive and transmit Jumbo frames.
87Using Jumbo frames can greatly improve performance for certain tasks,
88such as file transfers and data streaming.
89.Pp
90The
91.Nm
92driver supports the following media types:
93.Bl -tag -width full-duplex
94.It Cm autoselect
95Enable autoselection of the media type and options.
96The user can manually override
97the autoselected mode by adding media options to the appropriate
98.Xr hostname.if 5
99file.
100.It Cm 10baseT
101Set 10Mbps operation.
102The
103.Xr ifconfig 8
104.Ic mediaopt
105option can also be used to select either
106.Cm full-duplex
107or
108.Cm half-duplex
109modes.
110.It Cm 100baseTX
111Set 100Mbps (Fast Ethernet) operation.
112The
113.Xr ifconfig 8
114.Ic mediaopt
115option can also be used to select either
116.Cm full-duplex
117or
118.Cm half-duplex
119modes.
120.It Cm 1000baseT
121Set 1000baseT operation over twisted pair.
122Both
123.Cm full-duplex
124and
125.Cm half-duplex
126modes are supported.
127.It Cm 1000baseSX
128Set 1000Mbps (Gigabit Ethernet) operation.
129Both
130.Cm full-duplex
131and
132.Cm half-duplex
133modes are supported.
134.El
135.Pp
136The
137.Nm
138driver supports the following media options:
139.Bl -tag -width full-duplex
140.It Cm full-duplex
141Force full duplex operation.
142.It Cm half-duplex
143Force half duplex operation.
144.El
145.Pp
146For more information on configuring this device, see
147.Xr ifconfig 8 .
148.Sh SEE ALSO
149.Xr arp 4 ,
150.Xr ifmedia 4 ,
151.Xr intro 4 ,
152.Xr netintro 4 ,
153.Xr nsgphy 4 ,
154.Xr pci 4 ,
155.Xr hostname.if 5 ,
156.Xr ifconfig 8
157.Rs
158.%T National Semiconductor DP83820 datasheet
159.%O http://www.national.com
160.Re
161.Rs
162.%T National Semiconductor DP83861 datasheet
163.%O http://www.national.com
164.Re
165.Sh HISTORY
166The
167.Nm
168device driver first appeared in
169.Ox 3.0 .
170.Sh AUTHORS
171The
172.Nm
173driver was written by
174.An Bill Paul Aq wpaul@bsdi.com .
175