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>)。 - 程序中止:内核过程要求进程上下文。
参考
- 使用内核过程 op_pk_stamp_mod_get() 获取数据包戳记的模块对象 ID
- 使用内核过程 op_pk_stamp_time_get() 获取数据包戳记的仿真时间
- 使用内核过程 op_pk_creation_mod_get() 和 op_pk_creation_time_get() 获取与数据包创建相关的模块对象 ID 和仿真时间
- 使用内核过程 op_pk_id() 获取数据包的唯一 ID