Named Field 子包

在格式化数据包中,字段在通过 Packet Format Editor 创建的模板中预先定义。格式化数据包中的字段通过字母数字字段名指定。Named Field 子包中所有内核过程都具有前缀“op_pk_nfd_”。这些内核过程专为格式化数据包而设计,将其应用于未格式化数据包可能导致错误或不可预知的结果。

Field 子包中介绍的所有基本字段操作在此子包中都有对应的内核过程,包括 op_pk_nfd_set()、op_pk_nfd_get()、op_pk_nfd_strip()、op_pk_nfd_size()、op_pk_nfd_type()、op_pk_nfd_is_set(),以及表 10中列出的特定类型内核过程。(特定类型的内核过程更高效,并使编译器能够捕获通用内核过程所漏掉的参数错误。)

表 10:带类型的数据包 Named Field Get/Set 内核过程

op_pk_nfd_get_dbl() op_pk_nfd_set_dbl()
op_pk_nfd_get_int32() op_pk_nfd_set_int32()
op_pk_nfd_get_int64() op_pk_nfd_set_int64()
op_pk_nfd_get_objid() op_pk_nfd_set_objid()
op_pk_nfd_get_pkid() op_pk_nfd_set_pkid()
op_pk_nfd_get_pkt() op_pk_nfd_set_pkt()
op_pk_nfd_get_ptr() op_pk_nfd_set_ptr()
op_pk_nfd_set_info()

在处理格式化数据包时,确定某个命名字段的索引有时很有用。这一名称到索引的转换服务由内核过程 op_pk_name_to_index() 和 op_pk_nfd_name_to_index() 提供。

内核过程 op_pk_nfd_default() 返回目标字段的默认值,即数据包格式中原先指定的值。内核过程 op_pk_nfd_exists() 判断数据包中是否存在某个特定字段。内核过程 op_pk_nfd_size_set() 设置命名字段的大小。