DragonFly On-Line Manual Pages

dsktrans(1)                        Emulators                       dsktrans(1)

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] [-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).

              teledisk
                      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.

       -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.

Version 1.2.1                  27 December, 2007                   dsktrans(1)