| 1 |
.TH floppycontrol 1 "27Jan21" fdutils-5.6 |
| 2 |
.SH Name |
| 3 |
floppycontrol - floppy driver configuration utility |
| 4 |
'\" t |
| 5 |
.de TQ |
| 6 |
.br |
| 7 |
.ns |
| 8 |
.TP \\$1 |
| 9 |
.. |
| 10 |
|
| 11 |
.tr \(is' |
| 12 |
.tr \(if` |
| 13 |
.tr \(pd" |
| 14 |
|
| 15 |
.SH Note |
| 16 |
This manpage has been automatically generated from fdutils's texinfo |
| 17 |
documentation. However, this process is only approximative, and some |
| 18 |
items, such as cross-references, footnotes and indices are lost in this |
| 19 |
translation process. Indeed, these items have no appropriate |
| 20 |
representation in the manpage format. Moreover, only the items specific |
| 21 |
to each command have been translated, and the general information about |
| 22 |
fdutils has been dropped in the manpage version. Thus I strongly advise |
| 23 |
you to use the original texinfo doc. |
| 24 |
.TP |
| 25 |
* \ \ |
| 26 |
To generate a printable copy from the texinfo doc, run the following |
| 27 |
commands: |
| 28 |
|
| 29 |
.nf |
| 30 |
.ft 3 |
| 31 |
.in +0.3i |
| 32 |
./configure; make dvi; dvips fdutils.dvi |
| 33 |
.fi |
| 34 |
.in -0.3i |
| 35 |
.ft R |
| 36 |
|
| 37 |
\&\fR |
| 38 |
.TP |
| 39 |
* \ \ |
| 40 |
To generate a HTML copy, run: |
| 41 |
|
| 42 |
.nf |
| 43 |
.ft 3 |
| 44 |
.in +0.3i |
| 45 |
./configure; make html |
| 46 |
.fi |
| 47 |
.in -0.3i |
| 48 |
.ft R |
| 49 |
|
| 50 |
\&\fRA pre-made HTML can be found at: |
| 51 |
\&\fR\&\f(CW\(ifhttp://www.tux.org/pub/knaff/fdutils\(is\fR |
| 52 |
.TP |
| 53 |
* \ \ |
| 54 |
To generate an info copy (browsable using emacs' info mode), run: |
| 55 |
|
| 56 |
.nf |
| 57 |
.ft 3 |
| 58 |
.in +0.3i |
| 59 |
./configure; make info |
| 60 |
.fi |
| 61 |
.in -0.3i |
| 62 |
.ft R |
| 63 |
|
| 64 |
\&\fR |
| 65 |
.PP |
| 66 |
The texinfo doc looks most pretty when printed or as HTML. Indeed, in |
| 67 |
the info version certain examples are difficult to read due to the |
| 68 |
quoting conventions used in info. |
| 69 |
.SH Description |
| 70 |
.PP |
| 71 |
|
| 72 |
.nf |
| 73 |
.ft 3 |
| 74 |
.in +0.3i |
| 75 |
\&\fR\&\f(CWfloppycontrol [\fR\&\f(CW\-p] [\fR\&\f(CW\-\-pollstate] [\fR\&\f(CW\-\-printfdstate] |
| 76 |
[\fR\&\f(CW\-a \fIoperation\-abort\-threshold\fR\&\f(CW] [\fR\&\f(CW\-c \fIread\-track\-threshold\fR\&\f(CW] |
| 77 |
[\fR\&\f(CW\-r \fIrecalibrate\-threshold\fR\&\f(CW] [\fR\&\f(CW\-R \fIreset\-threshold\fR\&\f(CW] |
| 78 |
[\fR\&\f(CW\-e \fIreporting\-threshold\fR\&\f(CW] [\fR\&\f(CW\-f] [\fR\&\f(CW\-x] [\fR\&\f(CW\-d \fIdrive\fR\&\f(CW][\fR\&\f(CW\-F] [\fR\&\f(CW\-T] |
| 79 |
[\fR\&\f(CW\-reset \fIcondition\fR\&\f(CW] [\fR\&\f(CW\-\-debug] [\fR\&\f(CW\-\-nodebug] [\fR\&\f(CW\-\-messages] |
| 80 |
[\fR\&\f(CW\-\-nomessages] [\fR\&\f(CW\-\-broken_dcl] [\fR\&\f(CW\-\-working_dcl] [\fR\&\f(CW\-\-inverted_dcl] |
| 81 |
[\fR\&\f(CW\-\-no_inverted_dcl] [\fR\&\f(CW\-\-silent_dcl_clear] [\fR\&\f(CW\-\-noisy_dcl_clear] |
| 82 |
[\fR\&\f(CW\-c\fIcmos\-type\fR\&\f(CW] [\fR\&\f(CW\-hlt \fIhlt\fR\&\f(CW] [\fR\&\f(CW\-hut \fIhut\fR\&\f(CW] [\fR\&\f(CW\-srt \fIsrt\fR\&\f(CW] [\fR\&\f(CW\-o \fIspindown\fR\&\f(CW] |
| 83 |
[\fR\&\f(CW\-u \fIspinup\fR\&\f(CW] [\fR\&\f(CW\-s \fIselect\-delay\fR\&\f(CW] [\fR\&\f(CW\-rps \fIrotations\-per\-second\fR\&\f(CW] |
| 84 |
[\fR\&\f(CW\-O \fIspindown\-offset\fR\&\f(CW] [\fR\&\f(CW\-track \fImax\-tracks\fR\&\f(CW] [\fR\&\f(CW\-timeout \fIseconds\fR\&\f(CW] |
| 85 |
[\fR\&\f(CW\-C \fIcheck\-interval\fR\&\f(CW] [\fR\&\f(CW\-n \fInative\-format\fR\&\f(CW] |
| 86 |
[\fR\&\f(CW\-autodetect \fIautodetection\-sequence\fR\&\f(CW] [\fR\&\f(CW\-P] [\fR\&\f(CW\-\-clrwerror] |
| 87 |
[\fR\&\f(CW\-\-printwerror] [\fR\&\f(CW\-h] |
| 88 |
.fi |
| 89 |
.in -0.3i |
| 90 |
.ft R |
| 91 |
|
| 92 |
\&\fR |
| 93 |
.PP |
| 94 |
The \fR\&\f(CWfloppycontrol\fR program is used to configure the floppy driver. |
| 95 |
.PP |
| 96 |
.SH General\ Options |
| 97 |
.IP |
| 98 |
.TP |
| 99 |
\&\fR\&\f(CW\-h\fR\ |
| 100 |
.TQ |
| 101 |
\&\fR\&\f(CW\-\-help\fR |
| 102 |
Print a help screen. |
| 103 |
.TP |
| 104 |
\&\fR\&\f(CW\-d\ \fIdrive\fR\&\f(CW\ \fR\ |
| 105 |
.TQ |
| 106 |
\&\fR\&\f(CW\-\-drive\ \fI\ drive\fR\&\f(CW\fR |
| 107 |
Selects the drive to configure. The default is drive 0 |
| 108 |
(\fR\&\f(CW\(if/dev/fd0\(is\fR). |
| 109 |
.PP |
| 110 |
.SH One\ time\ actions |
| 111 |
.PP |
| 112 |
The following \fR\&\f(CWfloppycontrol\fR options don't set a configuration |
| 113 |
parameter, but perform a one-time action. They are available to anybody |
| 114 |
who has write access to the drive |
| 115 |
.TP |
| 116 |
\&\fR\&\f(CW\-f\ \ \fR\ |
| 117 |
.TQ |
| 118 |
\&\fR\&\f(CW\-\-flush\fR |
| 119 |
Flushes (throws away) the dirty data buffers associated with this drive. |
| 120 |
.TP |
| 121 |
\&\fR\&\f(CW\-x\ \ \fR\ |
| 122 |
.TQ |
| 123 |
\&\fR\&\f(CW\-\-eject\fR |
| 124 |
Ejects the disk out of the drive (Sparc). The dirty buffers are first |
| 125 |
committed to disk before ejecting it. Fails if the disk is mounted. |
| 126 |
.TP |
| 127 |
\&\fR\&\f(CW\-\-reset\ \fI\ condition\fR\&\f(CW\fR\ |
| 128 |
Resets the FDC under |
| 129 |
\&\fIcondition\fR . Condition may be one of the following: |
| 130 |
.RS |
| 131 |
.TP |
| 132 |
\&\fR\&\f(CW0\fR\ |
| 133 |
resets the FDC only if a reset is needed anyways, |
| 134 |
.TP |
| 135 |
\&\fR\&\f(CW1\fR\ |
| 136 |
resets the FDC |
| 137 |
also if a raw command has been performed since the last reset, and |
| 138 |
.TP |
| 139 |
\&\fR\&\f(CW2\ \fR\ |
| 140 |
resets the FDC unconditionally. |
| 141 |
.RE |
| 142 |
.IP |
| 143 |
This command may be needed after some failed raw commands |
| 144 |
(see section fdrawcmd). |
| 145 |
.IP |
| 146 |
.TP |
| 147 |
\&\fR\&\f(CW\-F\fR\ |
| 148 |
.TQ |
| 149 |
\&\fR\&\f(CW\-\-formatend\fR |
| 150 |
Issues an end format ioctl. This might be needed after exiting a |
| 151 |
\&\fR\&\f(CWfdformat\fR in an unclean way. \fR\&\f(CWsuperformat\fR is not subject to |
| 152 |
this. |
| 153 |
.PP |
| 154 |
.SH Printing\ current\ settings |
| 155 |
.IP |
| 156 |
.TP |
| 157 |
\&\fR\&\f(CW\-T\fR\ |
| 158 |
.TQ |
| 159 |
\&\fR\&\f(CW\-\-type\fR |
| 160 |
Print out the drive name of a floppy device. This is used by the |
| 161 |
\&\fR\&\f(CWMAKEFLOPPIES\fR script. The drive name is a letter (describing the |
| 162 |
drive type) followed by the capacity of the format in bytes. The letter |
| 163 |
is E for 3.5 ED drives, H for 3.5 HD drives, D for 3.5 DD drives, h for |
| 164 |
5.25 HD drives and d for 5.25 DD drives. The drive type letter |
| 165 |
corresponds to the oldest drive type supporting the format of this |
| 166 |
device node (not necessarily the type of the drive referred by this |
| 167 |
node.) For the generic format nodes (/dev/fd0 et al.) the name of |
| 168 |
"native format" of the drive is printed, and for the default formats, if |
| 169 |
a generic format has been redefined, its name becomes \fR\&\f(CW(null)\fR. |
| 170 |
.TP |
| 171 |
\&\fR\&\f(CW\-p\fR\ |
| 172 |
.TQ |
| 173 |
\&\fR\&\f(CW\-\-print\fR |
| 174 |
Prints out the configuration of the drive. The names of the various |
| 175 |
fields are the same as the names of the option to set them, see below. |
| 176 |
.TP |
| 177 |
\&\fR\&\f(CW\-P\fR\ |
| 178 |
.TQ |
| 179 |
\&\fR\&\f(CW\-\-printstate\fR |
| 180 |
Prints out the cached internal state of the driver. The first line lists |
| 181 |
various attributes about the disk: |
| 182 |
.RS |
| 183 |
.TP |
| 184 |
\&\fR\&\f(CWdrive\ present\fR\ |
| 185 |
.TQ |
| 186 |
\&\fR\&\f(CWdisk\ present\fR |
| 187 |
.TQ |
| 188 |
\&\fR\&\f(CWdisk\ writable\fR |
| 189 |
These are only updated when the drive is accessed. |
| 190 |
.TP |
| 191 |
\&\fR\&\f(CWspinup\fR\ |
| 192 |
is the time when the motor became switched on for the last time. |
| 193 |
.TP |
| 194 |
\&\fR\&\f(CWselect\fR\ |
| 195 |
is the time when the drive became selected for the last time |
| 196 |
.TP |
| 197 |
\&\fR\&\f(CWfirst_read\fR\ |
| 198 |
is the time when the first read request after the last spin up |
| 199 |
completed. |
| 200 |
.TP |
| 201 |
\&\fR\&\f(CWprobed_fmt\fR\ |
| 202 |
is the index of the autodetected format in the autodetection |
| 203 |
sequence for this drive. |
| 204 |
.TP |
| 205 |
\&\fR\&\f(CWcylinder\fR\ |
| 206 |
is the cylinder where the drive head currently sits. If this number is negative, it has the following meaning: |
| 207 |
.RS |
| 208 |
.TP |
| 209 |
* \ \ |
| 210 |
\-1 means that the driver doesn't know, but the controller does (a seek |
| 211 |
command must be issued). |
| 212 |
.TP |
| 213 |
* \ \ |
| 214 |
\-2 means that the controller doesn't know either, but is sure that it |
| 215 |
not beyond the 80th track. The drive needs a recalibration. |
| 216 |
.TP |
| 217 |
* \ \ |
| 218 |
\-3 means that the head may be beyond the 80th track. The drive needs |
| 219 |
two successive recalibrations, because at each recalibration, the |
| 220 |
controller only issues 80 move head commands per recalibration. |
| 221 |
.RE |
| 222 |
.TP |
| 223 |
\&\fR\&\f(CWmaxblock\fR\ |
| 224 |
is the highest block number that has been read. |
| 225 |
.TP |
| 226 |
\&\fR\&\f(CWmaxcylinder\fR\ |
| 227 |
is a boolean which is set when a sector that is not on cylinder 0/head 0 |
| 228 |
has been read. These are used for smart invalidation of the buffer |
| 229 |
cache on geometry change. The buffer cache of the drive is only |
| 230 |
invalidated on geometry change when this change actually implies that a |
| 231 |
block that has already been read changes position. This optimization is |
| 232 |
useful for mtools which changes the geometry after reading the boot |
| 233 |
sector. |
| 234 |
.TP |
| 235 |
\&\fR\&\f(CWgeneration\fR\ |
| 236 |
is roughly the number of disk changes noticed since boot. Disk changes |
| 237 |
are noticed if the disk is actually changed, or if a flush command is |
| 238 |
issued and for both cases if any I/O to/from the disk occurs. (i.e. if |
| 239 |
you insert several disks, but don't do any I/O to them, the generation |
| 240 |
number stays the same.) |
| 241 |
.TP |
| 242 |
\&\fR\&\f(CWrefs\fR\ |
| 243 |
is number of open file descriptors for this drive. It is always at |
| 244 |
least one, because floppycontrol's file descriptor is counted too. |
| 245 |
.TP |
| 246 |
\&\fR\&\f(CWdevice\fR\ |
| 247 |
is format type (as derived from the minor device number) which is |
| 248 |
currently being used. |
| 249 |
.TP |
| 250 |
\&\fR\&\f(CWlast_checked\fR\ |
| 251 |
is date (in jiffies) when the drive was last checked for a disk |
| 252 |
change, and a disk was actually in the drive. |
| 253 |
.RE |
| 254 |
.IP |
| 255 |
.TP |
| 256 |
\&\fR\&\f(CW\-\-pollstate\fR\ |
| 257 |
Polls the drive and then prints out the internal state of the |
| 258 |
driver.(\fR\&\f(CW\-\-Printstate\fR only prints out the cached information |
| 259 |
without actually polling the drive for a disk change.) |
| 260 |
.TP |
| 261 |
\&\fR\&\f(CW\-\-printfdcstate\fR\ |
| 262 |
Prints out the state of the controller where the target drive is |
| 263 |
attached to. |
| 264 |
.RS |
| 265 |
.TP |
| 266 |
\&\fR\&\f(CWspec1\fR\ |
| 267 |
.TQ |
| 268 |
\&\fR\&\f(CWspec2\fR |
| 269 |
are the current values of those registers. |
| 270 |
.TP |
| 271 |
\&\fR\&\f(CWrate\fR\ |
| 272 |
is current data transfer rate |
| 273 |
.TP |
| 274 |
\&\fR\&\f(CWrawcmd\fR\ |
| 275 |
is true if a raw command has been executed since the last reset. If this |
| 276 |
is the case, a reset will be triggered when a drive on the same FDC is |
| 277 |
next opened. |
| 278 |
.TP |
| 279 |
\&\fR\&\f(CWdor\fR\ |
| 280 |
is the value of the digital output register. The 4 high bits are a bit |
| 281 |
mask describing which drives are spinning, the 2 low bits describe the |
| 282 |
selected drive, bit 2 is used to reset the FDC, and bit 3 describes |
| 283 |
whether this FDC has hold of the interrupt and the DMA. If you have two |
| 284 |
FDCs, bit 3 is only set on one of them. |
| 285 |
.TP |
| 286 |
\&\fR\&\f(CWversion\fR\ |
| 287 |
is the version of the FDC. See \fR\&\f(CW\(iflinux/include/linux/fdreg.h\(is\fR for a |
| 288 |
listing of the FDC version numbers. |
| 289 |
.TP |
| 290 |
\&\fR\&\f(CWreset\fR\ |
| 291 |
is true if a reset needs to be issued to the FDC before processing the |
| 292 |
next request. |
| 293 |
.TP |
| 294 |
\&\fR\&\f(CWneed_configure\fR\ |
| 295 |
is true if this FDC needs configuration by the \fR\&\f(CWFD_CONFIGURE\fR |
| 296 |
command. |
| 297 |
.TP |
| 298 |
\&\fR\&\f(CWhas_fifo\fR\ |
| 299 |
is set if the FDC understands the \fR\&\f(CWFD_CONFIGURE\fR command. |
| 300 |
.TP |
| 301 |
\&\fR\&\f(CWperp_mode\fR\ |
| 302 |
describes the perpendicular mode of this FDC. 0 is non-perpendicular mode, |
| 303 |
2 is HD perpendicular mode, 3 is ED perpendicular mode, and 1 is unknown. |
| 304 |
.TP |
| 305 |
\&\fR\&\f(CWaddress\fR\ |
| 306 |
is the address of the first I/O port of the FDC. Normally, this is |
| 307 |
0x3f0 for the first FDC and 0x370 for the second. |
| 308 |
.RE |
| 309 |
.PP |
| 310 |
.SH Drive\ type\ configuration\ and\ autodetection |
| 311 |
.PP |
| 312 |
The following options handle the different available drive types, such |
| 313 |
as double density vs. high density vs. extra density drives, and 5 1/4 |
| 314 |
drives vs 3 1/2 drives. Usually the drive type is stored in a |
| 315 |
non-volatile memory, called CMOS, under the form of an integer ranging |
| 316 |
from 1 to 6. |
| 317 |
.PP |
| 318 |
Different drive types are able to handle and autodetect different |
| 319 |
formats (different autodetection lists). They also have different |
| 320 |
"native format name". The native format is the "usual" format with the |
| 321 |
highest capacity supported by the drive. (For example 720KB on a double |
| 322 |
density 3 1/2 drive, and 1.2MB on a high density 5 1/4 drive.) |
| 323 |
.PP |
| 324 |
These settings are only changeable by the super user. |
| 325 |
.TP |
| 326 |
\&\fR\&\f(CW\-c\ \fIcmos\-type\fR\&\f(CW\fR\ |
| 327 |
.TQ |
| 328 |
\&\fR\&\f(CW\-\-cmos\ \fI\ cmos\-type\fR\&\f(CW\fR |
| 329 |
Set the virtual CMOS type of the floppy drive. This is useful if |
| 330 |
.RS |
| 331 |
.TP |
| 332 |
* \ \ |
| 333 |
the physical CMOS type is wrong (this may happen with BIOSes |
| 334 |
which use a non-standard mapping), |
| 335 |
.TP |
| 336 |
* \ \ |
| 337 |
you have more than two drives |
| 338 |
(the physical CMOS may only describe up to two drives). |
| 339 |
.TP |
| 340 |
* \ \ |
| 341 |
you have a BIOS that allows swapping drives A: and B: for DOS. |
| 342 |
.RE |
| 343 |
|
| 344 |
Right now, this CMOS parameter is not used by the kernel, except for |
| 345 |
feeding it back to other applications (for instance \fR\&\f(CWsuperformat\fR, |
| 346 |
\&\fR\&\f(CWfloppymeter\fR or \fR\&\f(CWMAKEFLOPPIES\fR). It is also possible to |
| 347 |
supply a virtual CMOS type with the \fR\&\f(CWcmos\fR boot option |
| 348 |
(see section Boottime configuration). If possible, I recommend you use the |
| 349 |
boot option, rather than \fR\&\f(CWfloppycontrol\fR, because the boot option |
| 350 |
also sets any parameters derived from the CMOS type, such as the |
| 351 |
autodetection list and the native format, whereas \fR\&\f(CWfloppycontrol\fR |
| 352 |
does not. |
| 353 |
.TP |
| 354 |
\&\fR\&\f(CW\-A\ \ \fIautodetect\-seq\fR\&\f(CW\ \fR\ |
| 355 |
.TQ |
| 356 |
\&\fR\&\f(CW\-\-autodetect\ \fI\ autodetect\-seq\fR\&\f(CW\fR |
| 357 |
Set the autodetection sequence (see section Autodetection) The autodetection |
| 358 |
sequence is a comma-separated list of at most eight format |
| 359 |
descriptors. Each format descriptor is a format number optionally |
| 360 |
followed by the letter \fR\&\f(CWt\fR. For drive 0, the format number is the |
| 361 |
minor device number divided by 4. The autodetection sequence is used by |
| 362 |
the driver to find out the format of a newly inserted disk. The formats |
| 363 |
are tried one after the other, and the first matching format is |
| 364 |
retained. To test the format, the driver tries to read the first sector |
| 365 |
on the first track on the first head when \fR\&\f(CWt\fR is not given, or the |
| 366 |
whole first track when \fR\&\f(CWt\fR is given. Thus, autodetection cannot |
| 367 |
detect the number of tracks. However, this information is contained in |
| 368 |
the boot sector, which is now accessible. The boot sector can then be |
| 369 |
used by mtools to configure the correct number of tracks. |
| 370 |
.IP |
| 371 |
Example: |
| 372 |
|
| 373 |
.nf |
| 374 |
.ft 3 |
| 375 |
.in +0.3i |
| 376 |
7,4,24t,25 |
| 377 |
.fi |
| 378 |
.in -0.3i |
| 379 |
.ft R |
| 380 |
|
| 381 |
\&\fRmeans to try out the formats whose minor device numbers are 28 (1.44M), |
| 382 |
16 (720KB), 96 (1.76MB), and 100 (1.92MB), in this order. For the 1.76MB |
| 383 |
format, try to read the whole track at once. |
| 384 |
.IP |
| 385 |
Reading the whole track at once allows you to distinguish between two |
| 386 |
formats which differ only in the number of sectors. (The format with the |
| 387 |
most sectors must be tried first.) If you use mtools, you do not need this feature, as mtools can figure out |
| 388 |
the number of sectors without any help from the floppy driver, by |
| 389 |
looking at the boot sector. |
| 390 |
.IP |
| 391 |
Reading the whole track at once may also speed up the first read by 200 |
| 392 |
milliseconds. However, if, on the other hand, you try to read a disk |
| 393 |
which has less sectors than the format, you lose some time. |
| 394 |
.IP |
| 395 |
I suggest that you put the most often used format in the first place |
| 396 |
(barring other constraints), as each format that is tried out takes |
| 397 |
400 milliseconds. |
| 398 |
.TP |
| 399 |
\&\fR\&\f(CW\-n\ \fInative\-format\fR\&\f(CW\fR\ |
| 400 |
.TQ |
| 401 |
\&\fR\&\f(CW\-\-native_format\ \fI\ native\-format\fR\&\f(CW\fR |
| 402 |
Set the native format of this drive. The native format of a drive is the |
| 403 |
highest standard format available for this drive. (Example: For a 5 1/4 |
| 404 |
HD drive it is the usual 1200K format.) This is format is used to make |
| 405 |
up the format name for the generic device (which is the name of the |
| 406 |
native format). This drive name is read back from the kernel by the |
| 407 |
\&\fR\&\f(CWMAKEFLOPPIES\fR script which uses it to decide which device nodes to |
| 408 |
create. |
| 409 |
.PP |
| 410 |
.SH Configuration\ of\ the\ disk\ change\ line |
| 411 |
.TP |
| 412 |
\&\fR\&\f(CW\-\-broken_dcl\fR\ |
| 413 |
Assumes that the disk change line of the drive is broken. If this is |
| 414 |
set, disk changes are assumed to happen whenever the device node is |
| 415 |
first opened. The physical disk change line is ignored. |
| 416 |
.IP |
| 417 |
This option should be used if disk changes are either not detected at |
| 418 |
all, or if disk changes are detected when the disk was actually not |
| 419 |
changed. If this option fixes the problem, I'd recommend that you try to |
| 420 |
trace the root cause of the problem. Indeed, this options results in |
| 421 |
reduced performance due to spurious cache flushes. |
| 422 |
.IP |
| 423 |
The following hardware problems may lead to a bad disk change line: |
| 424 |
.RS |
| 425 |
.TP |
| 426 |
* \ \ |
| 427 |
If the floppy cable is not inserted straight, or if it is kinked, the |
| 428 |
disk change line is likely to suffer, as it is on the edge of the cable. |
| 429 |
Gently press on both connectors of the cable (drive and controller) to |
| 430 |
insure that all wires make contact. Visually inspect the cable, and if |
| 431 |
it shows obvious traces of damage, get a new one. |
| 432 |
.TP |
| 433 |
* \ \ |
| 434 |
On some drives, the locations disk change line may be chosen by |
| 435 |
jumper. Make sure that your floppy controller and your drive agree on |
| 436 |
which line is the disk change line. |
| 437 |
.TP |
| 438 |
* \ \ |
| 439 |
Some older drives (mostly double density 5 1/4 drives) don't have a disk |
| 440 |
change line. In this case, you have no choice other than to leave the |
| 441 |
\&\fR\&\f(CWbroken_dcl\fR option on. |
| 442 |
.RE |
| 443 |
.TP |
| 444 |
\&\fR\&\f(CW\-\-working_dcl\fR\ |
| 445 |
Assumes that the disk change line works all right. Switching from |
| 446 |
broken to working may lead to unexpected results after the first disk |
| 447 |
change. |
| 448 |
.TP |
| 449 |
\&\fR\&\f(CW\-\-inverted_dcl\fR\ |
| 450 |
Assumes that this disk drive uses an inverted disk change |
| 451 |
line. Apparently this is the case for IBM thinkpads. |
| 452 |
.TP |
| 453 |
\&\fR\&\f(CW\-\-no_inverted_dcl\fR\ |
| 454 |
Assumes that this drive follows the standard convention for the disk |
| 455 |
change line. |
| 456 |
.TP |
| 457 |
\&\fR\&\f(CW\-\-noisy_dcl_clear\fR\ |
| 458 |
Switches off silent disk change line clearing for this drive. |
| 459 |
.PP |
| 460 |
.SH Timing\ Parameters |
| 461 |
.PP |
| 462 |
This section describes how to configure drive timings. To set these |
| 463 |
parameters, you need superuser privileges. All times are in "jiffy" |
| 464 |
units (10 milliseconds), unless otherwise specified. |
| 465 |
.TP |
| 466 |
\&\fR\&\f(CW\-\-hlt\ \fI\ hlt\fR\&\f(CW\fR\ |
| 467 |
Set the head load time (in microseconds) for this floppy drive. The |
| 468 |
head load time describes how long the floppy controller waits after |
| 469 |
seeking or changing heads before allowing access to a track. |
| 470 |
.TP |
| 471 |
\&\fR\&\f(CW\-\-hut\ \fI\ hut\fR\&\f(CW\fR\ |
| 472 |
Set the head unload time (in microseconds) for this floppy drive. The |
| 473 |
head unload time describes how long the floppy controller waits after an |
| 474 |
access before directing its attention to the other head, or before |
| 475 |
seeking. |
| 476 |
.TP |
| 477 |
\&\fR\&\f(CW\-\-srt\ \fI\ srt\fR\&\f(CW\fR\ |
| 478 |
Set the step rate (in microseconds) for this floppy drive. The step |
| 479 |
rate describes how long the drive head stays on one cylinder when |
| 480 |
seeking. Setting this value to low (too fast seeks) may make seeks |
| 481 |
fail, because the motor doesn't follow fast enough. |
| 482 |
.TP |
| 483 |
\&\fR\&\f(CW\-u\ \fIspinup\-time\fR\&\f(CW\ \fR\ |
| 484 |
.TQ |
| 485 |
\&\fR\&\f(CW\-\-spinup\ \fI\ spinup\-time\fR\&\f(CW\fR |
| 486 |
Set the spinup time of the floppy drive. In order to do read or write |
| 487 |
to the floppy disk, it must spin. It takes a certain time for the |
| 488 |
motor to reach enough speed to read or write. This parameter describes |
| 489 |
this time. The floppy driver doesn't try to access the drive before |
| 490 |
the spinup time has elapsed. With modern controllers, you may set this time |
| 491 |
to zero, as the controller itself enforces the right delay. |
| 492 |
.TP |
| 493 |
\&\fR\&\f(CW\-o\ \fIspindown\-time\fR\&\f(CW\ \fR\ |
| 494 |
.TQ |
| 495 |
\&\fR\&\f(CW\-\-spindown\ \fI\ spindown\-time\fR\&\f(CW\fR |
| 496 |
Set the spindown time of this floppy drive. The motor is not stopped |
| 497 |
immediately after the operation completes, because there might be more |
| 498 |
operations following. The spindown time is the time the driver waits |
| 499 |
before switching off the motor. |
| 500 |
.TP |
| 501 |
\&\fR\&\f(CW\-O\ \fIspindown\-offset\fR\&\f(CW\ \fR\ |
| 502 |
.TQ |
| 503 |
\&\fR\&\f(CW\-\-spindown_offset\ \fI\ spindown\-offset\fR\&\f(CW\fR |
| 504 |
Set the spindown offset of this floppy drive. This parameter is used |
| 505 |
to set the position in which the disk stops. This is useful to |
| 506 |
minimize the next access time. (If the first sector is just near the |
| 507 |
head at the very moment at which the disk has reached enough speed, |
| 508 |
you win 200 milliseconds against the most unfavorable situation). |
| 509 |
.IP |
| 510 |
This is done by clocking the time where the first I/O request |
| 511 |
completes, and using this time to calculate the current position of |
| 512 |
the disk. |
| 513 |
.TP |
| 514 |
\&\fR\&\f(CW\-s\ \fIselect\-delay\fR\&\f(CW\ \fR\ |
| 515 |
.TQ |
| 516 |
\&\fR\&\f(CW\-\-select_delay\ \fI\ select\-delay\fR\&\f(CW\fR |
| 517 |
Set the \fIselect delay\fR of this floppy drive. This is the delay that |
| 518 |
the driver waits after selecting the drive and issuing the first command |
| 519 |
to it. For modern controllers/drives, you may set this to zero. |
| 520 |
.TP |
| 521 |
\&\fR\&\f(CW\-C\ \fIcheck\-interval\fR\&\f(CW\ \fR\ |
| 522 |
.TQ |
| 523 |
\&\fR\&\f(CW\-\-checkfreq\ \fI\ check\-interval\fR\&\f(CW\fR |
| 524 |
Set the maximal disk change check interval. The disk change line is |
| 525 |
checked whenever a read or write to the device is issued, and it has not |
| 526 |
been checked for more than \fIinterval\fR jiffies. |
| 527 |
.PP |
| 528 |
.SH Debugging\ messages |
| 529 |
.PP |
| 530 |
This subsection describes how to switch the available debugging messages |
| 531 |
on and off. |
| 532 |
.IP |
| 533 |
.TP |
| 534 |
\&\fR\&\f(CW\-\-debug\fR\ |
| 535 |
Switch debugging output on. The debugging information includes timing |
| 536 |
information. This option might be useful to fine-tune the timing |
| 537 |
options for your local setups. (But for most normal purposes, the |
| 538 |
default values are good enough.) |
| 539 |
.TP |
| 540 |
\&\fR\&\f(CW\-\-nodebug\fR\ |
| 541 |
Switch debugging output off. |
| 542 |
.TP |
| 543 |
\&\fR\&\f(CW\-\-messages\fR\ |
| 544 |
Print informational messages after autodetection, geometry parameter |
| 545 |
clearing and dma over/underruns. |
| 546 |
.TP |
| 547 |
\&\fR\&\f(CW\-\-nomessages\fR\ |
| 548 |
Don't print informational messages after these events. |
| 549 |
.PP |
| 550 |
.SH Error\ Handling\ Options |
| 551 |
.PP |
| 552 |
The following options configure the behavior of the floppy driver in |
| 553 |
case of read/write errors. They may be used by any user who has write |
| 554 |
privileges for the drive. Whenever the floppy driver encounters an |
| 555 |
error, a retry counter is incremented. If the value of this counter gets |
| 556 |
bigger than the thresholds described below, the corresponding actions |
| 557 |
are performed at the next retry. The counter is reset when the read or |
| 558 |
write finally terminates, whether successfully or not. |
| 559 |
.TP |
| 560 |
\&\fR\&\f(CW\-a\ \fIoperation\-abort\-threshold\fR\&\f(CW\ \fR\ |
| 561 |
.TQ |
| 562 |
\&\fR\&\f(CW\-\-abort\ \fI\ operation\-abort\-threshold\fR\&\f(CW\fR |
| 563 |
Tell the floppy driver to stop trying to read/write a sector after |
| 564 |
\&\fIoperation-abort-threshold\fR |
| 565 |
retries, and signal the I/O error to the user. |
| 566 |
.TP |
| 567 |
\&\fR\&\f(CW\-t\ \fIread\-track\-threshold\fR\&\f(CW\ \fR\ |
| 568 |
.TQ |
| 569 |
\&\fR\&\f(CW\-\-readtrack\ \fI\ read\-track\-threshold\fR\&\f(CW\fR |
| 570 |
Tell the floppy driver to switch from track-reading mode to |
| 571 |
sector-at-a-time-mode after |
| 572 |
\&\fIread-track-threshold\fR |
| 573 |
retries. |
| 574 |
.TP |
| 575 |
\&\fR\&\f(CW\-r\ \fIrecalibrate\-threshold\fR\&\f(CW\ \fR\ |
| 576 |
.TQ |
| 577 |
\&\fR\&\f(CW\-\-recalibrate\ \fI\ recalibrate\-threshold\fR\&\f(CW\fR |
| 578 |
Tell the floppy driver to recalibrate the drive after |
| 579 |
\&\fIrecalibrate-threshold\fR retries. |
| 580 |
.TP |
| 581 |
\&\fR\&\f(CW\-R\ \fIreset\-threshold\fR\&\f(CW\ \fR\ |
| 582 |
.TQ |
| 583 |
\&\fR\&\f(CW\-\-reset\ \fI\ reset\-threshold\fR\&\f(CW\fR |
| 584 |
Tell the floppy driver to reset the controller after |
| 585 |
\&\fIreset-threshold\fR retries. After a controller reset, the floppy |
| 586 |
driver also recalibrates all drives connected to that controller. |
| 587 |
.IP |
| 588 |
.TP |
| 589 |
\&\fR\&\f(CW\-e\ \fIerror\-report\-threshold\fR\&\f(CW\ \fR\ |
| 590 |
.TQ |
| 591 |
\&\fR\&\f(CW\-\-reporting\ \fI\ error\-report\-threshold\fR\&\f(CW\fR |
| 592 |
Tell the floppy driver to start printing error messages to the console |
| 593 |
after \fIerror-report-threshold\fR retries. |
| 594 |
.PP |
| 595 |
.SH Write\ error\ reporting |
| 596 |
.PP |
| 597 |
Due to the buffer cache, write errors cannot always be reported to the |
| 598 |
writing user program as soon as the write system call returns. Indeed, |
| 599 |
the actual writing may take place much later. If a write error is |
| 600 |
encountered, the floppy driver stores information about it in its per |
| 601 |
drive write error structure. This write error structure stays until |
| 602 |
explicitly cleared. It can for example be queried by a backup program |
| 603 |
which wants to make sure that the data has been written successfully. |
| 604 |
.IP |
| 605 |
.TP |
| 606 |
\&\fR\&\f(CW\-\-clrwerror\fR\ |
| 607 |
Clears the write error structure. |
| 608 |
.TP |
| 609 |
\&\fR\&\f(CW\-\-printwerror\fR\ |
| 610 |
Prints the contents of the write error structure: |
| 611 |
.RS |
| 612 |
.TP |
| 613 |
\&\fR\&\f(CWwrite_errors\fR\ |
| 614 |
is a count of how many write errors have occurred since the structure was last |
| 615 |
cleared. |
| 616 |
.TP |
| 617 |
\&\fR\&\f(CWbadness\fR\ |
| 618 |
is the maximal number of retries that were needed to complete an |
| 619 |
operation (reads, writes and formats). |
| 620 |
.TP |
| 621 |
\&\fR\&\f(CWfirst_error_sector\fR\ |
| 622 |
is where the first (chronologically) write error occurred. |
| 623 |
.TP |
| 624 |
\&\fR\&\f(CWfirst_error_generation\fR\ |
| 625 |
is the disk change generation in which did the first write error |
| 626 |
occurred. The disk change generation is a number which is incremented |
| 627 |
at each disk change. |
| 628 |
.TP |
| 629 |
\&\fR\&\f(CWlast_error_sector\fR\ |
| 630 |
and |
| 631 |
.TP |
| 632 |
\&\fR\&\f(CWlast_error_generation\fR\ |
| 633 |
are similar. |
| 634 |
.RE |
| 635 |
.PP |
| 636 |
.SH Other\ drive\ configuration\ options |
| 637 |
.PP |
| 638 |
This subsection lists per drive configuration options, which don't fit |
| 639 |
in any other category. They are available only to the superuser: |
| 640 |
.IP |
| 641 |
.TP |
| 642 |
\&\fR\&\f(CW\-\-tracks\ \fI\ max\-tracks\fR\&\f(CW\fR\ |
| 643 |
Set the maximal numbers of physical tracks that this drive may |
| 644 |
handle. If you have a drive which is only able to handle 80 tracks |
| 645 |
(making strange noises when you try to format or read a disk with more |
| 646 |
than 80 tracks), use this option to prevent unprivileged users of |
| 647 |
damaging your drive by repeatedly reading disks with more than 80 |
| 648 |
tracks. |
| 649 |
.IP |
| 650 |
If you trust your users and your disks, you don't need this. With most |
| 651 |
drives you don't need to worry anyways. See section More cylinders, for |
| 652 |
details. |
| 653 |
.TP |
| 654 |
\&\fR\&\f(CW\-i\ \fIsector\-interleave\fR\&\f(CW\ \fR\ |
| 655 |
.TQ |
| 656 |
\&\fR\&\f(CW\-\-interleave\ \fIsector\-interleave\fR\&\f(CW\fR |
| 657 |
Set the number of sectors beyond which sector interleaving will be used. |
| 658 |
This option will only be used by the \fR\&\f(CWFDFMTTRK\fR ioctl. The |
| 659 |
\&\fR\&\f(CWfdformat\fR command, which is now considered obsolete, uses |
| 660 |
\&\fR\&\f(CWFDFMTTRK\fR ioctl, but \fR\&\f(CWsuperformat\fR does not. |
| 661 |
.IP |
| 662 |
.SH See Also |
| 663 |
Fdutils' texinfo doc |