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
-----------------------------------------------------
%