cbmcopy is a fast file transfer program for various disk drives, in particular the 1541, 1570, 1571 and 1581 devices. Maximum transfer speed is achieved by custom drive- and transfer-routines based on the Star Commander ((C) Joe Forster/STA) routines.
cbmcopy [OPTION]... DEVICE# FILE...
DEVICE# specifies the drive number for file copy. The remaining arguments specify the files to be sent to/read from the disk drive. This version supports Raw, PC64 (P00) and T64 files. They are recognized when sending files to the disk drive, files read from external devices are always stored as raw binary data.
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
Operate in read-mode, i.e. read data from an external device. Starting cbmcopy as cbmread has the same effect.
Operate in write-mode, i.e. send files to an external device. Starting cbmcopy as cbmwrite has the same effect.
Set transfermode. Valid modes are:
parallel(fastest, not possible with a 1581)
serial1should work in any case.
serial2won't work with more than one device connected to the IEC bus,
parallelrequires a XP1541/XP1571 cable in addition to the XM/XA1541. If
autois given, or this option is completely omitted, cbmcopy will automatically determine the fastest transfer method possible with the current setup. Thus, you will seldom want to manually overdrive the transfer mode option.
Skip drive type detection.
Valid types are
Specifies target name. ASCII/PetSCII conversion is performed when in write-mode.
Overrides the file's first two bytes with address.
Skip file type detection. File data is sent as is. This option is only valid in write-mode.
Specifies/overrides file type. Supported types are
Raw files default to
P, whereas the T64 format contains meta data
which includes the file type. For PC64 files, cbmwrite tries to guess
the file type from the file extension.
This option is only valid in write-mode.
Read a file called cbmfile from drive 8 and store its binary value into the file file.bin, automatically selecting the fastest transfer method:
cbmcopy -r 8 cbmfile -o file.bin
Write out the file file.p00 in P64 format to the disk in drive 9, using
serial1 transfer method:
cbmcopy -w 9 file.p00