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) **
...