字符串结构体数据包字段转换(default_string_convert)
本节介绍默认字符串结构体数据包字段转换方法的功能与限制。该方法名为 default_string_convert,以源代码形式提供,位于文件 default_string_convert.pff.c 中,该文件位于 <reldir>/models/std/base 目录。
当数据包字段的类型为 “structure” 且该结构体的内存指向一个 C 字符串时,可以使用默认字符串数据包字段转换方法将数据包字段转换为值向量形式,或从值向量形式转换回数据包字段。
转换函数 default_string_convert_field_to_vvec() 和 default_string_convert_field_from_vvec() 通常是在调用内核过程 op_pk_fields_convert_to_vvec() 和 op_pk_fields_convert_from_vvec() 时被调用。
default_string_convert_field_to_vvec()
原型
int
default_string_convert_field_to_vvec (Packet * pkptr,
int fd_index, Vvec_Vector vvec, int pos)
说明
default_string_convert_field_to_vvec() 接收一个数据包指针、字段索引、值向量和值向量位索引。
数据包字段转换经过以下步骤:
- 确定字段的大小。
- 从字段中提取字符串。
- 确定字符串的长度。
- 按字段大小所允许的数量,将字符传送到值向量。
- 将该值向量写入整体值向量。
- 如果字符串长度小于定义的字段大小,则用零填充值向量的剩余区域。
- 使用
op_prg_mem_alloc()将字符串重新设置回字段。
default_string_convert_field_from_vvec()
原型
int
default_string_convert_field_from_vvec (Packet * pkptr,
int fd_index, Vvec_Vector vvec, int pos)
说明
default_string_convert_field_from_vvec() 接收一个数据包指针、字段索引、值向量和位索引。该字符串将使用 op_prg_mem_alloc() 分配,并带有一个终止零。
- 检查数据包字段是否为 “structure” 类型。
- 确定数据包字段的大小。
- 检查值向量是否包含足够的位来填充该字段。
- 为大小等于该字段的字符字符串分配空间,并额外加 1 用于终止空字符。
- 从值向量中逐个提取字符串的每个字符。
- 强制将最后一个字符设为空字符。
假设与限制
默认数据包字段转换方法依赖于某些假设。如果这些假设不成立,数据包转换将失败并且仿真会终止。以下条件必须成立:
- 字段大小必须大于 0 且为 8 的整数倍。
- 所有数据包字段都必须处于 “set” 状态。
- 位索引必须已知。
- 字段类型必须为 “structure”。
- 值向量必须完整,并完全表示数据包的所有字段。
- 结构体所使用的内存由
op_prg_mem_alloc()分配,并可以用op_prg_mem_free()释放。