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