1.\" Copyright (c) 2001 Wind River Systems 2.\" Copyright (c) 1997, 1998, 1999, 2000, 2001 3.\" Bill Paul <wpaul@bsdi.com>. All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 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. All advertising materials mentioning features or use of this software 14.\" must display the following acknowledgement: 15.\" This product includes software developed by Bill Paul. 16.\" 4. Neither the name of the author nor the names of any co-contributors 17.\" may be used to endorse or promote products derived from this software 18.\" without specific prior written permission. 19.\" 20.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND 21.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 22.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 23.\" ARE DISCLAIMED. IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD 24.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 25.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 26.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 27.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 28.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 29.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF 30.\" THE POSSIBILITY OF SUCH DAMAGE. 31.\"
|
32.\" $FreeBSD: head/share/man/man4/nge.4 138068 2004-11-24 19:06:43Z brueffer $
|
32.\" $FreeBSD: head/share/man/man4/nge.4 148145 2005-07-19 00:26:30Z trhodes $ |
33.\"
|
34.Dd November 24, 2004
|
34.Dd July 16, 2005 |
35.Dt NGE 4 36.Os 37.Sh NAME 38.Nm nge 39.Nd "National Semiconductor PCI Gigabit Ethernet adapter driver" 40.Sh SYNOPSIS
|
41To compile support for the 42.Nm 43driver into your kernel, place the following lines in your kernel configuration file: 44.Bd -ragged -offset indent |
45.Cd "device miibus" 46.Cd "device nge"
|
47.Ed 48.Pp 49Alternatively, to load the 50.Nm 51driver at boot time, place the following line in 52.Xr loader.conf 5 : 53.Bd -literal -offset indent 54if_nge_load="YES" 55.Ed |
56.Sh DESCRIPTION 57The 58.Nm 59driver provides support for various NICs based on the National Semiconductor 60DP83820 and DP83821 Gigabit Ethernet controller chips. 61.Pp 62The DP83820 supports TBI (ten bit interface) and GMII 63transceivers, which means it can be used with either copper or 1000baseX 64fiber applications. 65The DP83820 supports TCP/IP checksum offload and 66VLAN tagging/insertion as well as a 2048-bit multicast hash filter 67and up to 4 pattern match buffers. 68.Pp 69Most cards also use the DP83861 10/100/1000 copper gigabit transceiver 70chip, which supports autonegotiation of 10, 100 and 1000Mbps modes in 71full or half duplex. 72.Pp 73The DP83820 also supports jumbo frames, which can be configured 74via the interface MTU setting. 75Selecting an MTU larger than 1500 bytes with the 76.Xr ifconfig 8 77utility configures the adapter to receive and transmit jumbo frames. 78Using jumbo frames can greatly improve performance for certain tasks, 79such as file transfers and data streaming. 80.Pp 81The 82.Nm 83driver supports the following media types: 84.Bl -tag -width 10baseTXUTP 85.It Cm autoselect 86Enable autoselection of the media type and options. 87The user can manually override 88the autoselected mode by adding media options to 89.Xr rc.conf 5 . 90.It Cm 10baseT/UTP 91Set 10Mbps operation. 92The 93.Xr ifconfig 8 94.Ic mediaopt 95option can also be used to select either 96.Cm full-duplex 97or 98.Cm half-duplex 99modes. 100.It Cm 100baseTX 101Set 100Mbps (Fast Ethernet) 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 1000baseTX 111Set 1000baseTX operation over twisted pair. 112.Cm full-duplex 113and 114.Cm half-duplex 115modes are supported. 116.It Cm 1000baseSX 117Set 1000Mbps (Gigabit Ethernet) operation. 118Both 119.Cm full-duplex 120and 121.Cm half-duplex 122modes are supported. 123.El 124.Pp 125The 126.Nm 127driver supports the following media options: 128.Bl -tag -width full-duplex 129.It Cm full-duplex 130Force full duplex operation. 131.It Cm half-duplex 132Force half duplex operation. 133.El 134.Pp 135The 136.Nm 137driver also supports one special link option for 1000baseTX cards: 138.Bl -tag -width link0 139.It Cm link0 140With 1000baseTX cards, establishing a link between two ports requires 141that one port be configured as a master and the other a slave. 142With autonegotiation, 143the master/slave settings will be chosen automatically. 144However when manually selecting the link state, it is necessary to 145force one side of the link to be a master and the other a slave. 146The 147.Nm 148driver configures the ports as slaves by default. 149Setting the 150.Cm link0 151flag with 152.Xr ifconfig 8 153will set a port as a master instead. 154.El 155.Pp 156For more information on configuring this device, see 157.Xr ifconfig 8 . 158.Sh HARDWARE 159The 160.Nm 161driver supports National Semiconductor DP83820 and DP83821 based 162Gigabit Ethernet adapters including: 163.Pp 164.Bl -bullet -compact 165.It 166SMC EZ Card 1000 (SMC9462TX) 167.It 168D-Link DGE-500T 169.It 170Asante FriendlyNet GigaNIX 1000TA and 1000TPC 171.It 172Addtron AEG320T 173.It 174LinkSys EG1032 (32-bit PCI) and EG1064 (64-bit PCI) 175.It 176Surecom Technology EP-320G-TX 177.It 178Netgear GA622T 179.It 180Netgear GA621 181.It 182Ark PC SOHO-GA2500T (32-bit PCI) and SOHO-GA2000T (64-bit PCI) 183.It 184Trendware TEG-PCITX (32-bit PCI) and TEG-PCITX2 (64-bit PCI) 185.El 186.Sh DIAGNOSTICS 187.Bl -diag 188.It "nge%d: couldn't map memory" 189A fatal initialization error has occurred. 190.It "nge%d: couldn't map ports" 191A fatal initialization error has occurred. 192.It "nge%d: couldn't map interrupt" 193A fatal initialization error has occurred. 194.It "nge%d: no memory for softc struct!" 195The driver failed to allocate memory for per-device instance information 196during initialization. 197.It "nge%d: failed to enable memory mapping!" 198The driver failed to initialize PCI shared memory mapping. 199This might 200happen if the card is not in a bus-master slot. 201.It "nge%d: no memory for jumbo buffers!" 202The driver failed to allocate memory for jumbo frames during 203initialization. 204.It "nge%d: watchdog timeout" 205The device has stopped responding to the network, or there is a problem with 206the network connection (cable). 207.El 208.Sh SEE ALSO 209.Xr arp 4 , 210.Xr miibus 4 , 211.Xr netintro 4 , 212.Xr ng_ether 4 , 213.Xr polling 4 , 214.Xr vlan 4 , 215.Xr ifconfig 8 216.Rs 217.%T National Semiconductor DP83820 datasheet 218.%O http://www.national.com 219.Re 220.Rs 221.%T National Semiconductor DP83861 datasheet 222.%O http://www.national.com 223.Re 224.Sh HISTORY 225The 226.Nm 227device driver first appeared in 228.Fx 4.4 . 229.Sh AUTHORS 230The 231.Nm 232driver was written by 233.An Bill Paul Aq wpaul@bsdi.com .
|