op_pk_deliver_forced()

摘要

将指定数据包转发到远程模块,强制数据包立即到达该模块并引起相应进程被调用,同时释放调用进程对该数据包的拥有权。

语法

op_pk_deliver_forced (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, OPCODE_ACTIVATE, 0);

/* deliver the packet to remote processor under forced conditions */
op_pk_deliver_forced (oc_pkptr, proc_objid, 0);

/* check to see if remote processor responded with quiet packet; */
/* if so, obtain the response code */
if (!op_strm_empty (0))
	{
	resp_pkptr = op_pk_get (0);
	op_pk_fd_get (resp_pkptr, 0, &resp_code);
	}

详情

该内核过程将指定数据包转发到指定远程模块,没有任何延迟或调度。相应的强制事件不会被调度,因此仿真事件列表不参与该操作。强制事件使远程模块的进程以流中断方式被立即调用。在远程模块进程响应该流中断期间,调用进程被挂起;当远程进程进入非强制状态并释放控制权后,该内核过程将把控制权返回给调用进程,调用进程从调用该内核过程的语句之后继续执行。

如果远程模块是处理器或队列,其关联的进程可以通过内核过程 op_intrpt_type() 判断该中断是由输入流引起的。到达输入数据包流的数据包可由远程进程通过内核过程 op_pk_get() 获取。

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

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

警告: 在并行仿真中,强制中断效率低下且具有潜在危险。要执行强制中断,特定执行线程必须同时对当前模块和接收强制中断的模块设置执行锁。因此可能出现死锁情形。例如,线程 1 正在为模块 A 执行事件并试图向模块 B 发出强制中断,而与此同时线程 2 正在为模块 B 执行事件并试图向模块 A 发出强制中断,就会发生死锁。

用途

提供一种不依赖数据包流、在模块之间传递数据包的机制。使用该内核过程传递数据包是面向数据包流的 op_pk_send…() 系列内核过程的替代方式。该内核过程是基本操作 op_pk_deliver() 的一个变体。当交付方进程必须等待远程进程对已交付数据包作出响应后才能继续操作时,op_pk_deliver_forced() 非常有用。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_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