Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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]  [-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  de-
       tails.

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

	      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 destina-
	      tion 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 Mi-
	      croDesign	have placed it in the public domain and	given  permis-
	      sion  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  su-
	      perblock	to an Apricot superblock.  Note	that this is the oppo-
	      site 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 <seasip.webmaster@gmail.com>.

       Darren Salt wrote the man pages.

Version	1.2.1		       27 December, 2007		   dsktrans(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=dsktrans&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help