op_prg_odb_pktrace_active()
摘要
判断指定的 Packet 是否受到 ODB(仿真调试器)下发出的跟踪命令的影响。
语法
op_prg_odb_pktrace_active (pkptr)
| 参数 | 类型 | 说明 |
|---|---|---|
pkptr |
Packet* |
指向目标 Packet 的指针。[Packet 指针可从许多内核过程获得,包括 op_pk_create()、op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。] |
返回类型
Boolean
布尔值,指示指定的 Packet 是否正在被跟踪。若指定的 Packet 正在被跟踪,该值为 OPC_TRUE;否则为 OPC_FALSE。
示例
/* obtain a packet from the higher layer input stream */
pkptr = op_pk_get (HIGH_LAYER_INSTRM);
/* determine if the packet is being traced */
if (op_prg_odb_pktrace_active (pkptr) == OPC_TRUE)
{
/* tracing is active: print packet info. */
printf ("---------- Packet %04d ----------\n", op_pk_id (pkptr));
printf ("* Received by object #%d\n", op_id_self ());
op_pk_nfd_get (pkptr, "message_class", &mclass);
printf ("* Message class %s\n", Msg_Class_Table [mclass]);
printf ("---------------------------------\n");
}
/* insert the packet into the processing queue */
op_subq_pk_insert (0, pkptr, OPC_QPOS_TAIL);
详情
跟踪是仿真的一种特殊状态,激活后允许打印特定的诊断信息并执行相关动作。ODB 仿真调试器支持仿真跟踪(有关 ODB 的使用方法,参见“Simulation Debugger (ODB)“ 第 39 页)。在 ODB 中可以激活多种类型的跟踪,包括完整跟踪、面向模块的跟踪、面向 Packet 的跟踪和带标签跟踪。面向 Packet 的跟踪通过 ODB 命令 pktrace 和 pttrace 激活。本内核过程可检测处于激活状态的 Packet 跟踪,前提是传入的 Packet 与相应 ODB 命令传入的 Packet ID 或树 ID 完全匹配。
除特定的 Packet 跟踪外,如果由 ODB 命令 fulltrace 定义的完整跟踪正在生效,本内核过程也会返回 OPC_TRUE。
本内核过程在优化仿真内核下使用时返回 OPC_FALSE。
用途
为在 ODB 中定义了 Packet 跟踪时执行特殊动作提供了一种机制。这些动作通常包括由 op_prg_odb_print_major()、op_prg_odb_print_minor() 或 printf() 生成的诊断打印语句。不过,这些动作可以包含任何内核过程,包括如左侧示例小节所示的对受影响 Packet 的操作。
错误
- 程序中止:段违例(由于无效的 Packet 指针或格式错误的 Packet)。
参考
- 使用内核过程 op_prg_odb_print_major() 和 op_prg_odb_print_minor() 打印诊断语句
- 使用内核过程 op_pk_print() 打印 Packet 的内容
- 使用内核过程 op_prg_odb_ltrace_active() 判断特定的带标签跟踪是否处于激活状态
- 使用内核过程 op_prg_odb_trace_active() 判断完整跟踪或所在模块的跟踪是否处于激活状态