op_manfile

一个执行与模型文件的跟踪和识别相关的管理操作的实用工具,包括文件定位、锁、安全保护/注册以及文件头内容。

说明

op_manfile 程序提供了大量用于查看和修改模型文件的文件头与注释的操作,此外还有与定位文件相关的操作。

模型文件包含三个部分:(1) 文件头;(2) 文件注释;(3) 模型数据。模型文件的文件头部分包含该文件的跟踪与识别信息,例如文件创建的时间。模型文件的注释部分包含用户输入的文本描述,用于说明文件的数据内容与修改历史。模型派生的目标代码文件同样包含内嵌的、不可修改的文件头。

模型文件的文件头部分包含以下关于该文件的信息:

  • 模型类型
  • 创建时间和日期
  • 创建该文件的 OPNET 应用程序的名称与发布版本
  • 与该文件格式兼容的、创建该文件的 OPNET 应用程序的最早发布版本
  • 最后修改时间和日期
  • 文件的版本号(即该文件被写入磁盘的次数)
  • 与最后修改相关联的用户账户名和主机计算机名
  • 文件编辑锁的状态(编辑锁由正在编辑模型文件的 OPNET 应用程序自动设置,以防止对同一文件的并发编辑)
  • 文件用户锁的状态(用户锁由用户手动设置,用于表明临时所有权,并在开发阶段阻止其他用户修改该模型)
  • 模型安全访问信息(状态、已注册站点数量、本地站点的访问级别以及 world 访问状态)
  • 模型套件信息(套件名称与描述,通常包括模型供应商的名称和联系信息)

上述信息对于建立模型文件的背景信息非常有用。操作模型文件的 OPNET 应用程序可以修改上述信息,但查看上述信息的唯一途径是通过 op_manfile。

op_manfile 程序提供以下操作;每个操作由括号中标明的偏好指定。每次 op_manfile 会话只能执行一个操作。

  • 基于文件基本名称查找一个或多个模型 (-find
  • 打印文件头 (-header_print)
  • 修复文件头 (-header_repair)
  • 更新文件头 (-header_update)
  • 设置文件版本号 (-version_set)
  • 向文件添加注释 (-comments_add))
  • 从文件删除注释 (-comments_del)
  • 打印文件注释 (-comments_print)
  • 设置或释放编辑锁 (-edit_lock 与 -edit_unlock,分别对应)
  • 设置或释放用户锁 (-user_lock 与 -user_unlock,分别对应)
  • 显示文件的校验和 (-checksum)
  • 保护模型免遭未经授权使用 (-protect)
  • 注册模型以获得或授予访问权限 (-register)

所有 op_manfile 操作都至少需要一个目标模型文件作为其作用对象(某些操作可以支持多个目标文件)。op_manfile 的目标模型文件由若干偏好之一指定,包括 m、mf 和 f。某些命令(例如 register)还接受一个可选的源模型文件,由偏好 from、from_f 或 from_mf 指定。

偏好

本程序支持以下偏好集:

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

all

指定以与具体操作相关的方式扩展所选操作的作用范围。该标志作为一种操作修饰符,可与以下操作配合使用:-edit_lock、-edit_unlock、-find、-header_print、-user_lock 和 -user_unlock。

对于与锁相关的操作,-all 修饰符使该操作应用于模型目录中的所有模型文件(即无需通过 f、m 或 mf 偏好指定具体文件)。

对于 -find 操作,-all 修饰符会找到在不同模型目录中名称重复的所有模型(通常,位于较高优先级模型目录中的模型会覆盖并实际上隐藏位于较低优先级模型目录中的重复模型)。

对于 -print_header 操作,-all 修饰符会打印文件中存在的多个文件头,而不仅仅是文件中的第一个文件头(只有仿真可以包含多个文件头,因为仿真文件中与每个模型派生的目标代码模块相关联的文件头)。

类型 默认值
boolean FALSE

app_name

指定在目标文件头中被标识为该文件创建者的应用程序名称。当文件头由 -header_add 操作创建,或文件头由 -header_update 操作更新时,op_manfile 会使用此偏好的取值。

类型 默认值
string “”

backup_max_count

指定为给定文件保留的编号版本备份的最大数量。每次以相同名称保存模型时,被覆盖的文件都会以 <model_name>.v<vers_num>.<mdl_type>.m 形式的名称存储在 op_admin/bk 目录中。系统保留最新的文件版本;当新版本会使备份数量超过最大计数时,最早版本将从 bk 目录中移除。

类型 默认值
integer 10

checksum

指定计算并打印目标文件的校验和数值。通过 f 偏好,该操作可应用于任何类型的文件,包括程序可执行文件。该操作的输出是两个整数校验和数值,因其各自的计算方法而标识为 “Add” 和 “Xor”。文件校验和数值用于判定发布文件是否已损坏。用户必须联系技术支持以将其校验和数值与期望值进行比较。

类型 默认值
boolean FALSE

comments_add

指定向目标文件添加单条注释。注释文本由用户在标准输出设备上出现的提示之后输入。注释限制为一行文本;按 <Return> 键即完成该注释。注释会附带与其添加到文件时相关联的日期、用户账户名和文件版本。

类型 默认值
boolean FALSE

comments_del

指定删除目标文件中包含的所有注释。

类型 默认值
boolean FALSE

comments_print

指定将目标文件中包含的所有注释打印到标准输出设备。每条注释由一行下划线分隔,并附带与该注释添加到文件时相关联的日期、用户账户名和文件版本号。

类型 默认值
boolean FALSE

dir

指定将所请求的安全保护应用于当前目录中的所有文件。该参数由作者与 protect 参数配合使用。

类型 默认值
boolean FALSE

edit_lock

指定设置目标文件的编辑锁,就如同该文件正由 OPNET 程序编辑一样。这会将文件标记为“只读”,并阻止所有 OPNET 程序修改它。该操作通常不使用;相反,用户可以使用 -user_lock 操作临时锁定文件。

类型 默认值
boolean FALSE

edit_unlock

指定重置目标文件的编辑锁,从而允许 OPNET 程序对其进行修改。如果 OPNET 程序因程序中止而异常退出,正在被该程序编辑的文件可能仍保留编辑锁。这种情况可通过 -edit_unlock 操作纠正。

类型 默认值
boolean FALSE

f

指定执行操作的目标文件的全名和路径。文件名必须包含文件类型后缀,以及绝对或相对路径。

类型 默认值
string “”

find

指定在模型目录中查找目标文件,并将其位置信息打印到标准输出设备上。如果多个模型文件匹配由 m 偏好指定的基本名称,该操作不会请求选择单个目标文件,并且它会定位所有满足目标名称的模型文件。该操作与 f 偏好不兼容。位置信息包括目标文件的名称(含后缀)、类型和模型目录。

类型 默认值
boolean FALSE

from

指定要从中复制保护信息的源模型的基本名称(即不含文件后缀或路径的模型名称)。op_manfile 程序在模型目录中定位指定的模型文件。如果找到多个具有此基本名称的模型文件,且指定操作要求单个源文件,op_manfile 将请求从打印在标准输出设备上的选项菜单中选择单个文件。

类型 默认值
string “”

from_f

指定要从中复制保护信息的源模型的全名和路径。文件名必须包含文件后缀以及绝对或相对路径。

类型 默认值
string “”

from_mf

指定要从中复制保护信息的源模型的全名和文件后缀。文件名不应包含路径(指定的模型文件将在模型目录中定位)。

类型 默认值
string “”

header_add

指定向目标文件添加文件头信息。该操作很少使用。

类型 默认值
boolean FALSE

header_print

指定将目标文件的文件头信息打印到标准输出设备上。文件头信息以表格形式打印。

类型 默认值
boolean FALSE

header_repair

指定修复目标文件的文件头信息。如果 OPNET 程序发出指示模型文件已损坏的错误消息,且损坏仅限于文件头,该操作可能能够修复该损坏。

类型 默认值
boolean FALSE

header_update

指定更新目标文件的文件头信息。更新会修改文件头中所有“最后修改”字段,包括日期、版本号、用户账户名和主机计算机名。如果设置了 app_name 偏好,创建应用程序的名称也会被修改。

类型 默认值
boolean FALSE

m

指定执行操作的目标文件的基本名称(即不含文件类型后缀或路径的模型名称)。指定的模型文件在模型目录中定位。如果找到多个具有此基本名称的模型文件,且指定操作要求单个目标文件,op_manfile 将请求从打印在标准输出设备上的选项菜单中选择单个目标文件。

类型 默认值
string “”

mf

指定执行操作的目标文件的全名(即含文件类型后缀的模型名称)。文件名不应包含路径;指定的模型文件在模型目录中定位。

类型 默认值
string “”

protect

保护模型文件免遭未经授权的访问。作者指定用作加密密钥的口令短语。更多信息参见第 4 章“Security”第 250 页。

类型 默认值
boolean FALSE

register

注册受保护的模型文件。注册允许指定站点(OPNET 安装)的用户访问该模型。更多信息参见第 4 章“Security”第 250 页。

类型 默认值
boolean FALSE

suite

指定应注册与指定模型属于同一套件的所有模型文件。suite 偏好必须与 register 偏好配合使用。

类型 默认值
boolean FALSE

user_lock

指定设置目标文件的用户锁。这会将文件标记为属于设置该锁的用户账户,并阻止由其他用户账户运行的 OPNET 程序修改该文件。

类型 默认值
boolean FALSE

user_unlock

指定重置目标文件的用户锁,从而允许由任何用户账户运行的 OPNET 程序对其进行修改。

类型 默认值
boolean FALSE

version_set

指定将目标文件的版本号设置为指定的整数值(默认值 -1 表示不作任何更改)。该操作允许将文件的版本号与用户定义的顺序相关联。

类型 默认值
integer -1

world

指定注册模型文件以便任何人都可以访问它。该参数由作者使用,并与 register 参数配合使用。

类型 默认值
boolean FALSE

示例用法

以下示例演示如何使用 op_manfile 程序打印名为 “atm16_crossconn” 的进程模型的文件头信息。用户输入的信息以粗体显示。

% op_manfile -m atm16_crossconn -header_print

|-------------------------------------------------------------------|
|file path : /riverbed/18.0/models/std/atm/atm16_crossconn.nd.d     |
|-------------------------------------------------------------------|
|file type : Derived Node Model                                     |
|-------------------------------------------------------------------|
|creation                                                           |
| date : Wed Feb 28 14:11:09 1996                                   |
| application : op_cvdlb2                                           |
| release : 10.0.A                                                  |
| file data v. : 8.5.A                                              |
|-------------------------------------------------------------------|
|last modification                                                  |
| date : Sun Jun 15 19:40:01 2003                                   |
| version : 25                                                      |
| user : a_user                                                     |
| host : bhornet                                                    |
|-------------------------------------------------------------------|
|edit lock                                                          |
| status : unlocked                                                 |
|-------------------------------------------------------------------|
|user lock                                                          |
| status : unlocked                                                 |
|-------------------------------------------------------------------|
|security                                                           |
| status : not protected                                            |
|-------------------------------------------------------------------|
|suite info : (none available)                                      |
|-------------------------------------------------------------------|

%

有关保护与注册模型的示例,参见第 4 章“Security”第 250 页。

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