imgcopy is a fast disk image transfer (both read and write) program for various CBM disk drives, namely, VIC 1540, 1541, 1570, 1571, 1581, 2031, 2040, 3040, 4031, 4040, 8050, 8250, and SFD 1001.
See also d64copy and d82copy.
imgcopy [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 image file.
The extension of the image file determines the default Imagefiletype (.d64, .d71, .d80, .d81, .d82)
.d641540, 1541, 1570, 1571 (single-sided) or 2031 image
.d711571 image (double-sided)
.d808050 image (single-sided)
.d828250 or 1001 image (double-sided)
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 depends upon the file image type).
Set transfermode. Valid modes are:
Not all modes are supported with all drives!
auto is used, imgcopy 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. The default depends upon the file image type.
Lower values might slightly reduce transfer times, but if set a bit to low, transfer times will dramatically increase.
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.
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).
Skip drive type detection. Possible values are:
Single-sided mode (D80).
Double-sided mode (D82); requires a VIC 8250 or SFD 1001 drive.
Number of retries.
Controls whether error is appended to the disk image (15x1->PC only).
Allowed values for
mode are (abbreviations allowed):