import of upstream 2.4.34.4 from kernel.org
[linux-2.4.git] / Documentation / networking / skfp.txt
1 (C)Copyright 1998-2000 SysKonnect,
2 ===========================================================================
3
4 skfp.txt created 11-May-2000
5
6 Readme File for skfp.o v2.06
7
8
9 This file contains
10 (1) OVERVIEW
11 (2) SUPPORTED ADAPTERS
12 (3) GENERAL INFORMATION
13 (4) INSTALLATION
14 (5) INCLUSION OF THE ADAPTER IN SYSTEM START
15 (6) TROUBLESHOOTING
16 (7) FUNCTION OF THE ADAPTER LEDS
17 (8) HISTORY
18
19 ===========================================================================
20
21
22
23 (1) OVERVIEW
24 ============
25
26 This README explains how to use the driver 'skfp' for Linux with your
27 network adapter.
28
29 Chapter 2: Contains a list of all network adapters that are supported by
30            this driver.
31
32 Chapter 3: Gives some general information.
33
34 Chapter 4: Describes common problems and solutions.
35
36 Chapter 5: Shows the changed functionality of the adapter LEDs.
37
38 Chapter 6: History of development.
39
40 ***
41
42
43 (2) SUPPORTED ADAPTERS
44 ======================
45
46 The network driver 'skfp' supports the following network adapters:
47 SysKonnect adapters:
48   - SK-5521 (SK-NET FDDI-UP)
49   - SK-5522 (SK-NET FDDI-UP DAS)
50   - SK-5541 (SK-NET FDDI-FP)
51   - SK-5543 (SK-NET FDDI-LP)
52   - SK-5544 (SK-NET FDDI-LP DAS)
53   - SK-5821 (SK-NET FDDI-UP64)
54   - SK-5822 (SK-NET FDDI-UP64 DAS)
55   - SK-5841 (SK-NET FDDI-FP64)
56   - SK-5843 (SK-NET FDDI-LP64)
57   - SK-5844 (SK-NET FDDI-LP64 DAS)
58 Compaq adapters (not tested):
59   - Netelligent 100 FDDI DAS Fibre SC
60   - Netelligent 100 FDDI SAS Fibre SC
61   - Netelligent 100 FDDI DAS UTP
62   - Netelligent 100 FDDI SAS UTP
63   - Netelligent 100 FDDI SAS Fibre MIC
64 ***
65
66
67 (3) GENERAL INFORMATION
68 =======================
69
70 From v2.01 on, the driver is integrated in the linux kernel sources.
71 Therefor, the installation is the same as for any other adapter
72 supported by the kernel.
73 Refer to the manual of your distribution about the installation
74 of network adapters.
75 Makes my life much easier :-)
76 ***
77
78
79 (4) TROUBLESHOOTING
80 ===================
81
82 If you run into problems during installation, check those items:
83
84 Problem:  The FDDI adapter can not be found by the driver.
85 Reason:   Look in /proc/pci for the following entry:
86              'FDDI network controller: SysKonnect SK-FDDI-PCI ...'
87           If this entry exists, then the FDDI adapter has been
88           found by the system and should be able to be used.
89           If this entry does not exist or if the file '/proc/pci'
90           is not there, then you may have a hardware problem or PCI
91           support may not be enabled in your kernel.
92           The adapter can be checked using the diagnostic program
93           which is available from the SysKonnect web site:
94               www.syskonnect.de
95           Some COMPAQ machines have a problem with PCI under
96           Linux. This is described in the 'PCI howto' document
97           (included in some distributions or available from the
98           www, e.g. at 'www.linux.org') and no workaround is available.
99
100 Problem:  You want to use your computer as a router between
101           multiple IP subnetworks (using multiple adapters), but
102           you can not reach computers in other subnetworks.
103 Reason:   Either the router's kernel is not configured for IP
104           forwarding or there is a problem with the routing table
105           and gateway configuration in at least one of the
106           computers.
107
108 If your problem is not listed here, please contact our
109 technical support for help. 
110 You can send email to:
111   linux@syskonnect.de
112 When contacting our technical support,
113 please ensure that the following information is available:
114 - System Manufacturer and Model
115 - Boards in your system
116 - Distribution
117 - Kernel version
118
119 ***
120
121
122 (5) FUNCTION OF THE ADAPTER LEDS
123 ================================
124
125         The functionality of the LED's on the FDDI network adapters was
126         changed in SMT version v2.82. With this new SMT version, the yellow
127         LED works as a ring operational indicator. An active yellow LED
128         indicates that the ring is down. The green LED on the adapter now
129         works as a link indicator where an active GREEN LED indicates that
130         the respective port has a physical connection.
131
132         With versions of SMT prior to v2.82 a ring up was indicated if the
133         yellow LED was off while the green LED(s) showed the connection
134         status of the adapter. During a ring down the green LED was off and
135         the yellow LED was on.
136
137         All implementations indicate that a driver is not loaded if
138         all LEDs are off.
139
140 ***
141
142
143 (6) HISTORY
144 ===========
145
146 v2.07 (20020506) (In-Kernel version)
147     Fix: Transmit Descriptor struct
148     Fix: Receive Descriptor struct
149
150 v2.06 (20000511) (In-Kernel version)
151     New features:
152         - 64 bit support
153         - new pci dma interface
154         - in kernel 2.3.99
155
156 v2.05 (20000217) (In-Kernel version)
157     New features:
158         - Changes for 2.3.45 kernel
159
160 v2.04 (20000207) (Standalone version)
161     New features:
162         - Added rx/tx byte counter
163
164 v2.03 (20000111) (Standalone version)
165     Problems fixed:
166         - Fixed printk statements from v2.02
167
168 v2.02 (991215) (Standalone version)
169     Problems fixed:
170         - Removed unnecessary output
171         - Fixed path for "printver.sh" in makefile
172
173 v2.01 (991122) (In-Kernel version)
174     New features:
175         - Integration in Linux kernel sources
176         - Support for memory mapped I/O.
177
178 v2.00 (991112)
179     New features:
180         - Full source released under GPL
181
182 v1.05 (991023)
183     Problems fixed:
184         - Compilation with kernel version 2.2.13 failed
185
186 v1.04 (990427)
187     Changes:
188         - New SMT module included, changing LED functionality
189     Problems fixed:
190         - Synchronization on SMP machines was buggy
191
192 v1.03 (990325)
193     Problems fixed:
194         - Interrupt routing on SMP machines could be incorrect
195
196 v1.02 (990310)
197     New features:
198         - Support for kernel versions 2.2.x added
199         - Kernel patch instead of private duplicate of kernel functions
200
201 v1.01 (980812)
202     Problems fixed:
203         Connection hangup with telnet
204         Slow telnet connection
205
206 v1.00 beta 01 (980507)
207     New features:
208         None.
209     Problems fixed:
210         None.
211     Known limitations:
212         - tar archive instead of standard package format (rpm).
213         - FDDI statistic is empty.
214         - not tested with 2.1.xx kernels
215         - integration in kernel not tested
216         - not tested simultaneously with FDDI adapters from other vendors.
217         - only X86 processors supported.
218         - SBA (Synchronous Bandwidth Allocator) parameters can
219           not be configured.
220         - does not work on some COMPAQ machines. See the PCI howto
221           document for details about this problem.
222         - data corruption with kernel versions below 2.0.33.
223
224 *** End of information file ***