仿真调试器(ODB)
仿真调试器(ODB)本身就是开发版仿真内核的一部分,会自动链接到每一个仿真。这使你可以随时在 ODB 控制下运行仿真,而无需做任何特殊准备。
ODB 的目的是提供一个分析程序执行过程的环境,在该环境中高层抽象(如变量名、数据结构等)得以保留并可访问。在 Modeler 的语境下,被分析的程序就是仿真,高层抽象包括对象(如模块和子模块)以及动态数据实体(如数据包和事件)。
执行联合仿真时,通常 ODB 与外部仿真器的调试环境同时运行。你可以在外部仿真环境中执行大多数 ODB 命令,也可以在 ODB 中执行另一环境的命令。
ODB 使用基于文本的命令解释器,通过 Simulation Console 或标准输入输出进行通信。除命令行外,常用操作(如单步执行事件、设置断点)已集成到高级 Simulation Execution 对话框的图形化调试功能中。
命令解释器接受简单的命令,用于控制仿真的执行和信息的打印。大多数命令带有参数;参数可以指明命令的目标对象或影响命令的参数。
ODB 提供的命令可以让你:
- 执行单个事件
- 为特定事件、时间、模块或进程设置断点,并在断点之间继续执行
- 跟踪正在执行的内核过程,并可将跟踪记录限制在选定的模块、进程、数据包或数据包组
- 启用由进程模型中调用特殊 KP 所定义的断点或跟踪记录
- 打印仿真实体的当前状态信息,包括静态模型对象(如模块)以及事件、数据包和进程等动态实体
- 打印内存使用统计信息以及内存分配与释放的详细报告
- 通过修改对象属性来改变仿真的进程
ODB 命令的格式与说明见"ODB Command Reference"(第 65 页)。
调用 ODB
要访问 ODB 解释器,需要在执行仿真时将 debug 偏好设置为 TRUE。通常,在启动仿真之前通过 GUI 的 Configure/Run DES 对话框启用调试。在 Common 页或 Execution > OPNET Debugger 页上选中 "Use Simulation Debugger (ODB)" 复选框。从 GUI 进行调试时,你可以通过图形化调试器界面使用 ODB 的全部功能(参见"Simulation Execution Dialog Box (Advanced)"(第 9 页))。
在 GUI 之外,设置 debug 偏好的最常见方式是通过命令行参数,如图 7所示。另外,也可以通过 shell 变量或在偏好文件中赋值将 debug 偏好设置为 TRUE。不过这些替代方法不太常用,因为它们在生效期间会影响每一次仿真运行。设置 debug 偏好的另一种方式是在环境文件中赋值;这支持为仿真创建调试版和非调试版环境文件。
图 7:从命令行调用 ODB
% op_runsim -net_name example -debug
<...simulation banner...>
_______________ Simulation Debugger _______________
Type 'help' for Command Summary
ODB>
在图 7所示的示例仿真中,仿真调试器被立即进入:仿真横幅之后同时显示了 "Simulation Debugger" 横幅和 ODB> 命令提示符。某些仿真可能如此,但许多仿真会在仿真横幅与 ODB 横幅之间打印额外消息。仿真初始化阶段打印的消息属于以下目的之一:
- 指示仿真对象的加载(如果偏好 verbose_load 设置为 TRUE)
- 向用户询问被提升的对象属性的取值,可以在启动 Modeler 的 shell 窗口命令行中回答,也可以在 GUI 的对话框提示框中回答
另一次仿真运行的初始输出如图 8所示,其中在进入 ODB 之前包含若干消息。
图 8:带消息的调试示例
% op_runsim -net_name pksw_net -debug
<...simulation banner...>
-------------------- Unset Environment Attribute ---------------------
* pksw1.node0.src.interarrival args: <arg. list>
* Desc:
* Press <return> to select default: 1.0
Enter value> 2.0
----------------------------------------------------------------------
-------------------- Unset Environment Attribute ---------------------
* pksw1.node1.src.interarrival args: <arg. list>
* Desc:
* Press <return> to select default: 1.0
Enter value> 1.0, 2.0
----------------------------------------------------------------------
_______________ Simulation Debugger _______________
Type 'help' for Command Summary
ODB>
ODB 概念
有若干重要概念构成了大多数 ODB 命令的基础。这些概念与大多数符号调试工具共通,包括断点、跟踪记录、映射和诊断块。接下来的主题将逐一介绍它们,以及基于它们的 ODB 命令。