op_pk_fields_convert_to_vvec()
摘要
遍历已格式化数据包的各个字段,调用每个字段的转换函数。
语法
op_pk_fields_convert_to_vvec (pk_ptr, vvec, vvec_index)
| 参数 | 类型 | 说明 |
|---|---|---|
pk_ptr |
Packet* |
指向已格式化数据包的指针 [数据包的字段将使用为每个字段指定的转换函数写入值向量。] |
vvec |
Vvec_Vector |
用于存储所生成比特序列的已存在值向量 [该值向量必须已经分配好,用于接收各转换函数生成的比特序列。] |
vvec_index |
int |
接收比特序列第一个比特的位置索引号 [该内核过程使用的转换方法根据已格式化数据包用户自定义字段的内容生成比特序列。此参数指定在值向量中插入该比特序列的位置。] |
返回类型
Compcode
指示转换是否成功完成的完成代码。
[该值可与两个符号常量 OPC_COMPCODE_SUCCESS 和 OPC_COMPCODE_FAILURE 进行比较。]
示例
/* Build a value vector representation of the opnet */
/* packet, but without changing the original packet. */
vvec = op_vvec_create (OPC_TYPE_BIT);
/* Have each field's contents written into "vvec". */
/* The first 16 bits of the value vector */
/* representation of the packet will store a */
/* checksum, so the conversion of the fields is */
/* started offset 15 bits into "vvec' */
return_code = op_pk_fields_convert_to_vvec (pkptr, vvec, 15);
/* Set the checksum value... */
详情
该函数通常由数据包转换方法调用,它调用每个字段的转换方法以在值向量中设置值。它遍历每个字段,利用字段的转换顺序属性确定各字段的转换顺序。在利用某个字段设置值向量时,该内核过程调用该字段转换方法属性所指定的转换。
警告: 新创建的数据包格式的字段转换例程被设置为“NONE”,即不做任何事情。在调用本函数之前,必须将所需的转换例程设置为用户提供的例程,或 Riverbed Modeler 提供的某个默认例程(这些默认例程仅适用于很小一部分数据包格式;详见第 5 章“Packet Conversion”第 29 页)。
op_pk_fields_convert_to_vvec() 向字段转换方法传递四个参数:
- 一个数据包指针
- 一个字段索引
- 类型为 bit 的值向量(Vvec_Vector)
- 字段在值向量中位置的索引。仿真内核利用数据包格式中定义的各字段的比特大小来计算该位置。
注意: 仿真内核并不总能计算出精确的位置。在这种情况下,它会向转换方法传递 OPC_FIELD_BIT_POSE_UNKNOWN 常量。
转换方法的原型为:
typedef int
default_convert_field_to_vvec (Packet * pkptr, int fd_index,
Vvec_Vector vvec, int pos)
该函数必须位于一个 .pff.c 文件中,文件名与函数名的基础部分相匹配。例如,名为 my_convert_field_to_vvec() 的函数应定义在文件 my_convert.pff.c 中。
用途
提供一种遍历数据包各个字段、调用每个字段的转换函数在值向量中设置值的机制。
错误
- 程序中止:数据包指针引用了无主数据包(
<pk_id>)。 - 程序中止:数据包格式(
<packet_format>)不支持转换。 - 程序中止:数据包 ID(
<pk_id>)无法转换。 - 可恢复错误:值向量不属于该客户端。
- 可恢复错误:值向量无效。
参考
- 使用内核过程 op_pk_type() 确定数据包的类型
- 使用内核过程 op_pk_vvec_is_set() 查看值向量数据包是否包含值向量
- 使用内核过程 op_pk_convert_to_vvec() 将已格式化数据包转换为值向量数据包
- 使用内核过程 op_pk_fields_convert_from_vvec() 在将值向量数据包转换为已格式化数据包时,使用数据包格式中指定的字段转换顺序与方法