op_sar_srcbuf_bits_flush()
摘要
从指定源缓冲区(分段缓冲区或再分段缓冲区)中清除指定范围的比特。
语法
op_sar_srcbuf_bits_flush (sb_hndl, bit_index_loc, bit_count)
| 参数 | 类型 | 说明 |
|---|---|---|
sb_hndl |
Sbhandle |
标识目标源缓冲区的句柄 [该值必须标识一个 Sar 源缓冲区(即分段缓冲区或再分段缓冲区)。Sar 缓冲区句柄在通过内核过程 op_sar_buf_create() 创建缓冲区时获得。] |
bit_index_loc |
OpT_Sar_Size |
要从缓冲区清除的比特范围中首个比特的局部索引 [局部索引是一种数值,指示指定比特范围的首个比特在 Sar 缓冲区中的位置。局部索引取值从 0(缓冲区中的第一个比特)到 N-1(缓冲区中的最后一个比特,N 为缓冲区中的比特数)。] |
bit_count |
OpT_Sar_Size |
要从缓冲区清除的比特范围中的比特数 |
返回类型
Compcode
完成代码,指示指定的比特范围是否成功清除。
[该值可与两个符号常量 OPC_COMPCODE_SUCCESS 和 OPC_COMPCODE_FAILURE 进行比较。]
示例
/* Receive an acknowledgement from the peer process. */
ack_pkptr = op_pk_get (ACK_INSTRM);
/* Determine the sequence number of the source packet being acknowledged. */
op_pk_nfd_get (ack_pkptr, "ack_pk_seqnum", &new_ack_pk_seqnum);
/* Check if new acknowledgment progressed past last acknowledgment. */
if (new_ack_pk_seqnum > old_ack_pk_seqnum)
{
/* Determine the buffer-local bit-range of new acknowledgment. */
op_sar_rsgbuf_lbl_pk_range_get (rsg_sbh, new_ack_pk_seqnum,
&new_ack_bit_index, &new_ack_bit_count);
/* Flush the resegmentation buffer of acknowledged bits. */
op_sar_srcbuf_bits_flush (rsg_sbh, new_ack_bit_index, new_ack_bit_count);
/* Reset new acknowledgement as old acknowledgement. */
old_ack_pk_seqnum = new_ack_pk_seqnum;
}
详情
该内核过程要清除的比特范围用该范围首个比特的局部索引来指定。有时无需任何计算即可确定比特范围的局部索引,例如要清除整个缓冲区,或清除缓冲区的前 N 个比特(两种情况下局部索引均为 0)。然而,更常见的做法是清除缓冲区中与特定源数据包或 Sar 分段关联的比特范围。这一能力需要分别将源数据包或 Sar 分段的标签转换为基于局部索引的比特范围的内核过程:op_sar_rsgbuf_lbl_pk_range_get() 和 op_sar_rsgbuf_lbl_seg_range_get()。从这些内核过程的名称可以看出,该能力仅限于再分段缓冲区。
从 Sar 缓冲区清除一段比特会将其永久移出缓冲区所存储的比特序列。如果被清除的比特范围不在缓冲区头部,缓冲区剩余比特将在被清除比特范围的位置出现“顺序跳跃”。如果指定的比特范围包含缓冲区中与某一特定分段或源数据包关联的全部比特,则该分段或源数据包关联也将一并从缓冲区清除。如果指定的比特范围只包含缓冲区中与某一特定分段或源数据包关联的部分比特,则该分段或源数据包关联将因被清除的部分而缩减。
bit_index_loc 和 bit_count 两个参数均为 64 位整数,以支持大范围。
用途
提供一种从分段缓冲区或再分段缓冲区清除一段比特的机制。该范围由其首个比特的局部索引和长度标识。该内核过程的大多数调用针对再分段缓冲区,但有时也可能需要从分段中清除比特范围(例如,当比特范围的长度等于缓冲区中的比特数时,可以完全清除一个分段缓冲区)。从再分段缓冲区清除比特范围通常在这些缓冲区用于重传目的时进行(即存储已发送数据的副本,以备因数据包丢失、过度延迟等而重传)。在这些情况下,当一段已发送数据被正确接收后,即可从再分段缓冲区中清除,因为它不再需要作为“保险”。
错误
- 标准 Sar 错误(见表 15)
- 程序中止:比特数值(
<bit_count>)必须大于 0。 - 程序中止:缓冲区类型(重组)对该内核过程无效,应为(分段或再分段)。
- 可恢复错误:索引(
<bit_index_loc>)无效。 / 取值必须 >= 0。 - 可恢复错误:比特数(
<bit_count>)与索引的组合无效。取值必须小于缓冲区大小。
参考
- 使用内核过程 op_sar_rsgbuf_lbl_pk_range_get() 确定再分段缓冲区中与特定源数据包关联的比特范围的局部比特索引和长度
- 使用内核过程 op_sar_rsgbuf_lbl_seg_range_get() 确定再分段缓冲区中与特定 Sar 分段关联的比特范围的局部比特索引和长度
- 使用内核过程 op_sar_rsgbuf_bits_flush_abs() 从再分段缓冲区清除由绝对比特索引和长度标识的比特范围
- 使用内核过程 op_sar_buf_size() 确定 Sar 缓冲区中存储的比特数