Field 子包
数据包字段包含若干可能类型之一的单个数据元素(整数、双精度浮点数、数据结构、封装数据包或信息)。数据包字段为所传输数据的模型施加结构,并支持便捷访问将影响协议或算法处理的标志及其他信息。在未格式化数据包中,字段不是基于数据包格式预定义的,而是通过赋值操作动态定义的。未格式化数据包中的字段通过数字字段索引指定,索引从零开始。Field 子包中所有内核过程都具有前缀“op_pk_fd_”,尽管它们主要为未格式化数据包而设计,但也可应用于格式化数据包。
字段的内容取决于其指定类型,但文档提供了通用操作符来访问它们。内核过程 op_pk_fd_set() 为字段的内容以及字段的大小(以比特计)赋值。对称的内核过程 op_pk_fd_get() 获取字段的内容。当数据包在网络中传播并被不同进程反复处理时,其内容可能多次改变。内核过程 op_pk_fd_access_ptr() 提供对存储在数据包中的数据结构的访问,而不将该结构从数据包中移除;op_pk_fd_access_read_only_ptr() 提供对结构字段的高效只读访问。
op_pk_fd_set() 和 op_pk_fd_get() 都有特定类型的版本,它们更高效,并使编译器能够捕获通用内核过程所漏掉的参数错误。表 9 列出了这些特定类型的版本。
表 9:带类型的数据包字段 Get/Set 内核过程
当字段通过某个 op_pk_fd_set… 内核过程赋值时,其大小也随之设定。如果在数据包处理过程中某个字段的大小发生变化,数据包的大小也可能随之变化。为了确定字段的当前大小,可以使用内核过程 op_pk_fd_size()。如果数据包中的某个特定字段已完全失去其值,可以剥离(strip)该字段,从而将其内容和大小同时从受影响的数据包中移除。剥离字段使用内核过程 op_pk_fd_strip()。数字索引与特定字段的对应关系不受剥离操作的影响;被剥离的字段被标记为未设置(unset),但它们继续占据其索引“槽位”。
结构未知的数据包也可以被进程操作,但前提是数据包的结构能够被动态确定。上一节介绍的一个内核过程 op_pk_fd_max_index() 返回字段的数量,使进程可以遍历每个字段。内核过程 op_pk_fd_type() 通过确定每个字段的类型,为这样的循环提供“核心”内容。可以围绕该内核过程构建带有适当 case 分支的 switch 语句。当处理结构未知的格式化数据包时,获取每个字段的名称有时很有用,该功能由内核过程 op_pk_fd_index_to_name() 提供。
由于未格式化数据包没有预定义的字段组,任何正整数都标识一个有效字段。当字段具有已赋值的内容和比特大小时,它被视为已设置(set);没有内容或大小的未定义字段是未设置的。内核过程 op_pk_fd_is_set() 可用于判断字段是否已设置。