1.\" $OpenBSD: sf.4,v 1.26 2022/02/18 10:24:32 jsg 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.\" $NetBSD: sf.4,v 1.5 2003/03/31 12:34:49 bjh21 Exp $ 36.\" 37.\" Copyright (c) 2001 The NetBSD Foundation, Inc. 38.\" All rights reserved. 39.\" 40.\" This code is derived from software contributed to The NetBSD Foundation 41.\" by Jason R. Thorpe. 42.\" 43.\" Redistribution and use in source and binary forms, with or without 44.\" modification, are permitted provided that the following conditions 45.\" are met: 46.\" 1. Redistributions of source code must retain the above copyright 47.\" notice, this list of conditions and the following disclaimer. 48.\" 2. Redistributions in binary form must reproduce the above copyright 49.\" notice, this list of conditions and the following disclaimer in the 50.\" documentation and/or other materials provided with the distribution. 51.\" 52.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 53.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 54.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 55.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 56.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 57.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 58.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 59.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 60.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 61.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 62.\" POSSIBILITY OF SUCH DAMAGE. 63.\" 64.Dd $Mdocdate: February 18 2022 $ 65.Dt SF 4 66.Os 67.Sh NAME 68.Nm sf 69.Nd Adaptec AIC-6915 "Starfire" PCI 10/100 Ethernet device 70.Sh SYNOPSIS 71.Cd "sf* at pci?" 72.Cd "sqphy* at mii?" 73.Sh DESCRIPTION 74The 75.Nm 76driver provides support for Adaptec Duralink Fast Ethernet adapters 77based on the Adaptec AIC-6915 "Starfire" chipset. 78This includes the following: 79.Pp 80.Bl -bullet -offset indent -compact 81.It 82ANA-62011 64-bit single port 10/100baseTX 83.It 84ANA-62022 64-bit dual port 10/100baseTX 85.It 86ANA-62044 64-bit quad port 10/100baseTX 87.It 88ANA-69011 32-bit single port 10/100baseTX 89.It 90ANA-62020 64-bit single port 100baseFX 91.El 92.Pp 93The AIC-6915 is a bus master controller with an MII interface. 94It supports high and low priority transmit and receive queues, TCP/IP 95checksum offload, multiple DMA descriptor formats and both polling 96and producer/consumer DMA models. 97The AIC-6915 receive filtering options include a 16 entry perfect 98filter, a 512-bit hash table for multicast addresses, a 512-bit hash 99table for priority address matching and VLAN filtering. 100An external MII-compliant transceiver is required for media interfacing. 101.Pp 102Multiport adapters consist of several AIC-6915 controllers connected 103via a PCI to PCI bridge. 104Each controller is treated as a separate interface by the 105.Nm 106driver. 107.Pp 108The 109.Nm 110driver supports the following media types: 111.Bl -tag -width full-duplex 112.It autoselect 113Enable autoselection of the media type and options. 114The user can manually override 115the autoselected mode by adding media options to the 116.Xr hostname.if 5 117file. 118.It 10baseT 119Set 10Mbps operation. 120The 121.Ar mediaopt 122option can also be used to select either 123.Ar full-duplex 124or 125.Ar half-duplex 126modes. 127.It 100baseTX 128Set 100Mbps (Fast Ethernet) operation. 129The 130.Ar mediaopt 131option can also be used to select either 132.Ar full-duplex 133or 134.Ar half-duplex 135modes. 136.El 137.Pp 138The 139.Nm 140driver supports the following media options: 141.Bl -tag -width full-duplex 142.It full-duplex 143Force full duplex operation. 144.It half-duplex 145Force half duplex operation. 146.El 147.Pp 148For more information on configuring this device, see 149.Xr ifconfig 8 . 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 sqphy 4 , 157.Xr hostname.if 5 , 158.Xr ifconfig 8 159.Rs 160.%T The Adaptec AIC-6915 Programmer's Manual 161.%U https://download.adaptec.com/pdfs/user_guides/aic6915_pg.pdf 162.Re 163.Sh HISTORY 164The 165.Nm 166device driver first appeared in 167.Ox 2.7 . 168.Sh AUTHORS 169.An -nosplit 170The 171.Nm 172driver was written by 173.An Jason R. Thorpe Aq Mt thorpej@NetBSD.org 174and ported to 175.Ox 176by 177.An Martin Reindl Aq Mt martin@openbsd.org . 178.Sh BUGS 179The 180.Nm 181driver does not support the IPv4/TCP/UDP checksum function of the AIC-6915. 182.Pp 183The 184.Nm 185driver does not support the VLAN function of the AIC-6915. 186