op_prg_odb_ltrace_active()
摘要
判断指定的带标签跟踪是否已被 ODB 命令激活。
语法
op_prg_odb_ltrace_active (label)
| 参数 | 类型 | 说明 |
|---|---|---|
label |
const char* |
与跟踪关联的标签字符串。该字符串会与已激活的带标签跟踪的标签进行比较。此类跟踪通过 ODB 命令 ltrace 或 mltrace 激活。标签可包含任意 ASCII 字符,包括空白字符。 |
返回类型
Boolean
布尔值,指示指定的带标签跟踪是否处于激活状态。若指定的跟踪已激活,该值为 OPC_TRUE;否则为 OPC_FALSE。
示例
/* check to see if a queue dump trace is enabled */
if (op_prg_odb_ltrace_active ("queue_dump") == OPC_TRUE)
{
/* a trace is enabled, so scan through the queue’s contents */
queue_size = op_subq_stat (0, OPC_QSTAT_PKSIZE);
for (pos = 0; pos < queue_size; pos++)
{
/* obtain each packet from the subqueue */
pkptr = op_subq_pk_access (0, i);
/* extract each packet’s source and destination addresses */
op_pk_nfd_get (pkptr, "src_addr", &src_addr);
op_pk_nfd_get (pkptr, "dst_addr", &dst_addr);
/* print out the information */
printf ("packet [%d]: src_addr [%d] / dst_addr [%d]\n", pos,
src_addr, dst_addr);
}
}
详情
跟踪是仿真的一种特殊状态,激活后允许打印特定的诊断信息并执行相关动作。ODB 仿真调试器支持仿真跟踪(有关 ODB 的使用方法,参见“Simulation Debugger (ODB)“ 第 39 页)。
在 ODB 中可以激活多种类型的跟踪,包括完整跟踪、面向模块的跟踪、面向 Packet 的跟踪和带标签跟踪。带标签跟踪通过 ODB 命令 ltrace(用于全局的带标签跟踪)或 mltrace(用于仅适用于特定模块的带标签跟踪)激活。本内核过程可检测通过任一命令激活的带标签跟踪,前提是传递给本内核过程的标签字符串与传递给 ODB 命令的标签字符串完全一致。仅限于特定模块的带标签跟踪,只有当本内核过程由在该模块中执行的进程调用时才会被检测到。除特定的带标签跟踪外,如果由 ODB 命令 fulltrace 定义的完整跟踪正在生效,本内核过程也会返回 OPC_TRUE。
本内核过程在优化仿真内核下使用时返回 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_pktrace_active() 判断特定的 Packet 跟踪是否处于激活状态
- 使用内核过程 op_prg_odb_trace_active() 判断完整跟踪或所在模块的跟踪是否处于激活状态