7.8 cbmcopy

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 invocation

Synopsis: 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:

-h, --help

Display help and exit

-V, --version

Display version information and exit.

-@, --adapter=<plugin>[:<bus>]

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.

-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

-r, --read

Operate in read-mode, i.e. read data from an external device. Starting cbmcopy as cbmread has the same effect.

-w, --write

Operate in write-mode, i.e. send files to an external device. Starting cbmcopy as cbmwrite has the same effect.

-t, --transfer=transfer mode

Set transfermode. Valid modes are:

• auto (default)
• serial1 (slowest)
• serial2
• parallel (fastest, not possible with a 1581)

serial1 should work in any case. serial2 won't work with more than one device connected to the IEC bus, parallel requires a XP1541/XP1571 cable in addition to the XM/XA1541. If auto is 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.

-d, --drive-type=type

Skip drive type detection. Valid types are 1541, 1570, 1571 and 1581.

-o, --output=name

Specifies target name. ASCII/PetSCII conversion is performed when in write-mode.

-a, --address=address

Overrides the file's first two bytes with address.

-R, --raw

Skip file type detection. File data is sent as is. This option is only valid in write-mode.

-f, --file-type=type

Specifies/overrides file type. Supported types are P, S, D, U. 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.

cbmcopy Examples

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