op_intrpt_schedule_self()
摘要
为调用进程安排一个自中断。
语法
op_intrpt_schedule_self (time, code)
| 参数 | 类型 | 说明 |
|---|---|---|
time |
double |
中断的安排时间 [该值是绝对仿真时间,而不是相对于当前仿真时间的延迟。如果“sim_time_quantum“首选项的值不为 0.0,time 将在内部被截断为指定量子(quantum)的整数倍。] |
code |
int |
与中断关联的用户定义数字代码 [该值是任意的、用户定义的整数,可用作所安排中断的识别代码;当中断调用进程时,可使用内核过程 op_intrpt_code() 获取该代码。你可以为其指定一个文本字符串,当该代码出现在 ODB 事件横幅和跟踪中时,会连同该代码一起打印。有关详情,参见“Interrupt Code Map“ 第 507 页。] |
返回类型
Evhandle
所安排中断的事件句柄。
[该返回值可以存储在状态变量中,以便在后续调用 op_ev_cancel() 时用于识别该中断。]
示例
摘自:示例模型(models/std/base);进程模型(acb_fifo);状态(svc_start);enter 执行。
/* get a handle on packet at head of subqueue 0 */
/* (this does not remove the packet) */
pkptr = op_subq_pk_access (0, OPC_QPOS_HEAD);
/* determine the packet’s length (in bits) */
pk_len = op_pk_total_size_get (pkptr);
/* determine the time required to complete */
/* service of the packet */
pk_svc_time = pk_len / service_rate;
/* schedule an interrupt for this process */
/* for the time when service ends. */
op_intrpt_schedule_self (op_sim_time () + pk_svc_time, 0);
/* the server is now busy. */
server_busy = 1;
详情
调用该内核过程会在仿真事件列表上放置一个新事件;这个新事件表示一个安排在指定时间传送的自中断。事件一经安排,该内核过程就把控制权返回给调用进程。在延迟区间内,调用进程可以自由地进行任何活动。该事件将在安排的仿真时间发生,但不会先于为该特定仿真时间安排的其他更高优先级事件的执行。当所有较早的事件都已执行完毕,且自中断事件位于仿真事件列表的头部时,其仿真时间被确立为当前仿真时间,事件随即执行。事件的执行会使一个自中断被传送给调用进程。该进程可以通过内核过程 op_intrpt_code() 获取与中断关联的指定代码。
当自中断表示超时或类似事件时,如果它变得不再必要,取消它往往很有用(例如,由于在超时到期之前收到了 ack 而需要撤销超时)。取消中断要求把该内核过程返回的事件句柄存储在状态变量中,并在稍后传递给内核过程 op_ev_cancel(),如下例所示:
/* state variable declaration */
Evhandle \evh;
/* self interrupt scheduling */
evh = op_intrpt_schedule_self (sch_time, 5);
/* self interrupt cancelling */
op_ev_cancel (evh);
用途
提供了一种为指定的未来时间安排自中断(即“唤醒调用”)的机制。这常用于划定表示进程某种模式的区间的结束。在建模超时的情况下,该模式是等待数据包到达,而超时自中断标志着区间的结束。在建模处理延迟的情况下,该模式是执行某项任务,而“任务结束”自中断标志着任务的完成并释放任务的产物(即一个已处理的数据包)。在区间结束时,进程通常会回到空闲模式,或重新评估它还应承担哪些其他待处理任务。
错误
- 程序中止:内存分配失败。
- 程序中止:该内核过程需要进程上下文。(如果从处理器或队列之外调用)
- 可恢复错误:指定时间 (
<time>) 小于当前时间。 - 可恢复错误:指定时间 (
<time>) 是无效的双精度值。
参考
- 使用内核过程 op_intrpt_schedule_self_mt() 安排一个保证 MT 安全、可考虑并行执行(忽略模块实际 MT 安全规则)的自中断
- 使用内核过程 op_intrpt_schedule_remote() 安排远程中断
- 使用内核过程 op_intrpt_force_remote() 强制远程中断
- 使用内核过程 op_intrpt_schedule_call() 安排过程中断
- 使用内核过程 op_ev_cancel() 取消待处理的自中断、远程中断或过程中断
- 使用内核过程 op_intrpt_code() 获取与传入中断关联的代码