在 ODB 中使用诊断块

进程模型中包含一个称为*诊断块(diagnostic block)*的组成部分,Process Editor 提供编辑该块内容的操作。诊断块由一系列 C 语句构成,这些语句只在 ODB 命令的控制下执行。诊断块语句的典型用途与用户自定义跟踪语句类似:它们可以显示便于快速评估的相关进程信息的汇总,也可以执行与进程资源交互的更复杂的操作。诊断块语句与用户自定义跟踪语句的区别在于调用方式:

  • 用户自定义跟踪语句由 ODB 命令启用,但当包含它们的进程状态因中断交付而执行时才被调用
  • 诊断块语句由 ODB 命令直接调用;任何现存进程的诊断块都可以在任何 ODB 断点处被调用

能够在任意断点执行任意诊断块增强了 ODB 的灵活性。例如,可以为特定进程设置断点,使仿真在合适的中断处停止,然后调用另一个进程中的诊断块,检查只在断点时刻才值得关注的状态变量的值。

调用诊断块有两种方法,说明如下:

表 16:诊断块命令

"prodiag" 调用指定进程的诊断块。
"proldiag" 调用指定进程的诊断块,并为指定标签设置限定于该块执行过程的跟踪记录。在块内带有匹配标签的 op_prg_odb_ltrace_active() 调用返回 1。

基本命令是 prodiag,它不做任何改动地执行整个诊断块。此命令通常与打印进程模型当前状态全面信息的诊断块配合使用。带标签的诊断块调用方式通过 proldiag 命令提供。该命令调用整个诊断块,但在调用期间为单个标签设置跟踪记录,可通过内核过程 op_prg_odb_ltrace_active() 查询。将通过检查不同标签的 if 语句括起来的若干组语句写入,可以编写支持多种不同操作的复杂诊断块。此特性可用于基于 proldiag 以用户自定义的“命令”扩展 ODB 的功能。一个示例如图 22所示。

诊断块通常包含一些用于打印进程信息的语句。要以 ODB 的风格显示消息或变量值,可以使用内核过程 op_prg_odb_print_major() 和 op_prg_odb_print_minor()。若需要更灵活的格式,C 函数 printf() 很有用。

诊断块的作用可以不止于打印信息;它们还可以在进程上下文中执行服务于诊断功能的复杂操作。诊断语句可以包含内核过程调用以及对进程临时变量和状态变量的引用,并且可以修改进程状态。从诊断语句调用的内核过程可以调度稍后才执行的事件。对诊断语句的一项限制是:它们不应调用进程或引起进程的强制中断。

图 22:带标签段的诊断块

/* State variable summary;  label is "sv_summary". */
if (op_prg_odb_ltrace_active ("sv_summary"))
   {
   op_prg_odb_print_major ("----- State Variable Summary -----", OPC_NIL);
   sprintf (mstring, "Sequence Number (%d)", seq_num);
   op_prg_odb_print_minor (mstring, OPC_NIL);
   sprintf (mstring, "Mode (%s)", (mode == MODE_OPEN) ? "open" : "closed");
   op_prg_odb_print_minor (mstring, OPC_NIL);
   }
/* Queue contents summary; label is "q_summary". */
if (op_prg_odb_ltrace_active ("q_summary"))
   {
   op_prg_odb_print_major ("----- Queue Summary -----", OPC_NIL);

   /* Determine how many packets are in the queue. */
   qsize = op_subq_stat (0, OPC_QSTAT_PKSIZE);

   /* Loop through each packet in the queue, printing its address. */
   for (i = 0; i < qsize; i++)
      {
      /* Obtain a pointer to the ith packet & extract address field. */
      pkptr = op_subq_pk_access (0, i);
      op_pk_fd_get (pkptr, PKFD_ADDR, &addr);

      sprintf (mstring, "index (%d): pk address (%d)", i, addr);
      op_prg_odb_print_minor (mstring, OPC_NIL);
      }
   }