Pull esi-support into release branch
[linux-2.6] / drivers / char / ftape / Kconfig
1 #
2 # Ftape configuration
3 #
4 config ZFTAPE
5         tristate "Zftape, the VFS interface"
6         depends on FTAPE
7         ---help---
8           Normally, you want to say Y or M. DON'T say N here or you
9           WON'T BE ABLE TO USE YOUR FLOPPY TAPE DRIVE.
10
11           The ftape module itself no longer contains the routines necessary
12           to interface with the kernel VFS layer (i.e. to actually write data
13           to and read data from the tape drive).  Instead the file system
14           interface (i.e. the hardware independent part of the driver) has
15           been moved to a separate module.
16
17           To compile this driver as a module, choose M here: the
18           module will be called zftape.
19
20           Regardless of whether you say Y or M here, an additional runtime
21           loadable module called `zft-compressor' which contains code to
22           support user transparent on-the-fly compression based on Ross
23           William's lzrw3 algorithm will be produced.  If you have enabled the
24           kernel module loader (i.e. have said Y to "Kernel module loader
25           support", above) then `zft-compressor' will be loaded
26           automatically by zftape when needed.
27
28           Despite its name, zftape does NOT use compression by default.
29
30 config ZFT_DFLT_BLK_SZ
31         int "Default block size"
32         depends on ZFTAPE
33         default "10240"
34         ---help---
35           If unsure leave this at its default value, i.e. 10240. Note that
36           you specify only the default block size here. The block size can be
37           changed at run time using the MTSETBLK tape operation with the
38           MTIOCTOP ioctl (i.e. with "mt -f /dev/qft0 setblk #BLKSZ" from the
39           shell command line).
40
41           The probably most striking difference between zftape and previous
42           versions of ftape is the fact that all data must be written or read
43           in multiples of a fixed block size. The block size defaults to
44           10240 which is what GNU tar uses. The values for the block size
45           should be either 1 or multiples of 1024 up to a maximum value of
46           63488 (i.e. 62 K). If you specify `1' then zftape's builtin
47           compression will be disabled.
48
49           Reasonable values are `10240' (GNU tar's default block size),
50           `5120' (afio's default block size), `32768' (default block size some
51           backup programs assume for SCSI tape drives) or `1' (no restriction
52           on block size, but disables builtin compression).
53
54 comment "The compressor will be built as a module only!"
55         depends on FTAPE && ZFTAPE
56
57 config ZFT_COMPRESSOR
58         tristate
59         depends on FTAPE!=n && ZFTAPE!=n
60         default m
61
62 config FT_NR_BUFFERS
63         int "Number of ftape buffers (EXPERIMENTAL)"
64         depends on FTAPE && EXPERIMENTAL
65         default "3"
66         help
67           Please leave this at `3' unless you REALLY know what you are doing.
68           It is not necessary to change this value. Values below 3 make the
69           proper use of ftape impossible, values greater than 3 are a waste of
70           memory. You can change the amount of DMA memory used by ftape at
71           runtime with "mt -f /dev/qft0 setdrvbuffer #NUMBUFFERS". Each buffer
72           wastes 32 KB of memory. Please note that this memory cannot be
73           swapped out.
74
75 config FT_PROC_FS
76         bool "Enable procfs status report (+2kb)"
77         depends on FTAPE && PROC_FS
78         ---help---
79           Optional. Saying Y will result in creation of a directory
80           `/proc/ftape' under the /proc file system. The files can be viewed
81           with your favorite pager (i.e. use "more /proc/ftape/history" or
82           "less /proc/ftape/history" or simply "cat /proc/ftape/history"). The
83           file will contain some status information about the inserted
84           cartridge, the kernel driver, your tape drive, the floppy disk
85           controller and the error history for the most recent use of the
86           kernel driver. Saying Y will enlarge the size of the ftape driver
87           by approximately 2 KB.
88
89           WARNING: When compiling ftape as a module (i.e. saying M to "Floppy
90           tape drive") it is dangerous to use ftape's /proc file system
91           interface. Accessing `/proc/ftape' while the module is unloaded will
92           result in a kernel Oops. This cannot be fixed from inside ftape.
93
94 choice
95         prompt "Debugging output"
96         depends on FTAPE
97         default FT_NORMAL_DEBUG
98
99 config FT_NORMAL_DEBUG
100         bool "Normal"
101         ---help---
102           This option controls the amount of debugging output the ftape driver
103           is ABLE to produce; it does not increase or diminish the debugging
104           level itself. If unsure, leave this at its default setting,
105           i.e. choose "Normal".
106
107           Ftape can print lots of debugging messages to the system console
108           resp. kernel log files. Reducing the amount of possible debugging
109           output reduces the size of the kernel module by some KB, so it might
110           be a good idea to use "None" for emergency boot floppies.
111
112           If you want to save memory then the following strategy is
113           recommended: leave this option at its default setting "Normal" until
114           you know that the driver works as expected, afterwards reconfigure
115           the kernel, this time specifying "Reduced" or "None" and recompile
116           and install the kernel as usual. Note that choosing "Excessive"
117           debugging output does not increase the amount of debugging output
118           printed to the console but only makes it possible to produce
119           "Excessive" debugging output.
120
121           Please read <file:Documentation/ftape.txt> for a short description
122           how to control the amount of debugging output.
123
124 config FT_FULL_DEBUG
125         bool "Excessive"
126         help
127           Extremely verbose output for driver debugging purposes.
128
129 config FT_NO_TRACE
130         bool "Reduced"
131         help
132           Reduced tape driver debugging output.
133
134 config FT_NO_TRACE_AT_ALL
135         bool "None"
136         help
137           Suppress all debugging output from the tape drive.
138
139 endchoice
140
141 comment "Hardware configuration"
142         depends on FTAPE
143
144 choice
145         prompt "Floppy tape controllers"
146         depends on FTAPE
147         default FT_STD_FDC
148
149 config FT_STD_FDC
150         bool "Standard"
151         ---help---
152           Only change this setting if you have a special controller. If you
153           didn't plug any add-on card into your computer system but just
154           plugged the floppy tape cable into the already existing floppy drive
155           controller then you don't want to change the default setting,
156           i.e. choose "Standard".
157
158           Choose "MACH-2" if you have a Mountain Mach-2 controller.
159           Choose "FC-10/FC-20" if you have a Colorado FC-10 or FC-20
160           controller.
161           Choose "Alt/82078" if you have another controller that is located at
162           an IO base address different from the standard floppy drive
163           controller's base address of `0x3f0', or uses an IRQ (interrupt)
164           channel different from `6', or a DMA channel different from
165           `2'. This is necessary for any controller card that is based on
166           Intel's 82078 FDC such as Seagate's, Exabyte's and Iomega's "high
167           speed" controllers.
168
169           If you choose something other than "Standard" then please make
170           sure that the settings for the IO base address and the IRQ and DMA
171           channel in the configuration menus below are correct. Use the manual
172           of your tape drive to determine the correct settings!
173
174           If you are already successfully using your tape drive with another
175           operating system then you definitely should use the same settings
176           for the IO base, the IRQ and DMA channel that have proven to work
177           with that other OS.
178
179           Note that this menu lets you specify only the default setting for
180           the hardware setup. The hardware configuration can be changed at
181           boot time (when ftape is compiled into the kernel, i.e. if you
182           have said Y to "Floppy tape drive") or module load time (i.e. if you
183           have said M to "Floppy tape drive").
184
185           Please read also the file <file:Documentation/ftape.txt> which
186           contains a short description of the parameters that can be set at
187           boot or load time. If you want to use your floppy tape drive on a
188           PCI-bus based system, please read the file
189           <file:drivers/char/ftape/README.PCI>.
190
191 config FT_MACH2
192         bool "MACH-2"
193
194 config FT_PROBE_FC10
195         bool "FC-10/FC-20"
196
197 config FT_ALT_FDC
198         bool "Alt/82078"
199
200 endchoice
201
202 comment "Consult the manuals of your tape drive for the correct settings!"
203         depends on FTAPE && !FT_STD_FDC
204
205 config FT_FDC_BASE
206         hex "IO base of the floppy disk controller"
207         depends on FTAPE && !FT_STD_FDC
208         default "0"
209         ---help---
210           You don't need to specify a value if the following default
211           settings for the base IO address are correct:
212           <<< MACH-2     : 0x1E0 >>>
213           <<< FC-10/FC-20: 0x180 >>>
214           <<< Secondary  : 0x370 >>>
215           Secondary refers to a secondary FDC controller like the "high speed"
216           controllers delivered by Seagate or Exabyte or Iomega's Ditto Dash.
217           Please make sure that the setting for the IO base address
218           specified here is correct. USE THE MANUAL OF YOUR TAPE DRIVE OR
219           CONTROLLER CARD TO DETERMINE THE CORRECT SETTING. If you are already
220           successfully using the tape drive with another operating system then
221           you definitely should use the same settings for the IO base that has
222           proven to work with that other OS.
223
224           Note that this menu lets you specify only the default setting for
225           the IO base. The hardware configuration can be changed at boot time
226           (when ftape is compiled into the kernel, i.e. if you specified Y to
227           "Floppy tape drive") or module load time (i.e. if you have said M to
228           "Floppy tape drive").
229
230           Please read also the file <file:Documentation/ftape.txt> which
231           contains a short description of the parameters that can be set at
232           boot or load time.
233
234 config FT_FDC_IRQ
235         int "IRQ channel of the floppy disk controller"
236         depends on FTAPE && !FT_STD_FDC
237         default "0"
238         ---help---
239           You don't need to specify a value if the following default
240           settings for the interrupt channel are correct:
241           <<< MACH-2     : 6 >>>
242           <<< FC-10/FC-20: 9 >>>
243           <<< Secondary  : 6 >>>
244           Secondary refers to secondary a FDC controller like the "high speed"
245           controllers delivered by Seagate or Exabyte or Iomega's Ditto Dash.
246           Please make sure that the setting for the IO base address
247           specified here is correct. USE THE MANUAL OF YOUR TAPE DRIVE OR
248           CONTROLLER CARD TO DETERMINE THE CORRECT SETTING. If you are already
249           successfully using the tape drive with another operating system then
250           you definitely should use the same settings for the IO base that has
251           proven to work with that other OS.
252
253           Note that this menu lets you specify only the default setting for
254           the IRQ channel. The hardware configuration can be changed at boot
255           time (when ftape is compiled into the kernel, i.e. if you said Y to
256           "Floppy tape drive") or module load time (i.e. if you said M to
257           "Floppy tape drive").
258
259           Please read also the file <file:Documentation/ftape.txt> which
260           contains a short description of the parameters that can be set at
261           boot or load time.
262
263 config FT_FDC_DMA
264         int "DMA channel of the floppy disk controller"
265         depends on FTAPE && !FT_STD_FDC
266         default "0"
267         ---help---
268           You don't need to specify a value if the following default
269           settings for the DMA channel are correct:
270           <<< MACH-2     : 2 >>>
271           <<< FC-10/FC-20: 3 >>>
272           <<< Secondary  : 2 >>>
273           Secondary refers to a secondary FDC controller like the "high speed"
274           controllers delivered by Seagate or Exabyte or Iomega's Ditto Dash.
275           Please make sure that the setting for the IO base address
276           specified here is correct. USE THE MANUAL OF YOUR TAPE DRIVE OR
277           CONTROLLER CARD TO DETERMINE THE CORRECT SETTING. If you are already
278           successfully using the tape drive with another operating system then
279           you definitely should use the same settings for the IO base that has
280           proven to work with that other OS.
281
282           Note that this menu lets you specify only the default setting for
283           the DMA channel. The hardware configuration can be changed at boot
284           time (when ftape is compiled into the kernel, i.e. if you said Y to
285           "Floppy tape drive") or module load time (i.e. if you said M to
286           "Floppy tape drive").
287
288           Please read also the file <file:Documentation/ftape.txt> which
289           contains a short description of the parameters that can be set at
290           boot or load time.
291
292 config FT_FDC_THR
293         int "Default FIFO threshold (EXPERIMENTAL)"
294         depends on FTAPE && EXPERIMENTAL
295         default "8"
296         help
297           Set the FIFO threshold of the FDC. If this is higher the DMA
298           controller may serve the FDC after a higher latency time. If this is
299           lower, fewer DMA transfers occur leading to less bus contention.
300           You may try to tune this if ftape annoys you with "reduced data
301           rate because of excessive overrun errors" messages. However, this
302           doesn't seem to have too much effect.
303
304           If unsure, don't touch the initial value, i.e. leave it at "8".
305
306 config FT_FDC_MAX_RATE
307         int "Maximal data rate to use (EXPERIMENTAL)"
308         depends on FTAPE && EXPERIMENTAL
309         default "2000"
310         ---help---
311           With some motherboard/FDC combinations ftape will not be able to
312           run your FDC/tape drive combination at the highest available
313           speed. If this is the case you'll encounter "reduced data rate
314           because of excessive overrun errors" messages and lots of retries
315           before ftape finally decides to reduce the data rate.
316
317           In this case it might be desirable to tell ftape beforehand that
318           it need not try to run the tape drive at the highest available
319           speed. If unsure, leave this disabled, i.e. leave it at 2000
320           bits/sec.
321
322 config FT_ALPHA_CLOCK
323         int "CPU clock frequency of your DEC Alpha" if ALPHA
324         depends on FTAPE
325         default "0"
326         help
327           On some DEC Alpha machines the CPU clock frequency cannot be
328           determined automatically, so you need to specify it here ONLY if
329           running a DEC Alpha, otherwise this setting has no effect.
330