op_pk_send_forced()
摘要
将指定数据包通过输出数据包流转发,强制数据包立即到达目标模块并引起相应进程的调用,同时释放调用进程对该数据包的拥有权。
语法
op_pk_send_forced (pkptr, outstrm_index)
| 参数 | 类型 | 说明 |
|---|---|---|
pkptr |
Packet* |
指向目标数据包的指针 [数据包的指针可以从许多内核过程中获得,包括 op_pk_create()、op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。] |
outstrm_index |
int |
外围模块的一个输出数据包流的索引 |
返回类型
void
无返回值。
示例
摘自:示例模型(models/std/base);进程模型(acb_fifo);状态(svc_compl);进入执行语句。
/* extract packet at head of queue */
/* this is the packet just finishing service */
pkptr = op_subq_pk_remove (0, OPC_QPOS_HEAD);
/* forward the packet on stream 0, */
/* causing an immediate interrupt at dest. */
op_pk_send_forced (pkptr, 0);
/* server is idle again. */
server_busy = 0;
详情
该内核过程将指定数据包转发到目标模块,没有任何延迟或安排。所产生的事件是强制的,因此仿真事件列表不参与这一操作。强制事件会使目标模块的进程立即被调用,并带有流中断。与其他引起强制中断的内核过程一样,在目标进程响应的期间,调用进程被挂起;当目标进程完成非强制状态的进入执行语句并释放控制权后,该内核过程将把控制权交还给调用进程,调用进程从调用该内核过程之后的语句继续执行。
数据包一旦传递给该内核过程,调用进程即失去对该数据包的拥有权。发送进程再以任何内核过程传入同一数据包指针,都会导致数据包拥有权错误。该内核过程要求进程上下文,支持发送格式化与非格式化数据包。
警告: 强制中断在并行仿真中效率低下且具有潜在危险。要执行一次强制中断,特定的执行线程必须同时对当前模块和接收强制中断的模块设置执行锁。因此有可能陷入死锁局面。例如,线程 1 正在执行模块 A 的事件并试图向模块 B 发出强制中断,而与此同时线程 2 正在执行模块 B 的事件并试图向模块 A 发出强制中断,就会发生死锁。
用途
提供一种在单个节点内通过数据包流相连的模块之间传输数据包的机制。该内核过程是 op_pk_send() 的一个变体,适用于目标模块必须立即获知数据包到达的情形,通常用于"挤过"流中已排队的其他数据包,或使发起进程在继续之前获得响应。op_pk_send() 的其他变体可在目标模块产生延迟或静默到达;而另一组 op_pk_deliver…() 内核过程则提供不需要物理流对象存在的数据包传输。
op_pk_send_forced() 允许将数据包转发到处理器或队列中运行的其他进程,或转发到为节点间通信链路提供接口的发射机模块。
错误
- 程序中止:段错误。(由无效的数据包指针或畸形数据包引起)
- 程序中止:数据包指针为 NIL。
- 程序中止:数据包指针引用已被销毁的数据包。
- 程序中止:数据包指针引用无主数据包(
<pk_id>)。 - 程序中止:数据包指针引用静态数据包(
<pk_id>)。 - 程序中止:数据包投递在对象(
<mod_objid>)、流(<instrm_index>)处失败。 - 程序中止:内核过程要求进程上下文。
- 可恢复错误:输出流索引(
<outstrm_index>)超出范围。 - 可恢复错误:输出流索引(
<outstrm_index>)未被占用。
参考
- 使用内核过程 op_pk_send() 通过常规事件安排方式发送数据包
- 使用内核过程 op_pk_send_delayed() 发送延迟到达的数据包
- 使用内核过程 op_pk_send_quiet() 发送数据包且不在目标模块引起中断
- 使用内核过程
op_pk_deliver…()在不使用数据包流的情况下将数据包转发到其他模块 - 使用内核过程 op_pk_get() 获取到达数据包的指针