CVS 常用的cvs命令

 

常用的cvs命令

 

CVS的常用命令速查手册

发布： Linux 分类： Linux 发布日期： 2005.06.22

作者： 车东 chedong@bigfoot.com

概述：CVS是一个C/S系统，多个开发人员通过一个中心版本控制系统来记录文件版本，从而达到保证文件同步的目的。

CVS服务器（文件版本库）

/ |

（版 本 同 步）

/ |

开发者1 开发者2 开发者3

以下是本文主要内容：开发人员可以主要挑选2, 6看就可以了，CVS的管理员则更需要懂的更多一些

1.CVS环境初始化：CVS环境的搭建 管理员

2.CVS的日常使用：日常开发中最常用的CVS命令， 开发人员 管理员

3.CVS的分支开发：项目按照不同进度和目标并发进行 管理员

4.CVS的用户认证：通过SSH的远程用户认证，安全，简单 管理员

5.CVSWEB：CVS的WEB访问界面大大提高代码版本比较的效率 管理员

6.CVS TAG：将$Id$加入代码注释中，方便开发过程的跟踪 开发人员

7.CVS vs VSS: CVS和Virsual SourceSafe的比较

一个系统20%的功能往往能够满足80%的需求，CVS也不例外，以下是CVS最常用的功能，

可能用到的还不到它全部命令选项的10%，更多的功能请在实际应用过程中体会，学习过程

中应该是用多少，学多少，用到了再学也不迟。

CVS环境初始化

============

环境设置：指定CVS库的路径CVSROOT

tcsh

setenv CVSROOT /path/to/cvsroot

bash

CVSROOT=/path/to/cvsroot ; export CVSROOT

后面还提到远程CVS服务器的设置：

CVSROOT=:ext:$USER@test.server.address#port:/path/to/cvsroot CVS_RSH=ssh; export CVSROOT CVS_RSH

初始化：CVS版本库的初始化。

cvs init

一个项目的首次导入

cvs import -m ""write some comments here"" project_name vendor_tag release_tag

执行后：会将所有源文件及目录导入到/path/to/cvsroot/project_name目录下

vender_tag: 开发商标记

release_tag: 版本发布标记

项目导出：将代码从CVS库里导出

cvs checkout project_name

cvs 将创建project_name目录，并将最新版本的源代码导出到相应目录中。这个checkout和Virvual SourceSafe中的check

out不是一个概念，相对于Virvual SourceSafe的check out是cvs update， check in是cvs commit。

CVS的日常使用

=============

注意：第一次导出以后，就不是通过cvs checkout来同步文件了，而是要进入刚才cvs checkout

project_name导出的project_name目录下进行具体文件的版本同步（添加，修改，删除）操作。

将文件同步到最新的版本：

cvs update

不制定文件名，cvs将同步所有子目录下的文件，也可以制定某个文件名/目录进行同步

cvs update file_name

最好每天开始工作前或将自己的工作导入到CVS库里前都要做一次，并养成“先同步 后修改”的习惯，和Virvual

SourceSafe不同，CVS里没有文件锁定的概念，所有的冲突是在commit之前解决，

如果你修改过程中，有其他人修改并commit到了CVS库中，CVS会通知你文件冲突，并

自动将冲突部分用

>>>>>> 

content on cvs server

>>>>> 

标记出来，由你确认冲突内容的取舍。

版本冲突一般是在多个人修改一个文件造成的，但这种项目管理上的问题不应该指望由CVS来解决。

确认修改写入到CVS库里：

cvs commit -m ""write some comments here"" file_name

注意：CVS的很多动作都是通过cvs

commit进行最后确认并修改的，最好每次只修改一个文件。在确认的前，还需要用户填写修改注释，

以帮助其他开发人员了解修改的原因。如果不用写-m ""comments""而直接确认``cvs commit file_name``

的话，cvs会自动调用系统缺省的文字编辑器(一般是vi)要求你写入注释。

注释的质量很重要：所以不仅必须要写，而且必须写一些比较有意义的内容：以方便其他开发人员能够很好的理解

不好的注释，很难让其他的开发人员快速的理解：比如： -m ""bug fixed"" 甚至 -m """"

好的注释，甚至可以用中文: -m ""在用户注册过程中加入了Email地址校验""

修改某个版本注释：每次只确认一个文件到CVS库里是一个很好的习惯，但难免有时候忘了

指定文件名，把多个文件以同样注释commit到CVS库里了，以下命令可以允许你修改某个

文件某个版本的注释：

cvs admin -m 1.3:""write some comments here"" file_name

添加文件

创建好新文件后，比如：touch new_file

cvs add new_file

注意：对于图片，Word文档等非纯文本的项目，需要使用cvs add -b选项，否则有可能出现文件被破坏的情况

比如：cvs add -kb new_file.gif

然后确认修改并注释

cvs ci -m ""write some comments here""

删除文件：

将某个源文件物理删除后，比如：rm file_name

cvs rm file_name

然后确认修改并注释

cvs ci -m ""write some comments here""

以上面前2步合并的方法为：

cvs rm -f file_name

cvs ci -m ""why delete file""

注意：很多cvs命令都有缩写形式：commit=>ci; update=>up; checkout=>co; remove=>rm;

添加目录：

cvs add dir_name

查看修改历史：cvs log file_name

cvs history file_name

查看当前文件不同版本的区别

cvs diff -r1.3 -r1.5 file_name

查看当前文件（可能已经修改了）和库中相应文件的区别

cvs diff file_name

cvs的web界面提供了更方便的定位文件修改和比较版本区别的方法，具体安装设置请看后面的cvsweb使用

正确的通过CVS恢复旧版本的方法：

如果用cvs update -r1.2 file.name

这个命令是给file.name加一个STICK TAG： ""1.2"" ，虽然你的本意只是想将它恢复到1.2版本

正确的恢复版本的方法是：cvs update -p -r1.2 file_name >file_name

如果不小心已经加成STICK TAG的话：用cvs update -A 解决

移动文件：文件重命名

cvs里没有cvs move或cvs rename，因为这两个操作是先cvs remove old_file_name，然后cvs add new_file_name实现的。

删除，移动目录：

最方便的方法是让管理员直接移动，删除CVSROOT里相应目录（因为CVS一个项目下的子目录都是独立的，

移动到$CVSROOT目录下都可以作为新的独立项目：好比一颗树，其实砍下任意一枝都能独立存活），

对目录进行了修改后，要求其开发人员重新导出项目cvs checkout project_name 或者用

cvs update -dP同步。

CVS Branch：项目多分支同步开发

=============================

确认版本里程碑：多个文件各自版本号不一样，项目到一定阶段，可以给所有文件统一指定

一个阶段里程碑版本号，方便以后按照这个阶段里程碑版本号导出项目，同时也是项目的

多个分支开发的基础。

cvs tag release_1_0

开始一个新的里程碑：

cvs commit -r 2 标记所有文件开始进入2.x的开发

注意：CVS里的revsion和软件包的发布版本可以没有直接的关系。但所有文件使用和发布版本一致的版本号比较有助于维护。

在开发项目的2.x版本的时候发现1.x有问题，但2.x又不敢用，则从先前标记的里程碑：release_1_0导出一个分支release_1_0_patch

cvs rtag -b -r release_1_0 release_1_0_patch proj_dir

一些人先在另外一个目录下导出release_1_0_patch这个分支：解决1.0中的紧急问题，

cvs checkout -r release_1_0_patch

而其他人员仍旧在项目的主干分支2.x上开发

在release_1_0_patch上修正错误后，标记一个1.0的错误修正版本号

cvs tag release_1_0_patch_1

如果2.0认为这些错误修改在2.0里也需要，也可以在2.0的开发目录下合并release_1_0_patch_1中的修改到当前代码中：

cvs update -j release_1_0_patch_1

CVS的远程认证：通过SSH远程访问CVS

================================

使用cvs本身的远程认证很麻烦,需要定义服务器和用户组，用户名，设置密码等，而且不安全，

因此和系统本地帐号认证并通过SSH传输是比较好的办法，通过在客户机的/etc/profile里设置一下内容：

CVSROOT=:ext:$USER@test.server.address#port:/path/to/cvsroot CVS_RSH=ssh; export CVSROOT CVS_RSH

所有客户机所有本地用户都可以映射到CVS服务器相应同名帐号了。

如果CVS所在服务器的SSH端口不在缺省的22，或者和客户端与CVS服务器端SSH缺省端口不一致，有时候设置了：

:ext:$USER@test.server.address#port:/path/to/cvsroot

仍然不行，比如有以下错误信息：

ssh: test.server.address#port: Name or service not known

cvs [checkout aborted]: end of file from server (consult above messages if any)

解决的方法是做一个脚本指定端口转向（不能使用alias，会出找不到文件错误）：

创建一个/usr/bin/ssh_cvs文件：

#!/usr/bin/sh

/path/to/ssh -p 34567 ""$@""

然后：chmod +x /usr/bin/ssh_cvs

并CVS_RSH=ssh_cvs; export CVS_RSH

注意：port是指相应服务器SSH的端口，不是cvs pserver的端口

CVSWEB：提高程序员比较文件修改效率

================================

CVSWEB就是CVS的WEB界面，可以大大提高程序员定位修改的效率:

使用的样例可以看：http://www.freebsd.org/cgi/cvsweb.cgi

CVSWEB的下载：CVSWEB从最初的版本已经演化出很多功能界面更丰富的版本，这个是个人感觉觉得安装设置比较方便的：

http://www.spaghetti-code.de/software/linux/cvsweb/

下载解包：

tar zxf cvsweb.tgz

把配置文件cvsweb.conf放到安全的地方（比如和apache的配置放在同一个目录下），

修改：cvsweb.cgi让CGI找到配置文件：

$config = $ENV{''CVSWEB_CONFIG''} || ''/path/to/apache/conf/cvsweb.conf'';

转到/path/to/apache/conf下并修改cvsweb.conf：

1.修改CVSROOT路径设置：

%CVSROOT = (

''Development'' => ''/path/to/cvsroot'', # ""1"",#

AuthName ""CVS Authorization""

AuthType Basic

AuthUserFile /path/to/cvsweb.passwd

require valid-user

CVS TAGS: who? when?

====================

将$Id$ 加在程序文件开头的注释里是一个很好的习惯，cvs能够自动解释更新其中的内容成：file_name version time

user_name 的格式，比如：cvs_card.txt,v 1.1 2002/04/05 04:24:12 chedong

Exp，可以这些信息了解文件的最后修改人和修改时间

几个常用的缺省文件：

default.php

 

====================================

Default.java: 注意文件头一般注释用 /* 开始 JAVADOC注释用 /** 开始的区别

/*

* Copyright (c) 2002 Company Name.

* $Header$

*/

package com.netease;

import java.io;

/**

* comments here

*/

public class Default {

/**

*

* @param

* @return

*/

public toString() {

}

}

====================================

default.pl:

#!/usr/bin/perl -w

# Copyright (c) 2002 Company Name.

# $Header$

# file comments here

use strict;

CVS vs VSS　

===========

CVS没有文件锁定模式，VSS在check out同时，同时记录了文件被导出者锁定。

CVS是update commit， VSS是check out check in

在CVS中，标记自动更新功能缺省是打开的，这样也带来一个潜在的问题，就是不用-kb方式添加binary文件的话在cvs自动更新时可能会导致文件失效。

Virsual SourceSafe中这个功能称之为Keyword

Explaination，缺省是关闭的，需要通过OPITION打开，并指定需要进行源文件关键词扫描的类型：*.txt,*.java,*.html...

对于Virsual SourceSafe和CVS都通用的TAG有：

$Header$

$Author$

$Date$

$Revision$

尽量使用通用的关键词保证代码在CVS和VSS都能方便的跟踪。

　

相关资源：

CVS HOME：

http://www.cvshome.org

CVS FAQ：

http://www.loria.fr/~molli/cvs-index.html

相关网站:

http://directory.google.com/Top/Computers/Software/Configuration_Management/Tools/Concurrent_Versions_System/

CVS 免费书:

http://cvsbook.red-bean.com/

CVS 命令的速查卡片：

http://www.refcards.com/about/cvs.html

David

 

------------------------------------------------------------------------------------------------------------------------------------------------

 

 

 

 

1. 导入一个源代码库：

源代码库在目录/home/testuser/project，其下有文件test.c和test.h

shell>cd /home/testuser/project

shell>cvs import -m "test project" test(需要导入的项目名) testuser(开发商信息) start(版本信息)

2. 获得第一份工作copy

shell>cd /home/testuser

shell>cvs checkout test

则目录/home/testuser/test中就会有test.c和test.h两个文件

3. 检查工作拷贝(-Q为去除无关的提示文字)

shell>cvs -Q update(将cvs上的更新下载到本地)

shell>cvs -Q diff -c(比较cvs上和本地的代码的不同)

如果希望查看某一特定文件的变化，在最后加上文件名

4. 浏览记录信息

shell>cvs log test.c

5. 查看两个版本的不同之处：

shell>cvs diff -c -r 1.3 -r 1.4 test.c

6. 恢复旧版本：如果当前最新版本为1.4，而你想将其恢复到1.3版本，重新建立一个新版本1.5

shell>cvs -Q update -p -r 1.3 hello.c > hello.c

(如果没有-p，表示检验出1.3版本，但是会sticky；加上-p，将1.3版本打到标准输出中，且没有sticky，此处覆盖hello.c文件)

shell>cvs update hello.c

(可选，但是一般ci之前都要update一次)

shell>cvs ci -m "reverted to 1.3 code" hello.c

或者

shell>cvs update -j 1.4 -j 1.3 hello.c

(将1.4->1.3的差异，应用到当前版本上)

shell>cvs update hello.c

(可选，但是一般ci之前都要update一次)

shell>cvs ci -m "reverted to 1.3 code" hello.c

如果是目录

在你需要恢复的目录下

cvs tag TAG_R1_0_0_2

cvs update -j TAG_R1_0_0_2 -j TAG_R1_0_0_1

cvs update

cvs ci -m "restore to R1_0_0_1"

或者

在你需要恢复的目录的上一级目录中

cvs export -d project_name.old -r TAG_R1_0_0_1 project_name

cp -rf project_name.old/* project_name/

rm -rf project_name.old

cvs update

cvs ci -m "restore to R1_0_0_1"

请注意，内容是恢复到了TAG_R1_0_0_1，但是版本一直在增加。

7. 增加文件

vi newfile

cvs add newfile(若为二进制文件则用cvs add -kb readme.doc）

cvs ci -m "add newfile" newfile

8. 删除文件

rm newfile.c

cvs remove newfile.c

cvs ci -m "removed newfile.c" newfile.c

9. 增加目录

mkdir newdir

cvs add newdir

10. 要增加带有多级目录和文件的子目录，方法是导入一个目录

比如原项目叫abc，在abc目录下想增加一个带有多级目录和文件的目录jni，

cd jni

cvs import -m "new dir jni" abc/jni testuserimport R1_0_0_0

然后，客户端(自己和其他人的客户端)需要

cvs update -d 获取最新的目录更新

11. 删除目录

先删除目录下的所有文件，然后

cvs update -P 从工作copy中删除空目录，但是源代码库依然保留着空目录

如果需要更新工作copy的目录与源代码库完全一致（主要是包括空目录），需要

cvs update -d

如果不需要恢复，应该

到服务器上rm -rf删除该目录

在客户端，rm -rf删除该目录，然后在该目录的同级CVS目录下，修改Entries文件，删除带有该目录名的一行

12. 导出不带CVS目录的源文件，export只能针对一个TAG或者日期导出，空目录不会被导出：

cvs export -r release1 project_name

cvs export -D 20021023 project_name

cvs export -D now project_name

cvs export和cvs co module的区别在于export不生成CVS目录，也不导出空目录，用于作发布

13. 确认版本里程碑

cvs tag release_1_0

14. 开始一个新的里程碑，标记所有文件开始进入2.x的开发

cvs commit -m "make all release 2.0" -r 2.0

cvs up -A

15. 版本分支的建立

在开发项目的2.x版本的时候发现1.x有问题，但2.x又不敢用，

则从先前标记的里程碑：release_1_0导出一个分支release_1_0patch

cvs rtag -b -r release_1_0 release_1_0patch projname

一些人先在另外一个目录下导出release_1_0patch这个分支：解决1.0中的紧急问题，

cvs checkout -r release_1_0patch

而其他人员仍旧在项目的主干分支2.x上开发

在release_1_0patch上修正错误后，标记一个1.0的错误修正版本号

cvs tag release_1_0patch_1

如果2.0认为这些错误修改在2.0里也需要，也可以在2.0的开发目录下合并release_1_0patch_1

中的修改到当前代码中：

cvs update -j release_1_0patch_1

(将release_1_0patch->update -j release_1_0patch_1的改变，merge到当前的版本中)

16.修改某个版本注释：

每次只确认一个文件到CVS库里是一个很好的习惯，但难免有时候忘了指定文件名，

把多个文件以同样注释commit到CVS库里了，以下命令可以允许你修改某个文件某个版本的注释：

cvs admin -m 1.3:"write some comments here" file_name

修改从1.2->1.3checkin时的注释

17.在注释中可以加入以下宏，cvs会自动将其替换为相应的项

$Id$ $Header$ $Author$ $Date$ $Revision$ $Log$ $Source$ $Name$

18.查看当前各文件的状态，包括文件的当前编辑版本号，源代码库版本号，文件的状态

cvs status filename

19.粘着选项

cvs update -D "2004-10-09"

删除粘着，回到当前最新版本

cvs update -A