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)