op_pk_stamp()

摘要

在指定数据包中存储信息,记录当前位置(即模块)与仿真时间,供以后参考。

语法

op_pk_stamp (pkptr)
参数 类型 说明
pkptr Packet* 指向目标数据包的指针
[数据包的指针可以从许多内核过程中获得,包括 op_pk_create()、op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。]

返回类型

void

无返回值。

示例

摘自:示例模型(models/std/marsat);进程模型(inm_mac);状态(ARRIVAL);进入执行语句。

/* acquire the arriving packet */
/* (multiple arriving streams are supported.) */
pkptr = op_pk_get (op_intrpt_strm());

/* stamp the packet so that later other */
/* processes will know which process was the source */
op_pk_stamp (pkptr);

/* determine the ship index for the arriving packet */
op_pk_nfd_get (pkptr, "ship_index", &ship_index);

/* enqueue the packet at tail of the subqueue */
/* for the corresponding ship. */
op_subq_pk_insert (ship_index, pkptr, OPC_QPOS_TAIL)

详情

该内核过程修改指定数据包的内部戳记信息,使其反映当前模块与仿真时刻。戳记的模块值与时间值可在之后通过调用内核过程 op_pk_stamp_mod_get() 和 op_pk_stamp_time_get() 访问。数据包戳记在复制操作中是持久的(内核过程 op_pk_copy() 会将原始数据包的戳记复制到副本数据包中)。

该内核过程要求进程上下文,因此只能从进程模型、或由进程模型直接或间接调用的函数中调用。该内核过程可对非格式化与格式化数据包加戳。

用途

提供一种为数据包标注当前处理时间与位置的机制。这可用于向目的节点提供信息以计算特定路径的延迟(端到端,或相对于最后一跳)。另一个常见应用是动态确定节点的邻居;这可以通过内核过程 op_topo_parent() 将到达数据包戳记中的模块对象 ID 映射为其父节点对象 ID 来实现。

错误

  • 程序中止:段错误。(由无效的数据包指针或畸形数据包引起)
  • 程序中止:数据包指针为 NIL。
  • 程序中止:数据包指针引用已被销毁的数据包。
  • 程序中止:数据包指针引用无主数据包(<pk_id>)。
  • 程序中止:内核过程要求进程上下文。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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