op_sar_rsmbuf_seg_insert()
摘要
将指定分段插入指定重组缓冲区。
语法
op_sar_rsmbuf_seg_insert (sb_hndl, seg_pkptr)
| 参数 | 类型 | 说明 |
|---|---|---|
sb_hndl |
Sbhandle |
标识目标重组缓冲区的句柄 [该值必须标识一个 Sar 重组缓冲区。Sar 缓冲区句柄在通过内核过程 op_sar_buf_create() 创建缓冲区时获得。] |
seg_pkptr |
Packet* |
指向要插入缓冲区的分段的指针 [Sar 分段以标准数据包表示,可由 Pk 软件包的所有内核过程处理。然而,其内部数据内容通常仅由 Sar 软件包的内核过程访问,以执行重组或再分段任务。表示 Sar 分段的数据包指针通常首先从内核过程 op_sar_srcbuf_seg_get() 获得。] |
返回类型
void
无返回值。
示例
/* Obtain an arriving segment. */
seg_pkptr = op_pk_get (SEG_INSTRM);
/* Insert the segment into reassembly buffer. */
op_sar_rsmbuf_seg_insert (rsm_sbh, seg_pkptr);
/* Determine the number of complete source packets in reassembly buffer. */
comp_pk_count = op_sar_rsmbuf_pk_count (rsm_sbh);
/* Loop through all complete source packets in reassembly buffer. */
for (pk_index = 0; pk_index < comp_pk_count; pk_index++)
{
/* Remove a complete source packet. */
src_pkptr = op_sar_rsmbuf_pk_remove (rsm_sbh);
/* Add source packet to internal sub-queue. */
op_subq_pk_insert (0, src_pkptr, OPC_QPOS_TAIL);
}
详情
与分段缓冲区或再分段缓冲区不同,重组缓冲区并不是简单地将插入的数据包放置在缓冲区“尾部”(尾部指缓冲区数据包有序列表的进入端)。重组缓冲区的内部结构比其他类型的缓冲区更复杂,实际上包含两个独立的源数据包有序列表:不完整列表和完整列表。
- 不完整列表存储不完整的源数据包,并在到达的 Sar 分段插入重组缓冲区时将其吸收。该列表中不完整源数据包的顺序基于每个数据包首个分段的到达顺序。
- 完整列表存储完整的源数据包,源数据包在完成时从不完整列表转移到该列表。该列表中完整源数据包的顺序基于源数据包的完成顺序。从重组缓冲区移除的数据包取自该列表的头部。
用途
提供一种将 Sar 分段插入重组缓冲区的机制,用于添加到正在重组的源数据包(没有其他机制可以将 Sar 分段放入 Sar 重组缓冲区)。该内核过程也会接受并将源数据包插入指定重组缓冲区,为同时处理分段和非分段数据包提供了便捷方式。重组缓冲区将插入的分段拼接为完整源数据包,这些完整数据包可在完成时通过内核过程 op_sar_rsmbuf_pk_remove() 移除。由于源数据包在重组缓冲区中只有在响应新 Sar 分段的插入时才会完成,因此通常适合在将 Sar 分段(或源数据包)插入重组缓冲区后立即尝试移除完整源数据包。
错误
- 标准 Sar 错误(见表 15)
- 程序中止:缓冲区句柄引用了已销毁的缓冲区。
- 程序中止:缓冲区类型(
<type>)对该内核过程无效,应为(重组)。 - 程序中止:数据包指针引用了无主数据包(
<pkid>) - 程序中止:数据包指针引用了静态数据包(
<pkid>) - 程序中止:分段数据包(
<seg_pkid>)引用了无效数据包(<src_pkid>) - 程序中止:超出虚拟内存限制。分配的对象过多。
- 可恢复错误:对象块分配失败 / 对象类型(
<ob_type>)。
参考
- 使用内核过程 op_sar_rsmbuf_pk_remove() 从重组缓冲区头部移除并获得一个完整源数据包
- 使用内核过程 op_sar_rsmbuf_pk_flush() 从重组缓冲区清除陈旧的、不完整的源数据包
- 使用内核过程 op_sar_rsmbuf_pk_count() 确定重组缓冲区中完整源数据包的数量
- 使用内核过程 op_sar_buf_size() 确定 Sar 缓冲区中存储的比特数