c1541 - a stand alone disk image maintenance program
c1541 is a stand alone program that can be used for D64,
D71, D81, X64 and G64 disk image file maintenance. It is part of the
VICE emulator.
c1541 can be used both in interactive and batch mode. It
will start in interactive mode if no images and no options are specified or
if one image is specified; when started in interactive mode, command line
editing and command history are available.
Each command line option for use in batch mode has an interactive
mode counterpart, that is shown in parenthesis.
- -@ command
- execute CBM DOS command
- -attach image
(attach image)
- attach image for use. All consequent commands in interactive mode
will refer to this image.
- -bam [unit] |
track-min track_max [unit] (bam [unit] |
track-min track_max [unit])
- show bam bitmap of an imagem optionally specifying unit and/or a slice of
the tracks using track-min and track-max.
- -bcopy src_trk
src_sec dst_trk dst_sec [src_unit
[dst_unit]] (bcopy src_trk src_sec dst_trk
dst_sec [src_unit [dst_unit]])
- copy a block to another block. When not using the optional unit numbers,
the block is copied among the current unit. If one unit (src_unit)
is specified that unit is used for both source and destination. Using both
unit number allows copying blocks between different units.
- -bfill track
sector value [unit] (bfill track sector
value [unit])
- fill a block with a single value.
- -block track
sector [offset] [unit] (block track
sector [offset] [unit])
- show disk blocks in hex format.
- -bpoke [[@unit:]
track sector offset data (bpoke [[@unit:]
track sector offset data)
- poke data into a block. The data list should be at least a single
byte. Multiple prefixes for the data are supported: 0x/$ for hex, 0b/% for
binary, & for octal and unadorned for plain decimal.
- -bread filename
track sector [unit] (bread filename track
sector [unit])
- read a block from the disk image at (track,sector) and write
it to the host file system as filename.
- -bwrite filename
track sector [unit] (bwrite filename
track sector [unit])
- write a block from filename on the host file system to a disk image
at (track,sector).
- -chain track
sector [unit] (chain track sector
[unit])
- show block chain starting at (track,sector). The last number
shown is the number of bytes in the final block.
- -copy image
oldname1 [oldname2...] newname (copy oldname1
[oldname2...] newname)
- concatenate oldname1, oldname2... into newname on
image (can be used to copy files).
- -delete image
files... (delete files...)
- delete files from image
- -dir [pattern] (dir
[pattern])
- list directory. See the list command for details.
- extract all files from image.
- -format image
(format image 'name,id')
- format the disk image image with the specified label. image
is created if it does not exist.
- extract all the files to the file system and GEOS Convert them.
- -geosread
source [destination] (geosread source
[destination])
- read GEOS source from the disk image and copy it as a Convert file
into destination in the file system. If destination is not
specified, copy it into a file with the same name as source. Please
note that since GEOS files are stored in ASCII, violating CBMDOS
conventions, the filename should be given in inverted case.
- -geoswrite
source (geoswrite source)
- write GEOS Convert file source from the file system on a disk
image.
- -help [command]
(help)
- show help on all commands or more detailed help on a specific
command
- -info image
[unit] (info [unit])
- show information about image (format, geometry, error-block,
write-protect)
- -list [pattern]
(list)
- list directory. The optional pattern accepts the usual CBM DOS
wildcards (* and ?) and also supports file type selection
with '=X', where X is one of S, P, U or
R. Multiple sub patterns can be specified by using comma's.
- -name diskname[,id]
[unit] (name diskname[,id] [unit])
- set diskname and optionally id.
- -p00save
enable [unit] (p00save enable
[unit)
- save P00 files to the file system.
- -read image
1541name [fsname] (read 1541name
[fsname])
- extract 1541name from the disk image into fsname
(1541name by default) from image.
- -rename oldname
newname (rename oldname newname)
- rename files. The files must be on the same drive.
- -show
'copying'|'warranty' (show
'copying'|'warranty')
- show license or warranty information.
- -tape image
tapeimage [files...] (tape image tapeimage
[files...])
- transfer files from tapeimage to image (default is
all files).
- -unlynx archive
[unit] (unlynx archive [unit])
- dissolve Lynx archive.
- -validate
image (validate)
- validate mage.
- -verbose [off]
(verbose [off])
- set verbose mode. Output extra logging information, disable with
verbose off.
- -write image
fsname [1541name] (write fsname
[1541name])
- write fsname to image as 1541name (fsname by
default). (works with P00 files as well).
- -zcreate
x64name zipname [label,id] (zcreate x64name
zipname [label,id]
- create an X64 disk image from four Zipcoded files named 1!zipname
through 4!zipname.
When more than one command is specified in batch mode, all of them
are executed in the same order they have on the command line.
If you use - as a file name, it stands for stdin or
stdout.
Exit interactive mode with either exit or quit.
Teemu Rantanen <tvr@cs.hut.fi>
Ettore Perazzoli <ettore@comm2000.it>
Andreas Boose <boose@linux.rz.fh-hannover.de>
Jouko Valta <jopi@stekt.oulu.fi>
with improvements by
Olaf Seibert <rhialto@mbfys.kun.nl>
Gerhard Wesp <gwesp@cosy.sbg.ac.at>
Bas Wassink <b.wassink@ziggo.nl>