op_sar_buf_options_set()

摘要

将指定选项赋予指定缓冲区。

语法

op_sar_buf_options_set (sb_hndl, options, flush_time)
参数 类型 说明
sb_hndl Sbhandle 标识目标缓冲区的句柄
[该值可标识三种 Sar 缓冲区类型中的任意一种:分段、重组或再分段。Sar 缓冲区句柄在通过内核过程 op_sar_buf_create() 创建缓冲区时获得。]
options int 缓冲区选项标志
[该值是符号常量标志的按位 OR 组合,指定要启用的 Sar 缓冲区选项(见详情小节和表 77 “Sar Buffer Option Symbolic Constants“ 第 23 页。)]
flush_time double 不完整源数据包被清除的时间限值
[该值仅当该内核过程的调用涉及重组缓冲区并包含选项标志 OPC_SAR_BUF_OPT_FLUSH_TIMED 时使用(注意无论如何都必须向该内核过程传递一个“占位”值)。该值以秒为单位,指定不完整源数据包的分段可在重组缓冲区中停留的时间;当重组缓冲区中的不完整数据包分段达到时间限值时,即被清除。]

返回类型

void

无返回值。

示例

/* Change the reassembly buffer’s flush timer. */
switch (flush_mode)
	{
	case FM_LONG:
		/* Long is ten minutes. */
		op_sar_buf_options_set (sbh, OPC_SAR_BUF_OPT_FLUSH_TIMED, 600.0);
		break;

	case FM_MEDIUM:
		/* Medium is one minute. */
		op_sar_buf_options_set (sbh, OPC_SAR_BUF_OPT_FLUSH_TIMED, 60.0);
		break;

	case FM_SHORT:
		/* Short is one second. */
		op_sar_buf_options_set (sbh, OPC_SAR_BUF_OPT_FLUSH_TIMED, 1.0);
		break;
	}

详情

options 参数指示要启用的指定缓冲区的运行选项,并允许使用 C 语言按位 OR 运算符(竖线字符 “|”)组合多个选项标志。传递给 options 参数的缓冲区选项符号常量会使相应选项被无限期启用;缓冲区选项仅在该内核过程被调用时才会改变。该内核过程调用中支持的选项取决于缓冲区的类型,如表 17所示;传递给该内核过程的无效选项值会被忽略,并产生可恢复错误。

表 17:用于设置缓冲区的 Sar 缓冲区选项

缓冲区类型 支持的选项 选项标志
任意类型 默认选项(无) OPC_SAR_BUF_OPT_DEFAULT
分段与再分段 数据包边界
分段填充
OPC_SAR_BUF_OPT_PK_BNDRY
OPC_SAR_BUF_OPT_SEG_PAD
重组 自动清除
定时清除
OPC_SAR_BUF_OPT_FLUSH_AUTO
OPC_SAR_BUF_OPT_FLUSH_TIMED

设置数据包边界或分段填充选项不会立即引发任何动作;新选项值在缓冲区发生插入或移除时才首次生效。设置自动清除选项会立即清除任何包含间隙的不完整源数据包。设置定时清除选项会立即清除在指定重组缓冲区中停留时间超过新 flush_time 值的任何不完整源数据包。

用途

提供一种在 Sar 缓冲区创建之后更改其运行选项的机制。重组缓冲区的定时清除选项只能通过该内核过程设置,因此以该选项初始化重组缓冲区时必须包含对该内核过程的调用。其他缓冲区选项均可在通过 op_sar_buf_create() 创建缓冲区时设置,因此仅当需要修改这些选项时才会调用 op_sar_buf_options_set()。分段与再分段缓冲区选项处理源数据包与分段比特边界之间的关系,通常在源数据包数据性质的变化需要一种新的分段形式时(相当少见的情形)才被修改。重组缓冲区选项处理清除操作,通常在缓冲区大小接近受监控的上限时才被修改。

错误

  • 标准 Sar 错误(见表 15)
  • 可恢复错误:对于指定缓冲区类型,选项 (<option>) 无效。
  • 可恢复错误:清除时间 (<flush_time>) 无效。值必须大于或等于 0.0。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com