op_sar_rsgbuf_seg_insert()

摘要

将指定分段插入到指定再分段缓冲区的尾部。用户定义的标签参数与绝对索引参数分别为该分段的比特范围“打上标记”,以便后续引用。

语法

op_sar_rsgbuf_seg_insert (sb_hndl, seg_pkptr, seg_label, bit_index_abs)
参数 类型 说明
sb_hndl Sbhandle 标识目标再分段缓冲区的句柄
[该值必须标识一个 Sar 再分段缓冲区。Sar 缓冲区句柄在通过内核过程 op_sar_buf_create() 创建缓冲区时获得。]
seg_pkptr Packet* 指向要插入缓冲区的分段的指针
[Sar 分段以标准数据包表示,可由 Pk 软件包的所有内核过程处理。不过,其内部数据内容通常仅由 Sar 软件包的内核过程访问,以执行重组或再分段任务。表示 Sar 分段的数据包指针通常首先从内核过程 op_sar_srcbuf_seg_remove() 获得。]
seg_label OpT_Int64 指定分段在缓冲区中的标签
[分段标签是一种用户定义的数值,用于为指定分段“打上标记”。因此该标签与 Sar 再分段缓冲区中指定分段的内容相关联。]
bit_index_abs OpT_Sar_Size 指定分段首个比特的绝对索引
[绝对索引是一种用户定义的数值,用于标识 Sar 再分段缓冲区中某个范围的首个比特。]

返回类型

void

无返回值。

示例

/* Obtain an arriving frame. */
frame_pkptr = op_pk_get (REF_INSTRM);

/* Remove the frame’s data segment and destroy the frame */
op_pk_nfd_get (frame_pkptr, "data_seg", &inseg_pkptr);
op_pk_destroy (frame_pkptr);

/* The segments must be divided into smaller segments before entering */
/* the destination sub-network, so they are inserted into a reseg. buffer. */
op_sar_rsgbuf_seg_insert (rsg_sbh, inseg_pkptr, 0, 0);

/* Loop through all resulting small segments, forwarding them on. */
while ((remseg_pkptr = op_sar_srcbuf_seg_remove (rsg_sbh, STD_SEG_LEN)) != OPC_NIL)
	{
	/* Create a frame for the current small segment, and insert the segment. */
	frame_pkptr = create_frame ();
	op_pk_nfd_set (frame_pkptr, "data_seg", remseg_pktr);

	/* Forward the frame. */
	op_pk_send (frame_pkptr, REF_OUTSTRM);
	}

详情

seg_label 参数用于标识与已插入分段关联的比特范围。已插入分段的每一个比特都与同一分段标签关联,因此即使该分段因从缓冲区移除更小的分段而被拆分,缓冲区中剩余的比特仍可通过其分段标签加以识别。分段的标签之后可用于通过内核过程 op_sar_rsgbuf_lbl_seg_range_get() 和 op_sar_srcbuf_bits_flush() 将该分段从再分段缓冲区中清除。分段标签是用户定义的数值,以支持使用进程模型专用的序列号作为标签。通常,分段要么以分段序列号作为标签,要么以其包含的首个(或最后一个)字节(或比特)对应的序列号作为标签。

bit_index_abs 参数也用于标识与已插入分段关联的比特范围。绝对比特索引实际上标识的是分段的第一个比特,Sar 软件包假定该分段其余每个比特的绝对比特索引是依次递增的值(每次加一)。例如,若某分段有五个比特且第一个比特的绝对索引为 20,那么 Sar 软件包假定该分段最后一个比特的绝对索引为 24。分段的绝对比特索引之后可用于通过内核过程 op_sar_rsgbuf_bits_flush_abs() 将该分段(或其部分)从再分段缓冲区中清除。绝对比特索引是用户定义的数值,以支持使用进程模型专用的序列号作为比特范围标识,但 Sar 的假定通常限制所提供的索引按比特取向。bit_index_abs 参数是 64 位整数,以容纳大范围的比特序列。

用途

提供一种将 Sar 分段插入再分段缓冲区的机制(没有其他机制可以将数据包放入 Sar 再分段缓冲区)。再分段缓冲区只接受插入 Sar 分段,通常用于两类应用:

  • 作为重传缓冲区,存储已传输的数据,直到数据被确认或“超时”而必须重传
  • 作为缓冲区,压缩或扩展传入数据分段流的长度

错误

  • 标准 Sar 错误(见表 15)
  • 程序中止:缓冲区句柄引用了已销毁的缓冲区。
  • 程序中止:缓冲区类型(<type>)对该内核过程无效,应为(再分段)。
  • 程序中止:数据包指针引用了无主数据包(<pkid>)
  • 程序中止:数据包指针引用了静态数据包(<pkid>)
  • 程序中止:数据包(<pkid>)必须是另一个数据包的分段
  • 可恢复错误:索引(<bit_index_abs>)无效。 / 值必须 >= 0。

参考

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