1.\" Copyright (c) 1997, 1998, 1999 2.\" Bill Paul <wpaul@ctr.columbia.edu>. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. 9.\" 2. Redistributions in binary form must reproduce the above copyright 10.\" notice, this list of conditions and the following disclaimer in the 11.\" documentation and/or other materials provided with the distribution. 12.\" 3. All advertising materials mentioning features or use of this software 13.\" must display the following acknowledgement: 14.\" This product includes software developed by Bill Paul. 15.\" 4. Neither the name of the author nor the names of any co-contributors 16.\" may be used to endorse or promote products derived from this software 17.\" without specific prior written permission. 18.\" 19.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND 20.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 21.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 22.\" ARE DISCLAIMED. IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD 23.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 24.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 25.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 26.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 27.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 28.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF 29.\" THE POSSIBILITY OF SUCH DAMAGE. 30.\" 31.\" $FreeBSD: src/share/man/man4/sk.4,v 1.8.2.6 2001/08/17 13:08:39 ru Exp $ 32.\" $DragonFly: src/share/man/man4/sk.4,v 1.8 2008/05/02 02:05:05 swildner Exp $ 33.\" 34.Dd November 2, 2006 35.Dt SK 4 36.Os 37.Sh NAME 38.Nm sk 39.Nd "SysKonnect XMAC II and Marvell Yukon based Gigabit Ethernet device" 40.Sh SYNOPSIS 41.Cd "device miibus" 42.Cd "device sk" 43.Pp 44Alternatively, to load the driver as a module at boot time, place the 45following line in 46.Pa /boot/loader.conf : 47.Bd -literal -offset indent 48if_sk_load="YES" 49.Ed 50.Sh DESCRIPTION 51The 52.Nm 53driver provides support for SysKonnect based Gigabit Ethernet adapters and 54Marvell based Gigabit Ethernet adapters. 55.Pp 56The SysKonnect based adapters consist of two main components: 57the XaQti Corp. XMAC II gigabit MAC and 58the SysKonnect GEnesis controller ASIC. 59The XMAC provides the gigabit MAC and PHY support 60while the GEnesis provides an interface to the PCI bus, 61DMA support, packet buffering and arbitration. 62The GEnesis can control up to two XMACs simultaneously, 63allowing dual-port NIC configurations. 64.Pp 65The Marvell based adapters are a single integrated circuit, 66but are still presented as a separate MAC and controller ASIC. 67.Pp 68The 69.Nm 70driver configures dual port SysKonnect adapters such that each XMAC 71is treated as a separate logical network interface. 72Both ports can 73operate independently of each other and can be connected to separate 74networks. 75The SysKonnect driver software currently only uses the 76second port on dual port adapters for failover purposes: if the link 77on the primary port fails, the SysKonnect driver will automatically 78switch traffic onto the second port. 79.Pp 80The XaQti XMAC II supports full and half duplex operation with 81autonegotiation. 82The XMAC also supports unlimited frame sizes. 83Support for jumbo frames is provided via the interface 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 xxxxxxxxxxxxxxxxxxxx 94.It autoselect 95Enable autoselection of the media type and options. 96The user can manually override 97the autoselected mode by adding media options to the 98.Pa /etc/rc.conf 99file. 100.It 1000baseT 101Set 1000baseT operation over twisted pair. 102This is only available 103for SK-982x series adapters with 1000baseT ports. 104Both 105.Ar full-duplex 106and 107.Ar half-duplex 108modes are supported. 109.It 1000baseSX 110Set 1000Mbps (gigabit ethernet) operation. 111Both 112.Ar full-duplex 113and 114.Ar half-duplex 115modes are supported. 116.El 117.Pp 118The 119.Nm 120driver supports the following media options: 121.Bl -tag -width xxxxxxxxxxxxxxxxxxxx 122.It full-duplex 123Force full duplex operation 124.It half-duplex 125Force half duplex operation. 126.El 127.Pp 128The 129.Nm 130driver also supports one special link option for 1000baseT cards: 131.Bl -tag -width xxxxxxxxxxxxxxxxxxxx 132.It link0 133With 1000baseT cards, establishing a link between two ports requires 134that one port be configured as a master and the other a slave. 135With autonegotiation, 136the master/slave settings will be chosen automatically. 137However when manually selecting the link state, it is necessary to 138force one side of the link to be a master and the other a slave. 139The 140.Nm 141driver configures the ports as slaves by default. 142Setting the 143.Ar link0 144flag with 145.Xr ifconfig 8 146will set a port as a master instead. 147.El 148.Pp 149For more information on configuring this device, see 150.Xr ifconfig 8 . 151.Sh HARDWARE 152The 153.Nm 154driver supports SysKonnect based Gigabit Ethernet adapters and 155Marvell based Gigabit Ethernet adapters, including the following: 156.Pp 157.Bl -bullet -compact 158.It 1593Com 3c940 single port, copper adapter 160.It 1613Com 3c2000-T single port, copper adapter 162.It 163Belkin F5D5005, copper adapter 164.It 165D-Link DGE-530T, copper adapter 166.It 167Linksys EG1032v2, copper adapter 168.It 169Linksys EG1064v2, copper adapter 170.It 171SK-9821 SK-NET GE-T single port, copper adapter 172.It 173SK-9822 SK-NET GE-T dual port, copper adapter 174.It 175SK-9841 SK-NET GE-LX single port, single mode fiber adapter 176.It 177SK-9842 SK-NET GE-LX dual port, single mode fiber adapter 178.It 179SK-9843 SK-NET GE-SX single port, multimode fiber adapter 180.It 181SK-9844 SK-NET GE-SX dual port, multimode fiber adapter 182.It 183SK-9521 V2.0 single port, copper adapter (32-bit) 184.It 185SK-9821 V2.0 single port, copper adapter 186.It 187SK-9843 V2.0 single port, copper adapter 188.It 189SMC 9452TX, copper adapter 190.El 191.Sh DIAGNOSTICS 192.Bl -diag 193.It "skc%d: couldn't map memory" 194A fatal initialization error has occurred. 195.It "skc%d: couldn't map interrupt" 196A fatal initialization error has occurred. 197.It "sk%d: jumbo buffer allocation failed" 198The driver failed to allocate memory for jumbo frames 199during initialization. 200.It "sk%d: watchdog timeout" 201The device has stopped responding to the network, or there is a problem with 202the network connection (cable). 203.El 204.Sh SEE ALSO 205.Xr arp 4 , 206.Xr ifmedia 4 , 207.Xr miibus 4 , 208.Xr netintro 4 , 209.Xr ng_ether 4 , 210.Xr vlan 4 , 211.Xr ifconfig 8 212.Rs 213.%T XaQti XMAC II datasheet 214.%O http://www.xaqti.com 215.Re 216.Rs 217.%T SysKonnect GEnesis programming manual 218.%O http://www.syskonnect.com 219.Re 220.Sh HISTORY 221The 222.Nm 223device driver first appeared in 224.Fx 3.0 . 225.Sh AUTHORS 226The 227.Nm 228driver was written by 229.An Bill Paul Aq wpaul@ctr.columbia.edu . 230