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()(整数、双精度和数据包字段版本)相同。

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com