op_pk_stamp_mod_get()
摘要
获取指定数据包最近一次加戳时所在模块的对象 ID。
语法
op_pk_stamp_mod_get (pkptr)
| 参数 | 类型 | 说明 |
|---|---|---|
pkptr |
Packet* |
指向目标数据包的指针 [数据包的指针可以从许多内核过程中获得,包括 op_pk_create()、op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。] |
返回类型
Objid
指定数据包最近一次加戳时所在模块的对象 ID。
示例
/* obtain a pointer to the arriving packet */
pkptr = op_pk_get (INPUT_STRM);
/* determine the object ID of packet's source module */
src_mod_objid = op_pk_stamp_mod_get (pkptr);
/* determine the object ID of source node */
src_node_objid = op_topo_parent (src_mod_objid);
/* extract the LAN address of source node */
op_ima_obj_attr_get (src_node_objid, "LAN_Address", lan_address);
/* print out the extracted LAN address */
printf ("Packet just received from node [%s]", lan_address);
详情
从未通过内核过程 op_pk_stamp() 加戳的数据包,其戳记模块被定义为该数据包创建时所在的模块。
对数据包执行的多数操作不会影响其戳记信息。经由总线和无线链路的传输可能产生数据包的多个副本,但每个副本都保留原始的戳记信息。通过内核过程 op_pk_copy() 显式复制数据包,将产生与原始数据包具有相同戳记信息的副本。
该内核过程可操作非格式化与格式化数据包。
用途
提供一种确定数据包最近一次加戳位置的机制。该内核过程通常与内核过程 op_pk_stamp_time_get() 配合使用,以比较来自不同源位置的传输延迟。它也适用于记录对传入数据包执行了某种用户自定义操作的不同模块。
错误
- 程序中止:段错误。(由无效的数据包指针或畸形数据包引起)
- 程序中止:数据包指针为 NIL。
- 程序中止:数据包指针引用已被销毁的数据包。
参考
- 使用内核过程 op_pk_stamp() 设置数据包的戳记
- 使用内核过程 op_pk_stamp_time_get() 获取数据包最近一次加戳的仿真时间
- 使用内核过程 op_topo_parent() 将模块对象 ID 转换为其所在节点的对象 ID
- 使用内核过程 op_pk_creation_mod_get() 和 op_pk_creation_time_get() 获取与数据包创建相关的模块对象 ID 和仿真时间
- 使用内核过程 op_pk_id() 获取数据包的唯一 ID