op_pk_send()
摘要
将指定数据包通过输出数据包流转发,将数据包到达目标模块的时间安排为当前仿真时刻,并释放调用进程对该数据包的拥有权。
语法
op_pk_send (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/eth_net);进程模型(eth_mac);状态(TX_START);进入执行语句。
/* increment the number of attempts made so far */
/* on the current frame */
attempts ++;
/* the frame is no longer waiting; notify */
/* the deference process of this transition */
frame_waiting = 0;
op_stat_write (FRAME_WAITING_OUTSTAT, frame_waiting);
/* record the start time for the transmission attempt */
/* in order to determine if late collisions occur */
/* (these are collisions occurring beyond one slot time) */
frame_start_time = op_sim_time ();
/* send frame to bus transmitter */
op_pk_send (tx_frame, LOW_LAYER_OUTPUT_STREAM);
详情
该内核过程将指定数据包到达目标模块的时间安排下来。到达时间安排在当前仿真时刻,对应的事件被加入仿真事件列表。该事件将在任何仿真时间流逝之前发生,但不会先于已安排在当前仿真时刻的其他事件的执行。事件执行时,目标模块将以流中断方式被调用。如果目标模块是处理器或队列,其关联进程可通过内核过程 op_intrpt_type() 判断该中断是否由输入流引起。到达输入数据包流的数据包可由目标进程通过内核过程 op_pk_get() 获取。
数据包一旦传递给该内核过程,调用进程即失去对该数据包的拥有权,拥有权转移给目标模块。这使当前进程不能再继续使用该数据包。
该内核过程要求进程上下文,因此只能从进程模型、或由进程模型调用的函数中调用。该内核过程同时支持格式化与非格式化数据包。
用途
提供一种在节点内通过数据包流相连的模块之间传输数据包的机制。该内核过程是仿真中数据包转发的基本手段。该内核过程的变体可在目标模块产生延迟、强制或静默到达;而另一组 op_pk_deliver…() 内核过程则提供不依赖模块之间物理连接的数据包传输。
op_pk_send() 允许将数据包转发到处理器或队列中运行的其他进程,或转发到发射机模块。
错误
- 程序中止:段错误。(由无效的数据包指针或畸形数据包引起)
- 程序中止:数据包指针为 NIL。
- 程序中止:数据包指针引用已被销毁的数据包。
- 程序中止:数据包指针引用无主数据包(
<pk_id>)。 - 程序中止:数据包指针引用静态数据包(
<pk_id>)。 - 程序中止:数据包投递在对象(
<mod_objid>)、流(<instrm_index>)处失败 - 程序中止:内核过程要求进程上下文
- 可恢复错误:输出流索引(
<outstrm_index>)超出范围。 - 可恢复错误:输出流索引(
<outstrm_index>)未被占用。
参考
- 使用内核过程 op_pk_send_delayed() 发送延迟到达的数据包
- 使用内核过程 op_pk_send_forced() 发送数据包并在目标处立即开始处理
- 使用内核过程 op_pk_send_quiet() 发送数据包且不在目标模块引起中断
- 使用内核过程
op_pk_deliver…()在不使用数据包流的情况下将数据包转发到其他模块 - 使用内核过程 op_pk_get() 获取到达数据包的指针