op_pk_fd_strip()
摘要
从指定数据包中移除某个字段;目标字段由数字索引指定。
语法
op_pk_fd_strip (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 |
目标字段的数字索引 [该值必须为非负数,否则会发生错误。] |
返回类型
Compcode
完成代码,指示指定字段的值是否已成功重置为“未赋值”状态。若发生可恢复错误,则返回常量 OPC_COMPCODE_FAILURE。
示例
/* obtain an arriving packet */
pkptr = op_pk_get (0);
/* obtain the source node of the packet from an integer field */
op_pk_fd_get (pkptr, FD_SOURCE, &src_node);
/* write the source node out as a statistic */
op_stat_write (0, (double) src_node);
/* strip off the source node field */
op_pk_fd_strip (pkptr, FD_SOURCE);
/* send the modified packet out */
op_pk_send (pkptr, 0);
详情
该内核过程支持剥离全部五种类型的数据包字段:整数、双精度、数据包、信息和结构。简单数据包字段(即整数、双精度和信息字段)会被该内核过程置为未赋值状态,其对数据包总大小的贡献也会被减去。数据包中的数据包字段和结构字段同样会被该内核过程置为未赋值状态,其对数据包总大小的贡献也会被减去。但这些字段内容所指向的数据包和数据结构会被释放,以严格贯彻被剥离字段内部的封装概念。数据包字段可以封装数据包,而被封装的数据包本身也可以含有数据包字段;op_pk_fd_strip() 支持任意层级的这种递归。封装在结构字段内的数据结构的释放,使用内核过程 op_pk_fd_set() 或 op_pk_nfd_set() 的 dealloc_proc 参数所指定的释放过程来完成。
用途
提供了一种从数据包中移除字段的机制,从而减去该字段对数据包总大小的贡献。以下情形下该机制通常很有用:
- 数据包正被路由经过一系列处理器或队列
- 某些数据包字段用于向中间处理器或队列传递信息,且这些字段不会被数据包路由路径上的其他进程访问
在这些条件下,相关字段可以由中间处理器剥离掉。该内核过程通常用于未格式化数据包,但同样可用于格式化数据包(格式化数据包的字段名可以用内核过程 op_pk_nfd_name_to_index() 转换为数字索引)。
错误
- 程序中止:段错误。(由无效的数据包指针或畸形数据包引起)
- 程序中止:数据包指针为 NIL。
- 程序中止:数据包指针指向已被销毁的数据包。
- 程序中止:数据包指针指向无主数据包 (
<pk_id>)。 - 可恢复错误:数据包 (
<pk_id>) 中不存在索引为 (<fd_index>) 的字段。 - 可恢复错误:字段索引 (
<fd_index>) 超出数据包 (<pk_id>) 的范围。 - 可恢复错误:数据包 (
<pk_id>) 的字段索引 (<fd_index>) 没有赋值。
参考
- 使用内核过程
op_pk_nfd_strip()从格式化数据包中剥离字段,以名称指定字段 - 使用内核过程
op_pk_fd_set()的某种形式为数据包字段赋值 - 使用内核过程
op_pk_fd_get()访问数据包字段的值 - 使用内核过程
op_pk_destroy()释放数据包