op_mkema
一个实用工具,用于编译和链接调用外部模型访问(EMA)库函数的应用程序。
描述
EMA 是随 OPNET 发行版提供的一组过程库,可用于从外部程序创建或查询模型(EMA 在本手册后面有详细说明)。基于 EMA 的应用程序是调用 EMA 库以访问模型的程序。要正确构建此类应用程序,需要满足以下要求:(1) 应用程序的 C 代码必须能够访问 EMA 相关的头文件(即 opnet.h、ema.h、opnet_emadefs.h 和 opnet_constants.h,位于 <reldir>/sys/include 中);(2) 应用程序的编译产物必须与 EMA 库(名为 <reldir>/sys/<arch>/lib/libm3ema.so)链接。提供 op_mkema 实用工具,以便方便地准备 EMA 应用程序,使其满足这些要求。
op_mkema 实用工具接收不带文件类型后缀的 EMA 应用程序名称,并执行以下任务:
- 为名称添加 .em.c 文件类型后缀,并在模型目录中定位该文件
- 将应用程序的 C 文件编译为目标代码文件,文件类型后缀为 .em.o
- 将生成的目标代码文件与 EMA 库链接,从而生成完整的可执行程序,文件类型后缀为 .em.x
这一编译与链接过程的更多细节参见 “External Model Access” 第 1 页。
op_mkema 只编译应用程序的一个 C 代码文件,但可以通过在 bind_libs 偏好中引用额外的目标代码文件或库,将它们链接到应用程序可执行文件中。op_mkema 可以方便地在 makefile 环境中使用。
注意: 要在 Windows 中使用 External Model Access,必须确保 <reldir>/sys/pc_intel_win32/bin 是 PATH 环境变量中列出的第一个目录。
偏好
本程序支持以下偏好集:
本程序还支持以下附加偏好。
m
指定要编译和链接的 Ema 应用程序的基础名称。此偏好的取值中不应包含文件路径或文件类型后缀。指定的基于 Ema 的应用程序源代码文件必须位于模型目录中。
此偏好为必需项,且只能从命令行输入。
| 类型 | 默认值 |
|---|---|
| string | none |
num_err
指定在标准输出上显示的错误和/或警告消息的最大数量。op_mkema 会将任何错误或警告消息写入日志文件 cc_err(编译消息)和 bind_err(链接消息),这些文件位于你的 op_admin/tmp 目录中。此偏好提供了一种查看当前操作所产生的任何消息的机制。
此偏好只能从命令行输入。
| 类型 | 默认值 |
|---|---|
| integer | 0 |
示例用法
% op_mkema -m ring_build
--- op_mkema issued the following command: ---
/bin/sh -c "bind_gcc OP bind
IF /riverbed/18.6/models/std/ema_samp/ring_build.i1.em.o
OF /riverbed/18.6/models/std/ema_samp/ring_build.i1.em.x FL::
LD /riverbed/18.6/sys/pc_intel_linux/lib LB -lema -lsup -lvos
-lmdutl -lmdtab -lmdhdl -lobj -lorb
-lprg :: >/user/op_admin/tmp/bind_err 2>&1"
---------------------------------------------------------
Ema executable program (ring_build.i1.em.x) produced.
---------------------------------------------------------