mltrace
摘要
设置限定于指定模块的带标签跟踪记录。当内核过程 op_prg_odb_ltrace_active() 被传入与该跟踪记录匹配的 label 参数时,将返回 1。
语法
mltrace <objref> <label>
| 参数 | 类型 | 说明 |
|---|---|---|
<objref> |
integer or string | 目标模块的数字对象 ID 或层次名称 此参数的对象 ID 可通过 ODB 命令 objmap 或 objid 获得。 |
<label> |
string | 跟踪记录的标签字符串 标签可以包含字母数字字符、空格和特定标点符号,但如果包含空格,必须用双引号括起来。 用于跟踪记录的标签与用于带标签断点的标签处于不同的空间。跟踪记录和断点可以有同名标签,但彼此互不影响。 |
说明
带标签的跟踪记录不会发出内核跟踪消息;相反,op_prg_odb_ltrace_active() 的调用会返回 1,该返回值可用于触发用户自定义的诊断消息或其他操作(有关此内核过程的更多细节,参见第 85 页的 op_prg_odb_ltrace_active())。直接或间接导致调用 op_prg_odb_ltrace_active() 的事件会以事件横幅标示。跟踪记录可以通过命令 susptrace 暂停、通过 acttrace 重新激活,或通过 deltrace 删除。
示例
本示例假设代码中在需要“pk_created”跟踪记录的位置出现类似如下的语句。
if (op_prg_odb_ltrace_active ("pk_created"))
printf ("\nPk Created: objid (%d), time (%g)\n", op_id_self (), op_sim_time ());
-----------------------------------------------------------------------------------
ODB> mltrace pksw1.node_1.proc pk_created
Added trace #0: “trace on label (pk_created) in module (top.pksw1.node_1.proc)”
ODB> status
Breakpoints :
0) stop at time (75) sec.
Traces :
Full trace is disabled
Encapsulation trace is enabled
Execution trace is disabled
Trace format: indented
0) trace on label (pk_created) in module (top.pksw1.node_1.proc)
Actions :
None
Miscellaneous :
Memory tagging is disabled
ODB> cont
__________________________ (ODB 18.6.0: Event) ____________________________
* Time : 9.55254459034 sec, [9s . 552ms 544us 590ns 342ps]
* Event : execution ID (123), schedule ID (#141), type (stream intrpt)
* Source : execution ID (122), top.pksw1.node1.src (processor)
* Data : instrm (1), packet ID (12)
> Module : top.pksw1.node_1.proc [Objid=23] (processor) [process id: 94]
Pk Created: objid (63), time (9.55254)
. . .