op_mko
一个实用工具,将进程模型从二进制或 XML 形式转换为 C 或 C++ 代码形式,然后将其编译为目标代码形式。该实用工具还可以编译管道阶段、数据包转换文件和外部代码文件。
描述
大多数模型都是通过 modeler 程序创建和修改的,它是一个功能全面、带有易用图形用户界面(GUI)的交互式应用程序。不过,系统还提供了另一种用于创建和修改模型的外部接口,更符合 Linux 的理念,即由小型的非图形化工具程序来完成某一项特定任务。
使用所提供的外部接口,你可以通过调用 EMA Package 的函数以编程方式定义一组模型(详见第 1 章 “External Model Access” 第 1 页)。基于 EMA 的应用程序执行完毕后,它所指定的模型会被存储在相应的模型目录中。以这种方式创建的网络模型、节点模型和参数模型可以直接用于仿真。然而,以这种方式创建的进程模型仍必须转换为 C 或 C++ 并编译,以便之后链接到仿真中。完成转换/编译的一种方法是启动 modeler 程序,打开 Process Editor,并执行 Compile Process Model 操作。调用 op_mko 实用工具则是外部方式的选择;它转换并编译在命令行中作为参数指定的进程模型。
下图展示了 op_mko 操作的示意图;注意进程模型各版本在 Linux 下的文件后缀。
图 19:op_mko 操作示意图

类似地,op_mko 会根据文件指定方式(.c 对应 C,.cpp 对应 C++),使用相应的编译器编译管道阶段或外部代码文件。“kernel_type”、“m32”、“m64” 和 “mt” 偏好指定为哪个仿真内核进行编译。
偏好
本程序支持以下偏好集:
本程序还支持以下附加偏好。
all
单独使用时,使 op_mko 重新编译模型目录中的所有进程、外部代码和管道阶段。与 type 偏好一起使用时,会编译指定类型的所有文件(例如,op_mko -all -type ets 编译所有 .ets.c 和 .ets.cpp 文件)。
| 类型 | 默认值 |
|---|---|
| boolean | FALSE |
gui
指定 op_mko 应生成用于在 OPNET GUI 中执行的网络可视化映射库(为 TRUE 时),还是用于离散事件仿真期间执行(为 FALSE 时)。
注意: 此偏好为 TRUE 时,会使 op_mko 忽略 kernel_type 偏好,并生成与 GUI 使用所需的库相链接的库。不会与仿真内核链接;因此,你无法在将生成 “gui” 库的代码中使用内核过程。
| 类型 | 默认值 |
|---|---|
| boolean | FALSE |
m
指定要由 op_mko 编译的进程模型、管道阶段或外部代码文件的基础名称。支持二进制(.m)和 XML(.xml)两种形式的模型。此偏好的取值中不应包含文件路径或文件类型后缀。
注意: 编译进程模型或无线域模型时,Riverbed Modeler 会将模型文件名中的任何空格映射为下划线字符,用于由该模型派生的函数。对于这些模型,映射后的名称与中断函数相同。例如,my process model.pr.m 的中断函数名称为 my_process_model()。
此偏好为必需项,且只能从命令行输入。
| 类型 | 默认值 |
|---|---|
| string | none |
raw_err
指定应如何处理编译器输出。为 FALSE 时,编译器输出会被解析并以表格形式显示。为 TRUE 时,显示原始的编译器输出。
此偏好只能从命令行使用。
| 类型 | 默认值 |
|---|---|
| boolean | FALSE |
type
指定要编译的模型类型:“pr” 表示进程,“ps” 表示管道阶段,“pfp” 表示整体数据包转换方法文件,“pff” 表示数据包字段转换方法文件,“ex” 表示外部代码文件,“ets” 表示 ETS 代码文件,“da” 表示设计动作,“wdomain” 表示无线域。模型的基础名称由 m 偏好指定。
此偏好为必需项,且只能从命令行输入。
| 类型 | 默认值 |
|---|---|
| string | none |
示例用法
% op_mko -m router -type pr
------------------------------------------------
op_mko: process model object form
(/home/users/tsmith/op_models/router.pr.o) produced
------------------------------------------------
%