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_BNDRYOPC_SAR_BUF_OPT_SEG_PAD |
| 重组 | 自动清除 定时清除 |
OPC_SAR_BUF_OPT_FLUSH_AUTOOPC_SAR_BUF_OPT_FLUSH_TIMED |
设置数据包边界或分段填充选项不会立即引发任何动作;新选项值在缓冲区发生插入或移除时才首次生效。设置自动清除选项会立即清除任何包含间隙的不完整源数据包。设置定时清除选项会立即清除在指定重组缓冲区中停留时间超过新 flush_time 值的任何不完整源数据包。
用途
提供一种在 Sar 缓冲区创建之后更改其运行选项的机制。重组缓冲区的定时清除选项只能通过该内核过程设置,因此以该选项初始化重组缓冲区时必须包含对该内核过程的调用。其他缓冲区选项均可在通过 op_sar_buf_create() 创建缓冲区时设置,因此仅当需要修改这些选项时才会调用 op_sar_buf_options_set()。分段与再分段缓冲区选项处理源数据包与分段比特边界之间的关系,通常在源数据包数据性质的变化需要一种新的分段形式时(相当少见的情形)才被修改。重组缓冲区选项处理清除操作,通常在缓冲区大小接近受监控的上限时才被修改。
错误
- 标准 Sar 错误(见表 15)
- 可恢复错误:对于指定缓冲区类型,选项 (
<option>) 无效。 - 可恢复错误:清除时间 (
<flush_time>) 无效。值必须大于或等于 0.0。
参考
- 使用内核过程 op_sar_buf_create() 创建带有初始选项集的 Sar 缓冲区
- 使用内核过程 op_sar_buf_print() 将 Sar 缓冲区的详细信息打印到标准输出