op_pk_print()
摘要
将数据包的信息打印到输出设备。
语法
op_pk_print (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
无返回值。
示例
/* obtain an incoming packet */
pkptr = op_pk_get (0);
/* determine if the packet is of the appropriate type; */
/* if so, print its contents onto the terminal */
op_pk_format (pkptr, pk_format);
if (strcmp ("hssb_packet", pk_format) == 0)
op_pk_print (pkptr);
示例输出(水平压缩):
packet contents:
id : (14)
tree_id : (2)
address : (112768)
format : (hssb_packet)
creation_module : (sb_subnet,node0,application))
creation_time : (2.46388e-07)
creation_event : (457
stamp_module : ((sb_subnet,node0,application))
stamp_time : (2.46388e-07)
bulk_size : (128)
total_size : (128)
owner : (sim. kernel)
priority : (0)
Index Name Type Value Size
0 source_address integer 0 0
1 destination_address integer 3 0
2 type integer 3 0
3 command integer 1 0
4 subcommand integer - 0
5 response_code integer - 0
6 data_length integer 4 0
7 transaction_label double 0.0 0
8 delay_offset double - 0
详情
该内核过程打印到 Windows 控制台或 Linux 标准输出设备。若要将输出重定向到文件,可在仿真命令行上使用“>”I/O 重定向操作符。
默认情况下,仿真的 Linux 标准输出设备就是启动仿真进程的命令 shell。如果仿真进程是由应用程序 GUI 派生出来的,则标准输出设备是启动应用程序进程的命令 shell。如果仿真进程是从 shell 窗口启动的,则默认的标准输出设备将与该窗口关联。
该内核过程生成的数据包信息的格式见示例一节。注意以下显示约定:
- 数据包地址以十六进制数显示
- 如果数据包未格式化,其 format 属性将显示为“NONE”
- 未与特定对象关联的数据包,其 owner 属性显示为“simulation kernel”
- 如果指定的数据包已分配优先级,或存储在子队列中,则会打印可选的行
- 未设置的字段其值用短横线(“-”)表示
- 继承大小的字段在大小之后带有“(inherited)”
用途
为用户提供一种从终端监视数据包内容、或将数据包内容记录到文件以供后续分析的机制。当到达的数据包包含用于进程计算或影响进程逻辑流程的值时,打印数据包内容在仿真调试器中会非常有用。打印数据包的语句可以添加到状态执行段(用于事件驱动的打印),或添加到诊断块(用于通过 ODB “prodiag“ 命令进行用户驱动的打印)。也可以直接从仿真调试器使用 “pkprint“ 命令打印数据包,该命令以数据包 ID 作为参数。
错误
- 程序中止:段违例。(由于无效的数据包指针或格式错误的数据包)
- 程序中止:数据包指针为 NIL。
- 程序中止:数据包指针指向已被销毁的数据包。
参考
- 使用内核过程 op_pk_id() 获取数据包的唯一 ID
- 使用内核过程 op_pk_format() 获取数据包的格式名称
- 使用内核过程 op_pk_creation_mod_get()、op_pk_creation_time_get()、op_pk_stamp_mod_get() 和 op_pk_stamp_time_get() 获取数据包的创建模块、创建时间、戳记模块和戳记时间
- 分别使用内核过程 op_pk_bulk_size_get() 和 op_pk_total_size_get() 获取数据包的批量大小或总大小
- 使用内核过程 op_subq_print() 打印子队列中包含的数据包列表