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