op_pk_id()
摘要
获取仿真内核为指定数据包分配的唯一 ID。
语法
op_pk_id (pkptr)
| 参数 | 类型 | 说明 |
|---|---|---|
pkptr |
Packet* |
指向目标数据包的指针 [指向数据包的指针可以从许多内核过程获得,包括 op_pk_create()、op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。] |
返回类型
OpT_Packet_Id
指定数据包的唯一 ID。
示例
摘自:示例模型(models/std/base);进程模型(acb_fifo_ms);状态(svc_start);enter execs。
/* schedule an interrupt for this server */
/* at the time where service ends. */
op_intrpt_schedule_self (op_sim_time () + pk_svc_time, i);
/* the server is now busy. */
server_status_table [i] = STATUS_BUSY;
/* reduce the number of free servers */
num_free_servers--;
/* decrease the number of waiting packets */
num_waiting_pks--;
/* establish a correspondence between the server */
/* and the packet which it is serving */
server_pkid_table [i] = op_pk_id (pkptr);
详情
新数据包通过下列方式之一进入流通:
- 由内核过程 op_pk_create() 或 op_pk_create_fmt() 显式创建
- 通过内核过程 op_pk_copy() 复制现有数据包
- 仿真内核对在总线或无线链路上向多个目的地传输的数据包进行的自动复制
数据包 ID 的格式取决于该 ID 是全局序列化(顺序仿真的典型方式)还是按模块序列化(并行仿真的典型方式)。序列化方式由 op_runsim 首选项 “fully_serialized_packet_ids“ 设置。
被销毁数据包的 ID 在同一仿真内不会被重用;因此唯一数据包 ID 的上限为 2^32。
无格式和有格式的数据包都可以通过该内核过程标识。
用途
提供一种在数据包的整个生命周期中标识或跟踪特定数据包的机制。虽然数据包 ID 不用作任何内核过程的参数,但它们在仿真调试器的上下文中非常有用,调试器支持以数据包 ID 为参数的命令。调试器命令 pkmap 打印被标识数据包的位置,命令 pkprint 打印被标识数据包的内容,命令 pktrace 为对被标识数据包执行的每个操作启用跟踪语句。数据包 ID 也可供进程模型用于区分其他方面完全相同的数据包。例如,数据包 ID 可以用作键,在一组数据包(例如队列)中找到合适的数据包。
错误
- 程序中止:Segmentation violation.(由于无效的数据包指针或格式错误的数据包)
- 程序中止:数据包指针为 NIL。
- 程序中止:数据包指针指向已销毁的数据包。
参考
- 使用内核过程 op_pk_creation_time_get() 和 op_pk_creation_mod_get() 获取数据包创建的信息
- 使用内核过程 op_pk_stamp_time_get() 和 op_pk_stamp_mod_get() 获取关于最近一次施加到数据包的戳记的信息
- 使用内核过程 op_subq_pk_access() 获取子队列内某个数据包的指针(以检查其 ID)
- 使用内核过程 op_pk_id_str_get() 获取数据包 ID 的字符串表示