op_sar_buf_create()
摘要
创建指定类型、带指定选项的 Sar 缓冲区。
语法
op_sar_buf_create (buf_type, options)
| 参数 | 类型 | 说明 |
|---|---|---|
buf_type |
int |
新缓冲区的类型 [该值是数值代码,指定要创建的 Sar 缓冲区类型。三种 Sar 缓冲区类型的符号常量列于表 78 “Sar Buffer Type Symbolic Constants“ 第 24 页,即 OPC_SAR_BUF_TYPE_SEGMENT、OPC_SAR_BUF_TYPE_RESEGMENT 和 `OPC_SAR_BUF_TYPE_REASSEMBLY)。] |
options |
int |
缓冲区选项标志 [该值是符号常量标志的按位 OR 组合,指定要启用的 Sar 缓冲区选项(见详情小节和表 77 “Sar Buffer Option Symbolic Constants“ 第 23 页。)] |
返回类型
Sbhandle
标识所创建 Sar 缓冲区的句柄。
示例
/* Get the handle for the event’s ICI. */
iciptr = op_intrpt_ici ();
/* Extract the request type. */
op_ici_attr_get (iciptr, "svc_request", &svc_req);
/* Request is for opening a connection */
if (svc_req == GP_REQ_CONN_OPEN)
{
/* Allocate a connection data structure. */
conn_ptr = (GpT_Connection *) op_prg_mem_alloc (sizeof (GpT_Connection));
/* Initialize connection variables. */
conn_ptr->seq_num = 0;
conn_ptr->active = 1;
/* Create a segmentation buffer for use by the connection. */
conn_ptr->sbh = op_sar_buf_create (OPC_SAR_BUF_TYPE_SEGMENT,
OPC_SAR_BUF_OPT_PK_BNDRY);
}
详情
options 参数指定所创建缓冲区的运行选项。支持的选项取决于所创建缓冲区的类型,如下表所示。
表 16:用于创建缓冲区的 Sar 缓冲区选项
| 缓冲区类型 | 支持的选项 | 选项标志 |
|---|---|---|
| 任意类型 | 默认选项(无) | OPC_SAR_BUF_OPT_DEFAULT |
| 分段与再分段 | 数据包边界 分段填充 |
OPC_SAR_BUF_OPT_PK_BNDRYOPC_SAR_BUF_OPT_SEG_PAD |
| 重组 | 自动清除 | OPC_SAR_BUF_OPT_FLUSH_AUTO |
传递给该内核过程的无效选项标志会被忽略,但会产生可恢复错误。
注: 定时清除选项(OPC_SAR_BUF_OPT_FLUSH_TIMED)无法通过该内核过程设置,但可通过内核过程 op_sar_buf_options_set() 为已存在的重组缓冲区指定。
一旦创建,Sar 缓冲区的类型便无法更改(例如,重组缓冲区永远是重组缓冲区)。
用途
提供一种创建 Sar 缓冲区以供后续使用的机制。必须存在 Sar 缓冲区才能执行 Sar 包内核过程提供的任何分段与重组服务,因为缓冲区存储服务所使用的数据(例如,分段缓冲区保存源数据包的数据,直到其以分段形式被移除)。因此,该内核过程通常在进程模型的初始化部分调用;对于面向连接的进程模型,则在连接的初始化部分调用。该内核过程可以创建全部三种 Sar 缓冲区,因此没有专门用于创建特定缓冲区类型的内核过程;事实上,别无他法创建 Sar 缓冲区。
错误
- 程序中止:内核过程需要进程上下文
- 程序中止:缓冲区类型值 (
<buf_type>) 无效。 - 程序中止:超出虚拟内存限制。分配的对象过多。
- 可恢复错误:对于指定缓冲区类型,选项 (
<option>) 无效。 - 可恢复错误:创建时,对于指定缓冲区类型,选项 (
OPC_SAR_BUF_OPT_FLUSH_TIMED) 无效。
参考
- 使用内核过程 op_sar_buf_destroy() 在 Sar 缓冲区不再需要后将其释放
- 使用内核过程 op_sar_buf_options_set() 在 Sar 缓冲区创建后为其设置选项
- 使用内核过程 op_sar_buf_print() 将 Sar 缓冲区的信息打印到标准输出
- 使用内核过程 op_sar_buf_size() 确定 Sar 缓冲区中存储的比特数