Fireflyunix常用命令操作指南

中国光大银行信息科技部Fireflyunix常用命令操作指南Allrightsreserved版权所有，侵权必究1Fireflyunix常用命令操作指南文档修订记录编号*变化状态修订说明日期变更人001A新建文档*变化状态：A——增加，M——修改，D——删除2Fireflyunix常用命令操作指南目录1综述.........................................................................32FireflyClient的参数设置.....................................................33项目初始化...................................................................34Firefly工具基本命令的使用....................................................44.1Bringover命令（更新本地工作区文件）................................................................................44.2编辑命令（检出文件）............................................................................................................54.3添加到版本控制命令（将新建的文件添加到本地工作区中）............................................64.4删除、移动和重命名命令........................................................................................................74.5提交Default变更集命令（检入文件）..................................................................................85Firefly工具高级命令的使用....................................................95.1显示文件历史命令....................................................................................................................95.2版本比较命令............................................................................................................................95.3下载标记命令（项目配置管理员使用）..............................................................................105.4建立标记命令（项目配置管理员使用）..............................................................................103Fireflyunix常用命令操作指南1综述开发人员具有项目组开发库中相应配置项的权限；日常开发过程或由于变更需要进行配置项修改时，应从开发库中检出配置项到本地工作区进行修改；配置项的命名要按照项目《软件配置管理计划》中制定的配置项命名规范来进行；修改期间要每日将修改的配置项检入到配置库中，以保证工作成果。本文描述了项目成员在开发工作中常用Fireflyunix命令的使用方法。2FireflyClient的参数设置hffsetlicense.server=10.1.16.33项目初始化开发人员在工作前需要将配置项从Firefly的存储库中下载到本地工作区，然后在本地工作区中进行修改。操作命令：hffinit-h服务器地址-proj项目名称-p开发库-u用户名-pwd密码-d指定本地工作区的目录，默认为当前目录例：服务器地址为“10.1.100.62”，准备在d:\test目录下建立一个本地工作区，项目名称为“ECAS_test”、开发库为“develop”，操作如下：hffinit-h10.1.100.62-projECAS_test-pdevelop-u用户名-pwd密码-dd:\test如下所示：4Fireflyunix常用命令操作指南是否使用SSL？[y/N]选择N；端口号：[4759]按回车默认即可；描述：填写注释并按回车；本地工作区建立成功；确实要从父分支执行bringover操作吗？[Y/n]填写Y，则执行bringover操作，从父分支上把该分支下的全部内容下载到本地工作区，完成创建本地工作区的操作。填写n，则创建本地工作区成功，但是不得到分支上的文件如果直接点击回车，那么Firefly会自动执行bringover操作。有关bringover操作，详见第4.1节4Firefly工具基本命令的使用4.1Bringover命令（更新本地工作区文件）该操作从Firefly存储库中把指定路径下的更改内容下载到本地工作区，本地工作区中的文件会随之发生相应的变化。Bringover操作首先自动检查本地工作区与其父分支的不同，然后再将服务器中已变更的内容下载到本地工作区中。操作命令：hffbringover要执行bringover操作的文件或目录其中：目录需指定工作区相对路径；如果不指定文件或目录，则表示把所有更新的文件下载到本地工作区中。例：将src/tran/js/2611目录下的所有变更下载到本地工作区中，操作如下：hffbringoversrc/tran/js/2611如下所示：5Fireflyunix常用命令操作指南注意：如果本地文件处于编辑状态时，不更新最新版本，即不要将所有文件作编辑状态，否则bringover命令不起作用。需要修改文件时再编辑这个文件。4.2编辑命令（检出文件）该命令可以编辑一个或多个工作区文件，将文件的状态从只读状态变为可写。如果在edit后指定了一个目录名，则此操作将会对该目录下的所有工作区文件都执行edit操作。操作命令：hffedit-up需要执行编辑操作的文件或目录其中：目录需指定工作区相对路径；-up表示在编辑文件之前，先更新文件。例：如果要编辑当前目录下的工作区文件t2611.h，在编辑文件之前，先执行Bringover操作更新的文件，操作如下：hffedit-upt2611.h如下所示：6Fireflyunix常用命令操作指南4.3添加到版本控制命令（将新建的文件添加到本地工作区中）该操作可以在本地工作区中添加一个或多个文件到Firefly版本控制中。如果在执行create操作的时候，指定了一个目录名，没有使用任何参数，操作结果将会把该目录下的所有文件和子目录中的文件创建为工作区文件。新建后的文件版本为1.0。操作命令：hffcreate需要执行添加到版本控制操作的文件或目录其中：目录需指定工作区相对路径。例：在本地工作区中，创建一个非工作区文件record，在本地工作区中建立该文件，将其添加到Firefly版本控制中，操作如下：1、首先在本地工作区中建立文件record；2、执行hffcreaterecord如下所示：7Fireflyunix常用命令操作指南4.4删除、移动和重命名命令删除：该操作可以删除工作区文件或目录。此操作并不真正删除文件，而是把要删除的文件从当前目录移动到一个名为“DELETED”的目录中。操作命令：hffdelete要删除的文件或目录其中：目录需指定工作区相对路径。例：如果想要删除当前目录下文件“test.h”，操作如下：hffdeletetest.h如下所示：移动和重命名：该操作可以将一个或多个文件从一个目录移动到另一个目录，也可以将一个目录移动到另一个目录，也用于文件或目录的重命名。操作命令：hffmove要移动的文件或目录指定移动到的文件或目录其中：目录需指定工作区相对路径。例1：移动当前2611目录下的test.h文件到上一层目录下的2622目录下，操作如下：hffmovetest.h../2622如下所示：例2：如果要将当前目录中tran文件改名为t2611.h，操作如下：8Fireflyunix常用命令操作指南hffmovetrant2611.h如下所示：注：在firefly中，移动和重命名将不简单的被看作删除和新建的组合，从而避免了历史版本的丢失。Firefly完整的保存了一个文件的历史，即使这个文件被移动到其他目录下（移动本身也会成为一个版本保留下来）4.5提交Default变更集命令（检入文件）文件新建或经过以上修改后，需要使用提交Default变更集命令将文件提交到Firefly存储库。每个文件都能单独提交到Firefly存储库，也可以将多个文件一起提交到存储库。操作命令：hffsubmit指定要提交的文件或目录其中：目录需指定工作区相对路径；如果不指定文件或目录，则表示把所有更新的文件上传到Firefly存储库。例：提交2611目录下所做的变更，操作如下：hffsubmit2622如下所示：9Fireflyunix常用命令操作指南Comments：required输入本次提交的注释，并按回车；Crid：按回车即可；Reviewer：按回车即可；5Firefly工具高级命令的使用5.1显示文件历史命令显示指定工作区文件的历史版本，包括文件的版本号，修改时间，修改人，修改注释等操作命令：hffhist指定执行显示历史操作的文件例：显示test.h.文件的历史记录，操作如下：hffhisttest.h如下所示：5.2版本比较命令该操作比较本地工作区文件任意两个版本的不同。操作命令：hffdiffs–v1指定该文件的源版本-v2指定该文件的目标版本指定进行版本比较的文件例：比较test.h文件v1.3与v1.0版本之间的不同，操作如下：10Fireflyunix常用命令操作指南hffdiffs-v11.3-v21.0test.h如下所示：5.3下载标记命令（项目配置管理员使用）该操作是将标记中的所有文件下载到本地。操作命令：hffdownload-h服务器地址-proj项目名称-l标记名称-u用户名-pwd密码-d下载的目标路径其中：下载的目标路径必须为空；如果不指定下载目标路径，默认为下载到当前目录下。例：服务器地址为“10.1.100.62”，准备下载“ECAS_test”项目中名为test的标记到本地当前目录d:/test，操作如下：hffdownload-h10.1.100.62–projECAS_test-ltest-u用户名-pwd密码如下所示：注：具有管理员权限或标记的Bringover权限的用户才可以执行下载标记操作。5.4建立标记命令（项目配置管理员使用）该操作是利用文件列表来建立标记。操作命令：hffbrlabel-h服务器地址-proj项目名称-b配置库名称-lf文件列表名称-u用户名-pwd密码标记名称11Fireflyunix常用命令操作指南例：服务器地址为“10.1.16.3”，准备在“EBIP”项目的“开发库”中利用文件列表“filelist.txt”建立名为“test”的标记，操作如下：hffbrlabel-h10.1.16.3–projEBIP-bdevelop–lffilelist.