1dsktrans(1) Emulators dsktrans(1)
2
6 dsktrans - Copy from one floppy or image file to another
7
9 dsktrans [-itype TYPE] [-otype TYPE] [-iside SIDE] [-oside SIDE]
10 [-icomp COMP] [-ocomp COMP] [-idstep] [-odstep] [-retry COUNT] [-format
11 FMT] [-first CYLINDER] [-last CYLINDER] [-comment TEXT] [-comment
12 @FILE] [-md3] [-logical] [-apricot] [-pcdos] [-noformat] INPUT-IMAGE
13 OUTPUT-IMAGE
15 Dsktrans copies floppy discs or images, optionally converting image
16 types. This is a high-level copy which assumes that the disc has a
17 straightforward geometry; all the tracks are assumed to have the same
18 layout of sectors, and interleave is not preserved. See dskdump(1) for
19 a slower but more accurate copy which may preserve more of these
20 details.
21
23 -itype TYPE
24 Determines which driver is to be used to read from the source
25 disc. Some examples are:
26 auto Select according to the disc image file. This is the
28 default.
29 dsk Use the DSK (CPCEmu format) image driver.
31 edsk Use the extended version of the DSK format.
33 floppy Use the floppy driver.
35 ntwdm (Under Windows 2000 and later) Use Simon Owen's FDRAWCMD
37 floppy driver.
38 myz80 Use the hard disk (MYZ80 format) image driver. (This
40 format cannot be autodetected.)
41 cfi Use the CFI (DOS fdcopy format) image driver. (This
43 format cannot be autodetected.)
44 apridisk
46 Use the ApriDisk image driver (from the utility of the
47 same name). (This format cannot be autodetected.)
48 raw Use the raw driver.
50 logical Similar to the raw driver, but the resulting disc image
52 contains tracks laid out in logical filesystem order.
53 Mainly used for imaging discs in formats (such as ADFS)
54 where the mapping of tracks to cylinders/heads does not
55 match the way it's done on the PC.
56 qm Sydex's CopyQM format (can only be read, not written).
58 tele Sydex's Teledisk format (can only be read, not written).
60 -otype TYPE
63 Determines which driver is to be used to write to the destina‐
64 tion disc. The drivers are as for -itype.
65 -icomp COMP
68 Select the compression method used on the source disc image file
69 (has no effect when reading a floppy disc).
70 auto Detect from the first few bytes of the file. This is the
72 default.
73 sq Huffman coded (SQ / USQ).
75 gz Gzipped (gzip / gunzip).
77 bz2 Burrows-Wheeler compressed (bzip2 / bunzip2).
79 -ocomp COMP
82 Select the compression to be used on output. Compression methods
83 are as for -icomp, except that bz2 cannot be used.
84 -iside SIDE
87 Determines which side (0 or 1) of the source disc is to be read
88 from.
89 -oside SIDE
92 Determines which side (0 or 1) of the destination disc is to be
93 written to.
94 -idstep
97 Double-step the source drive (used to read 360k discs in 1.2Mb
98 drives). Only supported by the Linux floppy driver.
99 -odstep
102 Double-step the destination drive (used to write 360k discs in
103 1.2Mb drives). Only supported by the Linux floppy driver.
104 -retry COUNT
107 Set the number of times to attempt a read/write/format in case
108 of error.
109 -format FMT
112 Do not autodetect the disc format; use the named format.
113 -first CYL
116 Start copying at the specified cylinder. Cylinders prior to this
117 will not be formatted or written.
118 -last CYL
121 Copy up to and including the specified cylinder.
122 -comment TEXT
125 Set the comment field in the disc image to the specified text
126 (if supported by the image file format).
127 -comment @FILE
130 Set the comment field in the disc image to the contents of the
131 specified disc file (if supported by the image file format). If
132 the filename is "-" (i.e. -comment @- ) then you will be asked
133 to type the comment, terminated with a "." on a line by itself.
134 -odstep
137 Double-step the destination drive (used to write 360k discs in
138 1.2Mb drives). Only supported by the Linux floppy driver.
139 -md3 Defeat MicroDesign 3 copy protection. Note that this does not
142 make dsktrans a circumvention device, since the authors of
143 MicroDesign have placed it in the public domain and given per‐
144 mission for the copy-protection to be reverse engineered; I
145 posted their original press release to USENET as
146 <1008359853.26849.0.nnrp-13.c2de7091@news.demon.co.uk>.
147 -pcdos Convert the first sector from an Apricot superblock to a PC-DOS
150 superblock. This allows Apricot-format discs to be imaged as
151 files (with the output image type as raw) and then loopback-
152 mounted under Linux.
153 -apricot
156 Reverse -pcdos, and convert the first sector from a PC-DOS
157 superblock to an Apricot superblock. Note that this is the
158 opposite of what this option did in LibDsk 1.1.9 and earlier.
159 -logical
162 Rearrange the tracks in the logical order. This option has been
163 superseded; instead you should use -otype logical to output to a
164 logically-sectored raw image.
165 -noformat
168 Don't format the target disc/image - assume it's in the correct
169 format already.
170
172 dskdump(1)
173
175 John Elliott <jce@seasip.demon.co.uk>.
176 Darren Salt wrote the man pages.
178Version 1.2.1 27 December, 2007 dsktrans(1)