Esa_Main()
摘要
执行底层初始化,并可选择启动联合仿真代码。
语法
Esa_Main (argc, argv, options)
| 参数 | 类型 | 说明 |
|---|---|---|
argc |
int |
argv 数组的大小 |
argv |
char ** |
字符串参数数组,通常即传入 main() 入口点的参数。 |
options |
int |
取以下之一: - ESAC_OPTS_NONE——无特殊选项- ESAC_MAIN_OPTS_CALL——查找并调用 esa_main(参见详情) |
返回类型
int
若 esa_main() 被调用,返回其返回的联合仿真自定义值;若 esa_main() 未被调用,返回 1。
头文件
esa.h
详情
该函数是一个预初始化例程,用于执行即时动作,而将大部分初始化工作留给 Esa_Init()。
Riverbed 分析软件仿真可以运行在“dynamic”模式(使用 op_runsim 加载仓库)或“static”模式(使用 op_mksim 创建可执行文件)。联合仿真也是如此。此外还有 Riverbed 分析软件与联合仿真代码之间的关系:其中一方提供 main() 入口点,因此会以某种方式调用另一方。
情形 1——main() 由 Riverbed Modeler 提供
在这种情况下,调用 Esa_Main() 时将 options 设为 ESAC_MAIN_OPTS_CALL。联合仿真代码应当已被链接进来。在完成一组 Riverbed Modeler 底层初始化之后,程序会查找并调用名为 esa_main() 的函数。
情形 2——main() 由联合仿真提供
在这种情况下,main() 函数应尽早调用 Esa_Main()。核心 ESA 初始化完成后,会发生以下两种情况之一:
- 如果
options设为ESAC_MAIN_OPTS_CALL,程序会查找名为esa_main()的函数,找到后即调用它。Esa_Main()只有在esa_main()返回之后才会返回。 - 如果
options设为ESAC_OPTS_NONE,Esa_Main()在初始化完成后立即返回。
如果调用了 esa_main() 例程,它应当调用 Esa_Init()、Esa_Load() 等。如果没有调用任何 esa_main() 例程,则调用 Esa_Main() 的代码必须随后调用 Esa_Init()、Esa_Load() 等。