op_sar_rsmbuf_pk_count()
摘要
获取指定重组缓冲区中完整源数据包的数量。
语法
op_sar_rsmbuf_pk_count (sb_hndl)
| 参数 | 类型 | 说明 |
|---|---|---|
sb_hndl |
Sbhandle |
标识目标重组缓冲区的句柄 [该值必须标识一个 Sar 重组缓冲区。Sar 缓冲区句柄在通过内核过程 op_sar_buf_create() 创建缓冲区时获得。] |
返回类型
int
指定重组缓冲区中完成重组的数据包数量。
示例
/* 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);
}
详情
该内核过程返回的数量只统计完全重组的源数据包;缺少一个或多个比特的不完整源数据包将被忽略。
注意,内核过程 op_sar_buf_size() 确定的是重组缓冲区中的比特总数,包括完整和不完整的源数据包。因此,op_sar_rsmbuf_pk_count() 与 op_sar_buf_size() 的结果通常不应一起用于数学表达式(例如通过计算两者之比来确定重组缓冲区中数据包的平均大小)。
用途
提供一种确定重组缓冲区中有多少已重组源数据包可供移除的机制。该数量主要用作循环的上限值,该循环将从重组缓冲区中移除并处理每个完整的源数据包,如示例小节所示(另一种做法是,这类循环也可以在移除完整源数据包失败时终止,即 op_sar_rsmbuf_pk_remove() 返回 OPC_NIL)。重组缓冲区中完整源数据包的数量还可用于预留这些数据包从缓冲区移除后所需的资源,或用于计算重组吞吐量统计量。
错误
- 标准 Sar 错误(见表 15)
- 程序中止:缓冲区句柄引用了已销毁的缓冲区。
- 程序中止:缓冲区类型(
<type>)对该内核过程无效,应为(重组)。
参考
- 使用内核过程 op_sar_buf_size() 确定 Sar 缓冲区中存储的比特数
- 使用内核过程 op_sar_rsmbuf_pk_remove() 从重组缓冲区头部移除并获得一个完整源数据包
- 使用内核过程 op_sar_rsmbuf_seg_insert() 将 Sar 分段插入重组缓冲区
- 使用内核过程 op_sar_rsmbuf_pk_flush() 从重组缓冲区清除陈旧的、不完整的源数据包