version 0.5.2
[fw/sdcc] / sim / ucsim / doc / cmd_exec.html
index 8bca134842dfb67e9a8bc7cf18e6965c580c1648..c4adbe9c6b4c91648977762ebab17ca84f4f49e0 100644 (file)
@@ -1,12 +1,60 @@
 <html>
 <head>
-<title>Execution commands of uCsim</title>
+<title>Execution commands of &micro;Csim</title>
 </head>
 
 <body bgcolor="white">
 
 
-<h2>Execution commands of uCsim</h2>
+<h2>Execution commands of &micro;Csim</h2>
+
+
+<a name="run"><h3>r,run,go [start [stop]]</h3></a>
+
+This command starts the execution of the simulated program.
+
+<p>Parameters are optional. First parameter specifies start address of
+the execution. By default execution starts at address specified by
+actual value of the PC. This can be overridden by first parameter.
+
+<p>If second parameter is specified it places a dynamic breakpoint at
+specified address which stops the execution. If stop address is not
+given the simulator stops if it reaches a breakpoint, or the CPU
+accepts an interrupt and <b>stopit</b> option is TRUE, or fatal error
+occures or <a href="#stop">stop</a> command is used on an other
+console, or ENTER key is pressed on the console where the run command
+was issued.
+
+<p>If program execution is started the console is <i>frozen</i> it is
+not possible to give commands on this console to the simulator while
+execution is running. If it is needed to control the simulator during
+program execution then more consoles can be used. See using <a
+href="mulcons.html">multiple consoles</a> for more information.
+
+<p>Note that first instruction is executed without effect of
+breakpoints and simulation will be started afterwards. It means that
+if there is a breakpoint at start address then it will not be hit. See
+following example:
+
+<pre>
+$ <font color="#118811">./s51</font>
+ucsim 0.2.38-pre1, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+> <font color="#118811">b 0x10</font>
+Breakpoint 1 at 0x000010: MOV   R7,A
+> <font color="#118811">b 0x20</font>
+Breakpoint 2 at 0x000020: MOV   R7,A
+> <font color="#118811">run 0x10</font>
+Warning: maybe not instruction at 0x000010
+Simulation started, PC=0x000010
+Stop at 0x000020: (104) Breakpoint
+F 0x000020
+> 
+</pre>
+
+<hr>
 
 
 <a name="stop"><h3>stop</h3></a>
@@ -38,6 +86,8 @@ commands. If it stopped by the stop command the instruction pointed by
 PC is dissassembled, see the <a href="#dis"><b>dis</b></a> command for
 description of disassembled form.
 
+<hr>
+
 
 <a name="step"><h3>s,step</h3></a>
 
@@ -61,6 +111,8 @@ under certain conditions; type `show c' for details.
 After execution of actual instruction pointed by PC the <b>step</b>
 command dumps out the register set.
 
+<hr>
+
 
 <a name="n"><h3>n,next</h3></a>
 
@@ -101,6 +153,8 @@ under certain conditions; type `show c' for details.
    000177 0f       INC   R7
 > </pre>
 
+<hr>
+
 
 <a name="pc"><h3>pc [address]</h3></a>
 
@@ -124,53 +178,10 @@ Warning: maybe not instruction at 000020
  * 000020 ff       MOV   R7,A
 > </pre>
 
+<hr>
 
-<a name="run"><h3>r,run,go [start [stop]]</h3></a>
-
-This command starts the execution of the simulated program.
-
-<p>Parameters are optional. First parameter specifies start address of
-the execution. By default execution starts at address specified by
-actual value of the PC. This can be overridden by first parameter.
-
-<p>If second parameter is specified it places a dynamic breakpoint at
-specified address which stops the execution. If stop address is not
-given the simulator stops if it reaches a breakpoint, or the CPU
-accepts an interrupt and <b>stopit</b> option is TRUE, or fatal error
-occures or <a href="#stop">stop</a> command is used on an other
-console, or ENTER key is pressed on the console where the run command
-was issued.
-
-<p>If program execution is started the console is <i>frozen</i> it is
-not possible to give commands on this console to the simulator while
-execution is running. If it is needed to control the simulator during
-program execution then more consoles can be used. See using <a
-href="mulcons.html">multiple consoles</a> for more information.
-
-<p>Note that first instruction is executed without effect of
-breakpoints and simulation will be started afterwards. It means that
-if there is a breakpoint at start address then it will not be hit. See
-following example:
-
-<pre>
-$ ./s51
-ucsim 0.2.38-pre1, Copyright (C) 1997 Daniel Drotos, Talker Bt.
-ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
-This is free software, and you are welcome to redistribute it
-under certain conditions; type `show c' for details.
-> <font color="#118811">b 0x10</font>
-Breakpoint 1 at 0x000010: MOV   R7,A
-> <font color="#118811">b 0x20</font>
-Breakpoint 2 at 0x000020: MOV   R7,A
-> <font color="#118811">run 0x10</font>
-Warning: maybe not instruction at 0x000010
-Simulation started, PC=0x000010
-Stop at 0x000020: (104) Breakpoint
-F 0x000020
-> 
-</pre>
 
-<hr>
+<!--OK-->
 
 </body>
 </html>