包概述
事件包是一组内核过程的集合,为进程提供有关仿真中事件的信息。这些事件可以看作按执行顺序存储在列表中。事件列表的头部是当前事件,列表中的每个事件都会在其后一个事件之前发生。事件包使用 Evhandle 来引用事件。
多个内核过程提供对事件列表中事件的访问。内核过程 op_ev_current() 返回与当前事件关联的 Evhandle,op_ev_current_execid() 返回当前事件的执行 ID。以任何有效事件作为起点,进程都可以使用内核过程 op_ev_next() 逐步遍历事件列表。如果进程要查找相对于某个仿真时间值的事件,内核过程 op_ev_seek_time() 将定位到最接近所关注时间的事件。
上述内核过程适用于整个事件列表。还有一组类似的内核过程作用于本地事件。若某个事件计划在调用该内核过程的模块处发生,则该事件被视为本地事件。由于当前事件唤醒了调用它的进程,它必然是本地事件。因此,op_ev_current() 可以看作一个本地事件内核过程。op_ev_next_local() 提供了逐步遍历本地事件的能力。
事件包可用于监视未来事件或查找特定的事件集合。如果进程需要遍历全部事件,可以调用 op_ev_count() 获取事件数量,然后将该数量用作 for 循环的上界。op_ev_count_local() 返回本地事件的数量。
已计划的事件有时会在到达之前变得过时。例如,一个进程可能计划了五分钟的超时时间,却在两分钟后被一个到达的确认数据包打断。由于超时已无必要,挂起事件可能到达反而成为一种不便,需要进程模型对其进行特殊处理。内核过程 op_ev_cancel() 消除了对已失去意义的事件进行特殊处理的需要。该内核过程基于事件的 Evhandle 取消一个挂起事件。内核过程 op_ev_pending() 判断事件是否仍然挂起。如果对未挂起的事件应用 op_ev_cancel(),将发生可恢复错误。在多线程环境中,可以使用内核过程 op_ev_cancel_if_pending() 在取消事件之前先验证该事件。
事件的两个常用属性是其类型和计划时间。内核过程 op_ev_type() 为进程提供一个表示事件类型的整数代码;该代码可与第 15 页的表 59“中断类型符号常量“中的常量进行比较。内核过程 op_ev_time() 返回事件计划发生的时间。
自中断、远程中断或组播中断可以有许多不同的用途。例如,单个进程可以安排自中断来模拟各种处理延迟和超时时间。为了区分这类中断的用途,可以为自中断、远程中断和组播中断关联一个由用户定义含义的整数数字代码。对应事件的代码可以通过内核过程 op_ev_code() 获取。
流中断由在输入流上到达的数据包引起。内核过程 op_ev_strm() 确定数据包将在哪个输入流上到达。
统计量中断由响应模块统计量值中特定类型变化的触发器引起。内核过程 op_ev_stat() 确定与事件关联的是哪个输入统计量。注意,该内核过程不提供有关该统计量的信息(例如其名称或触发条件);它只提供输入统计量的数字索引。
要获取特定事件的 ID,请使用 op_ev_id()。要获取事件 ID 的字符串表示,请使用 op_ev_id_str_get()。
多数类型的事件源自特定模块。流中断源自生成或转发了到达数据包的模块。自中断、远程中断和组播中断源自安排它们的模块。要获取作为事件源的模块(对于故障和恢复中断则是链路或节点)的对象 ID,可以使用内核过程 op_ev_src_id()。三种类型的事件没有源对象:begin simulation、end simulation 和常规中断。要获取作为事件目标的模块的对象 ID,可以使用内核过程 op_ev_dst_id()。
内核过程 op_ev_equal() 提供了比较两个 Evhandle 的能力。如果两个 Evhandle 指向同一个事件,则认为它们相等。这对于等待某个特定事件的进程很有用:它可以保存该事件的 Evhandle,并使用 op_ev_equal() 将其与当前事件进行比较。
事件分为计划(scheduled)事件和强制(forced)事件。如果一个事件按执行顺序被放入事件列表,则它是计划事件。强制事件绕过事件列表,立即中断目标模块,“强制”它处理该事件。
源自进程的事件可以关联用户指定的信息。这些信息可以传达有关事件的数据,也可能传达所请求服务的类型。将此类信息与事件关联有两种方式:
- 接口控制信息(ICI)——ICI 由 Ici 包的内核过程操作,在源进程和接收进程中均是如此。内核过程 op_ici_install() 在源进程处将指定的 ICI 与发出的中断绑定。内核过程 op_ev_ici() 获取与事件关联的 ICI。
- 状态信息——与 ICI 机制相比,状态信息提供了更快的传达事件数据的方式。内核过程 op_ev_state_install() 指定要与事件关联的用户自定义数据结构。内核过程 op_ev_state() 返回与事件关联的状态。内核过程 op_ev_state_clear() 将移除与事件关联的状态。
事件句柄经常会被以它们作为参数的事件包内核过程检验其有效性。当事件句柄指向已被取消或已经发生的事件时,句柄即失效;此外,事件句柄也可能来自返回了表示错误的句柄的内核过程。可以使用内核过程 op_ev_valid() 检验事件句柄的有效性。当内核过程返回某个事件句柄且对其是否成功存有疑问时,通常需要进行这种检验;类似地,如果无法确定某个事件句柄指向的事件是否仍然挂起,可以在使用其他内核过程操作该句柄之前先调用 op_ev_valid()。