diff options
Diffstat (limited to 'doc/mdk_mixvm.texi')
| -rw-r--r-- | doc/mdk_mixvm.texi | 64 |
1 files changed, 32 insertions, 32 deletions
diff --git a/doc/mdk_mixvm.texi b/doc/mdk_mixvm.texi index 7992567..e52790e 100644 --- a/doc/mdk_mixvm.texi +++ b/doc/mdk_mixvm.texi @@ -1,10 +1,10 @@ @c -*-texinfo-*- @c This is part of the GNU MDK Reference Manual. -@c Copyright (C) 2000, 2001, 2002 +@c Copyright (C) 2000, 2001, 2002, 2003 @c Free Software Foundation, Inc. @c See the file mdk.texi for copying conditions. -@c $Id: mdk_mixvm.texi,v 1.11 2002/04/08 00:26:37 jao Exp $ +@c $Id: mdk_mixvm.texi,v 1.12 2003/06/02 23:20:38 jao Exp $ @node mixvm, gmixvm, mixasm, Top @comment node-name, next, previous, up @@ -91,7 +91,7 @@ MIX > and waiting for your commands (@pxref{Commands}). If the optional @var{FILE} argument is given, the file @file{FILE.mix} will be loaded into the virtual machine memory before entering the interactive -mode. +mode. The first time @code{mixvm} is invoked, a directory named @file{.mdk} is created in your home directory. It contains the @code{mixvm} @@ -105,12 +105,12 @@ the @code{-q} command line option to skip this file loading: @defopt -q @defoptx --noinit Do not load the Guile initialisation file @code{~/.mdk/mixguile.scm} at -startup. +startup. @end defopt @node Commands, Devices, Invocation, mixvm @comment node-name, next, previous, up -@section Interactive commands +@section Interactive commands You can enter the interactive mode of the MIX virtual machine by simply invoking @code{mixvm} without arguments. You will then presented a shell @@ -151,7 +151,7 @@ all available commands. * Debug commands:: Debugging programs. * State commands:: Inspecting the virtual machine state. * Configuration commands:: Changing and storing mixvm settings. -* Scheme commands:: +* Scheme commands:: @end menu @node File commands, Debug commands, Commands, Commands @@ -213,7 +213,7 @@ The source file @var{file.mixal} is compiled (with debug information enabled) using @code{mixasm}. If invoked without argument, the source file for the currently loaded MIX file is recompiled. The compilation command can be set using the @code{sasm} command (@pxref{Configuration -commands}). +commands}). @end deffn @deffn {file command} pprog @@ -223,7 +223,7 @@ Print the path of the currently loaded MIX program and its source file: @example MIX > load ../samples/primes Program loaded. Start address: 3000 -MIX > pprog +MIX > pprog ../samples/primes.mix MIX > psrc /home/jao/projects/mdk/gnu/samples/primes.mixal @@ -285,7 +285,7 @@ trying to set a breakpoint at line 5, will produce the following result: @example MIX > sbp 5 Breakpoint set at line 7 -MIX > +MIX > @end example @noindent @@ -312,7 +312,7 @@ given memory address. @deffn {debug command} sbpr A | X | J | Ii @deffnx {debug command} cbpr A | X | J | Ii Sets a conditional breakpoint on the specified register change. For -instance, +instance, @example sbpr I1 @@ -340,13 +340,13 @@ contents or of the memory cell number 1000 changes. A previously set breakpoint is cleared using the @code{cbpm} command. @end deffn -@deffn {debug command} sbpo -@deffnx {debug command} cbpo +@deffn {debug command} sbpo +@deffnx {debug command} cbpo Sets/clears a conditional breakpoint on overflow toggle change. @end deffn -@deffn {debug command} sbpc -@deffnx {debug command} cbpc +@deffn {debug command} sbpc +@deffnx {debug command} cbpc Sets/clears a conditional breakpoint on comparison flag change. @end deffn @@ -392,14 +392,14 @@ command. A typical tracing session could be like this: MIX > strace on MIX > next 3000: [OUT 3002,0(2:3)] START OUT MSG(TERM) -MIXAL HELLO WORLD +MIXAL HELLO WORLD Elapsed time: 1 /Total program time: 1 (Total uptime: 1) MIX > next 3001: [HLT 0,0] HLT End of program reached at address 3002 Elapsed time: 10 /Total program time: 11 (Total uptime: 11) MIX > strace off -MIX > +MIX > @end example @noindent The executed instruction, as it was translated, is shown between square @@ -418,7 +418,7 @@ Program loaded. Start address: 3000 MIX > pline Line 5: START OUT MSG(TERM) MIX > pline 6 -Line 6: HLT +Line 6: HLT MIX > @end example @end deffn @@ -445,7 +445,7 @@ you could get the following traces: MIX > load bt Program loaded. Start address: 0 MIX > next -MIX > pbt +MIX > pbt #0 BEG in bt.mixal:2 MIX > next MIX > pbt @@ -505,7 +505,7 @@ MIX > psym S + 00 00 18 19 56 (0000075000) MIX > weval S(3:4) + 00 00 19 56 00 (0000081408) -MIX > +MIX > @end example @end deffn @@ -517,14 +517,14 @@ Computes the decimal value of the given word. @var{WORD} must be expressed as a sign (+/-) followed by five space-delimited, two-digit decimal values representing the five bytes composing the word. The reverse operation (showing the word representation of a decimal value) -can be accomplished with @code{weval}. For instance: +can be accomplished with @code{weval}. For instance: @example MIX > w2d - 01 00 00 02 02 -16777346 MIX > weval -16777346 - 01 00 00 02 02 (0016777346) -MIX > +MIX > @end example @end deffn @@ -571,10 +571,10 @@ MIX > preg rA: - 00 00 00 00 35 (0000000035) rX: + 00 00 00 15 40 (0000001000) rJ: + 00 00 (0000) -rI1: + 00 00 (0000) rI2: + 00 00 (0000) -rI3: + 00 00 (0000) rI4: + 00 00 (0000) -rI5: + 00 00 (0000) rI6: + 00 00 (0000) -MIX > +rI1: + 00 00 (0000) rI2: + 00 00 (0000) +rI3: + 00 00 (0000) rI4: + 00 00 (0000) +rI5: + 00 00 (0000) rI6: + 00 00 (0000) +MIX > @end example As you can see in the above sample, the contents is printed as the sign @@ -592,11 +592,11 @@ MAXIMU_VALUE} is stored, e.g. @example MIX > sreg I1 1000 MIX > preg I1 -rI1: + 15 40 (1000) +rI1: + 15 40 (1000) MIX > sreg I1 1000000 MIX > preg I1 -rI1: + 09 00 (0576) -MIX > +rI1: + 09 00 (0576) +MIX > @end example @end deffn @@ -612,7 +612,7 @@ toggle of the virtual machine, e.g. MIX > pflags Overflow: F Cmp: E -MIX > +MIX > @end example @noindent @@ -663,7 +663,7 @@ commands prefixed with @code{p} (@code{preg}, @code{pmem} and the like). @end deffn @deffn {config command} stime on|off -@deffnx {config command} ptime +@deffnx {config command} ptime The @code{stime} command (un)sets the printing of timing statistics, and @code{ptime} prints their current value: @@ -749,7 +749,7 @@ command: @deffn {scheme command} scmf FILE_NAME Loads the given Scheme file and evaluates it using the embedded Guile -interpreter. +interpreter. @end deffn @@ -772,7 +772,7 @@ your favourite editor). The device files are stored, by default, in the directory @file{~/.mdk}; this location can be changed using the @code{mixvm} command @code{devdir} (@pxref{Configuration commands}). -@multitable {the device name} { xx-xx } {filename[x-x].dev} {bin i/o/char } +@multitable {the device name} { xx-xx } {filename[x-x].dev} {bin i/o/char } @item @emph{Device} @tab @emph{No.} @tab @emph{filename} @tab @emph{type} @item Tape @tab 0-7 @tab @file{tape[0-7].dev} @tab bin i/o @item Disks @tab 8-15 @tab @file{disk[0-7].dev} @tab bin i/o |