Next Previous Contents

2.3 d64copy

Synopsis: d64copy [OPTION]... SOURCE TARGET

d64copy is a fast disk image transfer (both read and write) program for the 1541 and compatible devices (1570, 1571, third-party clones). Maximum transfer speed is achieved by custom drive- and transfer-routines based on the Star Commander ((C) Joe Forster/STA) routines.

d64copy invocation

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:

-h, --help

Display help and exit

-V, --version

Display version information and exit.

-q, --quiet

Quiet output, fewer messages (also suppresses warnings, should not be used)

-v, --verbose

Verbose output, more messages (can be repeated)

-n, --no-progress

Omit progress display

-s, --start-track=start track

Set start track (defaults to 1)

-e, --end-track=end track

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.

-t, --transfer=transfer mode

Set transfermode. Valid modes are:

original and serial1 should work in any case. serial2 won't work with more than one device is connected to the IEC bus, parallel requires a XP1541/XP1571 cable

-i, --interleave=interleave

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
Lower values might slightly reduce transfer times, but if set a bit to low, transfer times will dramatically increase.

-w, --warp

Enable warp mode. this is not possible when transfer mode is set to original. 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.

-b, --bam-only

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.

-B, --bam-save

Save BAM-only copy. this is like the -b option but always copies the entire directory track (18, 18 and 53 in double-sided mode).

-d, --drive-type=type

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

-2, --two-sided

Double-sided mode for copying .d71 images to/from a 1571 drive. Warp mode is not supported (yet).

-r, --retry-count=count

Number of retries.

-E, --error-mode=mode

Controls whether error is appended to the disk image (15x1->PC only). Allowed values for mode are (abbreviations allowed):

Next Previous Contents