op_prg_odb_bkpt()

摘要

定义带标签的断点;当仿真在 ODB 控制下运行且该带标签断点已启用时,断点将会触发。

语法

op_prg_odb_bkpt (label)
参数 类型 说明
label const char* 标识断点的标签字符串。该字符串会与已启用的带标签断点的标签进行比较。此类断点通过 ODB 命令 lstop 或 mlstop 启用。标签可包含任意 ASCII 字符,包括空白字符。

返回类型

void

无返回值。

示例

/* perform different actions depending on the type of interrupt */
switch (op_intrpt_type ())
	{
	case OPC_INTRPT_REMOTE:
		gate_status = op_intrpt_code ();
		op_prg_odb_bkpt ("gate.remote");
		break;

	case OPC_INTRPT_STRM:
		if (gate_status == GATE_OPEN)
				op_pk_send (op_pk_get (0), 0);
		else{
			op_prg_odb_bkpt ("gate.closed");
			op_pk_destroy (op_pk_get (0));
			}
		break;

	case OPC_INTRPT_STAT:
		remote_status = (int) op_stat_local_read (REMOTE_STAT);
		break;
	}

详情

断点是仿真执行过程中的暂停点,使用户能够评估仿真状态,并确定在下一个断点出现之前事件处理的范围。ODB 仿真调试器支持仿真断点(有关 ODB 的使用方法,参见“Simulation Debugger (ODB)“ 第 39 页)。在 ODB 中可以定义和/或启用多种类型的断点,包括面向时间的断点、面向事件的断点和带标签断点。带标签断点在进程模型内部使用本内核过程定义,并可通过 ODB 中的 lstop 和 mlstop 命令启用。

本内核过程可检测通过 lstop 或 mlstop 激活的带标签跟踪,前提是传递给本内核过程的标签字符串与传递给 ODB 命令的标签字符串完全一致。仅限于特定模块的带标签跟踪,只有当本内核过程由在该模块中执行的进程调用时才会被检测到。

本内核过程在优化仿真内核下不起任何作用。

用途

为进程提供了一种在特定条件下触发断点的定义机制。例如,本内核过程可以嵌入 if 语句、switch 语句或特殊的进程转移或状态中;每当相关代码被执行、本内核过程被调用时,就产生一次断点“机会”。如果断点已通过 ODB 命令 lstop 或 mlstop 启用,这些断点“机会”就会真正实现。能够有选择地启用由内核过程定义的断点,使得在相关模型部分的初始调试阶段完成后,仍可将这些断点保留在进程模型中。为断点加标签允许多组进程定义的断点在同一仿真中共存,在未被专门启用之前保持休眠状态。

错误

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

参考

  • 使用内核过程 op_prg_odb_print_major() 和 op_prg_odb_print_minor() 在条件性带标签断点(即只在特殊情况下触发的断点)之前打印调试消息
  • 使用 ODB 命令 lstop 全局启用由本内核过程定义的带标签断点
  • 使用 ODB 命令 mlstop 按模块启用由本内核过程定义的带标签断点

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