1.\" $OpenBSD: vge.4,v 1.18 2009/10/31 12:26:36 sobrado Exp $ 2.\" $FreeBSD: vge.4,v 1.6 2004/11/24 19:06:43 brueffer Exp $ 3.\" 4.\" Copyright (c) 2004 5.\" Bill Paul <wpaul@windriver.com>. All rights reserved. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions 9.\" are met: 10.\" 1. Redistributions of source code must retain the above copyright 11.\" notice, this list of conditions and the following disclaimer. 12.\" 2. Redistributions in binary form must reproduce the above copyright 13.\" notice, this list of conditions and the following disclaimer in the 14.\" documentation and/or other materials provided with the distribution. 15.\" 3. All advertising materials mentioning features or use of this software 16.\" must display the following acknowledgement: 17.\" This product includes software developed by Bill Paul. 18.\" 4. Neither the name of the author nor the names of any co-contributors 19.\" may be used to endorse or promote products derived from this software 20.\" without specific prior written permission. 21.\" 22.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND 23.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 24.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 25.\" ARE DISCLAIMED. IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD 26.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 27.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 28.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 29.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 30.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 31.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF 32.\" THE POSSIBILITY OF SUCH DAMAGE. 33.\" 34.Dd $Mdocdate: October 31 2009 $ 35.Dt VGE 4 36.Os 37.Sh NAME 38.Nm vge 39.Nd VIA VT6122 PCI 10/100/Gigabit Ethernet device 40.Sh SYNOPSIS 41.Cd "vge* at pci?" 42.Cd "ciphy* at mii?" 43.Cd "ipgphy* at mii?" 44.Sh DESCRIPTION 45The 46.Nm 47driver provides support for various NICs and embedded Ethernet interfaces 48based on the VIA Networking Technologies VT6122 Gigabit Ethernet 49controller chips, including the following: 50.Pp 51.Bl -bullet -compact 52.It 53VIA Networking LAN-on-motherboard Gigabit Ethernet 54.It 55ZyXEL GN650-T 64-bit PCI Gigabit Ethernet NIC (ZX1701) 56.It 57ZyXEL GN670-T 32-bit PCI Gigabit Ethernet NIC (ZX1702) 58.El 59.Pp 60The VT6122 is a 33/66MHz 64-bit PCI device which combines a tri-speed 61MAC with an integrated 10/100/1000 copper PHY. 62(Some older cards use an external PHY.) 63The MAC supports IPv4 transmit/receive IP/TCP/UDP checksum offload, 64VLAN tag insertion and stripping, a 64-entry CAM filter and a 64-entry 65VLAN filter, 64-bit multicast hash filter, 4 separate transmit DMA 66queues, flow control and Jumbo frames up to 16K in size. 67The VT6122 has a 16K receive FIFO and 48K transmit FIFO. 68.Pp 69The 70.Nm 71driver takes advantage of the IPv4 transmit/receive IP/TCP/UDP checksum 72offload, VLAN tag insertion and stripping, and the CAM filter support. 73The CAM filter is used for multicast address filtering to provide 7464 perfect multicast address filter support. 75If it is necessary for the interface to join more than 64 multicast 76groups, the driver will switch over to using the hash filter. 77.Pp 78The 79.Nm 80driver supports the following media types: 81.Bl -tag -width 10baseTXUTP 82.It Cm autoselect 83Enable autoselection of the media type and options. 84The user can manually override the autoselected mode by adding media 85options to the appropriate 86.Xr hostname.if 5 87file. 88.It Cm 10baseT/UTP 89Set 10Mbps operation. 90The 91.Xr ifconfig 8 92.Ic mediaopt 93option can also be used to select either 94.Cm full-duplex 95or 96.Cm half-duplex 97modes. 98.It Cm 100baseTX 99Set 100Mbps (Fast Ethernet) operation. 100The 101.Xr ifconfig 8 102.Ic mediaopt 103option can also be used to select either 104.Cm full-duplex 105or 106.Cm half-duplex 107modes. 108.It Cm 1000baseT 109Set 1000baseT operation over twisted pair. 110Both 111.Cm full-duplex 112and 113.Cm half-duplex 114modes are supported. 115.El 116.Pp 117The 118.Nm 119driver supports the following media options: 120.Bl -tag -width full-duplex 121.It Cm full-duplex 122Force full duplex operation. 123.It Cm half-duplex 124Force half duplex operation. 125.El 126.Pp 127For more information on configuring this device, see 128.Xr ifconfig 8 . 129.Sh SEE ALSO 130.Xr arp 4 , 131.Xr ciphy 4 , 132.Xr ifmedia 4 , 133.Xr intro 4 , 134.Xr ipgphy 4 , 135.Xr netintro 4 , 136.Xr pci 4 , 137.Xr hostname.if 5 , 138.Xr ifconfig 8 139.Sh HISTORY 140The 141.Nm 142device driver first appeared in 143.Ox 3.7 . 144.Sh AUTHORS 145.An -nosplit 146The 147.Nm 148driver was written by 149.An Bill Paul Aq wpaul@windriver.com 150and ported to 151.Ox 152by 153.An Peter Valchev Aq pvalchev@openbsd.org . 154