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.

---------------------------------------------------------

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