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 disc images, optionally converting the
16 image file type. This simulates the process of copying a floppy disc
17 (read a track, write a track). It requires that the disc or image file
18 has a straightforward geometry where all the tracks are have the same
19 layout of sectors. Interleave is not preserved. See also dskconv(1) for
20 a conversion that can transform one disc image file format to another
21 and does not require a regular geometry; and dskdump(1) for a slower
22 but more accurate copy which may preserve more of these details.
23
25 -itype TYPE
26 Determines which driver is to be used to read from the source
27 disc. Some examples are:
28 auto Select according to the disc image file. This is the de‐
30 fault.
31 dsk Use the DSK (CPCEmu format) image driver.
33 edsk Use the extended version of the DSK format.
35 floppy Use the floppy driver.
37 ntwdm (Under Windows 2000 and later) Use Simon Owen's FDRAWCMD
39 floppy driver.
40 myz80 Use the hard disk (MYZ80 format) image driver. (This
42 format cannot be autodetected.)
43 cfi Use the CFI (DOS fdcopy format) image driver. (This
45 format cannot be autodetected.)
46 apridisk
48 Use the ApriDisk image driver (from the utility of the
49 same name). (This format cannot be autodetected.)
50 raw Use the raw driver.
52 logical Similar to the raw driver, but the resulting disc image
54 contains tracks laid out in logical filesystem order.
55 Mainly used for imaging discs in formats (such as ADFS)
56 where the mapping of tracks to cylinders/heads does not
57 match the way it's done on the PC.
58 qm Sydex's CopyQM format
60 tele Sydex's Teledisk format
62 -otype TYPE
65 Determines which driver is to be used to write to the destina‐
66 tion disc. The drivers are as for -itype.
67 -icomp COMP
70 Select the compression method used on the source disc image file
71 (has no effect when reading a floppy disc). Use 'none' to dis‐
72 able transparent decompression of gzipped disc images (for exam‐
73 ple, the Slackware installer rootdisks).
74 auto Detect from the first few bytes of the file. This is the
76 default.
77 sq Huffman coded (SQ / USQ).
79 gz Gzipped (gzip / gunzip).
81 bz2 Burrows-Wheeler compressed (bzip2 / bunzip2).
83 -ocomp COMP
86 Select the compression to be used on output. Compression methods
87 are as for -icomp, except that bz2 cannot be used.
88 -iside SIDE
91 Determines which side (0 or 1) of the source disc is to be read
92 from.
93 -oside SIDE
96 Determines which side (0 or 1) of the destination disc is to be
97 written to.
98 -idstep
101 Double-step the source drive (used to read 360k discs in 1.2Mb
102 drives). Only supported by the Linux floppy driver.
103 -odstep
106 Double-step the destination drive (used to write 360k discs in
107 1.2Mb drives). Only supported by the Linux floppy driver.
108 -retry COUNT
111 Set the number of times to attempt a read/write/format in case
112 of error.
113 -format FMT
116 Do not autodetect the disc format; use the named format.
117 -first CYL
120 Start copying at the specified cylinder. Cylinders prior to this
121 will not be formatted or written.
122 -last CYL
125 Copy up to and including the specified cylinder.
126 -comment TEXT
129 Set the comment field in the disc image to the specified text
130 (if supported by the image file format).
131 -comment @FILE
134 Set the comment field in the disc image to the contents of the
135 specified disc file (if supported by the image file format). If
136 the filename is "-" (i.e. -comment @- ) then you will be asked
137 to type the comment, terminated with a "." on a line by itself.
138 -odstep
141 Double-step the destination drive (used to write 360k discs in
142 1.2Mb drives). Only supported by the Linux floppy driver.
143 -md3 Defeat copy protection on program discs distributed by Creative
146 Technology, such as MicroDesign 2/3, Tweak, and The Network.
147 Note that this does not make dsktrans a circumvention device,
148 since the authors of the MicroDesign family of programs have
149 placed them in the public domain and given permission for the
150 copy-protection to be reverse engineered; I posted their origi‐
151 nal press release to USENET as
152 <1008359853.26849.0.nnrp-13.c2de7091@news.demon.co.uk>.
153 -pcdos Convert the first sector from an Apricot superblock to a PC-DOS
156 superblock. This allows Apricot-format discs to be imaged as
157 files (with the output image type as raw) and then loopback-
158 mounted under Linux.
159 -apricot
162 Reverse -pcdos, and convert the first sector from a PC-DOS su‐
163 perblock to an Apricot superblock. Note that this is the oppo‐
164 site of what this option did in LibDsk 1.1.9 and earlier.
165 -logical
168 Rearrange the tracks in the logical order. This option has been
169 superseded; instead you should use -otype logical to output to a
170 logically-sectored raw image.
171 -noformat
174 Don't format the target disc/image - assume it's in the correct
175 format already.
176
178 dskconv(1), dskdump(1)
179
181 John Elliott <seasip.webmaster@gmail.com>.
182 Darren Salt wrote the man pages.
184Version 1.5.9 17 September 2018 dsktrans(1)