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)
- 标准输出消息:数据包具有空指针(由于指定缓冲区的数据包列表中存在无效的数据包指针)
参考
- 使用内核过程 op_sim_debug() 判断仿真是否运行在 ODB 仿真调试器的“调试模式”下
- 使用内核过程 op_prg_odb_trace_active() 或 op_prg_odb_ltrace_active() 判断是否有 ODB 跟踪生效
- 使用内核过程 op_sar_buf_create() 创建 Sar 缓冲区
- 使用内核过程 op_sar_buf_options_set() 在 Sar 缓冲区创建后为其设置选项
- 使用内核过程 op_sar_buf_size() 确定 Sar 缓冲区中存储的比特数