op_prg_odb_trace_active()
摘要
判断完整跟踪,或与所在模块关联的模块跟踪,是否已被 ODB 命令激活。
语法
op_prg_odb_trace_active ()
| 参数 | 类型 | 说明 |
|---|---|---|
| 无参数 |
返回类型
Boolean
布尔值,指示完整跟踪是否处于激活状态,或所在模块的模块跟踪是否处于激活状态。若任一跟踪处于激活状态,该值为 OPC_TRUE;否则为 OPC_FALSE。
示例
/* check if this module is being traced */
if (op_prg_odb_trace_active ())
{
/* print local banner (time / module not necessary) */
op_prg_odb_print_major ("List of in-stream contents:", OPC_NIL);
/* loop through all the input streams, determining the number */
/* of packets being queued there (assumes consecutive connections) */
num_in_strms = op_strm_max_index_in () + 1;
for (i = 0; i < num_in_strms; i++)
{
sprintf (out_string, "in-stream [%d] contains %d packets\n", i,
op_strm_pksize ());
op_prg_odb_print_minor (out_string, OPC_NIL);
}
}
详情
跟踪是仿真的一种特殊状态,激活后允许打印特定的诊断信息并执行相关动作。ODB 仿真调试器支持仿真跟踪(有关 ODB 的使用方法,参见“Simulation Debugger (ODB)“ 第 39 页)。在 ODB 中可以激活多种类型的跟踪,包括完整跟踪、面向模块的跟踪、面向 Packet 的跟踪和带标签跟踪。完整跟踪通过 ODB 命令 fulltrace 激活,模块跟踪通过 ODB 命令 mtrace 激活。这两种跟踪类型均可由本内核过程检测,但模块跟踪仅在其影响所在模块时才会被检测到。
本内核过程在优化仿真内核下使用时返回 OPC_FALSE。
用途
为在 ODB 中定义了完整跟踪或所在模块的跟踪时执行特殊动作提供了一种机制。这些动作通常包括由 op_prg_odb_print_major()、op_prg_odb_print_minor() 或 printf() 生成的诊断打印语句。不过,这些动作可以包含任何内核过程,包括统计量读取、Packet 操作等。
错误
- 不捕获任何错误。
参考
- 使用内核过程 op_prg_odb_print_major() 和 op_prg_odb_print_minor() 打印诊断语句
- 使用内核过程 op_prg_odb_ltrace_active() 判断特定的带标签跟踪是否处于激活状态
- 使用内核过程 op_prg_odb_pktrace_active() 判断特定的 Packet 跟踪是否处于激活状态