op_mkso

一个从目标文件构建共享目标库的实用工具。

描述

op_mkso 用于构建:

  • 供内部执行 ETS 脚本使用的共享目标库
  • 仿真仓库,使你无需编译器即可运行仿真
  • 设计动作
  • 网络可视化库
  • 天线方向图库(用于可选的 Wireless 功能)
  • 传播模型(用于可选的 Terrain Modeling Module 功能)

op_mkso 构建的输入可以是任意目标文件,但通常是由 op_mko 实用工具创建的目标文件。

“kernel_type”、“m32”、“m64” 和 “mt” 偏好指定要为其构建哪个仿真内核。例如,对于既可使用开发仿真内核也可使用优化仿真内核的共享目标文件(如仓库和 TMM 传播模型),使用 “kernel_type” 指定要构建哪种类型的共享目标文件。

要使一个库中的变量和函数在其他库中可见,必须使用 DLLEXPORT 声明,如下例所示:

DLLEXPORT int x;
DLLEXPORT void eth_mac_gen();

在 Windows 下,若一个目标库要使用在另一个库中声明的变量,该引用必须使用 IMPORT_GLOBAL 声明:

extern IMPORT_GLOBAL int x;

使用 IMPORT_GLOBAL 的声明在 Linux 下不会产生任何异常影响。

偏好

本程序支持以下偏好集:

本程序还支持以下附加偏好。

all

指定 op_mkso 应构建指定类型的所有文件。此偏好仅适用于设计动作(type = da)。

类型 默认值
boolean FALSE

c

强制重新编译列出的模型文件。待重新编译的模型可以是二进制(.m)或 XML(.xml)形式。

类型 默认值
boolean FALSE

c_exclude_standard_models

指定在强制重新编译模型时应排除标准模型。当此偏好与 c 偏好均为 TRUE 时,Modeler 安装目录树(<install_dir>)内的所有模型文件都将被排除在强制重新编译之外。

类型 默认值
boolean FALSE

ets_files

ETS 目标文件列表。“ALL” 解释为该类型的所有文件。

类型 默认值
string list <empty>

ex_files

外部目标文件列表。“ALL” 解释为该类型的所有文件。

类型 默认值
string list <empty>

explicit_exports

为 TRUE 时,导出当前库中的所有函数和变量。这可能导致文件体积增大并降低仿真性能。

类型 默认值
boolean FALSE

export_funcs

库所导出的函数列表。此偏好只能在 Windows 机器上使用。

类型 默认值
string list <empty>

f

将被绑定到一起构成库的、必需的目标文件列表。必须提供包含完整扩展名的文件名。

类型 默认值
string list <empty>

gui

指定 op_mkso 应生成用于在 OPNET GUI 中执行(为 TRUE 时)还是在离散事件仿真期间执行(为 FALSE 时)的网络可视化映射库。

注意: 此偏好为 TRUE 时,会使 op_mkso 忽略 kernel_type 偏好,并生成与 GUI 使用所需的库相链接的库。不会与仿真内核链接;因此,你无法在将生成 “gui” 库的代码中使用内核过程。

类型 默认值
boolean FALSE

m

输出库文件名,包含扩展名。对于仓库(type = repos),扩展名不是必需的。

类型 默认值
string list ” “

num_err

指定要显示多少行错误和警告消息。

类型 默认值
integer 10

pff_files

数据包字段转换文件列表。“ALL” 解释为该类型的所有文件。

类型 默认值
string list <empty>

pfp_files

数据包转换文件列表。“ALL” 解释为该类型的所有文件。

类型 默认值
string list <empty>

pr_files

进程模型列表。“ALL” 解释为该类型的所有文件。

类型 默认值
string list <empty>

ps_files

管道模型列表。“ALL” 解释为该类型的所有文件。

类型 默认值
string list <empty>

raw_err

指定应如何处理编译器输出。为 FALSE 时,解析编译器输出并以表格形式显示。为 TRUE 时,显示原始编译器输出。

此偏好只能从命令行输入。

类型 默认值
boolean FALSE

type

模型类型。

表 22:op_mkso 支持的模型类型

类型 用于创建
ets ETS 程序
repos 仿真仓库
da 设计动作
nvism 网络可视化映射库
antn 天线方向图库(需要 Wireless 功能)
tmm 传播模型(需要 Terrain Modeling Module 功能)
terrain 地形模型(需要 Terrain Modeling Module 功能)
类型 默认值
string “ets”

verbose_exports

在编译期间打印所导出的所有函数和变量的列表。此偏好只能在 Windows 机器上使用。

类型 默认值
boolean FALSE

wdomain_files

无线域模型列表。“ALL” 解释为该类型的所有文件。(此偏好需要 Wireless 功能。)

类型 默认值
string list <empty>

示例用法

% op_mkso -type ets -f test_event.ex.o test_dialog.ex.o test_interface.ex.o
	-m example_library.so

-----------------------------------------------------
op_mkso: Shared library (example_library.so) 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