proltrace

摘要

为指定进程设置带标签的跟踪记录。指定进程对 KP op_prg_odb_ltrace_active() 的调用,若传入的标签参数与该跟踪记录匹配,则返回 1。此 KP 可用于启用用户定义的诊断消息或其它操作。

语法

proltrace <process_id> [<label>]

参数 类型 说明
<process_id> integer 目标进程的数字进程 ID
可使用 ODB 命令 objprint 或 promap 获得进程 ID,二者都会显示与特定模块关联的现有进程列表。
<label> string [可选] 一个或多个以空格分隔的字符串,指定要跟踪进程中的哪些标签
每个标签可包含字母数字字符、空格和某些标点符号,但若包含空格,必须用双引号括起。
如果命令中未给出标签,proltrace 会显示在进程模型中找到的标签列表。
跟踪记录使用的标签与带标签断点使用的标签处于不同的空间。跟踪记录和断点可以有同名标签,但彼此互不影响。

详细说明

带标签的跟踪记录不会发出 Kernel Procedure(内核过程)跟踪消息。直接或间接导致被跟踪进程调用 op_prg_odb_ltrace_active() 的事件会由事件横幅指示。跟踪记录可以用命令 susptrace 挂起、用 acttrace 重新激活,或用 deltrace 删除。

示例

对于本例,必须在进程模型 pksw_hub_proc 的 route_pk 状态 enter execs 中、从第 9 行开始的 else 子句内添加以下代码行。

if (op_prg_odb_ltrace_active ("xroute"))
    printf ("\n** cross route (%d) -> (%d) **\n", subnet_id, dest_subnet);

----------------------------------------------------------------------------------
ODB> proltrace 5
Following ODB labels are available for the process [5]: xroute

ODB> proltrace 5 xroute
Added trace #0: trace on label (xroute) in process (5)

ODB> cont

__________________________ (ODB 18.6.0: Event) ____________________________

    * Time   :  3.37121714973 sec, [3s . 371ms 217us 149ns 731ps]
    * Event  :  execution ID (59), schedule ID (#71), type (stream intrpt)
    * Source :  execution ID (58), top.pksw2.hub.rcv1 (pt-pt receiver)
    * Data   :  instrm (1), packet ID (4)
    > Module :  top.pksw2.hub.hub [Objid=180] (processor) [process id: 76]

** cross route (2) -> (1) **

__________________________ (ODB 18.6.0: Event) ____________________________

    * Time   :  4.66310754514 sec, [4s . 663ms 107us 545ns 137ps]
    * Event  :  execution ID (79), schedule ID (#91), type (stream intrpt)
    * Source :  execution ID (75), top.pksw2.hub.rcv2 (pt-pt receiver)
    * Data   :  instrm (2), packet ID (5)
    > Module :  top.pksw2.hub.hub [Objid=180] (processor) [process id: 76]

** cross route (2) -> (1) **

...

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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