op_sar_rsmbuf_pk_flush()
摘要
从指定重组缓冲区中清除所有在缓冲区中停留时长超过指定时间时限的不完整源数据包。
语法
op_sar_rsmbuf_pk_flush (sb_hndl, flush_time)
| 参数 | 类型 | 说明 |
|---|---|---|
sb_hndl |
Sbhandle |
标识目标重组缓冲区的句柄 [该值必须标识一个 Sar 重组缓冲区。Sar 缓冲区句柄在通过内核过程 op_sar_buf_create() 创建缓冲区时获得。] |
flush_time |
double |
清除不完整源数据包的时间时限 [该值指定用于确定指定重组缓冲区中哪些不完整源数据包将被清除的时间时限(以秒计):在缓冲区中存储时长等于或长于该时限的不完整数据包将被清除,存储时长短于该时限的不完整源数据包将保留在缓冲区中。将该参数设置为 0.0 将导致所有不完整源数据包被清除。] |
返回类型
void
无返回值。
示例
/* Obtain a segment from input stream. */
seg_pkptr = op_pk_get (SEG_INSTRM);
/* Determine the size of the segment. */
seg_size = op_pk_total_size_get (seg_pkptr);
/* Loop from 3 minutes to 20 seconds, successively reducing the flush time */
/* and flushing the reassembly buffer of packets older than this time. Stop */
/* when the buffer is less than threshold value for adding new segment. */
for (ft = 180.0, buf_overflow = 0; ((pksize + op_sar_buf_size (rsm_sbh))
> MAX_RSM_BUF_SIZE); ft -= 20.0)
{
if (ft == 0.0) { buf_overflow = 1; break; }
/* Flush buffer using current iteration of flush time. */
op_sar_rsmbuf_pk_flush (rsm_sbh, ft);
}
/* Insert segment into reassembly buffer if buffer overflow has not occurred. */
if (!buf_overflow)
op_sar_rsmbuf_seg_insert (rsm_sbh, seg_pkptr);
详情
清除重组缓冲区中的不完整源数据包有三种方法:
- 通过调用该内核过程
- 通过 timed flush(定时清除)缓冲区选项
- 通过 automatic flush(自动清除)缓冲区选项
这三种方法可以全部用于同一个重组缓冲区而互不干扰。这些方法在以下几点上有所区别:
- op_sar_rsmbuf_pk_flush() 清除在指定缓冲区中存储时长大于或等于指定时间时限的不完整源数据包;该内核过程在被调用时立即执行清除动作,返回后对缓冲区没有持续影响。
- timed flush(定时清除)缓冲区选项清除在受影响缓冲区中存储时长超过指定时间时限的不完整源数据包;该选项是缓冲区的持续模式,当基于每个不完整数据包首个分段插入时间导出的内部调度事件首次使清除成为必要时,执行清除动作。
- automatic flush(自动清除)缓冲区选项清除存在比特序列缺口的不完整源数据包(即比特 <N> 存在而比特 <N-1> 不存在);该选项是缓冲区的持续模式,当插入指示比特序列缺口的 Sar 分段使清除首次成为必要时,执行清除动作。
该内核过程对存储在指定重组缓冲区中的完整源数据包没有影响,无论它们在缓冲区中已存在多长时间。
用途
提供一种从重组缓冲区清除陈旧的、不完整源数据包的机制。如果重组缓冲区从不可靠的通信信道获取 Sar 分段(例如链路状态高度动态的移动无线电环境),则可能需要清除不完整源数据包。在这种情况下,链路故障可能阻止所需的 Sar 分段到达包含重组缓冲区的目的节点,导致缓冲区中出现永久不完整的源数据包。如果这种失效模式反复发生多次,重组缓冲区将积累大量此类不完整源数据包,这对建模的系统资源和仿真内存使用都是不利结果。因此,该内核过程可用于从重组缓冲区清除比指定时限更旧的不完整数据包。
错误
- 标准 Sar 错误(见表 15)
- 程序中止:缓冲区句柄引用了已销毁的缓冲区。
- 程序中止:缓冲区类型(
<type>)对该内核过程无效,应为(重组)。 - 可恢复错误:清除时间(
<flush_time>)无效。 / 值必须大于或等于 0.0。
参考
- 使用内核过程 op_sar_buf_options_set() 为重组缓冲区设置与清除相关的选项
- 使用内核过程 op_sar_buf_size() 确定 Sar 缓冲区中存储的比特数
- 使用内核过程 op_sar_rsmbuf_pk_remove() 从重组缓冲区头部移除并获得一个完整源数据包
- 使用内核过程 op_sar_rsmbuf_seg_insert() 将 Sar 分段插入重组缓冲区