d64copy is a fast disk image transfer (both read and write) program for the 1541 and compatible devices (1570, 1571, third-party clones). A 1581 drive is not supported! Maximum transfer speed is achieved by custom drive- and transfer-routines based on the Star Commander ((C) Joe Forster/STA) routines.
Synopsis: d64copy [OPTION]... SOURCE TARGET
Either SOURCE or TARGET must be an external drive, valid names are 8, 9, 10 and 11. The other parameter specifies the file name of the .d64 image.
Here's a complete list of known options:
Display help and exit
Display version information and exit.
Specify the plugin to use. If you have installed more than one plugin (XA1541, XU1541, XUM1541), you can specifiy which one to use for this command. This way, you can use all three variants at the same time.
This requires an argument of the form <plugin>[:<bus>], where <plugin> is the plugin's backend name (currently: xa1541, xu1541, xum1541), and <bus> is the bus identifier, if it is supported by the backend.
Quiet output, fewer messages (also suppresses warnings, should not be used)
Verbose output, more messages (can be repeated)
Omit progress display
Set start track (defaults to 1)
Set end track (default is 35 for .d64 images, 70 for .d71 images). d64copy
is able to access tracks 1-35 in original transfer mode and 1-42 with
serial1, serial2 and parallel. The 1571 supports tracks 1-70
in double sided (.d71) mode.
Set transfermode. Valid modes are:
auto (default)original (slowest)serial1serial2parallel (fastest)original and serial1 should work in any case.
serial2 won't work with more than one device
connected to the IEC bus,
parallel requires an additional XP1541/XP1571 cable.
If auto is used, d64copy itself determines the best transfer mode usable
with the current setup, and uses that one. Thus, you will seldom want to
manually overdrive the transfer mode option.
Set interleave value. This is ignored when reading in warp mode. Default is 16
for transfer mode original, for turbo and warp write as follows:
turbo (r/w) warp (write only)
serial1 3 5
serial2 12 11
parallel 6 3
Enable warp mode. This is default now; this option is only supported for backward-compatibility with OpenCBM (cbm4linux/cbm4win) versions before 0.4.0.
Disable warp mode. Warp mode is usually a good idea for transferring disk images unless you have a very slow CPU and/or bad disk material. Warp mode sends raw GCR data over the bus, which assures data integrity on the PC side and relieves the drive's CPU. Thus, it is unlikely you will want to use that option.
BAM-only copy. Only blocks marked as allocated are copied. For extended tracks (36-40), SpeedDOS BAM format is assumed. Use with caution, at least one wide-spread directory editor tends to forget to allocate some directory blocks.
Safe BAM-only copy. This is like the -b option but always copies the
entire directory track (18, 18 and 53 in double-sided mode).
typeSkip drive type detection. 0 or 1541 specifies 1541 mode (1 MHz,
parallel cable at VIA $1800), 1 or 1571 forces 1571 mode (2 MHz,
parallel cable at CIA $4000).
Double-sided mode for copying .d71 images to/from a 1571 drive. Warp mode is not supported (yet).
countNumber of retries.
modeControls whether error is appended to the disk image (15x1->PC only).
Allowed values for mode are (abbreviations allowed):
alwayson_error (default)neverRead a D64 disk image from the floppy in drive 8 to the file image.d64, automatically selecting the fastest transfer method:
d64copy 8 image.d64
Copy the D64 disk image in image.d64 to the floppy in drive 9, automatically selecting the fastest transfer method:
d64copy image.d64 9
Copy a double-sided disk from a 1571 drive 9 to image.d71, using
serial1 transfer method and only reading the blocks which are
marked as used in the BAM:
d64copy -2 -B --transfer=serial1 9 image.d64