Debian Codegraph @

upstream/debian-unstable/man1/floppymeter.1

raw
1 .TH floppymeter 1 "27Jan21" fdutils-5.6
2 .SH Name
3 floppymeter - measure raw capacity and exact rotation speed of floppy drive
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(CWfloppymeter [\fR\&\f(CW\-f] [\fR\&\f(CW\-w \fIwarmup\-delay\fR\&\f(CW] [\fR\&\f(CW\-W \fIwindow\fR\&\f(CW]
76 [\fR\&\f(CW\-c \fIcycles\fR\&\f(CW] [\fR\&\f(CW\-h] \fIdrive\fR\&\f(CW
77 .fi
78 .in -0.3i
79 .ft R
80
81 \&\fR
82 .PP
83 The \fR\&\f(CWfloppymeter\fR program measures characteristic parameters of a
84 floppy drive and floppy controller, such as the rotation speed of the
85 drive, the data transfer rate of the controller, and the resulting raw
86 capacity of a disk track. To use this program, insert a disposable
87 floppy in the drive, and type \fR\&\f(CWfloppymeter \-\-\fR\fIdensity\fR, where
88 density describes the density of the disk used for the test. (Should be
89 one of \fR\&\f(CWdd, hd\fR or \fR\&\f(CWed\fR). \fBCAUTION: the data on the
90 disk will be erased\fR. This program should be used to verify whether the
91 drive and controller are out of tolerance if you experience problems
92 with some high capacity formats. It only needs to be run once per
93 drive: although a disk is needed to perform the measurements, the
94 measured data only depend on the drive and the controller, and not on
95 the disk.
96 .PP
97 To measure the raw capacity of the disk track, the floppymeter program
98 formats the first track of the drive in a special way that allows it to
99 read the raw data (gaps and headers) of the disk. \fBThus, all data
100 previously stored on that disk is lost\fR.
101 .PP
102 The rotation speed is measured by timing the return time of a
103 \&\fR\&\f(CWreadid\fR command. In order to gain more precision, the command is
104 issued many times in a row. During this phase, the number of rotations
105 since the start of the test, the average time per rotation since the start,
106 and a sliding average of the times of the last 30 rotations is printed,
107 and updated continuously.
108 .PP
109 The data transfer rate is deduced from the two parameters above.
110 .PP
111 At the end of the program, all parameters (raw capacity, duration of one
112 rotation, and data transfer rate) are printed again, as well as their
113 relative deviation to the standard value. Finally, it suggests a
114 capacity deviation description line, which can be directly pasted into
115 the drive definition file (See section Drive descriptions.).
116 .PP
117 Usually, the data transfer rate should not deviate more than 150 ppm
118 from the expected value, and the rotation speed of the drive should not
119 deviate more than 3000 ppm from the expected value. If these deviations
120 are bigger, you may get problems with certain high capacity formats.
121 .PP
122 If the raw capacity of the drive is too small, some high capacity
123 formats may become unformattable on this drive/controller combo.
124 .PP
125 If on the other hand, the raw capacity of the drive is too big, you may
126 get problems when writing to a disk formatted by this drive on another
127 drive with a smaller raw capacity. In order to avoid this, increase
128 superformats gap parameter (\fR\&\f(CW\-G\fR).
129 .IP
130 .TP
131 \&\fR\&\f(CW\-h\fR\
132 Prints a short help
133 .TP
134 \&\fR\&\f(CW\-\-dd\fR\
135 Tells the program that we use a Double Density disk.
136 .TP
137 \&\fR\&\f(CW\-\-hd\fR\
138 Tells the program that we use a High Density disk.
139 .TP
140 \&\fR\&\f(CW\-\-ed\fR\
141 Tells the program that we use an Extra Density disk.
142 .TP
143 \&\fR\&\f(CW\-f\fR\
144 Runs the measurement non interactively. With this option, the program
145 doesn't ask for confirmation, and doesn't display the continuously
146 updated values during the rotation speed measurement.
147 .TP
148 \&\fR\&\f(CW\-W\ \fIWindow\fR\&\f(CW\fR\
149 This value describes how many rotations are used for the computation of
150 the sliding average. Default is 30.
151 .TP
152 \&\fR\&\f(CW\-c\ \fIcycles\fR\&\f(CW\fR\
153 Describes the number of rotations clocked during the rotations speed
154 determination test. Default is 1000.
155 .PP
156 .SH Bugs
157 .PP
158 This program is quite new, and may have bugs. Here are a few suggested
159 tests to check its sanity:
160 .TP
161 * \ \
162 The deviation of the data transfer rate solely depends on the
163 controller. It should not be different between two drives connected to
164 the same controller. However, the drive rotation speed may be different
165 for different drives.
166 .TP
167 * \ \
168 All data transfer rates (for double, high and extra density) are derived
169 from a same master frequency. Thus the \fIdeviation\fR of the data
170 transfer rate should be independent of the density used.
171 .SH See Also
172 Fdutils' texinfo doc