op_pk_copy()

摘要

创建一个新数据包,它是指定原始数据包的副本。

语法

op_pk_copy (pkptr)
参数 类型 说明
pkptr Packet* 指向原始目标数据包的指针
[指向数据包的指针可以从许多内核过程获得,包括 op_pk_create()、op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。]

返回类型

Packet*

指向该内核过程所创建的副本数据包的指针。

示例

/* receive a frame from upper layer */
ul_pkptr = op_pk_get (0);

/* copy and send to all active network interfaces */
for (i = 0; i < num_interfaces; i++)
	{
	if (interface_array [i].active)
		{
		cp_pkptr = op_pk_copy (ul_pkptr);
		op_pk_send (cp_pkptr, i);
		}
	}

详情

该内核过程创建一个新数据包,并将指定原始数据包的包头复制到新数据包中。新数据包引用原始数据包中的字段。之后,如果要修改原始数据包或副本的某个字段,则在修改发生之前,所有数据包字段都会被复制到数据包副本中。(这种复制方式可减少仿真时间并节省内存。)

未格式化和已格式化的数据包都可以通过该内核过程复制;复制得到的数据包将与原始数据包类型相同。结构字段(OPC_FIELD_TYPE_STRUCT)的复制使用该字段关联的分配过程,如内核过程 op_pk_fd_set() 或 op_pk_nfd_set() 所指定。数据包字段(OPC_FIELD_TYPE_PACKET)的复制会对被封装的数据包进行递归复制。所有其他字段类型都作为简单数据项复制。

复制得到的数据包会被赋予一个唯一的数据包 ID,对应于调用该内核过程时下一个可用的 ID。数据包的创建时间被设置为调用该内核过程时的仿真时间,创建模块被设置为运行调用该内核过程的进程的模块(如果该内核过程不是由进程或间接的进程函数调用所触发,创建模块的对象 ID 被设置为常量 OPC_OBJID_INVALID)。数据包的戳记和模块从原始数据包复制而来,使戳记“跟随”复制的数据包字段,且仅因显式调用 op_pk_stamp() 而改变(这一策略允许戳记用于端到端传输时延计算)。

与原始数据包关联的任何 ICI 也会与复制的数据包关联(ICI 不会被复制;两个数据包指向同一个 ICI)。与原始数据包关联的路由会被复制,且复制得到的路由与复制的数据包相关联。

用途

提供一种克隆数据包的机制,用途例如:

  • 在数据包泛洪过程中生成同一数据的多次传输
  • 保存传出数据包传输的副本,以备后续需要重传

错误

  • 程序中止:Segmentation violation.(由于无效的数据包指针、格式错误的数据包,或数据包内格式错误的结构字段或数据包字段)
  • 程序中止:Bus Error.(由于数据包内含的某结构字段的分配过程指定了无效地址)
  • 程序中止:数据包指针为 NIL。
  • 程序中止:数据包指针指向已销毁的数据包。
  • 程序中止:数据包指针指向无主数据包 (<pk_id>)。
  • 程序中止:内存分配失败。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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