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

<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
<html>
<head>
<title>SPARC Architectural Model: User Commands</title>
</head>
<body bgcolor="#FFFFFF" LANG="en-US">
<div STYLE="margin-bottom: 0cm"></div>&nbsp;

<h2>
break
</h2>

<h4>
NAME
</h4>
<ul>
break - set breakpoint
</ul>

<h4>SYNOPSIS</h4>
<tt>
break
<p>break <i>pc_addr</i> [<i>cpu_num</i>]</p>
<p>break [-cpu <i>cpu_set</i>] <i>pc_addr</i></p>
<p>break [-cpu <i>cpu_set</i>] -trap <i>trap_type</i></p>
<p>break [-cpu <i>cpu_set</i>] -red</p>
</ul>
</tt>

<h4>DESCRIPTION</h4>
<ul>
Set a breakpoint on one or more cpus.  One of these cpus encounters a breakpoint, control is returned to frontend before the instruction is executed.
<p>
Each breakpoint is associated with an id (printed when the breakpoint
is set, by typing break with no arguments, or by the list-breakpoints
command) which is used for further references to the breakpoint.
<p>
The break command without any arguments prints the list of current
breakpoints.
<p>
break <i>pc_addr</i> <i>cpu_num</i> sets a
breakpoint at <i>pc_addr</i> on the cpu <i>cpu_num</i>.
<p>
For the remaining forms of break, the optional flag
<a href="flag_cpu.html">-cpu</a> selects a collection
of cpus on which the appropriate breakpoint is set.  If the -cpu flag
is omitted, then the breakpoint is set on all configured cpus.
<p>
break followed by an optional -cpu flag and a <i>pc_addr</i> sets a
breakpoint at <i>pc_addr</i> on the selected set of cpus.
<p>
The -trap flag sets a trap breakpoint that stops execution before a
trap of type <i>trap_type</i> is taken  on the selected set of cpus.
<p>
The -red flag sets a RED state breakpoint that stops execution before
any of the selected set of cpus enters the RED state.
<p>
Breakpoints can be removed using delete.

<p> Breakpoints are <b>not supported</b> in execution-driven mode. An
execution-driven timing model may provide its own breakpoint
capability. To avoid unpredictable results, all breakpoints should be
disabled prior to enabling execution-driven simulation
</p>

</ul>

<h4>RETURN VALUES</h4>
<ul>
Returns the breakpoint id of the newly set breakpoint.
</ul>

<h4>SEE ALSO</h4>
<ul><a href="cmd_delete.html">delete</a></ul>
<ul><a href="cmd_enable_disable.html">enable/disable</a></ul>
<ul><a href="cmd_ignore.html">ignore</a></ul>
<ul><a href="cmd_list-breakpoints.html">list-breakpoints</a></ul>

<hr>
</body>
</html>