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.
	       Please note that	since GEOS files are stored in ASCII,  violat-
	       ing  CBMDOS  conventions,  the  filename	should be given	in in-
	       verted case.

       -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 <>
       Bas Wassink <>

VICE				   May 2018			      C1541(1)


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

home | help