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>)。 - 程序中止:内存分配失败。
参考
- 使用内核过程 op_pk_id() 确定复制数据包的 ID
- 使用内核过程 op_pk_destroy() 释放原始或复制的数据包
- 使用内核过程 op_pk_create() 和 op_pk_create_fmt() 创建不基于其他数据包的新数据包