op_intrpt_schedule_remote()
摘要
在指定的时间为指定的处理器或队列安排一个远程中断。
语法
op_intrpt_schedule_remote (time, code, mod_objid)
| 参数 | 类型 | 说明 |
|---|---|---|
time |
double |
中断的安排时间 [该值是绝对仿真时间,而不是相对于当前仿真时间的延迟。如果“sim_time_quantum“首选项的值不为 0.0,time 将在内部被截断为指定量子(quantum)的整数倍。] |
code |
int |
与中断关联的用户定义数字代码 [该值是任意的、用户定义的整数,可用作所安排中断的识别代码;当中断调用进程时,可使用内核过程 op_intrpt_code() 获取该代码。你可以为其指定一个文本字符串,当该代码出现在 ODB 事件横幅和跟踪中时,会连同该代码一起打印。有关详情,参见“Interrupt Code Map“ 第 507 页。] |
mod_objid |
Objid |
将接收中断的处理器或队列的对象 ID [处理器或队列的对象 ID 可通过 Id 包中的多个内核过程获取: op_id_self()、op_topo_child() 和 op_id_from_name()。] |
返回类型
Evhandle
所安排中断的事件句柄。
[该返回值可以存储在状态变量中,以便在后续调用 op_ev_cancel() 时用于识别该中断。]
示例
摘自:示例模型(models/std/fddi);进程模型(fddi_mac);功能块。
fddi_tk_inject (int address)
{
/* Re-insert the token into the ring in response to */
/* a station registering its intent to send data after */
/* a dead period on the ring. */
FIN (fddi_tk_inject (address))
/* The token is recreated and reinserted onto the ring */
/* at the specified station which is not necessarily the */
/* station now requesting the token. */
/* The station which will reinsert the token is */
/* asked to do so by means of a remote interrupt. */
op_intrpt_schedule_remote (op_sim_time (), 0, Fddi_Address_Table [address]);
FOUT
}
详情
调用该内核过程会在仿真事件列表上放置一个新事件;这个新事件表示一个安排在指定时间传送的远程中断。事件一经安排,该内核过程就把控制权返回给调用进程,调用进程随即可以自由地进行任何活动。该事件将在安排的仿真时间发生,但不会先于为该特定仿真时间安排的其他更高优先级事件的执行。当所有较早的事件都已执行完毕,且远程中断事件位于仿真事件列表的头部时,其仿真时间被确立为当前仿真时间,事件随即执行。事件的执行会使一个远程中断被传送到指定模块。该模块的进程可以通过内核过程 op_intrpt_code() 获取与中断关联的指定代码。
有时由于条件变化而需要取消远程中断(例如,一个进程安排了一个在特定时间请求路由更新的中断,但在所安排的更新请求传送到远程模块之前,由于其他原因已经收到了更新)。取消中断要求把该内核过程返回的事件句柄存储在状态变量中,并在稍后传递给内核过程 op_ev_cancel(),如下例所示:
/* state variable declaration */
Evhandle \evh;
/* remote interrupt scheduling */
evh = op_intrpt_schedule_remote (stime, 22, mod_objid);
/* remote interrupt cancelling */
op_ev_cancel (evh);
用途
提供了一种机制,使一个进程能够远程调用另一个进程,而无需它们之间存在物理数据包流或统计量连线。当一个进程需要提醒另一个进程某件值得关注的事情已经发生时(例如,队列进程在数据包容量饱和时可以中断另一个节点中的处理器),这会很有用。
警告: 远程中断只能传送给处理器和队列,否则会发生错误。
错误
- 程序中止:内存分配失败。
- 可恢复错误:指定时间 (
<time>) 小于当前时间。 - 可恢复错误:指定时间 (
<time>) 是无效的双精度值。 - 可恢复错误:对象 ID (
<mod_objid>) 超出范围。 - 可恢复错误:对象 (
<mod_objid>) 类型不正确;应为队列或处理器对象。
参考
- 使用内核过程 op_intrpt_schedule_self() 安排自中断
- 使用内核过程 op_intrpt_force_remote() 强制远程中断
- 使用内核过程 op_intrpt_schedule_call() 安排过程中断
- 使用内核过程 op_ev_cancel() 取消待处理的中断
- 使用内核过程 op_intrpt_code() 获取与传入中断关联的代码