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 操作等。

错误

  • 程序中止:段违例。(由于无效的标签指针或格式错误的标签字符串)

参考

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