op_pk_fd_size()

摘要

获取指定数据包中某个字段的建模大小;目标字段由数字索引指定。

语法

op_pk_fd_size (pkptr, fd_index)
参数 类型 说明
pkptr Packet* 目标数据包的指针
[数据包的指针可以从许多内核过程中获得,包括 op_pk_create()、op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。]
fd_index int 目标字段的数字索引
[该值应为非负数;但即使为负数也不会发生错误,而是返回 OPC_FIELD_SIZE_INVALID,表示指定字段未在数据包中定义。]

返回类型

OpT_Packet_Size

指定字段的建模大小(以比特为单位)。

如果指定字段未在数据包中定义,或发生了可恢复错误,则该值为 OPC_FIELD_SIZE_INVALID。

示例

/* obtain an arriving packet */
pkptr = op_pk_get (0);

/* determine the size of the information field */
data_size = op_pk_fd_size (pkptr, 2);

/* write the data size out as a statistic */
op_stat_write (0, (double) data_size);

/* deallocate the packet */
op_pk_destroy (pkptr);

详情

返回指定字段的大小,即该字段最近通过内核过程 op_pk_fd_set() 或 op_pk_nfd_set() 的 size 参数所设置的大小,或由内核过程 op_pk_create_fmt() 创建时的大小。

用途

提供了一种确定数据包字段建模大小的机制。当信息字段的大小可变、且其大小对计算流量统计量有意义时(如上一页示例所示),该内核过程通常很有用。该内核过程通常用于未格式化数据包,但同样可用于格式化数据包(格式化数据包的字段名可以用内核过程 op_pk_nfd_name_to_index() 转换为数字索引)。

错误

  • 程序中止:段错误。(由无效的数据包指针或畸形数据包引起)
  • 程序中止:数据包指针为 NIL。
  • 程序中止:数据包指针指向已被销毁的数据包。
  • 可恢复错误:数据包 (<pk_id>) 中不存在索引为 (<fd_index>) 的字段。
  • 可恢复错误:字段索引 (<fd_index>) 超出数据包 (<pk_id>) 的范围。

参考

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