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)。

参考

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