1.\" $OpenBSD: sf.4,v 1.12 2003/04/07 16:03:32 jmc Exp $ 2.\" 3.\" Copyright (c) 1997, 1998, 1999 4.\" Bill Paul <wpaul@ctr.columbia.edu>. 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/man4.i386/sf.4,v 1.4 1999/09/26 18:35:30 wpaul Exp $ 34.\" 35.Dd July 22, 1999 36.Dt SF 4 37.Os 38.Sh NAME 39.Nm sf 40.Nd Adaptec AIC-6915 "Starfire" PCI Fast Ethernet driver 41.Sh SYNOPSIS 42.Cd "sf* at pci? dev ? function ?" 43.Sh DESCRIPTION 44The 45.Nm 46driver provides support for Adaptec Duralink Fast Ethernet adapters 47based on the Adaptec AIC-6915 "Starfire" chipset. 48This includes the following: 49.Pp 50.Bl -bullet -offset indent -compact 51.It 52ANA-62011 64-bit single port 10/100baseTX 53.It 54ANA-62022 64-bit dual port 10/100baseTX 55.It 56ANA-62044 64-bit quad port 10/100baseTX 57.It 58ANA-69011 32-bit single port 10/100baseTX 59.It 60ANA-62020 64-bit single port 100baseFX 61.El 62.Pp 63The AIC-6915 is a bus master controller with an MII interface. 64It supports high and low priority transmit and receive queues, TCP/IP 65checksum offload, multiple DMA descriptor formats and both polling 66and producer/consumer DMA models. 67The AIC-6915 receive filtering options include a 16 entry perfect 68filter, a 512-bit hash table for multicast addresses, a 512-bit hash 69table for priority address matching and VLAN filtering. 70An external MII-compliant transceiver is required for media interfacing. 71.Pp 72Multiport adapters consist of several AIC-6915 controllers connected 73via a PCI to PCI bridge. 74Each controller is treated as a separate interface by the 75.Nm 76driver. 77.Pp 78The 79.Nm 80driver supports the following media types: 81.Pp 82.Bl -tag -width xxxxxxxxxxxxxxxxxxxx 83.It autoselect 84Enable autoselection of the media type and options. 85The user can manually override 86the autoselected mode by adding media options to the 87.Xr hostname.if 5 88file. 89.It 10baseT 90Set 10Mbps operation. 91The 92.Ar mediaopt 93option can also be used to select either 94.Ar full-duplex 95or 96.Ar half-duplex 97modes. 98.It 100baseTX 99Set 100Mbps (Fast Ethernet) operation. 100The 101.Ar mediaopt 102option can also be used to select either 103.Ar full-duplex 104or 105.Ar half-duplex 106modes. 107.El 108.Pp 109The 110.Nm 111driver supports the following media options: 112.Pp 113.Bl -tag -width xxxxxxxxxxxxxxxxxxxx 114.It full-duplex 115Force full duplex operation. 116.It half-duplex 117Force half duplex operation. 118.El 119.Pp 120For more information on configuring this device, see 121.Xr ifconfig 8 . 122.Sh DIAGNOSTICS 123.Bl -diag 124.It "sf%d: couldn't map memory" 125A fatal initialization error has occurred. 126This may happen if the PCI BIOS did not configure the device, which can occur 127when the BIOS has been configured for a "Plug and Play" operating system. 128The "Plug and Play OS" setting in the BIOS should be set to "no" or 129"off" in order for PCI devices to work properly with 130.Ox . 131.It "sf%d: couldn't map ports" 132A fatal initialization error has occurred. 133This may happen if the PCI BIOS did not configure the device, which can occur 134when the BIOS has been configured for a "Plug and Play" operating system. 135The "Plug and Play OS" setting in the BIOS should be set to "no" or 136"off" in order for PCI devices to work properly with 137.Ox . 138.It "sf%d: couldn't map interrupt" 139A fatal initialization error has occurred. 140.It "sf%d: no memory for softc struct!" 141The driver failed to allocate memory for per-device instance information 142during initialization. 143.It "sf%d: failed to enable I/O ports/memory mapping!" 144The driver failed to initialize PCI I/O port or shared memory access. 145This might happen if the card is not in a bus-master slot. 146.It "sf%d: watchdog timeout" 147The device has stopped responding to the network, or there is a problem with 148the network connection (cable). 149.El 150.Sh SEE ALSO 151.Xr arp 4 , 152.Xr ifmedia 4 , 153.Xr intro 4 , 154.Xr netintro 4 , 155.Xr pci 4 , 156.Xr hostname.if 5 , 157.Xr ifconfig 8 158.Rs 159.%T The Adaptec AIC-6915 Programmer's Manual 160.%O ftp://ftp.adaptec.com/pub/BBS/userguides/aic6915_pg.pdf 161.Re 162.Sh HISTORY 163The 164.Nm 165device driver first appeared in 166.Ox 2.7 . 167.Sh AUTHORS 168The 169.Nm 170driver was written by 171.An Bill Paul Aq wpaul@ctr.columbia.edu . 172