mlstop
Abstract
Sets a labeled breakpoint that is limited to the specified module. The breakpoint will stop the simulation when the KP op_prg_odb_bkpt() is invoked with a matching label by a process within the specified module.
Syntax
mlstop <objref> <label>
| Argument | Type | Description |
|---|---|---|
<objref> |
integer or string | numeric object ID or hierarchical name of the module-of-interest An object ID for this argument can be obtained by using the ODB commands objmap or objid. |
<label> |
string | label string of the breakpoint The label can include alphanumeric characters, spaces, and selected punctuation, but must be surrounded by double quotes if spaces are included. The labels used for breakpoints exist in a different space from those used by labeled traces. Traces and breakpoints can have labels with the same name, but they do not affect each other. |
Details
A labeled module breakpoint is trapped when the KP op_prg_odb_bkpt() is invoked with the specified module with a label argument that matches the breakpoint label. Labeled module breakpoints are indefinite because they are associated with a repeatable situation, and they remain on the pending breakpoint list after being trapped. Breakpoints can be suspended by the command suspstop, reactivated by actstop, or deleted by delstop.
Example
This example assumes that a statement similar to the following one appears in the code to conditionally set the breakpoint label.
if (dest_subnet == 2)
op_prg_odb_bkpt ("subnet = 2");
-----------------------------------------------------------------------------------
ODB> mlstop pksw1.hub.hub "subnet = 2"
Added breakpoint #0: “stop at label (subnet = 2) in module (top.pksw1.hub.hub)”
ODB> status
Breakpoints :
0) stop at label (subnet = 2) in module (top.pksw1.hub.hub)
Traces :
Full trace is disabled
Encapsulation trace is enabled
Execution trace is disabled
Trace format: indented
No other traces
Actions :
None
Miscellaneous :
Memory tagging is disabled
ODB> cont
__________________________ (ODB 18.6.0: Event) _____________________________
* Time : 3.38813614299 sec, [3s . 388ms 136us 142ns 988ps]
* Event : execution ID (145), schedule ID (#169), type (stream intrpt)
* Source : execution ID (143), top.pksw1.hub.rcv1 (pt-pt receiver)
* Data : instrm (1), packet ID (12)
> Module : top.pksw1.hub.hub [Objid=32] (processor) [process id: 17]
breakpoint #0 trapped : "stop at label (subnet = 2) in module (top.pksw1.hub.hub)"