dsktrans man page

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 images, optionally converting image types. This is a high-level copy which assumes that the disc has a straightforward geometry; all the tracks are assumed to have the same layout of sectors, and interleave is not preserved. See 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 (can only be read, not written).

tele

Sydex's Teledisk format (can only be read, not written).

-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

dskdump(1)

Author

John Elliott <jce@seasip.demon.co.uk>.

Darren Salt wrote the man pages.

Referenced By

apriboot(1), dskdump(1), libdskrc(5).

27 December, 2007 Version 1.2.1 Emulators