1dsktrans(1)                        Emulators                       dsktrans(1)
2
3
4

NAME

6       dsktrans - Copy from one floppy or image file to another
7

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

25       -itype TYPE
26              Determines which driver is to be used to read  from  the  source
27              disc. Some examples are:
28
29              auto    Select  according  to  the  disc image file. This is the
30                      default.
31
32              dsk     Use the DSK (CPCEmu format) image driver.
33
34              edsk    Use the extended version of the DSK format.
35
36              floppy  Use the floppy driver.
37
38              ntwdm   (Under Windows 2000 and later) Use Simon Owen's FDRAWCMD
39                      floppy driver.
40
41              myz80   Use  the  hard  disk (MYZ80 format) image driver.  (This
42                      format cannot be autodetected.)
43
44              cfi     Use the CFI (DOS fdcopy  format)  image  driver.   (This
45                      format cannot be autodetected.)
46
47              apridisk
48                      Use  the  ApriDisk image driver (from the utility of the
49                      same name).  (This format cannot be autodetected.)
50
51              raw     Use the raw driver.
52
53              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
59              qm      Sydex's CopyQM format
60
61              tele    Sydex's Teledisk format
62
63
64       -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
68
69       -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
75              auto    Detect from the first few bytes of the file. This is the
76                      default.
77
78              sq      Huffman coded (SQ / USQ).
79
80              gz      Gzipped (gzip / gunzip).
81
82              bz2     Burrows-Wheeler compressed (bzip2 / bunzip2).
83
84
85       -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
89
90       -iside SIDE
91              Determines which side (0 or 1) of the source disc is to be  read
92              from.
93
94
95       -oside SIDE
96              Determines  which side (0 or 1) of the destination disc is to be
97              written to.
98
99
100       -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
104
105       -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
109
110       -retry COUNT
111              Set the number of times to attempt a read/write/format  in  case
112              of error.
113
114
115       -format FMT
116              Do not autodetect the disc format; use the named format.
117
118
119       -first CYL
120              Start copying at the specified cylinder. Cylinders prior to this
121              will not be formatted or written.
122
123
124       -last CYL
125              Copy up to and including the specified cylinder.
126
127
128       -comment TEXT
129              Set the comment field in the disc image to  the  specified  text
130              (if supported by the image file format).
131
132
133       -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
139
140       -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
144
145       -md3   Defeat  MicroDesign  3  copy protection. Note that this does not
146              make dsktrans a  circumvention  device,  since  the  authors  of
147              MicroDesign  have  placed it in the public domain and given per‐
148              mission for the copy-protection  to  be  reverse  engineered;  I
149              posted    their    original   press   release   to   USENET   as
150              <1008359853.26849.0.nnrp-13.c2de7091@news.demon.co.uk>.
151
152
153       -pcdos Convert the first sector from an Apricot superblock to a  PC-DOS
154              superblock.   This  allows  Apricot-format discs to be imaged as
155              files (with the output image type as  raw)  and  then  loopback-
156              mounted under Linux.
157
158
159       -apricot
160              Reverse  -pcdos,  and  convert  the  first  sector from a PC-DOS
161              superblock to an Apricot superblock.   Note  that  this  is  the
162              opposite of what this option did in LibDsk 1.1.9 and earlier.
163
164
165       -logical
166              Rearrange  the tracks in the logical order. This option has been
167              superseded; instead you should use -otype logical to output to a
168              logically-sectored raw image.
169
170
171       -noformat
172              Don't  format the target disc/image - assume it's in the correct
173              format already.
174

SEE ALSO

176       dskconv(1), dskdump(1)
177

AUTHOR

179       John Elliott <seasip.webmaster@gmail.com>.
180
181       Darren Salt wrote the man pages.
182
183
184
185Version 1.5.9                  17 September 2018                   dsktrans(1)
Impressum