op_sar_segbuf_pk_insert()

摘要

将指定源数据包插入指定分段缓冲区的尾部。用户定义的标签参数为该数据包“打上标记”,以便后续引用。

语法

op_sar_segbuf_pk_insert (sb_hndl, src_pkptr, src_pk_label)
参数 类型 说明
sb_hndl Sbhandle 标识目标分段缓冲区的句柄
[该值必须标识一个 Sar 分段缓冲区。Sar 缓冲区句柄在通过内核过程 op_sar_buf_create() 创建缓冲区时获得。]
src_pkptr Packet* 指向要插入缓冲区的源数据包的指针
[指向数据包的指针可从许多内核过程获得,包括 op_pk_create()、op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。]
src_pk_label OpT_Int64 指定源数据包的标签
[源数据包标签是一种用户定义的数值,用于为指定源数据包“打上标记”;因此该标签与指定源数据包在其所有派生 Sar 分段中的内容相关联。源数据包标签可传递给内核过程 op_sar_rsgbuf_lbl_pk_range_get(),以确定 Sar 再分段缓冲区中与指定源数据包关联的存储比特范围。]

返回类型

void

无返回值。

示例

/* Obtain an arriving source packet. */
src_pkptr = op_pk_get (HLP_INSTRM);

/* Determine the size of the source packet. */
rem_size = op_pk_total_size_get (src_pkptr);

/* Insert the source packet into segmentation buffer. */
op_sar_segbuf_pk_insert (seg_sbh, src_pkptr, pk_seq_num++);

/* Remove and send the first segment associated with arriving packet. */
seg_pkptr = op_sar_srcbuf_seg_remove (rsm_sbh, SEG_SIZE);
op_pk_send (seg_pkptr, LLP_OUTSTRM);

/* Compute new remainder of source packet */
rem_size -= SEG_SIZE;

/* If there is a remainder of source packet, schedule next segment transmission. */
if (rem_size > 0)
	op_intrpt_schedule_self (op_sim_time () + SEG_TX_TIME, SEG_TX_CODE);

详情

src_pk_label 参数用于标识与所插入源数据包关联的比特。所插入源数据包的每一个比特都与指定标签关联,因此如果源数据包被拆分为多个 Sar 分段,每个所得分段中与该源数据包关联的比特都可通过其源数据包标签加以识别。源数据包的标签之后可通过内核过程 op_sar_rsgbuf_lbl_seg_range_get() 和 op_sar_srcbuf_bits_flush() 用于标识要从再分段缓冲区清除的分段。源数据包标签是用户定义的数值,以支持使用进程模型专用的序列号作为标签。通常,源数据包要么以数据包序列号作为标签,要么以其包含的首个(或最后一个)字节(或比特)对应的序列号作为标签。

注意,源数据包一旦插入分段缓冲区,就无法再通过其原始指针访问(即无法再对该数据包指针执行任何数据包操作)。重新获得该数据包访问权的唯一方式是:从其分段缓冲区移除各分段,将它们插入重组缓冲区,然后提取完全重组的源数据包。重组后的数据包是原始数据包的“再创造”,其指针值和 ID 可能与原始数据包不同。

用途

提供一种将源数据包插入分段缓冲区的机制(注意,没有其他方法可以将数据包插入分段缓冲区)。分段缓冲区将源数据包拆分或合并为用户请求大小的分段;实际创建分段的动作发生在调用内核过程 op_sar_srcbuf_seg_remove() 或 op_sar_srcbuf_seg_access() 之时。分段缓冲区接受插入“普通”数据包(即未被 Sar 软件包分段的数据包);它们也接受插入 Sar 分段,这些分段被视为源数据包,并被拆分或合并为另一个“层级”的分段(对经过分层分段的源数据包进行最终重组,需要由一系列重组缓冲区按顺序处理)。

错误

  • 标准 Sar 错误(见表 15)
  • 程序中止:缓冲区句柄引用了已销毁的缓冲区。
  • 程序中止:缓冲区类型(<type>)对该内核过程无效,应为(分段)。
  • 程序中止:数据包指针引用了无主数据包(<pkid>)
  • 程序中止:数据包指针引用了静态数据包(<pkid>)
  • 程序中止:数据包(<pkid>)已被分段。 / 它不能被插入另一个分段缓冲区。
  • 程序中止:超出虚拟内存限制。分配的对象过多。
  • 可恢复错误:对象块分配失败 / 对象类型(<ob_type>)。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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