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() 获取到达数据包的指针

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com