1.\" $OpenBSD: nge.4,v 1.7 2001/10/05 19:08:14 nate 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: src/share/man/man4/nge.4,v 1.5 2001/07/11 22:09:31 wpaul Exp $ 34.\" 35.Dd May 11, 2001 36.Dt NGE 4 37.Os 38.Sh NAME 39.Nm nge 40.Nd "National Semiconductor PCI gigabit ethernet adapter driver" 41.Sh SYNOPSIS 42.Cd "nge* at pci? dev ? function ?" 43.Sh DESCRIPTION 44The 45.Nm 46driver provides support for various NICs based on the National Semiconductor 47DP83820 and DP83821 gigabit ethernet controller chips, including the 48following: 49.Pp 50.Bl -bullet -compact 51.It 52Addtron AEG320T 53.It 54Asante FriendlyNet GigaNIX 1000TA and 1000TPC 55.It 56D-Link DGE-500T 57.It 58LinkSys EG1032 (32-bit PCI) and EG1064 (64-bit PCI) 59.It 60Netgear GA622T 61.It 62SMC EZ Card 1000 (SMC9462TX) 63.It 64Surecom Technology EP-320G-TX 65.El 66.Pp 67All of these NICs are capable of 10, 100 and 1000mbps speeds over CAT5 68copper cable. 69The DP83820 supports TBI (ten bit interface) and GMII 70transceivers, which means it can be used with either copper or 1000baseX 71fiber applications. 72The DP83820 supports 73.Xr ip 4 , 74.Xr tcp 4 , 75and 76.Xr udp 4 77checksum offload and VLAN tagging/insertion as well as a 2048-bit 78multicast hash filter and up to 4 pattern match buffers. 79.Pp 80Most cards also use the DP83861 10/100/1000 copper gigabit tranceiver 81chip, which supports autonegotiation of 10, 100 and 1000mbps modes in 82full or half duplex. 83.Pp 84The DP83820 also supports jumbo frames, which can be configured 85via the interface MTU setting. 86Selecting an MTU larger than 1500 bytes with the 87.Xr ifconfig 8 88utility configures the adapter to receive and transmit jumbo frames. 89Using jumbo frames can greatly improve performance for certain tasks, 90such as file transfers and data streaming. 91If the MTU is set to be larger than the NIC's transmit buffer 92(typically 8152 bytes), hardware output checksumming is disabled 93as the NIC cannot handle this case. 94.Pp 95The 96.Nm 97driver supports the following media types: 98.Bl -tag -width 1000baseTX 99.It Cm autoselect 100Enable autoselection of the media type and options. 101The user can manually override 102the autoselected mode by adding media options to 103.Xr rc.conf 5 . 104.It Cm 10baseT 105Set 10Mbps operation. 106The 107.Xr ifconfig 8 108.Ic mediaopt 109option can also be used to select either 110.Cm full-duplex 111or 112.Cm half-duplex 113modes. 114.It Cm 100baseTX 115Set 100Mbps (fast ethernet) operation. 116The 117.Xr ifconfig 8 118.Ic mediaopt 119option can also be used to select either 120.Cm full-duplex 121or 122.Cm half-duplex 123modes. 124.It Cm 1000baseTX 125Set 1000baseTX operation over twisted pair. 126.Cm full-duplex 127and 128.Cm half-duplex 129modes are supported. 130.It Cm 1000baseSX 131Set 1000Mbps (gigabit ethernet) operation. 132Both 133.Cm full-duplex 134and 135.Cm half-duplex 136modes are supported. 137.El 138.Pp 139The 140.Nm 141driver supports the following media options: 142.Bl -tag -width full-duplex 143.It Cm full-duplex 144Force full duplex operation. 145.It Cm half-duplex 146Force half duplex operation. 147.El 148.Pp 149The 150.Nm 151driver also supports one special link option for 1000baseTX cards: 152.Bl -tag -width link0 153.It Cm link0 154With 1000baseTX cards, establishing a link between two ports requires 155that one port be configured as a master and the other a slave. 156With autonegotiation, 157the master/slave settings will be chosen automatically. 158However when manually selecting the link state, it is necessary to 159force one side of the link to be a master and the other a slave. 160The 161.Nm 162driver configures the ports as slaves by default. 163Setting the 164.Cm link0 165flag with 166.Xr ifconfig 8 167will set a port as a master instead. 168.El 169.Pp 170For more information on configuring this device, see 171.Xr ifconfig 8 . 172.Sh DIAGNOSTICS 173.Bl -diag 174.It "nge%d: couldn't map memory" 175A fatal initialization error has occurred. 176.It "nge%d: couldn't map ports" 177A fatal initialization error has occurred. 178.It "nge%d: couldn't map interrupt" 179A fatal initialization error has occurred. 180.It "nge%d: no memory for softc struct!" 181The driver failed to allocate memory for per-device instance information 182during initialization. 183.It "nge%d: failed to enable memory mapping!" 184The driver failed to initialize PCI shared memory mapping. 185This might 186happen if the card is not in a bus-master slot. 187.It "nge%d: no memory for jumbo buffers!" 188The driver failed to allocate memory for jumbo frames during 189initialization. 190.It "nge%d: watchdog timeout" 191The device has stopped responding to the network, or there is a problem with 192the network connection (cable). 193.El 194.Sh SEE ALSO 195.Xr arp 4 , 196.Xr netintro 4 , 197.Xr ifconfig 8 198.Rs 199.%T National Semiconductor DP83820 datasheet 200.%O http://www.national.com 201.Re 202.Rs 203.%T National Semiconductor DP83861 datasheet 204.%O http://www.national.com 205.Re 206.Sh HISTORY 207The 208.Nm 209device driver first appeared in 210.Ox 3.0 . 211.Sh AUTHORS 212The 213.Nm 214driver was written by 215.An Bill Paul Aq wpaul@bsdi.com . 216