结构体数据包字段转换(default_structure_convert)
本节介绍默认结构体数据包字段转换方法的功能与限制。该方法名为 default_structure_convert,以源代码形式提供,位于文件 default_structure_convert.pff.c 中,该文件位于 <reldir>/models/std/base 目录。
当数据包字段的类型为 “structure” 且该结构体包含一个扁平的 C 数据结构时,可以使用默认结构体数据包字段转换方法将数据包字段转换为值向量形式,或从值向量形式转换回数据包字段。
转换函数 default_structure_convert_field_to_vvec() 和 default_structure_convert_field_from_vvec() 通常是在调用内核过程 op_pk_fields_convert_to_vvec() 和 op_pk_fields_convert_from_vvec() 时被调用。这些转换函数适用于类型为 “structure” 的字段,这类字段包含一个指向某块内存区域的指针。要使该转换方法生效,该指针必须指向一个由内核过程 op_prg_mem_alloc() 分配的扁平 C 数据结构。
default_structure_convert_field_to_vvec()
原型
int
default_structure_convert_field_to_vvec (Packet * pkptr,
int fd_index, Vvec_Vector vvec, int pos)
说明
default_structure_convert_field_to_vvec() 接收一个数据包指针、字段索引、值向量和值向量位索引。
数据包字段转换经过以下步骤:
- 确定字段是否为 “structure” 类型。
- 确定字段的大小。
- 检查数据包字段大小是否为 8 的整数倍。
- 从指针所指示的内存区域中提取字段值。
- 假定该内存区域的字节数与字段大小(以字节计)相同。
- 将结构体的每个字节传送到值向量,并把表示该字节的值向量写入整体值向量。
- 使用
op_prg_mem_alloc()将结构体重新设置回字段。
default_structure_convert_field_from_vvec()
原型
int
default_structure_convert_field_from_vvec (Packet * pkptr,
int fd_index, Vvec_Vector vvec, int pos)
说明
default_structure_convert_field_from_vvec() 接收一个数据包指针、字段索引、值向量和位索引。
值向量转换经过以下步骤:
- 检查数据包字段是否为 “structure” 类型。
- 确定数据包字段的大小。
- 检查数据包字段大小是否为 8 的整数倍。
- 分配与数据包字段大小(以字节计)相等的内存。
- 检查值向量中是否有足够的位来填充刚刚分配的数据包字段。
- 从值向量中逐字节提取,并将提取出的每个字节写入结构体数据包字段。
假设与限制
默认数据包字段转换方法依赖于某些假设。如果这些假设不成立,数据包转换将失败并且仿真会终止。以下条件必须成立:
- 字段大小必须大于 0 且为 8 的整数倍。
- 字段必须已设置。
- 位索引必须已知。
- 字段类型必须为 “structure”。
- 值向量必须完整;它必须包含数据包格式中所有字段所对应的位。
- 结构体所使用的内存由
op_prg_mem_alloc()分配,并可以用op_prg_mem_free()释放。