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)

. . .

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com