Debian Codegraph @

upstream/debian-unstable/man1/xdfcopy.1

raw
1 .TH xdfcopy 1 "27Jan21" fdutils-5.6
2 .SH Name
3 xdfcopy - copy and format XDF disks in Linux
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(CWxdfcopy [\fR\&\f(CW\-\fIformat\-id\fR\&\f(CW] [\fR\&\f(CW\-d] [\fR\&\f(CW\-n] [\fR\&\f(CW\-h \fIhead\-skew\fR\&\f(CW] [\fR\&\f(CW\-t \fIcylinder\-skew\fR\&\f(CW] [\fR\&\f(CW\-T
76 \&\fIend\-cylinder\fR\&\f(CW] [\fIsource\fR\&\f(CW] \fItarget\fR\&\f(CW
77 .fi
78 .in -0.3i
79 .ft R
80
81 \&\fR
82 .PP
83 \&\fR\&\f(CWXdfcopy\fR is a utility to copy and format XDF disks. XDF (eXtended
84 Density Format) is a format used by OS/2 which can hold 1840KB of data
85 (on a 3 1/2 high density disk). Its advantage over 2m formats is that it
86 is faster: 38KB/s. Because of this fast speed, I extended the XDF
87 standard to higher capacities (1992KB) with a transfer rate of 45KB/s. I
88 called the new formats XXDF.
89 .PP
90 This program works best with kernels newer than 2.0.0.
91 .PP
92 If both source and target are given, xdfcopy copies the disk image from
93 file to floppy disk or vice-versa. When copying to a floppy disk, the
94 disk is first formatted, unless the \fR\&\f(CW\-n\fR option is given.
95 .PP
96 If no source is given, the target is only formatted. In this case, the
97 target must be a floppy drive.
98 .PP
99 .SH Options
100 .PP
101 .SS Selecting\ a\ format
102 .PP
103 Formats are selected by the format_id. The following formats are understood:
104 .IP
105 .TP
106 \&\fR\&\f(CW0\fR\
107 Formats a 5 1/4 XDF disk (1520 KB, 45.6 KB/s).
108 .TP
109 \&\fR\&\f(CW1\fR\
110 Formats a 3 1/2 high density XDF disk (1840 KB, 38.3 KB/s).
111 .TP
112 \&\fR\&\f(CW2\fR\
113 Formats a 3 1/2 extra density XDF disk (3680 KB, 102 KB/s)
114 .TP
115 \&\fR\&\f(CW3\fR\
116 Formats a 3 1/2 high density XXDF disk (1920 KB, 45 KB/s)
117 .TP
118 \&\fR\&\f(CW4\fR\
119 Formats a 3 1/2 extra density XXDF disk (3840 KB, 90 KB/s)
120 .PP
121 .SH Misc\ options
122 .TP
123 \&\fR\&\f(CW\-D\ \fIdosdrive\fR\&\f(CW\fR\
124 Describes the DOS drive letter for mformat. If this option is given, an
125 MS-DOS filesystem is automatically installed on the disk after the
126 low-level format is complete. In order for this to work, the drive has
127 to be configured to accept the 23x2x80 geometry in your /etc/mtools or
128 your ~/.mtoolsrc file. Moreover, this only works with a version of
129 mtools that is more recent than 3.0.
130 .IP
131 Example of a working mtoolsrc line:
132
133 .nf
134 .ft 3
135 .in +0.3i
136 A /dev/fd0 0 0 0 0
137 .fi
138 .in -0.3i
139 .ft R
140
141 \&\fR
142 .IP
143 Examples of a non-working mtoolsrc line:
144
145 .nf
146 .ft 3
147 .in +0.3i
148 A /dev/fd0 12 80 2 18
149 .fi
150 .in -0.3i
151 .ft R
152
153 \&\fR
154 .TP
155 \&\fR\&\f(CW\-n\fR\
156 Don't format the disk before copying the disk image to the disk.
157 .PP
158 .SH Options\ for\ power\ users
159 .IP
160 .TP
161 \&\fR\&\f(CW\-t\ \fIcylinder\ skew\fR\&\f(CW\fR\
162 Uses a different track skew than the default (14). For more details on
163 skews, see section superformat. In this version of xdfcopy, the \fR\&\f(CW\-t\fR
164 parameter is ignored.
165 .TP
166 \&\fR\&\f(CW\-h\ \fIhead\ skew\fR\&\f(CW\fR\
167 Uses a different head skew than the default (0) In this version, this
168 parameter is ignored
169 .TP
170 \&\fR\&\f(CW\-d\fR\
171 Debugging. For each read or write operation, the time it took to
172 complete the operation is printed (in milliseconds). This can be used
173 to optimize the skews.
174 .TP
175 \&\fR\&\f(CW\-T\ \fIend\-cylinders\fR\&\f(CW\fR\
176 Tells how many cylinders to format. With the XXDF formats, it is
177 actually possible to format up to 83 cylinders, yielding a format of
178 up to 1992KB on a 3 1/2 high density disk.
179 .IP
180 .SH See Also
181 Fdutils' texinfo doc