op_pk_fd_set_pkt()
摘要
为指定数据包中的某个数据包字段指定类型、值和大小;目标字段由数字索引指定。
语法
op_pk_fd_set_pkt (pkptr, field_index, value, field_size)
| 参数 | 类型 | 说明 |
|---|---|---|
pkptr |
Packet* |
目标数据包的指针 [数据包的指针可以从许多内核过程中获得,包括 op_pk_create()、op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。] |
field_index |
int |
目标字段的数字索引 [该值必须为非负数,否则会发生错误。] |
value |
Packet* |
要赋给该字段的值 |
field_size |
OpT_Int64 |
字段内容的建模大小(以比特为单位),或 OPC_FIELD_SIZE_UNCHANGED(见详情) |
返回类型
Compcode
字段设置成功时返回 OPC_COMPCODE_SUCCESS,否则返回 OPC_COMPCODE_FAILURE。
示例
/* create an unformatted packet */
uf_pkptr = op_pk_create (64);
/* encapsulate a higher-level packet in the packet */
enc_pkptr = op_pk_create (24);
op_pk_fd_set_pkt (uf_pkptr, 4, enc_pkptr, OPC_FIELD_SIZE_UNCHANGED);
详情
如果 field_size 与该字段原先的大小不同,数据包的总大小将相应改变。如果 field_size 指定为 OPC_FIELD_SIZE_UNCHANGED,则该字段的大小保持数据包中原有的定义不变。
被赋值给字段的数据包会被封装(encapsulated)在高层数据包之内,且调用方进程失去对被封装数据包的所有权。被封装的数据包在被 op_pk_fd_get_pkt()(若为格式化数据包,也可由 op_pk_nfd_get_pkt())解封之前无法访问。如果指定的数据包字段大小为负值,则该字段的大小将被设置为被封装数据包的大小,从而准确模拟聚合数据包的大小。如果指定的数据包字段大小为零或正值,则它会覆盖所赋值数据包的大小,从而支持对剥离或压缩的建模。
用途
提供了一种在数据包内设置某个数据包字段值的方法。该内核过程通常用于未格式化数据包,但同样可用于格式化数据包(格式化数据包的字段名可以用内核过程 op_pk_name_to_index() 和 op_pk_nfd_name_to_index() 转换为数字索引)。
错误
- 与
op_pk_fd_set()(整数、双精度和数据包字段版本)相同。
参考
- 与
op_pk_fd_set()(整数、双精度和数据包字段版本)相同。