mlstop
摘要
设置限定于指定模块的带标签断点。当指定模块内的进程以匹配的标签调用内核过程 op_prg_odb_bkpt() 时,该断点将停止仿真。
语法
mlstop <objref> <label>
| 参数 | 类型 | 说明 |
|---|---|---|
<objref> |
integer or string | 目标模块的数字对象 ID 或层次名称 此参数的对象 ID 可通过 ODB 命令 objmap 或 objid 获得。 |
<label> |
string | 断点的标签字符串 标签可以包含字母数字字符、空格和特定标点符号,但如果包含空格,必须用双引号括起来。 用于断点的标签与用于带标签跟踪记录的标签处于不同的空间。跟踪记录和断点可以有同名标签,但彼此互不影响。 |
说明
当内核过程 op_prg_odb_bkpt() 在指定模块内以与断点标签匹配的 label 参数被调用时,带标签的模块断点会被触发。带标签的模块断点是无限期的,因为它们与可重复出现的情形相关联,并且在被触发后仍保留在待触发断点列表中。断点可以通过命令 suspstop 暂停、通过 actstop 重新激活,或通过 delstop 删除。
示例
本示例假设代码中出现类似如下的语句,用于有条件地设置断点标签。
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)"