95
95
Watchpoints are triggered by a read and/or write to an address. When
96
96
a watchpoint is triggered, the monitor is entered.
98
<DT><SAMP>`memmap'</SAMP>
100
The memmap keeps track of RAM/ROM/IO read/write/execute
101
accesses. The feature must be enabled with "--enable-memmap"
102
configure option, as it might decrease performance notably on
103
slower hardware. The option also enables CPU history.
98
105
<DT><SAMP>`<...>'</SAMP>
114
<H2><A NAME="SEC138" HREF="vice_toc.html#TOC138">9.2 Machine state commands</A></H2>
121
<H2><A NAME="SEC148" HREF="vice_toc.html#TOC148">9.2 Machine state commands</A></H2>
125
<DT><CODE>backtrace</CODE>
127
Print JSR call chain (most recent call first). Stack offset
128
relative to SP+1 is printed in parentheses. This is a best guess
131
<DT><CODE>cpuhistory [<count>]</CODE>
133
Show <count> last executed commands.
134
(disabled by default; configure with --enable-memmap to enable)
118
136
<DT><CODE>goto <address></CODE>
120
138
Change the PC to address and continue execution.
133
151
Assign respective registers. With no parameters, display register
154
<DT><CODE>reset [<type>]</CODE>
156
Reset the machine or drive.
157
<CODE>type</CODE>: 0 = soft, 1 = hard, 8-11 = drive.
136
159
<DT><CODE>return</CODE>
138
161
Continues execution and returns to the monitor just
180
203
Hunt memory in the specified address range for the data in
181
204
<data_list>. If the data is found, the starting address of the match
182
205
is displayed. The entire range is searched for all possible matches.
206
The data list may have `xx' as a wildcard.
184
208
<DT><CODE>i <address_opt_range></CODE>
186
210
Display memory contents as PETSCII text.
212
<DT><CODE>ii <address_opt_range></CODE>
214
Display memory contents as screen code text
188
216
<DT><CODE>m [<data_type>] [<address_opt_range>]</CODE>
190
218
Display the contents of memory. If no datatype is given, the default
192
220
displayed is based on the datatype. If no addresses are given, the
193
221
'dot' address is used.
223
<DT><CODE>memmapshow [<mask>] [<address_opt_range>]</CODE>
225
Show the memmap. The mask can be specified to show only those
226
locations with accesses of certain type(s). The mask is a number
227
with the bits "ioRWXrwx", where RWX are for ROM and rwx for RAM.
228
Optionally, an address range can be specified.
229
(disabled by default; configure with --enable-memmap to enable)
231
<DT><CODE>memmapzap</CODE>
234
(disabled by default; configure with --enable-memmap to enable)
236
<DT><CODE>memmapsave "<filename>" <format></CODE>
238
Save the memmap as a picture. <CODE>format</CODE>:
239
0 = BMP, 1 = PCX, 2 = PNG, 3 = GIF, 4 = IFF.
240
(disabled by default; configure with --enable-memmap to enable)
195
242
<DT><CODE>mc [<data_type>] [<address_opt_range>]</CODE>
197
244
Display the contents of memory as character data. If only one address
326
373
Set the default memory device to either the computer (<CODE>c:</CODE>) or
327
374
the disk (<CODE>d:</CODE>).
376
<DT><CODE>dir [<directory>]</CODE>
378
Display the directory contents.
382
Show current working directory.
329
384
<DT><CODE>radix [H|D|O|B]</CODE>
331
386
Set the default radix to hex, decimal, octal, or binary. With no
350
<H2><A NAME="SEC143" HREF="vice_toc.html#TOC143">9.7 Disk commands</A></H2>
405
<H2><A NAME="SEC153" HREF="vice_toc.html#TOC153">9.7 Disk commands</A></H2>
409
<DT><CODE>attach <filename> <device></CODE>
411
Attach file to device. (device 32 = cart)
354
413
<DT><CODE>br <track> <sector> [<address>]</CODE>
356
415
Read the block at the specified track and sector. If an address is
362
421
Write a block of data at <CODE>address</CODE> to the specified track and
363
422
sector of disk in drive 8.
424
<DT><CODE>detach <device></CODE>
426
Detach file from device. (device 32 = cart)
365
428
<DT><CODE>@<disk command></CODE>
367
430
Perform a disk command on the currently attached disk image on drive
375
438
address and the first two bytes read from the file are skipped. If
376
439
device is 0, the file is read from the file system.
441
<DT><CODE>bload "<filename>" <device> <address></CODE>
443
Load the specified file into memory at the specified address.
444
If device is 0, the file is read from the file system.
378
446
<DT><CODE>save "<filename>" <device> <address1> <address2></CODE>
380
Save the memory from address1 to address2 to the specified file. If
381
device is 0, the file is written to the file system.
448
Save the memory from address1 to address2 to the specified file.
449
Write two-byte load address.
450
If device is 0, the file is written to the file system.
452
<DT><CODE>bsave "<filename>" <device> <address1> <address2></CODE>
454
Save the memory from address1 to address2 to the specified file.
455
If device is 0, the file is written to the file system.
387
<H2><A NAME="SEC144" HREF="vice_toc.html#TOC144">9.8 Command file commands</A></H2>
461
<H2><A NAME="SEC154" HREF="vice_toc.html#TOC154">9.8 Command file commands</A></H2>
425
499
Load a file containing a mapping of labels to addresses. If no memory
426
500
space is specified, the default readspace is used.
502
The file must contain commands the monitor understands, e.g. add_label. The
503
compiler cc65 can create such label files.
505
Vice can also load label files created by the Acme assembler. Their syntax is
506
e.g. "labelname = $1234 ; Maybe a comment". A dot will be added automatically
507
to label names assigned in this way to fit to the Vice label syntax. Normally
508
the semicolon seperates commands but after an assignment of this kind it may be
509
used to start a comment to end of line, so unchanged Acme label files can be
428
512
<DT><CODE>save_labels [<memspace>] "<filename>"</CODE>
430
514
Save labels to a file. If no memory space is specified, all of the
442
<H2><A NAME="SEC146" HREF="vice_toc.html#TOC146">9.10 Miscellaneous commands</A></H2>
526
<H2><A NAME="SEC156" HREF="vice_toc.html#TOC156">9.10 Miscellaneous commands</A></H2>
530
<DT><CODE>cartfreeze</CODE>
532
Use cartridge freeze.
446
534
<DT><CODE>exit</CODE>
448
536
Leave the monitor and return to execution.
538
<DT><CODE>help [<command>]</CODE>
540
If no argument is given, prints out a list of all available commands.
541
If an argument is given, prints out specific help for that command.
450
543
<DT><CODE>print <expression></CODE>
452
545
Evaluate the specified expression and output the result.
547
<DT><CODE>resourceget "<resource>"</CODE>
549
Displays the value of the <CODE>resource</CODE>.
551
<DT><CODE>resourceset "<resource>" "<value>"</CODE>
553
Sets the value of the <CODE>resource</CODE>.
555
<DT><CODE>screenshot "<filename>" [<format>]</CODE>
557
Take a screenshot. <CODE>format</CODE>:
558
default = BMP, 1 = PCX, 2 = PNG, 3 = GIF, 4 = IFF.
560
<DT><CODE>tapectrl <command></CODE>
562
Control the datasette. <CODE>command</CODE>:
563
0 = stop, 1 = start, 2 = forward, 3 = rewind, 4 = record,
564
5 = reset, 6 = reset counter.
454
566
<DT><CODE>quit</CODE>
456
568
Exit the emulator immediately.