op_pk_format()

摘要

获取与指定数据包相关联的数据包格式的名称。

语法

op_pk_format (pkptr, fmt_name)
参数 类型 说明
pkptr Packet* 指向目标数据包的指针
[指向数据包的指针可以从许多内核过程获得,包括 op_pk_create()、op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。]
fmt_name char* 数据包格式的名称(由该内核过程填入)
[该值应当是一个静态声明的字符数组,或一个指向动态分配内存的字符指针;无论哪种方式,它都必须指向一个足够大的字符串,以容纳指定数据包的格式名称。如果指定的数据包是无格式的,该字符串将被置为 “NONE”。]

返回类型

void

无返回值。

示例

/* obtain the arriving packet */
pkptr = op_pk_get (INPUT_STRM);

/* determine the format of the packet */
op_pk_format (pkptr, pk_format);

/* print out a debug statement */
printf ("processing packet with format [%s]\n", pk_format);

/* store the packet in the second subqueue */
op_subq_pk_insert (1, pkptr, OPC_QPOS_TAIL);

详情

有格式的数据包可以通过内核过程 op_pk_create_fmt() 创建。创建时指定的格式决定了所创建数据包的内部结构。数据包格式可以在数据包格式编辑器(Packet Format Editor)的一个模式中定义,也可以通过 Ema 程序定义。格式由一组命名数据包字段的列表组成,每个字段都有指定的类型、以比特为单位的大小,以及一个在数据包创建时可置位或不置位的默认值。

每个有格式的数据包都有一个关联的格式。无格式和有格式的数据包都可以传入该内核过程,但只有有格式的数据包会产生有意义的结果;无格式的数据包会使字符串 “NONE” 被赋给传入的字符指针。

用途

提供一种确定数据包格式名称的机制。对于根据所处理数据包的类型进行进程逻辑分支,这一信息很有用。显示到达数据包格式的调试语句也很有用,如前一页示例所示。

错误

  • 程序中止:Segmentation violation.(由于无效的数据包指针、格式错误的数据包或无效的 fmt_name 参数)
  • 程序中止:数据包指针为 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