op_sar_buf_destroy()

摘要

释放指定的缓冲区,将其关联的内存资源交还供其他用途使用。

语法

op_sar_buf_destroy (sb_hndl)
参数 类型 说明
sb_hndl Sbhandle 标识目标缓冲区的句柄
[该值可标识三种 Sar 缓冲区类型中的任意一种:分段、重组或再分段。Sar 缓冲区句柄在通过内核过程 op_sar_buf_create() 创建缓冲区时获得。]

返回类型

void

无返回值。

示例

/* Get the handle for the event’s ICI. */
iciptr = op_intrpt_ici ();

/* Extract the request type. */
op_ici_attr_get (iciptr, "svc_request", &svc_req);

/* Request is for closing a connection */
if (svc_req == GP_REQ_CONN_CLOSE)
	{
	/* Print out the final size of the connection’s buffer. */
	printf ("Connection #%d closing down; final buffer size is %d bytes.\n",
		conn_ptr->id, op_sar_buf_size (conn_ptr->sbh) / 8);

	/* Deallocate the reassembly buffer in use by the connection. */
	op_sar_buf_destroy (conn_ptr->sbh);

	/* Deallocate the connection data structure. */
	op_prg_mem_free (conn_ptr);
	}

详情

该内核过程可用于释放全部三种 Sar 缓冲区:分段、再分段和重组。只应在最后一次访问指定缓冲区之后才调用该内核过程。该内核过程一旦返回,指定的缓冲区句柄即告失效,不应再被引用。

销毁 Sar 缓冲区会导致其全部数据内容被释放,包括完整的、被分段部分削减的或被部分重组的源数据包。如果缓冲区中的源数据包已被部分削减或重组,如果它已通过 op_sar_srcbuf_seg_access() 被并行多次分段,或其分段已被复制,则该源数据包的部分内容同时存在于缓冲区内和缓冲区外。销毁包含部分源数据包数据的 Sar 缓冲区不会影响缓冲区外的该数据包的分段;被销毁的缓冲区对剩余源数据包分段的唯一影响是:由于仅包含在被销毁缓冲区中的分段已被释放,源数据包的完整重组可能无法完成。

用途

提供一种移除不再使用的 Sar 缓冲区并“回收”其关联内存资源的机制。该内核过程通常由面向连接的进程模型在模型中处理连接“拆除”的部分调用,因为这些部分负责释放即将关闭的连接所使用的资源。在仿真期间拥有固定一组 Sar 缓冲区的进程模型通常不需要调用该内核过程,因为这些缓冲区将作为进程的已分配资源一直保留到仿真结束。

错误

  • 标准 Sar 错误(见表 15)
  • 诊断错误:非法的内存释放尝试。内存地址为 NIL。
  • 若干诊断错误,指示对各类内存(池化、分类和通用)的非法释放尝试

参考

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