op_pk_deliver_quiet()

摘要

将指定数据包转发到远程模块,不调度中断也不调用该模块上运行的进程,并释放调用进程对该数据包的拥有权。

语法

op_pk_deliver_quiet (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 */
oc_pkptr = op_pk_create (128);

/* stuff packet with operation code */
op_pk_fd_set (oc_pkptr, 0, OPC_FIELD_TYPE_INTEGER, REQUEST_UPDATE, 0);

/* deliver the packet to remote processor quietly; */
/* processor will read in at next update interval */
op_pk_deliver_quiet (oc_pkptr, proc_objid, 0);

详情

该内核过程将指定数据包转发到指定远程模块,没有任何延迟或调度。数据包到达不会被调度,因此仿真事件列表不参与该操作。由于数据包到达不会向远程模块交付中断,因此称为“静默”。远程模块的进程因此需要负责在未来某个时刻、当该进程因其他中断被调用时,检测转发数据包在输入流中的存在。由于远程模块的输入流会缓冲传入的数据包,在一次进程调用期间可以向同一远程模块发送多个数据包。当远程进程下次被调用时,它可以使用内核过程 op_strm_empty() 或 op_strm_pksize() 检测已静默到达其输入流的数据包。如果流中存在数据包,可以通过内核过程 op_pk_get() 获取。

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

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

用途

提供一种不依赖数据包流、在模块之间传递数据包的机制。使用该内核过程传递数据包是面向数据包流的 op_pk_send…() 系列内核过程的替代方式。该内核过程是基本操作 op_pk_deliver() 的一个变体。当远程模块不应接收数据包到达的异步通知时,op_pk_deliver_quiet() 非常有用。op_pk_deliver() 的其他变体提供在远程模块的延迟到达或强制到达。数据包可以交付到处理器或队列中运行的其他进程,或交付到发射机模块。

错误

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

参考

  • 使用内核过程 op_pk_deliver() 通过常规事件调度方式交付数据包
  • 使用内核过程 op_pk_deliver_delayed() 交付数据包并使到达时间延迟
  • 使用内核过程 op_pk_deliver_forced() 交付数据包以便在远程模块立即处理
  • 使用 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