prolstop
摘要
设置一个带标签的断点,当指定进程以匹配的标签调用 KP op_prg_odb_bkpt() 时停止仿真。
语法
prolstop <process_id> [<label>]
| 参数 | 类型 | 说明 |
|---|---|---|
<process_id> |
integer | 目标进程的数字进程 ID 可通过执行 ODB 命令 objprint 或 promap 获得进程 ID,二者都会显示与特定模块关联的现有进程列表。 |
<label> |
string | [可选] 一个或多个以空格分隔的字符串,指定将进程中的哪些标签设置为断点 每个标签可包含字母数字字符、空格和某些标点符号,但若包含空格,必须用双引号括起。 如果命令中未给出标签, prolstop 会显示在进程模型中找到的标签列表。断点使用的标签与带标签跟踪记录使用的标签处于不同的空间。跟踪记录和断点可以有同名标签,但彼此互不影响。 |
详细说明
处理器和队列可以使用 KP op_pro_create() 创建多个进程,以模拟在模块内部运行的子系统。这种技术的典型用途是创建同一进程模型的多个实例。在这种情况下,由 prolstop 命令设置的带标签进程断点可以隔离到单个进程实例,比范围更广的 mlstop 命令有效得多。
带标签的进程断点是无限期的,因为它们在被触发后仍保留在待触发断点列表中。断点可以用 suspstop 挂起、用 actstop 重新激活,或用 delstop 删除。
示例
对于本例,必须在进程模型 pksw_hub_proc 的 route_pk 状态 enter execs 中、从第 4 行开始的 if 子句内添加以下代码行。
op_prg_odb_bkpt ("same_subnet");
----------------------------------------------------------------------------------
ODB> prolstop 5
Following ODB labels are available for the process [5]: same_subnet
ODB> prolstop 5 same_subnet
Added breakpoint #0: stop at label (same_subnet) in process (5)
ODB> status
Breakpoints :
0) stop at label (same_subnet) in process (5)
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 : 5.07578191176 sec, [5s . 75ms 781us 911ns 757ps]
* Event : execution ID (109), schedule ID (#127), type (stream intrpt)
* Source : execution ID (107), top.pksw2.hub.rcv2 (pt-pt receiver)
* Data : instrm (2), packet ID (8)
> Module : top.pksw2.hub.hub [Objid=37] (processor) [process id: 79]
breakpoint #0 trapped : "stop at label (same_subnet) in process (5)"