op_pk_destroy()
摘要
释放指定数据包占用的内存,将相关内存资源释放给其他用途。
语法
op_pk_destroy (pkptr)
| 参数 | 类型 | 说明 |
|---|---|---|
pkptr |
Packet* |
指向目标数据包的指针 [指向数据包的指针可以从许多内核过程获得,包括 op_pk_create()、op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。] |
返回类型
void
无返回值。
示例
节选自:示例模型(models/std/base);进程模型(pc_fifo);状态(INS_TAIL)的 enter execs。
/* a new packet has arrived; acquire it */
pkptr = op_pk_get (op_intrpt_strm ());
/* insert the new packet at tail of subqueue 0 */
if (op_subq_pk_insert (0, pkptr, OPC_QPOS_TAIL) != OPC_QINS_OK)
{
/* if the insertion failed, discard the packet */
op_pk_destroy (pkptr);
}
详情
当某个数据包不再会被访问(即不会读取或赋值其字段,也不会被发送或交付给其他模块)时,就可以将其从流通中移除。通过该内核过程销毁数据包会将数据包从流通中移除,并释放为该数据包分配的内存资源。与原始数据包关联的路由也会被销毁。但数据包被销毁时 ICI 不会被销毁,因为其他数据包或进程模型可能仍持有对 ICI 的引用并打算使用其内容。销毁不再需要的 ICI 请使用 op_ici_destroy()。
数据包被销毁后,释放的内存可复用于创建新数据包。如果不销毁不再使用的数据包,未处理的数据包会不断累积,最终可能使仿真因虚拟内存用量过大、无法满足新对象的分配请求而中止。未格式化和已格式化的数据包都可以通过该内核过程销毁。
该函数会自动释放数据包所有结构和数据包字段的内存。但如果在销毁数据包之前使用 op_pk_nfd_get () 将结构字段从数据包中剥离,则必须使用 op_prg_mem_free () 来释放结构字段占用的内存。
用途
提供一种“回收”不再使用的数据包相关内存的机制。仿真内核可以按需将释放的内存分配给进行中的仿真所需的其他用途。应在最后一次访问数据包之后调用该内核过程。该内核过程一旦返回,发起调用的上下文中就应将指定的数据包指针视为无效(即不能再引用它或将其传递给内核过程)。
错误
- 程序中止:Segmentation violation.(由于无效的数据包指针、格式错误的数据包,或数据包内格式错误的数据包字段或结构字段)
- 程序中止:Bus error.(由于数据包内结构的无效释放过程)
- 程序中止:数据包指针为 NIL。
- 程序中止:数据包指针指向已销毁的数据包。
- 程序中止:数据包指针指向无主数据包 (
<pk_id>)。 - 程序中止:数据包指针指向静态数据包 (
<pk_id>)。
参考
- 使用内核过程 op_pk_create() 和 op_pk_create_fmt() 创建新数据包。
- 使用内核过程 op_pk_fd_strip() 和 op_pk_nfd_strip() 从数据包中移除单个字段。
- 使用内核过程 op_pk_creation_time_get() 确定数据包的存活时间(在销毁它之前)