1.\" $OpenBSD: sf.4,v 1.8 2000/10/18 02:38:23 aaron 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. This includes the 48following: 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. It 64supports high and low priority transmit and receive queues, TCP/IP 65checksum offload, multiple DMA descriptor formats and both polling 66and producer/consumer DMA models. The AIC-6915 receive filtering 67options include a 16 entry perfect filter, a 512-bit hash table 68for multicast addresses, a 512-bit hash table for priority address 69matching and VLAN filtering. An external MII-compliant transceiver 70is required for media interfacing. 71.Pp 72Multiport adapters consist of several AIC-6915 controllers connected 73via a PCI to PCI bridge. Each controller is treated as a separate 74interface 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/UTP 90Set 10Mbps operation. The 91.Ar mediaopt 92option can also be used to select either 93.Ar full-duplex 94or 95.Ar half-duplex 96modes. 97.It 100baseTX 98Set 100Mbps (Fast Ethernet) operation. The 99.Ar mediaopt 100option can also be used to select either 101.Ar full-duplex 102or 103.Ar half-duplex 104modes. 105.El 106.Pp 107The 108.Nm 109driver supports the following media options: 110.Pp 111.Bl -tag -width xxxxxxxxxxxxxxxxxxxx 112.It full-duplex 113Force full duplex operation 114.It half-duplex 115Force half duplex operation. 116.El 117.Pp 118For more information on configuring this device, see 119.Xr ifconfig 8 . 120.Sh DIAGNOSTICS 121.Bl -diag 122.It "sf%d: couldn't map memory" 123A fatal initialization error has occurred. This may 124happen if the PCI BIOS did not configure the device, which can occur when 125the BIOS has been configured for a "Plug and Play" operating system. 126The "Plug and Play OS" setting in the BIOS should be set to "no" or 127"off" in order for PCI devices to work properly with 128.Ox . 129.It "sf%d: couldn't map ports" 130A fatal initialization error has occurred. This may 131happen if the PCI BIOS did not configure the device, which can occur when 132the BIOS has been configured for a "Plug and Play" operating system. 133The "Plug and Play OS" setting in the BIOS should be set to "no" or 134"off" in order for PCI devices to work properly with 135.Ox . 136.It "sf%d: couldn't map interrupt" 137A fatal initialization error has occurred. 138.It "sf%d: no memory for softc struct!" 139The driver failed to allocate memory for per-device instance information 140during initialization. 141.It "sf%d: failed to enable I/O ports/memory mapping!" 142The driver failed to initialize PCI I/O port or shared memory access. 143This might happen if the card is not in a bus-master slot. 144.It "sf%d: watchdog timeout" 145The device has stopped responding to the network, or there is a problem with 146the network connection (cable). 147.El 148.Sh SEE ALSO 149.Xr arp 4 , 150.Xr netintro 4 , 151.Xr ifconfig 8 152.Rs 153.%T The Adaptec AIC-6915 Programmer's Manual 154.%O ftp://ftp.adaptec.com/pub/BBS/userguides/aic6915_pg.pdf 155.Re 156.Sh HISTORY 157The 158.Nm 159device driver first appeared in 160.Ox 2.7 . 161.Sh AUTHORS 162The 163.Nm 164driver was written by 165.An Bill Paul Aq wpaul@ctr.columbia.edu . 166