Fix of typecast malloc
[fw/sdcc] / sim / ucsim / doc / cmd_general.html
index b7031cc763ce97b81b73496e5bff2af8db071cb1..e0483de03fc95e6f09ba5eb527ef798c6d375437 100644 (file)
@@ -7,34 +7,33 @@
 
 <h2>General commands of uCsim</h2>
 
-                                                              <!-- GENERAL -->
-
-Some commands can be repeated by entering an empty command (just
-pressing ENTER if command console is interactive). This repeats the
-<b>full</b> command entered previously precisely including parameters
-of the command. Repeatable commands are signed with <img
-src="burst.gif" alt="[Repeatable]"> icon.
-
-<p>Some commands accept parameters which in most cases can be
-numbers. Numbers can be entered in C-style form. If the number begins
-whith <tt><b>0x</b></tt> or <tt><b>0X</b></tt> it is interpreted as a
-hexadecimal number. If it begins with <tt><b>0</b></tt> followed by
-digits it is interpreted as octal number. In other cases it is
-interpreted as decimal number.
 
 <p>Every command which changes content of ROM area such as <b><a
-href="#l">l</a></b>, <b><a href="#dl">dl</a></b> or <b><a
-href="#sc">sc</a></b> deletes result of code analyzer and causes to
+href="#dl">dl</a></b> or <b><a href="cmd_set#set_memory">set
+memory</a></b> deletes result of code analyzer and causes to
 re-analyze the code.
 
 
-<a name="show"><h3>show c|w</h3></a>
+<a name="show"><h3>show</h3></a>
+
+Show command can be used to display different kind of information. It
+must be followed by a subcommand. Subcommands are:
+
+<p>show <a href="#show_copying">copying</a>
+<br>show <a href="#show_warranty">warranty</a>
+
+
+<a name="show_copying"><h4>show copying</h4></a>
+
+This command can be used to list licensing information. It is first 10
+point of the version 2 of GNU Genral Public License. If you do not
+accept GPL simply do not use the program.
+
 
-This command can be used to list licensing information. If <b>c</b>
-option has given, the license is listed. It is first 10 point of the
-version 2 of GNU Genral Public License. Using <b>w</b> parameter the
-command prints out last 2 point of the license ("NO WARRANTY"
-message). If you do not accept GPL simply do not use the program.
+<a name="show_warranty"><h4>show warranty</h4></a>
+
+This command prints out last 2 point of the license ("NO WARRANTY"
+message).
 
 
 <a name="dl"><h3>download,dl</h3></a>
@@ -101,10 +100,16 @@ confirmation. It doesn't matter how many consoles are used and what
 commands are running on them.
 
 
-<a name="h"><h3>help,?</h3></a>
+<a name="h"><h3>?,help [command]</h3></a>
 
 Help command. It prints out short description of the commands.
 
+<p>If a command name is given as parameter then uCsim prints out all
+command that has the same name.
+
+<p>If parameter is unique name of a command then long description of
+the command is printed out.
+
 
 <a name="reset"><h3>reset</h3></a>
 
@@ -141,130 +146,44 @@ under certain conditions; type `show c' for details.
 > </pre>
 
 
-<a name="wi"><h3>wi,Wi string</h3></a>
-
-Searching for specified string in internal RAM area. String is
-interpreted from first non-space sharacter until end of the command
-including spaces. <b>wi</b> command makes case insensitive search and
-<b>Wi</b> can be used to make case sensitive search. Result is a hexa
-dump of memory areas that match with specified string. Most of C-style
-escape sequences can be used in the string: <tt>\f</tt>, <tt>\n</tt>,
-<tt>\r</tt>, <tt>\t</tt>, <tt>\v</tt>, <tt>\a</tt>, <tt>\b</tt>,
-<tt>\0</tt>, and <tt>\0xxx</tt> where <tt>xxx</tt> is an octadecimal
-number of the code of the character.
-
-<pre>
-$ <font color="#118811">s51 remoansi.hex</font>
-ucsim 0.2.24, 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.
-58659 bytes read from remoansi.hex
-> <font color="#118811">g</font>
-Simulation started, PC=0x000000
-
-Stop at 00019c: (7) User stopped
-F 00019c
-> <font color="#118811">si 20 Dani DAni</font>
-000014 44 61 6e 69 44 41 6e 69                         DaniDAni
-> <font color="#118811">wi dani</font>
-000014 44 61 6e 69             Dani
-000018 44 41 6e 69             DAni
-> <font color="#118811">Wi Dani</font>
-000014 44 61 6e 69             Dani
-> <font color="#118811">wi dani\0</font>
-000018 44 41 6e 69 00          DAni.
-> </pre>
-
-
-<a name="wx"><h3>wx,Wx string</h3></a>
-
-Search commands. These commands are similar to <a href="#wi"><b>wi,
-Wi</b></a> commands the only difference is that <b>wx,Wx</b> are used
-to search for a string in external memory.
-
-
-<a name="wc"><h3>wc,Wc string</h3></a>
-
-Search commands. These commands are similar to <a href="#wi"><b>wi,
-Wi</b></a> commands the only difference is that <b>wx,Wx</b> are used
-to search for a string in code memory area.
-
-
-<a name="gopt"><h3>gopt [opt]</h3></a>
-
-Get actual value of option(s). Some options can be set by <a
-href="#sopt"><b>sopt</b></a> to modify behavior of the
-simulator. Using <b>gopt</b> you can get actual value of these
-options. If you use this command without parameter you get list of all
-options known by the program. In this way you can figure out which
-options can be used.
-
-<pre>
-$ <font color="#118811">s51 -V</font>
-ucsim 0.2.24, 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">gopt</font>
-verbose TRUE Verbose flag.
-stopit FALSE Stop if interrupt accepted.
-debug FALSE Debug flag.
-> <font color="#118811">gopt stopit</font>
-stopit FALSE Stop if interrupt accepted.
-> </pre>
-
-This version of the simulator knows about three options. First element
-of the list is name of the option (<b>verbose</b>, <b>debug</b> and
-<b>stopit</b>). This name can be used to identify the option in
-<b>gopt</b> and <a href="#sopt"><b>sopt</b></a> command. Second
-element of the list is the value of the option. In this case type of
-both options is boolean, their value can be TRUE or FALSE. Third
-element is a short description of the option.
-
-<dl><dt><b>verbose</b> <dd>?
-
-<dt><b>debug</b> <dd>Debug flag can be set by <b>-V</b> option of the
-program to TRUE otherwise its default value is FALSE. If it is TRUE,
-the simulator prints out short messages about important events.
-
-<dt><b>stopit</b> <dd>Setting this option to TRUE (default value is
-FALSE) forces execution to stop every time when CPU accepts an
-interrupt. You do not have to use breakpoints to inspect interrupts.
+<a name="where"><h3>where,Where memory_type data...</h3></a>
 
-</dl>
+Searching for some data in memory. First parameter specifies
+memory. Class name of the memory must be used, it can be checked using
+<a href="cmd_general.html#conf">conf</a> command which lists size and
+class name of all available memories.
 
+<p>Other parameters can be mixed list of strings (characters between "
+and ") and numbers. Strings can contain escape sequencies. Ucsim
+merges all parameters together and will search for megred list of
+values in specified memory.
 
-<a name="sopt"><h3>sopt opt value</h3></a>
+<p><b>where</b> command do case unsensitive search while <b>Where</b>
+command is for case sensitive search.
 
-Set option value. Options described at previous command (<a
-href="#gopt"><b>gopt</b></a>) can be set using this command. First
-parameter must be an option name and second the new
-value. Interpretation of the value depends on type of the
-option. Value for a boolean type of option interpreted as follows: if
-first character of the value is one of <tt>1</tt>, <tt>t</tt>,
-<tt>T</tt>, <tt>y</tt>, <tt>Y</tt> then value will be TRUE otherwise
-it will be FALSE.
+<p>Search is done in whole memory and all matches are dumped out.
 
 <pre>
-$ <font color="#118811">s51 -V</font>
-ucsim 0.2.24, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+$ <font color="#118811">/s51</font>
+ucsim 0.2.38-pre2, 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">gopt</font>
-verbose TRUE Verbose flag.
-stopit FALSE Stop if interrupt accepted.
-debug FALSE Debug messages appears on this console.
-> <font color="#118811">sopt debug t</font>
-> <font color="#118811">gopt</font>
-verbose TRUE Verbose flag.
-stopit FALSE Stop if interrupt accepted.
-debug TRUE Debug messages appears on this console.
+> <font color="#118811">set mem x 20 "Dani d ani D ani dani Dani"</font>
+0x0014 44 61 6e 69 20 64 20 61 Dani d a
+0x001c 6e 69 20 44 20 61 6e 69 ni D ani
+0x0024 20 64 61 6e 69 20 44 61  dani Da
+0x002c 6e 69                   ni
+> <font color="#118811">where x "dani"</font>
+0x0014 44 61 6e 69             Dani
+0x0025 64 61 6e 69             dani
+0x002a 44 61 6e 69             Dani
+> <font color="#118811">Where x "d ani"</font>
+0x0019 64 20 61 6e 69          d ani
 > </pre>
 
 
-<a name="conf"><h3>conf </h3></a>
+<a name="conf"><h3>conf</h3></a>
 
 This command prints out configuration of the simulator:
 
@@ -282,10 +201,10 @@ Controller has 8 hardware element(s).
   port[3]
   irq[0]
 Memories:
-  ROM  size= 0x010000 65536
-  XRAM size= 0x010000 65536
-  IRAM size= 0x000100 256
-  SFR  size= 0x000100 256
+  ROM  size= 0x010000  65536 width=  8 class= "rom"
+  XRAM size= 0x010000  65536 width=  8 class= "xram"
+  IRAM size= 0x000100    256 width=  8 class= "iram"
+  SFR  size= 0x000100    256 width=  8 class= "sfr"
 > 
 </pre>
 
@@ -479,32 +398,54 @@ well as pointed memory values.
 
 <p>Last line is disassembled instruction ap PC.
 
-<a name="info_hw"><h4>info hardware|hw cathegory [id]</h4></a>
+<a name="info_hw"><h4>info hardware|hw identifier</h4></a>
 
 This subcommand prints out information about a unit of the
-controller. Cathegory can be:
-
-<ul><li>timer
-<li>uart
-<li>port
-<li>pca
-<li>interrupt
-<li>wdt
-</ul>
-
-Ouput format of this command depends on CPU family and type of the CPU
-too because requested unit can be different in different type of
+controller. <b>identifier</b> specifies hardware element. One form of
+it is a name. Names of hardware elements can be checked by <a
+href="#conf">conf</a> command. This form is accepted only when name is
+unique. If more than one element exists with the same name then name
+must be followed by id number is squere brackets in same form as it is
+listed by <a href="#conf">conf</a> command.
+
+<p>Ouput format of this command depends on CPU family and type of the
+CPU too because requested unit can be different in different type of
 controller even in the same CPU family.
 
 <pre>
 $ <font color="#118811">s51 -t 51</font>
-ucsim 0.2.36, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim 0.2.38-pre2, 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">i h t</font>
+> <font color="#118811">conf</font>
+ucsim version 0.2.38-pre2
+Type of microcontroller: 51 CMOS
+Controller has 8 hardware element(s).
+  timer0[0]
+  timer1[1]
+  uart[0]
+  port[0]
+  port[1]
+  port[2]
+  port[3]
+  irq[0]
+Memories:
+  ROM  size= 0x010000  65536 width=  8 class= "rom"
+  XRAM size= 0x010000  65536 width=  8 class= "xram"
+  IRAM size= 0x000100    256 width=  8 class= "iram"
+  SFR  size= 0x000100    256 width=  8 class= "sfr"
+> <font color="#118811">i h port[2]</font>
+port[2]
+P2    11111111 0xff 255 . (Value in SFR register)
+Pin2  11111111 0xff 255 . (Output of outside circuits)
+Port2 11111111 0xff 255 . (Value on the port pins)
+> <font color="#118811">i h t[0]</font>
 timer0[0] 0x0000 13 bit timer OFF irq=0 dis prio=0
-timer1[1] 0x0000 13 bit timer OFF irq=0 dis prio=0
+> <font color="#118811">i h u</font>
+uart[0] Shift, fixed clock MultiProc=none irq=dis prio=0
+Receiver OFF RB8=0 irq=0
+Transmitter TB8=0 irq=0
 > 
 </pre>
 
@@ -512,99 +453,17 @@ Timer #2 differs a little bit from other timers of MCS51:
 
 <pre>
 $ <font color="#118811">s51 -t 52</font>
-ucsim 0.2.36, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim 0.2.38-pre2, 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">i h t</font>
+> <font color="#118811">i h timer0</font>
 timer0[0] 0x0000 13 bit timer OFF irq=0 dis prio=0
-timer1[1] 0x0000 13 bit timer OFF irq=0 dis prio=0
+> <font color="#118811">i h t[2]</font>
 timer2[2] 0x0000 reload 0x0000 timer OFF irq=0 dis prio=0
 > 
 </pre>
 
-<p>If the controller contains more than one unit of a cathegory, then
-optional <b>id</b> parameter can be used to select a specific one. If
-<b>id</b> is not used then information is printed about all units
-belonging to specified cathegory.
-
-<pre>
-> <font color="#118811">i h t 1</font>
-timer1[1] 0x0000 13 bit timer OFF irq=0 dis prio=0
-> 
-</pre>
-
-It is possible that there is no unit belonging to some cathegory. It
-is also possible that the specific unit exists but information command
-of that unit is not implemented, in this case you have to check SFRs
-of the unit...
-
-<pre>
-> <font color="#118811">i h pca</font>
-> 
-</pre>
-
-Information you can get about units of MCS51 controllers:
-
-<pre>
-$ <font color="#118811">s51 -t 251</font> 
-ucsim 0.2.37, 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">g</font>
-Simulation started, PC=0x000000
-
-Stop at 0x000023: (105) User stopped
-F 0x000023
-> <font color="#118811">i h t</font>
-timer0[0] 0xaa8d 16 bit timer ON irq=0 en prio=0
-timer1[1] 0xfdff 8 bit autoreload timer ON irq=1 dis prio=0
-timer2[2] 0x0000 reload 0x0000 timer OFF irq=0 dis prio=0
-> <font color="#118811">i h u</font>
-uart[0] 8 bit UART timer clocked MultiProc=none irq=en prio=1
-Receiver ON RB8=1 irq=0
-Transmitter TB8=1 irq=1
-> <font color="#118811">i h po</font>
-port[0]
-P0    11111111 0xff 255 . (Value in SFR register)
-Pin0  11111111 0xff 255 . (Output of outside circuits)
-Port0 11111111 0xff 255 . (Value on the port pins)
-port[1]
-P1    11111111 0xff 255 . (Value in SFR register)
-Pin1  11111111 0xff 255 . (Output of outside circuits)
-Port1 11111111 0xff 255 . (Value on the port pins)
-port[2]
-P2    11111111 0xff 255 . (Value in SFR register)
-Pin2  11111111 0xff 255 . (Output of outside circuits)
-Port2 11111111 0xff 255 . (Value on the port pins)
-port[3]
-P3    11111111 0xff 255 . (Value in SFR register)
-Pin3  11111111 0xff 255 . (Output of outside circuits)
-Port3 11111111 0xff 255 . (Value on the port pins)
-> <font color="#118811">i h i</font>
-Interrupts are enabled. Interrupt sources:
-  Handler  En  Pr Req Act Name
-  0x000003 en   1 no  act external #0
-  0x00000b en   0 no  act timer #0
-  0x000013 en   1 no  act external #1
-  0x00001b dis  0 YES act timer #1
-  0x000033 dis  0 no  act PCA counter
-  0x000033 dis  0 no  act PCA module #0
-  0x000033 dis  0 no  act PCA module #1
-  0x000033 dis  0 no  act PCA module #2
-  0x000033 dis  0 no  act PCA module #3
-  0x000033 dis  0 no  act PCA module #4
-  0x000023 en   1 YES act serial transmit
-  0x000023 en   1 no  act serial receive
-  0x00002b dis  0 no  act timer #2 TF2
-  0x00002b dis  0 no  act timer #2 EXF2
-Active interrupt service(s):
-  Pr Handler  PC       Source
-   1 0x000023 0x003672 serial transmit
->
-</pre>
-
 
 <a name="timer"><h3>timer a|d|g|r|s|v id [value]</h3></a>
 
@@ -653,6 +512,242 @@ timer #3("unnamed") ON: 0 sec (0 clks)
 If you use 0 as timer id in "get" operation, simulator prints out
 value of all timers including predefined ones.
 
+
+<a name="set"><h3>set</h3></a>
+
+This command can be used to set various kind of things. It requires a
+subcommand to specify what is going to be set. Known subcommands are:
+
+<p>set <a href="#set_memory">memory</a>
+<br>set <a href="#set_bit">bit</a>
+<br>set <a href="#set_port">port</a>
+<br>set <a href="#set_option">option</a>
+
+
+<a name="set_memory"><h4>set memory memory_type address
+data...</h4></a>
+
+This command can be used to modify content of any simulated
+memory. First parameter must be a class name to specify type of
+memory. Class names can de checked by <a
+href="cmd_general.html#conf">conf</a> command.
+
+<p>Second parameter specifies start address of the modification.
+
+<p>Remaining parameters will be written into the memory starting at
+address specified by second parameter. Data list can include numbers
+as well as strings. See <a href="syntax.html">syntax</a> for more
+details.
+q
+<p>Modified memory locations are dumped out.
+
+<pre>
+$ <font color="#118811">s51</font>
+ucsim 0.2.38-pre2, 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">set mem x 1 "ab\tcd\0ef\012ghq" 2 "ABC"</font>
+0x0001 61 62 09 63 64 00 65 66 ab.cd.ef
+0x0009 0a 67 68 71 02 41 42 43 .ghq.ABC
+> <font color="#118811">set mem sfr pcon 0x34</font>
+0x87 34                      4
+> </pre>
+
+
+<a name="set_bit"><h4>set bit address 0|1</h4></a>
+
+Set one bit to 0 or 1. First parameter specifies the bit. It can be
+the address of the bit (number or syqmbolic name) or it can be
+specified in <i>address<b>.</b>bitnumber</i> format where
+<i>address</i> addresses SFR area and <i>bitnumber</i> is number of
+bit in specified SFR location. Using this syntax any SFR (and 8051's
+internal RAM) location can be modified it need not be really bit
+addressable.
+
+<p>Second parameter interpreted as 1 if it is not zero.
+
+<p>Modified memory location is dumped out.
+
+<pre>
+$ <font color="#118811">s51 </font>
+ucsim 0.2.38-pre2, 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">set bit tf1 1</font>
+0x88 80 .
+> <font color="#118811">set bit 130 0</font>
+0x80 fb .
+> <font color="#118811">set bit pcon.2 1</font>
+0x87 04 .
+> <font color="#118811">set bit 10.7 1</font>
+0x0a 80 .
+> 
+</pre>
+
+
+<a name="set_port"><h4>set port hardware_id data</h4></a>
+
+This command can be used to set value of external circuits which
+connected to ports of simulated controller. First parameter specifies
+port number. It can be an array which specifies a hardware element or
+simply a number.
+
+<pre>
+> <font color="#118811">set port 0 12</font>
+> <font color="#118811">i h po[0]</font>
+port[0]
+P0    11111111 0xff 255 . (Value in SFR register)
+Pin0  00001100 0x0c  12 . (Output of outside circuits)
+Port0 00001100 0x0c  12 . (Value on the port pins)
+> <font color="#118811">set port port[0] 23</font>
+> <font color="#118811">i h po[0]</font>
+port[0]
+P0    11111111 0xff 255 . (Value in SFR register)
+Pin0  00010111 0x17  23 . (Output of outside circuits)
+Port0 00010111 0x17  23 . (Value on the port pins)
+> </pre>
+
+
+<a name="set_option"><h4>set option name value</h4></a>
+
+<p>Set option value. Options described at (<a
+href="#get_option"><b>get option</b></a>) command can be set using
+this command. First parameter must be an option name and second the
+new value. Interpretation of the value depends on type of the
+option. Value for a boolean type of option interpreted as follows: if
+first character of the value is one of <tt>1</tt>, <tt>t</tt>,
+<tt>T</tt>, <tt>y</tt>, <tt>Y</tt> then value will be TRUE otherwise
+it will be FALSE.
+
+<pre>
+$ <font color="#118811">s51 -V</font>
+ucsim 0.2.38, 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">get opt</font>
+verbose TRUE Verbose flag.
+stopit FALSE Stop if interrupt accepted.
+debug FALSE Debug messages appears on this console.
+> <font color="#118811">set opt debug t</font>
+> <font color="#118811">get opt</font>
+verbose TRUE Verbose flag.
+stopit FALSE Stop if interrupt accepted.
+debug TRUE Debug messages appears on this console.
+> </pre>
+
+
+<a name="get"><h3>get</h3></a>
+
+This command can be used to get value of various kind of things. It
+requires a subcommand to specify what is going to be set. Known
+subcommands are:
+
+<p>get <a href="#get_sfr">sfr</a>
+<br>get <a href="#get_option">option</a>
+
+
+<a name="get_sfr"><h4>get sfr address...</h4></a>
+
+This command can be used to check values of SFR location(s) if SFR
+exists in simulated memory. Note that <a
+href="cmd_dump.html#dump_memory">dump memory</a> or <a
+href="cmd_dump.html#ds">ds</a> can be used as well.
+
+<p>Parameters are interpreted as SFR names or addresses and values of
+addressed locations are dumped out.
+
+<pre>
+$ <font color="#118811">s51 </font>
+ucsim 0.2.38-pre2, 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">get sfr pcon p1 0 0x80 kahd scon</font>
+0x87 00 .
+0x90 ff .
+0x00 00 .
+0x80 ff .
+Warning: Invalid address kahd
+0x98 00 .
+> </pre>
+
+
+<a name="get_option"><h4>get option name</h4></a>
+
+Get actual value of option(s). Some options can be set by <a
+href="#set_option"><b>set option</b></a> to modify behavior of the
+simulator. Using <b>get option</b> you can get actual value of these
+options. If you use this command without parameter you get list of all
+options known by the program. In this way you can figure out which
+options can be used.
+
+<pre>
+$ <font color="#118811">s51 -V</font>
+ucsim 0.2.38, 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">get opt</font>
+verbose TRUE Verbose flag.
+stopit FALSE Stop if interrupt accepted.
+debug FALSE Debug flag.
+> <font color="#118811">get opt stopit</font>
+stopit FALSE Stop if interrupt accepted.
+> </pre>
+
+This version of the simulator knows about three options. First element
+of the list is name of the option (<b>verbose</b>, <b>debug</b> and
+<b>stopit</b>). This name can be used to identify the option in
+<b>gopt</b> and <a href="#set_option"><b>set option</b></a>
+command. Second element of the list is the value of the option. In
+this case type of both options is boolean, their value can be TRUE or
+FALSE. Third element is a short description of the option.
+
+<dl><dt><b>verbose</b> <dd>?
+
+<dt><b>debug</b> <dd>Debug flag can be set by <b>-V</b> option of the
+program to TRUE otherwise its default value is FALSE. If it is TRUE,
+the simulator prints out short messages about important events.
+
+<dt><b>stopit</b> <dd>Setting this option to TRUE (default value is
+FALSE) forces execution to stop every time when CPU accepts an
+interrupt. You do not have to use breakpoints to inspect interrupts.
+
+</dl>
+
+
+<a name="fill"><h3>fill memory_type start end data</h3></a>
+
+Fill memory region with specified data. First parameter specifies
+memory. Class name of the memory must be used, it can be checked using
+<a href="cmd_general.html#conf">conf</a> command which lists size and
+class name of all available memories.
+
+<p><b>start</b> and <b>end</b> parameters specify first and last
+address of the memory region to be filled.
+
+<p><b>data</b> parameter specifies the data which is used to fill the
+memory region.
+
+<pre>
+$ <font color="#118811">s51</font> 
+ucsim 0.2.38-pre2, 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">fill x 12 0x12 0x56</font>
+> <font color="#118811">dump x 0 0x20</font>
+0x0000 00 00 00 00 00 00 00 00 ........
+0x0008 00 00 00 00 56 56 56 56 ....VVVV
+0x0010 56 56 56 00 00 00 00 00 VVV.....
+0x0018 00 00 00 00 00 00 00 00 ........
+0x0020 00                      .
+> </pre>
+
+
 <hr>
 
 </body>