op_sar_buf_print()

摘要

将指定缓冲区的信息打印到标准输出设备。

语法

op_sar_buf_print (sb_hndl)
参数 类型 说明
sb_hndl Sbhandle 标识目标缓冲区的句柄
[该值可标识三种 Sar 缓冲区类型中的任意一种:分段、重组或再分段。Sar 缓冲区句柄在通过内核过程 op_sar_buf_create() 创建缓冲区时获得。]

返回类型

void

无返回值。

示例

/* End-of-simulation diagnostics. */
if (op_intrpt_type () == OPC_INTRPT_ENDSIM)
	{
	/* Print out info. on Sar buffer. */
	op_sar_buf_print (seg_sbh);
	}

标准输出设备上显示的示例输出:

		* SAR Buffer:
			buffer ID        (6)
			buffer type      (segmentation)
			buffer option    (packet boundary (on))
			buffer option    (pad segments (off))
			creation module  (sn1.hub.ipx)
			buffer size      (685)

			Packets contained within buffer:
			--------------------------------
			packet ID         (40510)
			SAR label         (710)
			insertion time    (5012.672)
			bit count (orig)  (256)
			bit count (curr)  (18)
			bit ranges: <...>

详情

该内核过程以标准 ODB 跟踪格式打印 Sar 缓冲区信息(见示例小节)。打印信息的范围部分取决于指定缓冲区的类型。表 18列出了该内核过程输出的各个组成部分。

表 18:Sar 缓冲区打印组成部分

所有缓冲区 分段缓冲区 再分段缓冲区 重组缓冲区
缓冲区 ID
缓冲区类型
创建模块
缓冲区大小
选项状态:数据包边界与分段填充
源数据包列表:
ID
标签
插入时间
原始比特数
当前比特数
比特范围列表
选项状态:数据包边界与分段填充
分段列表:
标签
插入时间
比特数
分段内源数据包列表:
- ID
- 标签
- 比特数
- 比特范围列表
选项状态:自动清除与定时清除
不完整源数据包列表:
ID
标签
插入时间
已接收比特数
所需比特数
比特范围列表
完整源数据包列表:
ID
插入时间
完成时间

源数据包的比特范围以 <from>-<to> 格式打印,其中 <from> 与 <to> 是数据包中比特的数字索引,数据包的第一个比特从 0 开始计数。

用途

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

错误

  • 标准 Sar 错误(见表 15)
  • 标准输出消息:数据包具有空指针(由于指定缓冲区的数据包列表中存在无效的数据包指针)

参考

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