Firefly unix常用命令操作指南.doc

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