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)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | SEE ALSO | AUTHOR

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

home | help