op_sar_rsmbuf_pk_remove()
摘要
从指定重组缓冲区中移除一个完整源数据包。返回指向被移除数据包的指针。
语法
op_sar_rsmbuf_pk_remove (sb_hndl)
| 参数 | 类型 | 说明 |
|---|---|---|
sb_hndl |
Sbhandle |
标识目标重组缓冲区的句柄 [该值必须标识一个 Sar 重组缓冲区。Sar 缓冲区句柄在通过内核过程 op_sar_buf_create() 创建缓冲区时获得。] |
返回类型
Packet*
指向从指定重组缓冲区移除的完整源数据包的指针。[如果指定重组缓冲区中没有完整数据包,该内核过程返回值 OPC_NIL。]
示例
/* Receive an incoming packet. */
pkptr = op_pk_get (INSTRM_1);
/* Determine if the received packet is a segment, or normal packet. */
if (op_sar_pk_is_segment (pkptr) == OPC_TRUE)
{
/* Received a segment; add to reassembly buffer. */
op_sar_rsmbuf_seg_insert (rsm_sbh, pkptr);
/* See if any packets are ready to be removed from reassembly buffer. */
while ((pkptr = op_sar_rsmbuf_pk_remove (rsm_sbh)) != OPC_NIL)
op_pk_send (pkptr, OUTSTRM_1);
}
else
{
/* Received a normal packet; forward on to output stream. */
op_pk_send (pkptr, OUTSTRM_1);
}
详情
该内核过程只移除完全重组的源数据包;缓冲区中不完整的源数据包(缺少一个或多个比特)不受该内核过程调用的影响。
与分段缓冲区或再分段缓冲区不同,重组缓冲区并不是简单地从缓冲区“头部”移除数据包(头部指缓冲区数据包有序列表的离开端)。重组缓冲区的内部结构比其他类型的缓冲区更复杂,实际上包含两个独立的源数据包有序列表:不完整列表(incomplete list)和完整列表(complete list)。
- 不完整列表存储不完整的源数据包,并在到达的 Sar 分段插入重组缓冲区时将其吸收。该列表中不完整源数据包的顺序基于每个数据包首个分段的到达顺序。
- 完整列表存储完整的源数据包,源数据包在完成时从不完整列表转移到该列表。该列表中完整源数据包的顺序基于源数据包的完成顺序。从重组缓冲区移除的数据包取自该列表的头部。
从完整列表移除的源数据包将是缓冲区中完成时长最长的数据包。注意,在完整列表中位于被移除数据包之后的其他完整数据包,其等待完成的时长可能比被移除的数据包更长。
用途
提供一种从重组缓冲区提取完整源数据包的机制。这是源数据包与 Sar 软件包交互的最终阶段,此时它已完全重构地重新出现。该内核过程通常被调用来获取重组后的数据包以进行进一步处理并最终交付给更高层协议。检查完整源数据包是否存在的合适时机是在 Sar 分段(或源数据包)插入重组缓冲区之后,因为源数据包只可能在这些时刻完成(见示例小节)。
错误
- 标准 Sar 错误(见表 15)
- 程序中止:缓冲区句柄引用了已销毁的缓冲区。
- 程序中止:缓冲区类型(
<type>)对该内核过程无效,应为(重组)。
参考
- 使用内核过程 op_sar_rsmbuf_pk_count() 确定重组缓冲区中完整源数据包的数量
- 使用内核过程 op_sar_buf_size() 确定 Sar 缓冲区中存储的比特数
- 使用内核过程 op_sar_rsmbuf_seg_insert() 将 Sar 分段插入重组缓冲区
- 使用内核过程 op_sar_rsmbuf_pk_flush() 从重组缓冲区清除陈旧的、不完整的源数据包