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。
  • 程序中止:数据包指针指向已被销毁的数据包。

参考

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