Provided by: libdsk-utils_1.5.9+dfsg-1build1_amd64 
NAME
dsktrans - Copy from one floppy or image file to another
SYNOPSIS
dsktrans [-itype TYPE] [-otype TYPE] [-iside SIDE] [-oside SIDE] [-icomp COMP] [-ocomp COMP] [-idstep]
[-odstep] [-retry COUNT] [-format FMT] [-first CYLINDER] [-last CYLINDER] [-comment TEXT] [-comment
@FILE] [-md3] [-logical] [-apricot] [-pcdos] [-noformat] INPUT-IMAGE OUTPUT-IMAGE
DESCRIPTION
Dsktrans copies floppy discs or disc images, optionally converting the image file type. This simulates
the process of copying a floppy disc (read a track, write a track). It requires that the disc or image
file has a straightforward geometry where all the tracks are have the same layout of sectors. Interleave
is not preserved. See also dskconv(1) for a conversion that can transform one disc image file format to
another and does not require a regular geometry; and dskdump(1) for a slower but more accurate copy which
may preserve more of these details.
OPTIONS
-itype TYPE
Determines which driver is to be used to read from the source disc. Some examples are:
auto Select according to the disc image file. This is the default.
dsk Use the DSK (CPCEmu format) image driver.
edsk Use the extended version of the DSK format.
floppy Use the floppy driver.
ntwdm (Under Windows 2000 and later) Use Simon Owen's FDRAWCMD floppy driver.
myz80 Use the hard disk (MYZ80 format) image driver. (This format cannot be autodetected.)
cfi Use the CFI (DOS fdcopy format) image driver. (This format cannot be autodetected.)
apridisk
Use the ApriDisk image driver (from the utility of the same name). (This format cannot be
autodetected.)
raw Use the raw driver.
logical Similar to the raw driver, but the resulting disc image contains tracks laid out in
logical filesystem order. Mainly used for imaging discs in formats (such as ADFS) where
the mapping of tracks to cylinders/heads does not match the way it's done on the PC.
qm Sydex's CopyQM format
tele Sydex's Teledisk format
-otype TYPE
Determines which driver is to be used to write to the destination disc. The drivers are as for
-itype.
-icomp COMP
Select the compression method used on the source disc image file (has no effect when reading a
floppy disc).
auto Detect from the first few bytes of the file. This is the default.
sq Huffman coded (SQ / USQ).
gz Gzipped (gzip / gunzip).
bz2 Burrows-Wheeler compressed (bzip2 / bunzip2).
-ocomp COMP
Select the compression to be used on output. Compression methods are as for -icomp, except that
bz2 cannot be used.
-iside SIDE
Determines which side (0 or 1) of the source disc is to be read from.
-oside SIDE
Determines which side (0 or 1) of the destination disc is to be written to.
-idstep
Double-step the source drive (used to read 360k discs in 1.2Mb drives). Only supported by the
Linux floppy driver.
-odstep
Double-step the destination drive (used to write 360k discs in 1.2Mb drives). Only supported by
the Linux floppy driver.
-retry COUNT
Set the number of times to attempt a read/write/format in case of error.
-format FMT
Do not autodetect the disc format; use the named format.
-first CYL
Start copying at the specified cylinder. Cylinders prior to this will not be formatted or written.
-last CYL
Copy up to and including the specified cylinder.
-comment TEXT
Set the comment field in the disc image to the specified text (if supported by the image file
format).
-comment @FILE
Set the comment field in the disc image to the contents of the specified disc file (if supported
by the image file format). If the filename is "-" (i.e. -comment @- ) then you will be asked to
type the comment, terminated with a "." on a line by itself.
-odstep
Double-step the destination drive (used to write 360k discs in 1.2Mb drives). Only supported by
the Linux floppy driver.
-md3 Defeat MicroDesign 3 copy protection. Note that this does not make dsktrans a circumvention
device, since the authors of MicroDesign have placed it in the public domain and given permission
for the copy-protection to be reverse engineered; I posted their original press release to USENET
as <1008359853.26849.0.nnrp-13.c2de7091@news.demon.co.uk>.
-pcdos Convert the first sector from an Apricot superblock to a PC-DOS superblock. This allows Apricot-
format discs to be imaged as files (with the output image type as raw) and then loopback-mounted
under Linux.
-apricot
Reverse -pcdos, and convert the first sector from a PC-DOS superblock to an Apricot superblock.
Note that this is the opposite of what this option did in LibDsk 1.1.9 and earlier.
-logical
Rearrange the tracks in the logical order. This option has been superseded; instead you should use
-otype logical to output to a logically-sectored raw image.
-noformat
Don't format the target disc/image - assume it's in the correct format already.
SEE ALSO
dskconv(1), dskdump(1)
AUTHOR
John Elliott <seasip.webmaster@gmail.com>.
Darren Salt wrote the man pages.
Version 1.5.9 17 September 2018 dsktrans(1)