dsktrans - Copy from one floppy or image file to another

       John Elliott <seasip.webmaster@gmail.com>.

       Darren Salt wrote the man pages.

Version 1.5.9                                   17 September 2018                                    dsktrans(1)

       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.

       dsktrans - Copy from one floppy or image file to another

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

       -otypeTYPE
              Determines  which  driver  is  to be used to write to the destination disc. The drivers are as for
              -itype.

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

       -ocompCOMP
              Select  the  compression  to be used on output. Compression methods are as for -icomp, except that
              bz2 cannot be used.

       -isideSIDE
              Determines which side (0 or 1) of the source disc is to be read from.

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

       -retryCOUNT
              Set the number of times to attempt a read/write/format in case of error.

       -formatFMT
              Do not autodetect the disc format; use the named format.

       -firstCYL
              Start copying at the specified cylinder. Cylinders prior to this will not be formatted or written.

       -lastCYL
              Copy up to and including the specified cylinder.

       -commentTEXT
              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.
              NotethatthisistheoppositeofwhatthisoptiondidinLibDsk1.1.9andearlier.-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.

dskconv(1), dskdump(1)

dsktrans  [-itypeTYPE]  [-otypeTYPE] [-isideSIDE] [-osideSIDE] [-icompCOMP] [-ocompCOMP] [-idstep]
       [-odstep] [-retryCOUNT] [-formatFMT] [-firstCYLINDER]  [-lastCYLINDER]  [-commentTEXT]  [-comment@FILE] [-md3] [-logical] [-apricot] [-pcdos] [-noformat] INPUT-IMAGEOUTPUT-IMAGE