PNFile 入门指南

1、产品概述

         PNFile是一个平台型工具，在该平台上集成了多个应用程序和实用工具。下图1所示，在PNFile中有Directory Structure和PNPreview这两个窗口，PNTree、PNEdit、PNDiff、PNFinder和PNCompare这5个应用程序，以及System Information、Encrypt/Decrypt、Split/Join和Directory Print这4个实用工具。

图1 PNFile产品概述

         Directory Structure为目录结构窗口，该窗口集成了PNTree的全部功能，可以操作和实时更新目录结构。PNPreview为文件预览窗口，该窗口集成了PNEdit的部分功能，主要实现文本内容打开预览以及简单的文本编辑功能。PNFile集合了目录的树状管理结构和对预览文件的实时操作，能够快速的对系统中的文件进行预览、编辑和保存等操作。

         PNTree应用为目录结构树，对系统中的目录结构以树状图形化的形式显示并可以实时操作和更新该目录树，常用的有新建、删除、改名、复制、移动和压缩这几个基本操作，在PNTree中可以在目录树上直接做这些操作，并在这些操作完成之后在目录树上进行实时更新，这使得这些常规目录操作更加方便和快捷。

         PNEdit应用为文本编辑器，支持tab和split多窗口方式同时对多个文件进行文本编辑；对编辑窗口中文本内容的颜色、语法、字体和高亮等属性有多种方式可以方便的设置；PNEdit是一种支持多模式的文本编辑器，在不同编辑模式下操作行为有所不同，在对编辑的文本内容的选择会有多种选择方式，在做具体编辑操作时主要靠大量的快捷键命令操作来实现快速高效的文本编辑功能；该编辑器中集成了目录浏览界面、高级编辑工具、高级搜索工具、编辑状态缓冲、编辑字符缓冲、编辑文件缓冲和编辑内容标记等编辑小工具以扩展文本编辑功能。

         PNDiff应用为文本比较器，其提供了多种可配置的文本比对方式，用户可以根据自己的需求做相应的配置进行比对，在行内容比较时有Auto(自动行偏移)、Precise(精确逐行)和Customized(定制行偏移值)模式，列内容可以选择比较或不比较，在列比较时也有Auto(自动列偏移)、Precise(精确逐列)和Customized(定制列偏移值)模式，比较的范围有全部行和设置比较区间模式。文本比对结果查看方式有很多种，可以通过菜单、按钮、快捷菜单以及结果列表这些方式方便快速的查看结果。对比较结果中不一致的行内容在多个文件之间可以做合并操作。

         PNFinder应用为文件搜索器，其提供了多种可配置的文件搜索和替换方式，在Expression中可以设置不同的搜索关键字和表达式的方式，在Filter中可以设置搜索的文件和文件夹类型、文件名关键字过滤、目录创建者、目录访问权限、目录创建时间以及目录的存储大小，在Select中有Scope目录域模式和Customized定制目录模式用于设置搜索的目录范围。文件搜索结果查看方式有很多种，可以通过菜单、按钮、快捷菜单以及结果列表这些方式方便快速的查看结果。对文件搜索的结果可以设置以文本格式将其导出至文件中。

         PNCompare应用为目录比较器，其提供了多种可配置的目录比较方式，在Scope Select中设置目录比较的层次范围有Level All(全部层次)、Level 1(第1层)、Level 1-?(第1至？层)和Level ?(第？层)模式。在Compare Condition中可以设置目录比较的文件和文件夹类型、目录创建者、目录访问权限、目录创建时间、目录的存储大小以及文件的内容。目录结果查看方式有很多种，可以通过菜单、按钮、快捷菜单以及结果列表这些方式方便快速的查看结果。对比较结果中不一致的目录节点可以分别做L2R或R2L的合并操作。

         System Information 工具为系统信息查看，在该工具中可以当前系统中Architecture、Machine、Node、Processors、System、Distribution、Average Load、Memory Info、Uptime、HostName、HostId、MacAddr、IPAddr和SystemTime的信息内容。Encrypt/Decrypt工具为文件加解密，在该工具中文件加密操作是对选择的未加密源文件设置密码后转成一个乱码文件，文件解密操作是对选择的加密的乱码文件输入正确的密码后转成源文件。Split/Join工具为文件分解合并，在该工具中文件分解操作是将一个文件按行数或文件数分解成多个文件，文件合并操作是将多个文件合并成一个文件。Directory Print工具为目录列表打印，在该工具中可以设置Scope(目录域)、Information(详细信息)、File/Folder(文件或文件夹)、Flatten/Hierarchy(展平或有层次的)、Sort By(列表排序方式)等参数控制目录列表打印的内容和格式。

2、工具安装和环境配置

         PNFile工具可以在当前主流的Linux或Unix操作系统上运行，其软件安装过程非常简单，在Linux或Unix系统上无需任何特殊设置，在安装完成之后配置软件安装路径和设定license文件即可启动工具命令。

2.1、安装PNFile工具

         PNFile已被打包成一个独立的软件包，用户无需下载安装任何第三方软件包，仅需安装PNFile包本身即可。用户可发邮件至邮箱support@veriforma.com获取PNFile软件包或从网站www.veriforma.com上直接下载即可。PNFile工具包解压即可用，用户无需再安装或编译任何中间文件，将安装包解压至本地工具安装路径即完成工具安装过程。下图2所示为PNFile软件安装包解压之后的目录结构，在该软件包中有五个文件夹和两个shell设置文件。

图2 PNFile软件安装包

bin/              包含了所有支持的命令。

doc/             用于存放软件的文档。

lib/               PNFile软件的库文件。

lic/                默认存放license文件。

tools/           PNFile软件需要调用的编译器工具。

pn.bshrc      在bshell中设置工具的路径和license。

pn.cshrc      在cshell中设置工具的路径和license。

2.2、环境变量设置

         对于PNFile工具环境变量设置用户需配置LIC_FILE_PATH和PNFILE_PATH这两个环境变量。LIC_FILE_PATH环境变量用于设置license文件的全路径，PNFile工具以及在该平台下的PNTree、PNEdit、PNDiff、PNFinder和PNCompare这5个应用程序在启动时都需要检查license文件，用户可发邮件至邮箱sales@veriforma.com获取license文件。PNFILE_PATH环境变量用于设置PNFile软件包解压安装的全路径，PNFile工具以及在该平台下的PNTree、PNEdit、PNDiff、PNFinder和PNCompare这5个应用程序的启动命令只有在PNFILE_PATH环境变量设置之后与工具安装包bin目录下的命令对应上才能生效。用户可以通过以下方式配置LIC_FILE_PATH和PNFILE_PATH这两个环境变量。

1、命令直接配置，在Linux或Unix系统的客户端直接用设置环境变量的命令setenv(cshell)、export(bshell)设置。

2、创建新的shell文件，在工具安装目录下的shell文件中设置，如下图3所示，pn.cshrc(cshell)或pn.bshrc(bshell)文件打开更新正确的路径，保存文件之后在Linux或Unix系统的客户端source该文件。

3、默认shell文件中设置，在Linux或Unix系统的客户端打开时通常会自动source一个隐藏的.cshrc(cshell)或.bshrc(bshell)文件，可以将这两个环境变量设置命令增加到该文件中，这样每次打开客户端时则会自动配置好这两个环境变量。

图3 PNFile安装目录下shell文件

         PNEdit文本编辑器是PNFile平台中一个独立的工具，用户可以单独下载安装。在独立的PNEdit工具中无需检查license文件，用户仅需配置PNEDIT_PATH这一个环境变量即可使用。PNEdit工具的启动命令只有在PNEDIT_PATH环境变量设置之后与工具安装包bin目录下的命令对应上才能生效。

3、工具启动和调试

         PNFile平台及集成的PNTree、PNEdit、PNDiff、PNFinder和PNCompare这5个应用程序都有单独的命令启动相应的工具界面，应用程序的启动还可以在打开的工具中通过菜单和按钮打开，其对应的按钮为、、、、。工具在运行过程出现异常情况时，该平台还支持对出现异常的情况进行调试。

3.1、工具启动方式

         下图4所示为PNFile工具的启动命令pnfile以及其对应的选项列表，其中”+help/h”选项打印pnfile命令支持的所有选项列表、”+version/v”选项打印PNFile工具当前使用的版本信息、”+debug”选项打印PNFile工具运行过程中出现异常的调试信息、”+proj <proj_name>”选项用来指定PNFile工具运行过程中产生的中间文件存放的路径、”+path <path_name>”选项用来指定打开的目录树结构的根节点、”+log <log_file>”选项用来指定PNFile工具运行过程中生成的日志文件存放的路径。pnfile命令缺省启动时会在当前目录下生成pnfproj文件夹用于存放中间文件，界面打开的目录树结构的根节点为当前目录路径，日志文件存放于新生成的pnfproj文件夹中。

图4 PNFile工具启动命令

         下图5所示为PNTree工具的启动命令pntree以及其对应的选项列表，其中”+help/h”选项打印pntree命令支持的所有选项列表、”+version/v”选项打印PNTree工具当前使用的版本信息、”+debug”选项打印PNTree工具运行过程中出现异常的调试信息。pntree命令缺省启动时界面打开的目录树结构的根节点为当前目录路径，可以在pntree命令后加上一个目录路径作为打开的目录树结构的根节点。

图5 PNTree工具启动命令

         下图6所示为PNEdit工具的启动命令pnedit以及其对应的选项列表，其中”+help/h”选项打印pnedit命令支持的所有选项列表、”+version/v”选项打印PNEdit工具当前使用的版本信息、”+debug”选项打印PNEdit工具运行过程中出现异常的调试信息。pnedit命令缺省启动时会在文本编辑窗口打开当前目录路径下的目录浏览界面，可以在pnedit命令后加上多个文件或文件夹路径，启动后会在文本编辑窗口自动分别打开文件和文件夹。

图6 PNEdit工具启动命令

         下图7所示为PNDiff工具的启动命令pndiff以及其对应的选项列表，其中”+help/h”选项打印pndiff命令支持的所有选项列表、”+version/v”选项打印PNDiff工具当前使用的版本信息、”+debug”选项打印PNDiff工具运行过程中出现异常的调试信息。pndiff命令缺省启动时仅打开界面，可以在pndiff命令后加上多个文件路径，启动后会自动打开这些文件并直接开始文本比对。

图7 PNDiff工具启动命令

         下图8所示为PNFinder工具的启动命令pnfinder以及其对应的选项列表，其中”+