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>) 的范围。
参考
- 使用内核过程
op_pk_nfd_size()确定格式化数据包中某个字段的大小,以名称指定目标字段 - 使用内核过程
op_pk_fd_type()确定数据包字段的类型 - 使用内核过程
op_pk_fd_is_set()判断数据包字段是否已赋值 - 使用内核过程
op_pk_total_size_get()确定数据包的总大小 - 使用内核过程
op_pk_bulk_size_get()确定数据包的批量数据大小