| @@ -1,300 +1,300 @@ | | | @@ -1,300 +1,300 @@ |
1 | .\" $NetBSD: sk.4,v 1.24 2020/04/23 15:54:36 jdolecek Exp $ | | 1 | .\" $NetBSD: sk.4,v 1.25 2020/04/23 15:55:14 jdolecek Exp $ |
2 | .\" | | 2 | .\" |
3 | .\" Copyright (c) 2003, The NetBSD Foundation, Inc. | | 3 | .\" Copyright (c) 2003, The NetBSD Foundation, Inc. |
4 | .\" All rights reserved. | | 4 | .\" All rights reserved. |
5 | .\" | | 5 | .\" |
6 | .\" Redistribution and use in source and binary forms, with or without | | 6 | .\" Redistribution and use in source and binary forms, with or without |
7 | .\" modification, are permitted provided that the following conditions | | 7 | .\" modification, are permitted provided that the following conditions |
8 | .\" are met: | | 8 | .\" are met: |
9 | .\" 1. Redistributions of source code must retain the above copyright | | 9 | .\" 1. Redistributions of source code must retain the above copyright |
10 | .\" notice, this list of conditions and the following disclaimer. | | 10 | .\" notice, this list of conditions and the following disclaimer. |
11 | .\" 2. Redistributions in binary form must reproduce the above copyright | | 11 | .\" 2. Redistributions in binary form must reproduce the above copyright |
12 | .\" notice, this list of conditions and the following disclaimer in the | | 12 | .\" notice, this list of conditions and the following disclaimer in the |
13 | .\" documentation and/or other materials provided with the distribution. | | 13 | .\" documentation and/or other materials provided with the distribution. |
14 | .\" | | 14 | .\" |
15 | .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS | | 15 | .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS |
16 | .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED | | 16 | .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED |
17 | .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR | | 17 | .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR |
18 | .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS | | 18 | .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS |
19 | .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR | | 19 | .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR |
20 | .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF | | 20 | .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF |
21 | .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS | | 21 | .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS |
22 | .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN | | 22 | .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN |
23 | .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) | | 23 | .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) |
24 | .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE | | 24 | .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE |
25 | .\" POSSIBILITY OF SUCH DAMAGE. | | 25 | .\" POSSIBILITY OF SUCH DAMAGE. |
26 | .\" | | 26 | .\" |
27 | .\" $OpenBSD: sk.4,v 1.41 2006/08/16 22:01:56 kettenis Exp $ | | 27 | .\" $OpenBSD: sk.4,v 1.41 2006/08/16 22:01:56 kettenis Exp $ |
28 | .\" | | 28 | .\" |
29 | .\" Copyright (c) 1997, 1998, 1999 | | 29 | .\" Copyright (c) 1997, 1998, 1999 |
30 | .\" Bill Paul <wpaul@ctr.columbia.edu>. All rights reserved. | | 30 | .\" Bill Paul <wpaul@ctr.columbia.edu>. All rights reserved. |
31 | .\" | | 31 | .\" |
32 | .\" Redistribution and use in source and binary forms, with or without | | 32 | .\" Redistribution and use in source and binary forms, with or without |
33 | .\" modification, are permitted provided that the following conditions | | 33 | .\" modification, are permitted provided that the following conditions |
34 | .\" are met: | | 34 | .\" are met: |
35 | .\" 1. Redistributions of source code must retain the above copyright | | 35 | .\" 1. Redistributions of source code must retain the above copyright |
36 | .\" notice, this list of conditions and the following disclaimer. | | 36 | .\" notice, this list of conditions and the following disclaimer. |
37 | .\" 2. Redistributions in binary form must reproduce the above copyright | | 37 | .\" 2. Redistributions in binary form must reproduce the above copyright |
38 | .\" notice, this list of conditions and the following disclaimer in the | | 38 | .\" notice, this list of conditions and the following disclaimer in the |
39 | .\" documentation and/or other materials provided with the distribution. | | 39 | .\" documentation and/or other materials provided with the distribution. |
40 | .\" 3. All advertising materials mentioning features or use of this software | | 40 | .\" 3. All advertising materials mentioning features or use of this software |
41 | .\" must display the following acknowledgement: | | 41 | .\" must display the following acknowledgement: |
42 | .\" This product includes software developed by Bill Paul. | | 42 | .\" This product includes software developed by Bill Paul. |
43 | .\" 4. Neither the name of the author nor the names of any co-contributors | | 43 | .\" 4. Neither the name of the author nor the names of any co-contributors |
44 | .\" may be used to endorse or promote products derived from this software | | 44 | .\" may be used to endorse or promote products derived from this software |
45 | .\" without specific prior written permission. | | 45 | .\" without specific prior written permission. |
46 | .\" | | 46 | .\" |
47 | .\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND | | 47 | .\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND |
48 | .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | | 48 | .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE |
49 | .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | | 49 | .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE |
50 | .\" ARE DISCLAIMED. IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD | | 50 | .\" ARE DISCLAIMED. IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD |
51 | .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR | | 51 | .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR |
52 | .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF | | 52 | .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF |
53 | .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS | | 53 | .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS |
54 | .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN | | 54 | .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN |
55 | .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) | | 55 | .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) |
56 | .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF | | 56 | .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF |
57 | .\" THE POSSIBILITY OF SUCH DAMAGE. | | 57 | .\" THE POSSIBILITY OF SUCH DAMAGE. |
58 | .\" | | 58 | .\" |
59 | .\" $FreeBSD: src/share/man/man4/man4.i386/sk.4,v 1.3 1999/08/28 00:20:29 peter Exp $ | | 59 | .\" $FreeBSD: src/share/man/man4/man4.i386/sk.4,v 1.3 1999/08/28 00:20:29 peter Exp $ |
60 | .\" | | 60 | .\" |
61 | .Dd April 23, 2020 | | 61 | .Dd April 23, 2020 |
62 | .Dt SK 4 | | 62 | .Dt SK 4 |
63 | .Os | | 63 | .Os |
64 | .Sh NAME | | 64 | .Sh NAME |
65 | .Nm sk , | | 65 | .Nm sk , |
66 | .Nm skc , | | 66 | .Nm skc , |
67 | .Nm msk , | | 67 | .Nm msk , |
68 | .Nm mskc | | 68 | .Nm mskc |
69 | .Nd SysKonnect XMAC II and Marvell GMAC based Gigabit Ethernet | | 69 | .Nd SysKonnect XMAC II and Marvell GMAC based Gigabit Ethernet |
70 | .Sh SYNOPSIS | | 70 | .Sh SYNOPSIS |
71 | .Cd "skc* at pci? dev ? function ?" | | 71 | .Cd "skc* at pci? dev ? function ?" |
72 | .Cd "sk* at skc?" | | 72 | .Cd "sk* at skc?" |
73 | .Cd "mskc* at pci? dev ? function ?" | | 73 | .Cd "mskc* at pci? dev ? function ?" |
74 | .Cd "msk* at mskc?" | | 74 | .Cd "msk* at mskc?" |
75 | .Sh DESCRIPTION | | 75 | .Sh DESCRIPTION |
76 | The | | 76 | The |
77 | .Nm sk | | 77 | .Nm sk |
78 | driver provides support for SysKonnect based Gigabit Ethernet adapters | | 78 | driver provides support for SysKonnect based Gigabit Ethernet adapters |
79 | and Marvell based Gigabit Ethernet adapters, including the following: | | 79 | and Marvell based Gigabit Ethernet adapters, including the following: |
80 | .Pp | | 80 | .Pp |
81 | .Bl -bullet -offset indent -compact | | 81 | .Bl -bullet -offset indent -compact |
82 | .It | | 82 | .It |
83 | SK-9821 SK-NET GE-T single port, copper adapter | | 83 | SK-9821 SK-NET GE-T single port, copper adapter |
84 | .It | | 84 | .It |
85 | SK-9822 SK-NET GE-T dual port, copper adapter | | 85 | SK-9822 SK-NET GE-T dual port, copper adapter |
86 | .It | | 86 | .It |
87 | SK-9841 SK-NET GE-LX single port, single mode fiber adapter | | 87 | SK-9841 SK-NET GE-LX single port, single mode fiber adapter |
88 | .It | | 88 | .It |
89 | SK-9842 SK-NET GE-LX dual port, single mode fiber adapter | | 89 | SK-9842 SK-NET GE-LX dual port, single mode fiber adapter |
90 | .It | | 90 | .It |
91 | SK-9843 SK-NET GE-SX single port, multimode fiber adapter | | 91 | SK-9843 SK-NET GE-SX single port, multimode fiber adapter |
92 | .It | | 92 | .It |
93 | SK-9844 SK-NET GE-SX dual port, multimode fiber adapter | | 93 | SK-9844 SK-NET GE-SX dual port, multimode fiber adapter |
94 | .It | | 94 | .It |
95 | SK-9521 V2.0 single port, copper adapter (32-bit) | | 95 | SK-9521 V2.0 single port, copper adapter (32-bit) |
96 | .It | | 96 | .It |
97 | SK-9821 V2.0 single port, copper adapter | | 97 | SK-9821 V2.0 single port, copper adapter |
98 | .It | | 98 | .It |
99 | SK-9843 V2.0 single port, copper adapter | | 99 | SK-9843 V2.0 single port, copper adapter |
100 | .It | | 100 | .It |
101 | 3Com 3c940 single port, copper adapter | | 101 | 3Com 3c940 single port, copper adapter |
102 | .It | | 102 | .It |
103 | Belkin Gigabit Desktop Network PCI Card, single port, copper (32-bit) | | 103 | Belkin Gigabit Desktop Network PCI Card, single port, copper (32-bit) |
104 | .It | | 104 | .It |
105 | D-Link DGE-530T single port, copper adapter | | 105 | D-Link DGE-530T single port, copper adapter |
106 | .It | | 106 | .It |
107 | Linksys EG1032v2 single-port, copper adapter | | 107 | Linksys EG1032v2 single-port, copper adapter |
108 | .It | | 108 | .It |
109 | Linksys EG1064v2 single-port, copper adapter | | 109 | Linksys EG1064v2 single-port, copper adapter |
110 | .El | | 110 | .El |
111 | .Pp | | 111 | .Pp |
112 | The | | 112 | The |
113 | .Nm msk | | 113 | .Nm msk |
114 | driver provides support for the Marvell Yukon-2 based Gigabit Ethernet | | 114 | driver provides support for the Marvell Yukon-2 based Gigabit Ethernet |
115 | adapters, including the following: | | 115 | adapters, including the following: |
116 | .Pp | | 116 | .Pp |
117 | .Bl -bullet -offset indent -compact | | 117 | .Bl -bullet -offset indent -compact |
118 | .It | | 118 | .It |
119 | Marvell Yukon 88E8035, copper adapter | | 119 | Marvell Yukon 88E8035, copper adapter |
120 | .It | | 120 | .It |
121 | Marvell Yukon 88E8036, copper adapter | | 121 | Marvell Yukon 88E8036, copper adapter |
122 | .It | | 122 | .It |
123 | Marvell Yukon 88E8038, copper adapter | | 123 | Marvell Yukon 88E8038, copper adapter |
124 | .It | | 124 | .It |
125 | Marvell Yukon 88E8050, copper adapter | | 125 | Marvell Yukon 88E8050, copper adapter |
126 | .It | | 126 | .It |
127 | Marvell Yukon 88E8052, copper adapter | | 127 | Marvell Yukon 88E8052, copper adapter |
128 | .It | | 128 | .It |
129 | Marvell Yukon 88E8053, copper adapter | | 129 | Marvell Yukon 88E8053, copper adapter |
130 | .It | | 130 | .It |
131 | Marvell Yukon 88E8055, copper adapter | | 131 | Marvell Yukon 88E8055, copper adapter |
132 | .It | | 132 | .It |
133 | SK-9E21 1000Base-T single port, copper adapter | | 133 | SK-9E21 1000Base-T single port, copper adapter |
134 | .It | | 134 | .It |
135 | SK-9E22 1000Base-T dual port, copper adapter | | 135 | SK-9E22 1000Base-T dual port, copper adapter |
136 | .It | | 136 | .It |
137 | SK-9E81 1000Base-SX single port, multimode fiber adapter | | 137 | SK-9E81 1000Base-SX single port, multimode fiber adapter |
138 | .It | | 138 | .It |
139 | SK-9E82 1000Base-SX dual port, multimode fiber adapter | | 139 | SK-9E82 1000Base-SX dual port, multimode fiber adapter |
140 | .It | | 140 | .It |
141 | SK-9E91 1000Base-LX single port, single mode fiber adapter | | 141 | SK-9E91 1000Base-LX single port, single mode fiber adapter |
142 | .It | | 142 | .It |
143 | SK-9E92 1000Base-LX dual port, single mode fiber adapter | | 143 | SK-9E92 1000Base-LX dual port, single mode fiber adapter |
144 | .It | | 144 | .It |
145 | SK-9S21 1000Base-T single port, copper adapter | | 145 | SK-9S21 1000Base-T single port, copper adapter |
146 | .It | | 146 | .It |
147 | SK-9S22 1000Base-T dual port, copper adapter | | 147 | SK-9S22 1000Base-T dual port, copper adapter |
148 | .It | | 148 | .It |
149 | SK-9S81 1000Base-SX single port, multimode fiber adapter | | 149 | SK-9S81 1000Base-SX single port, multimode fiber adapter |
150 | .It | | 150 | .It |
151 | SK-9S82 1000Base-SX dual port, multimode fiber adapter | | 151 | SK-9S82 1000Base-SX dual port, multimode fiber adapter |
152 | .It | | 152 | .It |
153 | SK-9S91 1000Base-LX single port, single mode fiber adapter | | 153 | SK-9S91 1000Base-LX single port, single mode fiber adapter |
154 | .It | | 154 | .It |
155 | SK-9S92 1000Base-LX dual port, single mode fiber adapter | | 155 | SK-9S92 1000Base-LX dual port, single mode fiber adapter |
156 | .It | | 156 | .It |
157 | SK-9E21D 1000Base-T single port, copper adapter | | 157 | SK-9E21D 1000Base-T single port, copper adapter |
158 | .El | | 158 | .El |
159 | .Pp | | 159 | .Pp |
160 | The SysKonnect based adapters consist of two main components: the | | 160 | The SysKonnect based adapters consist of two main components: the |
161 | XaQti Corp. XMAC II Gigabit MAC | | 161 | XaQti Corp. XMAC II Gigabit MAC |
162 | .Pq Nm sk | | 162 | .Pq Nm sk |
163 | and the SysKonnect GEnesis controller ASIC | | 163 | and the SysKonnect GEnesis controller ASIC |
164 | .Pq Nm skc . | | 164 | .Pq Nm skc . |
165 | The XMAC provides the Gigabit MAC and PHY support | | 165 | The XMAC provides the Gigabit MAC and PHY support |
166 | while the GEnesis provides an interface to the PCI bus, DMA support, | | 166 | while the GEnesis provides an interface to the PCI bus, DMA support, |
167 | packet buffering and arbitration. | | 167 | packet buffering and arbitration. |
168 | The GEnesis can control up to two XMACs simultaneously, | | 168 | The GEnesis can control up to two XMACs simultaneously, |
169 | allowing dual-port NIC configurations. | | 169 | allowing dual-port NIC configurations. |
170 | .Pp | | 170 | .Pp |
171 | The Marvell based adapters are a single integrated circuit, but are | | 171 | The Marvell based adapters are a single integrated circuit, but are |
172 | still presented as a separate MAC | | 172 | still presented as a separate MAC |
173 | .Pq Nm sk | | 173 | .Pq Nm sk |
174 | and controller ASIC | | 174 | and controller ASIC |
175 | .Pq Nm skc . | | 175 | .Pq Nm skc . |
176 | At this time, there are no dual-port Marvell based NICs. | | 176 | At this time, there are no dual-port Marvell based NICs. |
177 | .Pp | | 177 | .Pp |
178 | The | | 178 | The |
179 | .Nm | | 179 | .Nm |
180 | driver configures dual port SysKonnect adapters such that each XMAC | | 180 | driver configures dual port SysKonnect adapters such that each XMAC |
181 | is treated as a separate logical network interface. | | 181 | is treated as a separate logical network interface. |
182 | Both ports can operate independently of each other and can be connected | | 182 | Both ports can operate independently of each other and can be connected |
183 | to separate networks. | | 183 | to separate networks. |
184 | The SysKonnect driver software currently only uses the second port on | | 184 | The SysKonnect driver software currently only uses the second port on |
185 | dual port adapters for failover purposes: if the link | | 185 | dual port adapters for failover purposes: if the link |
186 | on the primary port fails, the SysKonnect driver will automatically | | 186 | on the primary port fails, the SysKonnect driver will automatically |
187 | switch traffic onto the second port. | | 187 | switch traffic onto the second port. |
188 | .Pp | | 188 | .Pp |
189 | The XaQti XMAC II supports full and half duplex operation with | | 189 | The XaQti XMAC II supports full and half duplex operation with |
190 | autonegotiation. | | 190 | autonegotiation. |
191 | The XMAC also supports unlimited frame sizes. | | 191 | The XMAC also supports unlimited frame sizes. |
192 | Support for jumbo frames is provided via the interface MTU setting. | | 192 | Support for jumbo frames is provided via the interface MTU setting. |
193 | Selecting an MTU larger than 1500 bytes with the | | 193 | Selecting an MTU larger than 1500 bytes with the |
194 | .Xr ifconfig 8 | | 194 | .Xr ifconfig 8 |
195 | utility configures the adapter to receive and transmit jumbo frames. | | 195 | utility configures the adapter to receive and transmit jumbo frames. |
196 | Using jumbo frames can greatly improve performance for certain tasks, | | 196 | Using jumbo frames can greatly improve performance for certain tasks, |
197 | such as file transfers and data streaming. | | 197 | such as file transfers and data streaming. |
198 | .Pp | | 198 | .Pp |
199 | Hardware TCP/IP checksum offloading for IPv4 is available but not | | 199 | Hardware TCP/IP checksum offloading for IPv4 is available but not |
200 | supported by the driver. | | 200 | supported by the driver. |
201 | .Pp | | 201 | .Pp |
202 | The following media types and options (as given to | | 202 | The following media types and options (as given to |
203 | .Xr ifconfig 8 ) | | 203 | .Xr ifconfig 8 ) |
204 | are supported: | | 204 | are supported: |
205 | .Bl -tag -width xxx -offset indent | | 205 | .Bl -tag -width xxx -offset indent |
206 | .It Cm media No autoselect | | 206 | .It Cm media No autoselect |
207 | Enable autoselection of the media type and options. | | 207 | Enable autoselection of the media type and options. |
208 | The user can manually override | | 208 | The user can manually override |
209 | the autoselected mode. | | 209 | the autoselected mode. |
210 | .\" by adding media options to the appropriate | | 210 | .\" by adding media options to the appropriate |
211 | .Xr ifconfig.if 5 | | 211 | .Xr ifconfig.if 5 |
212 | .\" file. | | 212 | .\" file. |
213 | .It Cm media No 1000baseSX Cm mediaopt No full-duplex | | 213 | .It Cm media No 1000baseSX Cm mediaopt No full-duplex |
214 | Set 1000Mbps (Gigabit Ethernet) operation on fiber and force full-duplex mode. | | 214 | Set 1000Mbps (Gigabit Ethernet) operation on fiber and force full-duplex mode. |
215 | .It Cm media No 1000baseSX Cm mediaopt No half-duplex | | 215 | .It Cm media No 1000baseSX Cm mediaopt No half-duplex |
216 | Set 1000Mbps (Gigabit Ethernet) operation on fiber and force half-duplex mode. | | 216 | Set 1000Mbps (Gigabit Ethernet) operation on fiber and force half-duplex mode. |
217 | .It Cm media No 1000baseT Cm mediaopt No full-duplex | | 217 | .It Cm media No 1000baseT Cm mediaopt No full-duplex |
218 | Set 1000Mbps (Gigabit Ethernet) operation and force full-duplex mode. | | 218 | Set 1000Mbps (Gigabit Ethernet) operation and force full-duplex mode. |
219 | .El | | 219 | .El |
220 | .Pp | | 220 | .Pp |
221 | For more information on configuring this device, see | | 221 | For more information on configuring this device, see |
222 | .Xr ifconfig 8 . | | 222 | .Xr ifconfig 8 . |
223 | To view a list of media types and options supported by the card, try | | 223 | To view a list of media types and options supported by the card, try |
224 | .Ic ifconfig Fl m Aq Mt device . | | 224 | .Ic ifconfig Fl m Aq Mt device . |
225 | For example, | | 225 | For example, |
226 | .Ic ifconfig Fl m Ar sk0 . | | 226 | .Ic ifconfig Fl m Ar sk0 . |
227 | .Sh DIAGNOSTICS | | 227 | .Sh DIAGNOSTICS |
228 | .Bl -diag | | 228 | .Bl -diag |
229 | .It "sk%d: couldn't map memory" | | 229 | .It "sk%d: couldn't map memory" |
230 | A fatal initialization error has occurred. | | 230 | A fatal initialization error has occurred. |
231 | .It "sk%d: couldn't map ports" | | 231 | .It "sk%d: couldn't map ports" |
232 | A fatal initialization error has occurred. | | 232 | A fatal initialization error has occurred. |
233 | .It "sk%d: couldn't map interrupt" | | 233 | .It "sk%d: couldn't map interrupt" |
234 | A fatal initialization error has occurred. | | 234 | A fatal initialization error has occurred. |
235 | .It "sk%d: failed to enable memory mapping!" | | 235 | .It "sk%d: failed to enable memory mapping!" |
236 | The driver failed to initialize PCI shared memory mapping. | | 236 | The driver failed to initialize PCI shared memory mapping. |
237 | This might happen if the card is not in a bus-master slot. | | 237 | This might happen if the card is not in a bus-master slot. |
238 | .It "sk%d: no memory for jumbo buffers!" | | 238 | .It "sk%d: no memory for jumbo buffers!" |
239 | The driver failed to allocate memory for jumbo frames during | | 239 | The driver failed to allocate memory for jumbo frames during |
240 | initialization. | | 240 | initialization. |
241 | .It "sk%d: watchdog timeout" | | 241 | .It "sk%d: watchdog timeout" |
242 | The device has stopped responding to the network, or there is a problem with | | 242 | The device has stopped responding to the network, or there is a problem with |
243 | the network connection (cable). | | 243 | the network connection (cable). |
244 | .El | | 244 | .El |
245 | .Sh SEE ALSO | | 245 | .Sh SEE ALSO |
246 | .Xr ifmedia 4 , | | 246 | .Xr ifmedia 4 , |
247 | .Xr intro 4 , | | 247 | .Xr intro 4 , |
248 | .Xr netintro 4 , | | 248 | .Xr netintro 4 , |
249 | .Xr pci 4 , | | 249 | .Xr pci 4 , |
250 | .Xr ifconfig.if 5 , | | 250 | .Xr ifconfig.if 5 , |
251 | .Xr ifconfig 8 | | 251 | .Xr ifconfig 8 |
252 | .Rs | | 252 | .Rs |
253 | .%T XaQti XMAC II datasheet | | 253 | .%T XaQti XMAC II datasheet |
254 | .%U http://www.xaqti.com | | 254 | .%U http://www.xaqti.com |
255 | .Re | | 255 | .Re |
256 | .Rs | | 256 | .Rs |
257 | .%T SysKonnect GEnesis programming manual | | 257 | .%T SysKonnect GEnesis programming manual |
258 | .%U http://www.syskonnect.com | | 258 | .%U http://www.syskonnect.com |
259 | .Re | | 259 | .Re |
260 | .Sh HISTORY | | 260 | .Sh HISTORY |
261 | The | | 261 | The |
262 | .Nm | | 262 | .Nm |
263 | device driver first appeared in | | 263 | device driver first appeared in |
264 | .Fx 3.0 . | | 264 | .Fx 3.0 . |
265 | .Ox | | 265 | .Ox |
266 | support was added in | | 266 | support was added in |
267 | .Ox 2.6 . | | 267 | .Ox 2.6 . |
268 | .Nx | | 268 | .Nx |
269 | support was added in | | 269 | support was added in |
270 | .Nx 2.0 . | | 270 | .Nx 2.0 . |
271 | .Pp | | 271 | .Pp |
272 | The | | 272 | The |
273 | .Nm msk | | 273 | .Nm msk |
274 | driver first appeared in | | 274 | driver first appeared in |
275 | .Ox 4.0 , | | 275 | .Ox 4.0 , |
276 | and was ported to | | 276 | and was ported to |
277 | .Nx 4.0 . | | 277 | .Nx 4.0 . |
278 | .Sh AUTHORS | | 278 | .Sh AUTHORS |
279 | .An -nosplit | | 279 | .An -nosplit |
280 | The | | 280 | The |
281 | .Nm | | 281 | .Nm |
282 | driver was written by | | 282 | driver was written by |
283 | .An Bill Paul Aq Mt wpaul@ctr.columbia.edu . | | 283 | .An Bill Paul Aq Mt wpaul@ctr.columbia.edu . |
284 | Support for the Marvell Yukon-2 was added by | | 284 | Support for the Marvell Yukon-2 was added by |
285 | .An Mark Kettenis Aq Mt kettenis@openbsd.org . | | 285 | .An Mark Kettenis Aq Mt kettenis@openbsd.org . |
286 | .Sh BUGS | | 286 | .Sh BUGS |
287 | Support for checksum offload is unimplemented. | | 287 | Support for checksum offload is unimplemented. |
288 | Particularly for Yukon-II hardware, there are multiple different | | 288 | Particularly for Yukon-II hardware, there are multiple different |
289 | receive and transmit offload silicon bugs which have to be worked | | 289 | receive and transmit offload silicon bugs which have to be worked |
290 | around in software when using hardware offloading. | | 290 | around in software when using hardware offloading. |
291 | For this reason, support for hardware offloading | | 291 | For this reason, support for hardware offloading |
292 | is not very desirable for therse controllers, and unlikely to be | | 292 | is not very desirable for these controllers, and unlikely to be |
293 | ever implemented. | | 293 | ever implemented. |
294 | .Pp | | 294 | .Pp |
295 | Performance with at least some Marvell-based adapters is poor, | | 295 | Performance with at least some Marvell-based adapters is poor, |
296 | especially on loaded PCI buses or when the adapters are behind | | 296 | especially on loaded PCI buses or when the adapters are behind |
297 | PCI-PCI bridges. | | 297 | PCI-PCI bridges. |
298 | It is believed that this is because the Marvell parts have | | 298 | It is believed that this is because the Marvell parts have |
299 | significantly less buffering than the original SysKonnect cards | | 299 | significantly less buffering than the original SysKonnect cards |
300 | had. | | 300 | had. |