proldiag

摘要

执行指定进程的诊断块,并在该块的执行期间为指定标签设置跟踪记录。块内对内核过程 op_prg_odb_ltrace_active() 的调用若标签匹配,则返回 1。

语法

proldiag <process_id> [<label>] [--args <arg>]

参数 类型 说明
<process_id> integer 目标进程的数字化进程 ID
可通过执行 ODB 命令 objprint 或 promap 获取进程 ID,二者都会显示与特定模块关联的现有进程列表。
<label> string [可选] 一个或多个以空格分隔的字符串,指定要跟踪进程中的哪些标签
每个标签可包含字母数字字符、空格和特定标点,但若包含空格,必须用双引号括起。
若命令中未给出标签,proldiag 将显示进程模型中找到的标签列表。
<arg> string [可选] 一个或多个以空格分隔的字符串,指定要传递给诊断块的参数。
每个参数可包含字母数字字符、空格和特定标点,但若包含空格,必须用双引号括起。

详细说明

进程模型的诊断块可包含多条 C 语句,用于在 ODB 环境中进行诊断(诊断块的完整说明见“在 ODB 中使用诊断块”第 53 页)。诊断语句可以访问进程状态变量,因此可用于显示其值。

proldiag 命令执行整个诊断块,同时为指定标签设置跟踪记录。如果某些语句的执行取决于内核过程 op_prg_odb_ltrace_active() 的布尔返回值(如示例所示),则可以利用带标签的跟踪记录来控制诊断块内执行的语句。该技术适用于定义多个相互独立的诊断操作,每个操作都可以通过带有相应启用标签的 proldiag 命令触发。

可选的 --args 参数允许你向诊断块代码传递一个或多个字符串。你可以在诊断块中通过内核过程 op_prg_odb_prodiag_args() 访问这些参数,用于定制诊断例程的执行。

示例

在本示例中,需要在 pksw_nd_proc 进程模型的指定位置添加以下代码。

diagnostic block:         if (op_prg_odb_ltrace_active (“xmit”))
                                 printf (“\n(%d packets transmitted)\n", xmit_packets);
xmt state enter execs:    xmit_packets++;
init state enter execs:   xmit_packets = 0;
state variables:          int \xmit_packets;

----------------------------------------------------------------------------------
...

breakpoint #0 trapped : "stop at time (50) sec."

ODB> promap pksw1.node0.proc
________________________________________________________________
Active Processes for Module (23)
process ID     process model       process tag
----------     -------------       -----------
1              pksw_nd_proc        (none)

ODB> proldiag 1
Following ODB labels are available for the process [1]: xmit

ODB> proldiag 1 xmit

(34 packets transmitted)

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