op_pk_deliver()

摘要

将指定数据包转发到远程模块,将数据包到达该模块的时间调度在当前仿真时间,并释放调用进程对该数据包的所有权。

语法

op_pk_deliver (pkptr, mod_objid, instrm_index)
参数 类型 说明
pkptr Packet* 指向目标数据包的指针
[指向数据包的指针可以从许多内核过程获得,包括 op_pk_create()、op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。]
mod_objid Objid 远程模块的对象 ID
[模块对象 ID 可以从 Topo 和 Id 包中的若干内核过程获得:op_id_self()、op_topo_child() 和 op_id_from_name()。]
instrm_index int 远程模块某个输入数据包流的索引

返回类型

void

无返回值。

示例

/* obtain the object ID of remote telemetry processor */
node_objid = op_id_from_name (0, OPC_OBJTYPE_NODE_FIXED, "tlm_node");
proc_objid = op_id_from_name (node_objid, OPC_OBJTYPE_PROC, "tlm_proc");

/* create a packet */
pkptr = op_pk_create (128);

/* stuff packet with operation code */
op_pk_fd_set (pkptr, 0, OPC_FIELD_TYPE_INTEGER, OPCODE_ACTIVATE, 0);

/* deliver the packet to remote processor */
op_pk_deliver (pkptr, proc_objid, 0);

详情

该内核过程将指定数据包到达指定远程模块的时间进行调度。到达时间被调度在当前仿真时间,相应的事件被加入仿真事件列表。该事件将在任何仿真时间推进之前发生,但不会先于已调度在当前仿真时间的其他事件执行。事件执行时,远程模块将以流中断方式被调用。如果远程模块是处理器或队列,其关联的进程可以通过内核过程 op_intrpt_type() 判断该中断是由输入流引起的。到达输入数据包流的数据包可由目标进程通过内核过程 op_pk_get() 获取。

数据包一旦传递给该内核过程,调用进程即失去对该数据包的所有权,因为所有权已转移给远程模块。传递方进程再调用任何内核过程时若传入这个“失效”的数据包指针,将导致数据包所有权错误。

未格式化和已格式化的数据包都可以通过该内核过程传递。

用途

提供一种不依赖数据包流、在模块之间传递数据包的机制。使用该内核过程传递数据包是面向数据包流的 op_pk_send…() 系列内核过程的替代方式。当模块与节点之间的物理互连不影响对等进程之间的传输时,或者当网络架构的底层(即物理层、数据链路层和网络层)未被显式建模时,这种替代方式非常有用。该内核过程的变体提供在远程模块的延迟到达、强制到达或静默到达。数据包可以交付到处理器或队列中运行的其他进程,或交付到发射机模块。

错误

  • 程序中止:Segmentation violation.(由于无效的数据包指针或格式错误的数据包)
  • 程序中止:数据包指针为 NIL。
  • 程序中止:数据包指针指向已销毁的数据包。
  • 程序中止:数据包指针指向无主数据包 (<pk_id>)。
  • 程序中止:数据包指针指向静态数据包 (<pk_id>)。
  • 程序中止:数据包交付失败,对象 (<mod_objid>),流 (<instrm_index>)。
  • 可恢复错误:对象 ID (<mod_objid>) 超出范围。

参考

  • 使用内核过程 op_pk_deliver_delayed() 交付数据包,其到达带有延迟
  • 使用内核过程 op_pk_deliver_forced() 交付数据包以便在远程模块立即处理
  • 使用内核过程 op_pk_deliver_quiet() 交付数据包且不在远程模块引起中断
  • 使用 op_pk_send…() 内核过程通过数据包流向相邻模块转发包
  • 使用内核过程 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