Next: , Previous: , Up: c1541   [Contents][Index]


14.3 c1541 commands and options

This is a list of the c1541 commands. They are shown in their interactive form, without the leading -. Square brackets [] indicate an optional part, and "<COMMAND>" translates to a disk command according to CBM DOS, like "i0" for example.

@ [<command>]

Execute specified CBM DOS command and print the current status of the drive. If no command is specified, just print the status.

? [<command>]

Explain specified command. If no command is specified, list available ones.

attach <diskimage> [<unit>]

Attach diskimage to unit (default unit is 8).

bam [<unit>] | <track-min> <track-max> [<unit>]

Show the BAM of unit, optionally displaying only the entries for track-min to track-max

bcopy <src-trk> <src-sec> <dst-trk> <dst-sec> [<src-unit> [<dst-unit>]]

Copy a block to another block, optionally specifying different source and destination units. The block is copied using all 256 bytes.

bfill <track> <sector> <value> [<unit>]

Fill a block with a single value.

block <track> <sector> [<offset> [<unit>]]

Show specified disk block in hex form.

bpoke [@unit:<unit>] <track> <sector> <offset> <data …>

Store one or more bytes of data into a block. The data can be specified using prefixes:

0b or %

binary value (‘%11111111‘)

&

octal value (‘&377‘)

0x or $

hexadecimal value (‘$ff‘)

The <unit> is optional, and when used must use the CBM DOS notation for the unit number, for example ‘@9:‘.

bread <filename> <track> <sector> [<unit>]

Read a block from a disk image and write it to the host filesystem as filename.

bwrite <filename> <track> <sector> [<unit>]

Write data from the host filesystem using filename as input. At most 256 bytes are written to the disk image.

chain <track> <sector> [<unit>]

Show block chain starting at (track, sector). The last number shown is the number of bytes used in the final block.

copy <source1> [<source2> … <sourceN>] <destination>

Copy source1sourceN into destination. If N > 1, destination must be a simple drive specifier (@n:). To copy a REL file, specify the <source> with a ,L file type suffix.

delete <file1> [<file2> … <fileN>]

Delete the specified files.

exit

Exit (same as quit).

entry [+side] <file1> [<file2> … <fileN>]

Show the directory entries of the given files in full detail. If the +side option is present, and it is a RELative file, it also shows all side sectors.

extract

Extract all the files to the file system.

format <diskname,id> [<type> <imagename>] [<unit>]

If unit is specified, format the disk in unit unit. If type and imagename are specified, create a new image named imagename, attach it to unit 8 and format it. type is a disk image type, and must be either x64, d64 (both VC1541/2031), g64 (VC1541/2031 but in GCR coding), d71 (VC1571), g71 (VC1571 but in GCR coding), d81 (VC1581), d80 (CBM8050), d82 (CBM8250/1001), or d90 (CBM D9090). Otherwise, format the disk in the current unit, if any.

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

geoswrite <source>

Write GOES Convert file <source> from the file system on a disk image.

geosextract <source>

Extract all the files to the file system and GEOS Convert them.

help [<command>]

Explain specified command. If no command is specified, list available ones.

info [<unit>]

Display information about unit unit (if unspecified, use the current one).

list [<pattern>]
dir [<pattern>]

List files matching pattern (default is all files).

name <diskname>[,<id>] <unit>

Change image name.

p00save <enable> [<unit>]

Save P00 files to the file system.

pwd

Print current working directory.

quit

Exit (same as exit).

read <source> [<destination>]

Read source from the disk image and copy it into destination in the file system. If destination is not specified, copy it into a file with the same name as source. By default PRG files are copied. To copy SEQ files add ,s (i.e. the usual DOS file specification syntax). REL files can be copied by adding ,l. Don’t specify the record length, c1541 will determine it automatically.

rename <oldname> <newname>

Rename oldname into newname. The files must be on the same drive.

show [copying | warranty]

Show conditions for redistributing copies of C1541 (‘copying’) or the various kinds of warranty you do not have with C1541 (‘warranty’).

tape <t64name> [<file1> … <fileN>]

Extract files from a T64 image.

unit <number>

Make unit number the current unit.

unlynx <lynxname> [<unit>]

Extract the specified Lynx image file into the specified unit (default is the current unit).

validate [<unit>]

Validate the disk in unit unit. If unit is not specified, validate the disk in the current unit.

verbose ["off"]

Enable or disable verbose output.

version

Show C1541 version string

write <source> [<destination>]

Write source from the file system into destination on a disk image.

To create a REL file, you must specify the destination including the record length. As a special convenience, you can give it in decimal. Example: write fsname imgname,l,100 Note that the size of the file may be rounded up to fill the last sector.

unzip <d64name> <zipname> [<label,id>]

Create a D64 disk image out of a set of four Zipcoded files named 1!zipname, 2!zipname, 3!zipname and 4!zipname.


Next: Executing shell commands, Previous: Using quotes and backslashes, Up: c1541   [Contents][Index]