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。
参考
- 使用内核过程 op_sar_srcbuf_seg_remove() 从(再)分段缓冲区头部移除并获得一个 Sar 分段
- 使用内核过程 op_sar_srcbuf_seg_access() 从(再)分段缓冲区头部复制一个 Sar 分段
- 使用内核过程 op_sar_srcbuf_bits_flush() 从(再)分段缓冲区清除由局部比特索引和长度标识的比特范围
- 使用内核过程 op_sar_rsgbuf_bits_flush_abs() 从再分段缓冲区清除由绝对比特索引和长度标识的比特范围