Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
C1541(1)		    General Commands Manual		      C1541(1)

       c1541 - a stand alone disk image	maintenance program

       c1541 [options] [image]

       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]
	       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 sin-
	       gle  byte.  Multiple  prefixes for the data are supported: 0x/$
	       for hex,	0b/% for binary, & for octal and unadorned  for	 plain

       -bread  filename	 track	sector	[unit]	(bread	filename  track	sector
	       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
	       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...]
	       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	image (extract image)
	       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.

       -geosextract source (geosextract	source)
	       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.

       -geoswrite source (geoswrite source)
	       write  GEOS  Convert file source	from the file system on	a disk

       -help [command] (help)
	       show help on all	commands or more detailed help on  a  specific

       -info image [unit] (info	[unit])
	       show  information  about	 image (format,	geometry, error-block,

       -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!zip-
	       name 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.

       VICE(1),	cartconv(1), petcat(1)

       Teemu Rantanen <>
       Ettore Perazzoli	<>
       Andreas Boose <>
       Jouko Valta <>

       with improvements by

       Olaf Seibert <>
       Gerhard Wesp <>

VICE				  March	2017			      C1541(1)


Want to link to this manual page? Use this URL:

home | help