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