sam-t2/sam/docs/ui-cmds/index.html

 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
  <title>SPARC Architectural Model: User Commands</title>
</head>
<body bgcolor="#ffffff" lang="en-US">
<h1>SPARC Architectural Model: User Commands</h1>
<h2>Introduction</h2>
<p>
The <a href="flag_cpu.html">-cpu</a> flag is available on a number of
commands.
It used to change the default set of cpus used by the command.

<p>
All commands that access memory take a common set of addressing
options.
These flags control whether addresses are interpreted as virtual,
real, or physical and, for translated addressed, the translation's
context id and partition id.
More documentation can be found
<a href="flag_addressing_options.html">here</a>.

<h2>Command List: by Category</h2>

<h3>User Interface</h3>
<a href="cmd_help.html">help</a>,
<a href="cmd_alias.html">alias</a>,
<a href="cmd_unalias.html">unalias</a>,
<a href="cmd_echo.html">echo</a>,
<a href="cmd_pselect.html">pselect</a>,
<a href="cmd_file.html">file</a>,
<a href="cmd_run-cmd-file.html">run-cmd-file</a>,
<a href="cmd_run-python-file.html">run-python-file</a>

<h3>Configuration Commands</h3>
<a href="cmd_conf.html">conf</a>,
<a href="cmd_diskdelay.html">diskdelay</a>
<a href="cmd_mod.html">mod</a>,
<a href="cmd_mips.html">mips</a>,
<a href="cmd_penable_pdisable.html">penable_pdisable</a>,
<a href="cmd_version.html">version</a>

<h3>Running, stopping</h3>
<a href="cmd_dump.html">dump</a>,
<a href="cmd_run.html">run</a>,
<a href="cmd_stepc.html">stepc</a>,
<a href="cmd_stept.html">stept</a>,
<a href="cmd_stepi.html">stepi</a>,
<a href="cmd_stop.html">stop</a>,
<a href="cmd_quit.html">quit</a>,
<a href="cmd_perf.html">perf</a>,
<a href="cmd_sync.html">sync</a>

<h3>Debugging and Breakpointing</h3>
<a href="cmd_break.html">break</a>,
<a href="cmd_delete.html">delete</a>,
<a href="cmd_list-breakpoints.html">list-breakpoints</a>,
<a href="cmd_disassemble.html">disassemble</a>,
<a href="cmd_events.html">events</a>,
<a href="cmd_load_symbols.html">load_symbols</a>,
<a href="cmd_unload_symbols.html">unload_symbols</a>,
<a href="cmd_loglev.html">loglev</a>,
<a href="cmd_sym.html">sym</a>,
<a href="cmd_translate.html">translate</a>,
<a href="cmd_vdebug.html">vdebug</a>

<h3>Examine/Modify Simulated State</h3>
<a href="cmd_reg.html">%reg</a>,
<a href="cmd_fpregs.html">fpregs</a>,
<a href="cmd_cmpregs.html">%cmpregs</a>,
<a href="cmd_pregs.html">pregs</a>
<a href="cmd_read-asi.html">read-asi</a>,
<a href="cmd_write-asi.html">write-asi</a>,
<a href="cmd_read-reg.html">read-reg</a>,
<a href="cmd_write-reg.html">write-reg</a>,
<a href="cmd_set-pc.html">set-pc</a>,
<a href="cmd_get.html">get</a>,
<a href="cmd_set.html">set</a>,
<a href="cmd_load.html">load</a>,
<a href="cmd_tlbs.html">tlbs</a>
<a href="cmd_where.html">where</a>


<h2>Command List: Alphabetical</h2>
<table cellspacing="0" cellpadding="0">
<tr>
  <th>Command</th>
  <th>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</th>
  <th>Description</th>
</tr>
<tr>
  <td><a href="cmd_reg.html">%reg</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>prints cpu registers</td>
</tr>
<tr>
  <td><a href="cmd_alias.html">alias</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>sets aliases for standard commands</td>
</tr>
<tr>
  <td><a href="cmd_break.html">break</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>sets cpu breakpoints</td>
</tr>
<tr>
  <td><a href="cmd_cmpregs.html">cmpregs</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>prints cmp registers</td>
</tr>
<tr>
  <td><a href="cmd_conf.html">conf</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>sets configuration parameters</td>
</tr>
<tr>
  <td><a href="cmd_cpuregs.html">cpuregs</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>prints cpu register names</td>
</tr>
<tr>
  <td><a href="cmd_delete.html">delete</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>deletes breakpoints</td>
</tr>
<tr>
  <td><a href="cmd_disassemble.html">disassemble</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>disassembles machine instructions</td>
</tr>
<tr>
  <td><a href="cmd_diskdelay.html">diskdelay</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>sets disk delay parameters </td>
</tr>
<tr>
  <td><a href="cmd_dump.html">dump</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>dumps a checkpoint</td>
</tr>
<tr>
  <td><a href="cmd_echo.html">echo</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>echos arguments</td>
</tr>
<tr>
  <td><a href="cmd_events.html">events</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>controls event debugging output</td>
</tr>
<tr>
  <td><a href="cmd_file.html">file</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>runs user interface commands from a file</td>
</tr>
<tr>
  <td><a href="cmd_fpregs.html">fpregs</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>prints floating point registers</td>
</tr>
<tr>
  <td><a href="cmd_get.html">get</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>reads memory</td>
</tr>
<tr>
  <td><a href="cmd_help.html">help</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>user help</td>
</tr>
<tr>
  <td><a href="cmd_list-breakpoints.html">list-breakpoints</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>lists cpu breakpoints</td>
</tr>
<tr>
  <td><a href="cmd_load.html">load</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>loads values from a file and stores them to memory</td>
</tr>
<tr>
  <td><a href="cmd_load_symbols.html">load_symbols</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>loads symbol table information</td>
</tr>
<tr>
  <td><a href="cmd_loglev.html">loglev</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>controls logging levels</td>
</tr>
<tr>
  <td><a href="cmd_mod.html">mod</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>load analyzer or remote-debugger module</td>
</tr>
<tr>
  <td><a href="cmd_mips.html">mips</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>displays performance information</td>
</tr>
<tr>
  <td><a href="cmd_penable_pdisable.html">penable_pdisable</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>enables (or disables) cpus</td>
</tr>
<tr>
  <td><a href="cmd_perf.html">perf</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>displays simualator throughput information</td>
</tr>

<tr>
  <td><a href="cmd_pregs.html">pregs</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>prints cpu register information</td>
</tr>
<tr>
  <td><a href="cmd_pselect.html">pselect</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>specifies the current cpu</td>
</tr>
<tr>
  <td><a href="cmd_quit.html">quit</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>ends simulation</td>
</tr>
<tr>
  <td><a href="cmd_read-asi.html">read-asi</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>reads values from an non-translating ASI</td>
</tr>
<tr>
  <td><a href="cmd_read-reg.html">read-reg</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>reads values from a cpu register</td>
</tr>
<tr>
  <td><a href="cmd_run.html">run</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>starts execution</td>
</tr>
<tr>
  <td><a href="cmd_run-cmd-file.html">run-cmd-file</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>runs user interface commands from a file </td>
</tr>
<tr>
  <td><a href="cmd_run-python-file.html">run-python-file</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>runs python code from a file</td>
</tr>
<tr>
  <td><a href="cmd_set.html">set</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>writes values to memeory</td>
</tr>
<tr>
  <td><a href="cmd_set-pc.html">set-pc</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>sets a cpu's program counter</td>
</tr>
<tr>
  <td><a href="cmd_stepc.html">stepc</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>steps execution a specified time interval</td>
</tr>
<tr>
  <td><a href="cmd_stepi.html">stepi</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>steps execution a specified number of instructions</td>
</tr>
<tr>
  <td><a href="cmd_stept.html">stept</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>steps execution a specified time interval in global time-sync mode</td>
</tr>
<tr>
  <td><a href="cmd_stop.html">stop</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>stops simulation</td>
</tr>
<tr>
  <td><a href="cmd_sym.html">sym</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>displays symbol information</td>
</tr>
<tr>
  <td><a href="cmd_sync.html">sync</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>synchronizes global time-sync</td>
</tr>
<tr>
  <td><a href="cmd_tlbs.html">tlbs</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>prints tlb information</td>
</tr>
<tr>
  <td><a href="cmd_translate.html">translate</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>translates an address to a physical address</td>
</tr>
<tr>
  <td><a href="cmd_unalias.html">unalias</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>removes an alias</td>
</tr>
<tr>
  <td><a href="cmd_unload_symbols.html">unload_symbols</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>removes all symbol information</td>
</tr>
<tr>
  <td><a href="cmd_vdebug.html">vdebug</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>enables cpu tracing</td>
</tr>
<tr>
  <td><a href="cmd_version.html">version</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>prints SAM's version number</td>
</tr>
<tr>
  <td><a href="cmd_where.html">where</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>Lists the call stacks of all cpus</td>
</tr>
<tr>
  <td><a href="cmd_write-asi.html">write-asi</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>writes a value to a non-translating ASI</td>
</tr>
<tr>
  <td><a href="cmd_write-reg.html">write-reg</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td>writes a value to a cpu register</td>
</tr>
</table>

<h4>Deprecated Commands</h4>
<table cellspacing="0" cellpadding="0">
<tr>
  <td><a href="cmd_dbreak.html">dbreak</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td></td>
</tr>
<tr>
  <td><a href="cmd_debug.html">debug</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td></td>
</tr>
<tr>
  <td><a href="cmd_pc.html">pc</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td></td>
</tr>
<tr>
  <td><a href="cmd_on.html">on</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td></td>
</tr>
<tr>
  <td><a href="cmd_option.html">option</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td></td>
</tr>
<tr>
  <td><a href="cmd_pty.html">pty</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td></td>
</tr>
<tr>
  <td><a href="cmd_r.html">r</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td></td>
</tr>
<tr>
  <td><a href="cmd_setreg.html">setreg</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td></td>
</tr>
<tr>
  <td><a href="cmd_rdt.html">rdt</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td></td>
</tr>
<tr>
  <td><a href="cmd_read-fp-reg-i.html">read-fp-reg-i</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td></td>
</tr>
<tr>
  <td><a href="cmd_read-fp-reg-x.html">read-fp-reg-x</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td></td>
</tr>
<tr>
  <td><a href="cmd_read-th-ctl-reg.html">read-th-ctl-reg</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td></td>
</tr>
<tr>
  <td><a href="cmd_read-th-fp-reg-i.html">read-th-fp-reg-i</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td></td>
</tr>
<tr>
  <td><a href="cmd_read-th-fp-reg-x.html">read-th-fp-reg-x</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td></td>
</tr>
<tr>
  <td><a href="cmd_read-th-reg.html">read-th-reg</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td></td>
</tr>
<tr>
  <td><a href="cmd_resume.html">resume</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td></td>
</tr>
<tr>
  <td><a href="cmd_stepim.html">stepim</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td></td>
</tr>
<tr>
  <td><a href="cmd_write.html">write</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td></td>
</tr>
<tr>
  <td><a href="cmd_write-fp-reg-i.html">write-fp-reg-i</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td></td>
</tr>
<tr>
  <td><a href="cmd_write-fp-reg-x.html">write-fp-reg-x</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td></td>
</tr>
<tr>
  <td><a href="cmd_write-th-ctl-reg.html">write-th-ctl-reg</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td></td>
</tr>
<tr>
  <td><a href="cmd_write-th-fp-reg-i.html">write-th-fp-reg-i</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td></td>
</tr>
<tr>
  <td><a href="cmd_write-th-fp-reg-x.html">write-th-fp-reg-x</a></td>
  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
  <td></td>
</tr>
</table>

</body>
</html>