在 ODB 中使用断点

ODB 的控制架构如图 9所示。ODB 被调用后,就像一个控制仿真中事件执行的阀门。ODB 的"阀门"可以处于开启或关闭状态。开启状态下,ODB 允许事件正常顺序执行,从而将中断传递给仿真对象。关闭状态下,ODB 停止事件执行,等待用户命令,并在收到命令后处理该命令。这种关闭状态对应于仿真中断点的概念:仿真在事件流的特定"位置"处停止("断"于某个"点")。阀门的开启状态对应于仿真继续执行的概念。ODB 的一项基本功能就是根据待触发断点列表,在合适的时刻停止仿真。

图 9:ODB/仿真控制架构

ODB/仿真控制架构

初次进入 ODB 解释器时,仿真处于断点状态(即事件执行已停止,ODB 等待命令)。此时仿真时间为 0.0,事件列表包含所有启用了 begsim 事件的模块的初始 begsim 事件集合。这一初始断点允许在仿真开始执行事件之前输入 ODB 命令。

在 ODB 中推进仿真执行有两种方法:单事件执行,以及继续执行事件直到出现断点。单事件执行通过 next 命令完成,它执行紧邻的待执行事件,并在下一个事件之前自动设置断点。使用这种方式,用户可以精细地控制仿真,并且每个事件在执行前都会打印其信息。然而,仿真可能需要执行数十万个事件才能到达用户感兴趣的事件。用户定义的断点允许仿真以最高执行速度推进,直到出现值得关注的情况。ODB 命令 cont(continue 的缩写)开始执行仿真事件,直到出现待触发断点。

图 10:ODB 控制下的事件执行

ODB 控制下的事件执行

断点除了发生在两个事件之间,也可以发生在单个事件的执行过程中。这种事件内断点或者由特定进程的调用触发,或者由进程调用引发断点的 KP 触发。当在事件内部遇到这种断点时,可能需要多条 next 或 cont 命令才能越过该事件,如下图所示。

图 11:事件内断点

事件内断点

当断点发生在事件之间时,ODB 会打印一个描述下一个待执行事件的横幅。由于事件在执行前已被描述,用户可以判断该事件是否特别值得关注、是否应在执行时密切观察。事件横幅的格式如下所示,并在随后的段落中说明。

图 12:ODB 事件横幅格式

__________________________(ODB 10.0.A: Event)

* Time   :  0.0741848742007 sec, [00d 00h 00m 00s . 074ms 184us 874ns 201ps]
* Event  :  execution ID (12), schedule ID (#20), type (stream intrpt)
* Source :  execution ID (11), top.pksw2.node1.proc (processor)
* Data   :  instrm (0), packet ID (0)
> Module :  top.pksw2.node1.xmt (pt-pt transmitter)

事件横幅的第一行(标记为 "Time")以两种格式显示仿真时间。第一种是以秒为单位的时间值的双精度表示。第二种格式将时间值分解为标准时间码单位,格式如下图所示。

图 13:事件横幅时间码格式

事件横幅时间码格式

事件横幅的第二行(标记为 "Event")显示事件的标识信息,包括事件的执行 ID、调度 ID 和中断类型。执行 ID 是基于事件发生顺序的序号。调度 ID 是基于事件被调度顺序的序号。例如,仿真中第五个被调度的事件的调度 ID 为 5,无论实际有多少事件在它之前发生。执行 ID 和调度 ID 通常不具有相同的值。事件在等待执行期间其调度 ID 保持不变,但如果之后有其他事件被安排在其之前发生,其执行 ID 可能改变。调度 ID 数字前总是带有编号符号 (#),以区别于执行 ID 数字。

横幅的中断类型字段将取下列值之一:

  • access intrpt
  • begin sim intrpt
  • end sim intrpt
  • esys interface intrpt
  • failure intrpt
  • multicast intrpt
  • procedure call intrpt
  • process intrpt
  • recovery intrpt
  • regular intrpt
  • remote intrpt
  • self intrpt
  • statwire intrpt
  • stream intrpt

事件横幅的第三行(标记为 "Source")显示待执行事件的来源信息。显示的两个字段是:导致当前事件被调度的前驱事件的执行 ID,以及与前驱事件关联的模块的全名。利用这些信息可以从当前事件沿所有前驱事件的"链"向过去追溯。

事件横幅的第四行(标记为 "Data")显示随事件携带的信息。在此示例中,到达数据包的流索引和数据包 ID 与该事件关联。这一行的格式随事件类型而异。procedure call、process、remote 和 self 中断在这一行显示用户定义的代码;如果你在 Process Editor 中定义了"Interrupt Code Map",文本标签将与整数值一起显示。

事件横幅的第五行也是最后一行(标记为 "Module")显示事件目标模块的全名。模块的全名指定了从网络模型顶层到该模块的层次"路径"。路径由模块名、所在节点名以及所有上层子网名组成(如果模块所在节点位于网络模型的顶层,其子网名就是 "top")。在上一页的示例事件横幅中,上层子网名是 pksw2,所在节点名是 node1,模块名是 xmt。模块类型显示在括号中(在本例中,该模块是点对点发送器)。

每当出现 ODB 提示符时都可以设置新的断点。注意,在 ODB 命令中实际上并不使用 "breakpoint" 一词,而是使用同义词 "stop" 出现在命令名称中。例如,为特定事件设置断点的命令名为 evstop。ODB 支持基于特定事件、时间、进程、模块,或模块与中断类型组合来设置断点的命令。

表 7:基本断点设置命令

"comstop" 为特定的发送和接收设置断点。
"esastop" 使联合仿真在当前事件之后返回到外部代码。
"evstop" 为指定的待执行事件设置断点。断点将在该事件执行之前立即触发。
"interfacestop" 为联合仿真中写入指定 esys 接口的值设置断点。当有值到达指定接口时,断点将停止仿真。
"intstop" 为指定模块上指定类型的中断设置断点。断点将在中断交付之前立即触发。
"mstop" 为交付到指定模块的所有中断设置断点。断点将在中断交付之前立即触发。
"pkstop" 为特定数据包设置断点。断点将在处理该数据包的每个事件执行之前立即触发。
"prostop" 为指定进程的所有调用设置断点。断点将在进程调用之前立即触发。
"tstop" 为指定时间设置断点。断点将在晚于指定时间的第一个事件执行之前立即触发。

上述基本断点基于相当粗略的条件触发。要让 ODB 恰好在仿真中的正确位置停止,可能需要连续触发多个此类断点,之后还可能通过 next 命令执行若干单事件。例如,如果希望让某个排队过程恰在完成处理来自特定输入流的数据包时停止,可以先通过 mstop 在队列上设置断点并反复触发,直到数据包到达期望的流;然后通过 evstop 为指示数据包处理完成的 self 中断设置断点。

还有另一类断点,称为带标签断点,它支持基于进程动作的条件触发。它允许单个断点直接以精准的方式触发复杂条件。此外,带标签断点允许在进程模型中预先定义预期的断点位置并加以标记,以便在 ODB 中方便地后续使用。带标签断点通过带有标签参数的 ODB 命令设置。

注: 断点使用的标签与带标签跟踪记录使用的标签处于不同的空间。跟踪记录和断点可以有同名的标签,但它们互不影响。

当进程调用内核过程 op_prg_odb_bkpt() 并传入与 ODB 中某个待触发断点匹配的标签时,带标签断点即被触发。因此,带标签断点的触发条件由进程动作与 ODB 命令共同定义。

图 14:进程状态中的带标签断点

/* Acquire an Ethernet frame. */
eth_pkptr = op_pk_get (LOW_LAYER_INPUT_STREAM);

/* Extract the frame’s address. */
op_pk_nfd_get (eth_pkptr, "dst_addr", &dest_addr);

/* If this is a broadcast packet, define a breakpoint. */
if (dest_addr == ETH_MAC_BROADCAST_ADDR)
   op_prg_odb_bkpt ("eth_bcast_pk");

带标签断点命令存在多个版本;它们与部分基本断点命令相互对应。

表 8:带标签断点设置命令

"lstop" 设置带标签断点,当任何对内核过程 op_prg_odb_bkpt() 的调用带有匹配标签时触发。
"mlstop" 设置带标签断点,当对内核过程 op_prg_odb_bkpt() 的调用带有匹配标签时触发(限定于特定模块)。
"prolstop" 设置带标签断点,当对内核过程 op_prg_odb_bkpt() 的调用带有匹配标签时触发(限定于特定进程)。

使用上述命令之一设置断点,会将其添加到 ODB 维护的待触发断点列表中。ODB 利用断点列表决定何时停止仿真执行;该列表可以通过 status 命令显示,如下所示。列表每行左侧的数字是断点 ID,用于在修改断点的 ODB 命令中标识特定断点。

表 9:断点列表命令

"status" 显示待触发断点、跟踪记录和动作的列表。

图 15:status 命令显示的断点列表

ODB> status

Breakpoints :
   0  stop at time = (150) sec.
   1  stop at event (45)
   2  stop at label (txl) in module (top.f_0.p_1)
...

断点可以处于激活或挂起状态。激活的断点在其关联条件出现时停止仿真执行。挂起的断点被临时停用,即使其关联条件出现也不会停止仿真执行。断点的挂起与激活允许用户开关断点,而无需完全重建它们。断点可以在触发之前或之后从列表中删除。注意,通过 tstop 设置的时间断点在触发后会自动从断点列表中删除。ODB 支持激活、挂起和删除断点的命令。

表 10:断点修改命令

"actstop" 重新激活指定的挂起断点。
"delstop" 从待触发断点列表中删除指定断点。也可以删除列表中的所有断点。
"suspstop" 挂起指定断点,使其在重新激活之前不会被触发。