CVS 使用简介
============
CVS是RCS的前端工具，它是用于多用户并行开发的版本控制工具，它的最大特点
是使用了“copy-modify-merge”机制而不是“lock-modify-unlock”。通过使用
CVS生成一个存储文件的仓库（repository），存储在仓库中的每个目录叫做模块
（module），在修改时将相应的模块检出到工作目录中（working directory）生
成对应的目录，所有的修改都在工作目录中完成，修改完成后再提交到仓库中生
成新的版本号，并加以保存。
1． CVS初始化
-------------
（1） 创建CVSROOT根目录
编辑有关的环境变量，加入CVSROOT的定义（比如在 /etc/bashrc 文件中加入下
面两行）：
CVSROOT=/usr/local/cvsroot
export CVSROOT
然后在相应位置开始创建CVSROOT
$cd /usr/local/
$mkdir cvsroot
$cvs –d /usr/local/cvsroot init
这时就会产生/usr/local/cvsroot/CVSROOT 目录，这下面放着有关CVS的配置文
件。同时/usr/local/cvsroot/也作为文件仓库存放所有的文件。
(2） 创建开发项目
如果从头开始一个新的项目，就需要创建一个单独的目录，并把所有要使用的文
件做一个有效的组织。而如果在开始使用源文件的目录之前就有了，则只需进入
该目录就行了。
$cd /work/tang
$ls cvstest
. .. c/
$cd cvstest
然后，就可以输入源文件目录：
$cvs import –m “Create Source Dir” cvstest/c tang cvstest
这样会生成 $CVSROOT/cvstest/c 目录。 其中 -m 用来指定注释信息，如果后面
在命令行不指定注释信息，则会启动缺省编辑器（vi）要求输入注释信息。 tan
g, cvstest分别标识了厂商和发行标识。
注意，使用import命令会把当前目录下的所有文件和目录（包括子目录）引入到
文件仓库中指定模块（目录）下。
2． 命令简介
-------------
（1） 检出源文件
cvs checkout [-r rev][-D date][-d dir][-j merg1] [-j merg2] modules
-r 检出指定版本的模块
-D 检出指定日期的模块
-d 检出指定目录而不是模块
-j 合并当前版本和指定版本
使用下面的命令会检出刚才生成的模块，并在当前目录下生成与文件仓库中完全
一样的目录结构：
$cvs checkout cvstest/c
对于目录结构比较复杂的模块可以在 $CVSROOT/CVSROOT/modules中加以指定:
1) $cvs checkout CVSROOT/modules
2) 在modules文件中加入下面一行：
SOURCE cvstest/c
3) 然后执行：
$cvs commit –m “Add SOURCE”
以后就可以使用下面的命令在当前路径下生成 cvstest/c 目录
$cvs checkout SOURCE
在当前路径下生成的这个目录就被称为工作目录，对源文件的所有修改都应该在
这个目录下完成，而绝对不允许去改动在 文件仓库中$CVSROOT 目录下的文件。
（2） 删除、增加、重命名文件和目录
cvs add [-k kflags][-m message] files...
-k 指定以后该文件的缺省检出目录
-m 对文件的描述
上述命令会加入一个新的文件到文件仓库里，但直到使用了提交命令它才会真正
更新文件仓库。
cvs remove [options] files
上述命令会从文件仓库中删除文件，但也要到提交之后才有作用。
例1：增加文件
$cvs checkout SOURCE
$cd cvstest/c
$touch test.c
$cvs add test.c
$cvs commit –m “add test.c”
例2：删除文件
$cvs checkout SOURCE
$cd cvstest/c
$rm test.c
$cvs remove test.c
使用 –f 选项能上面两步合做一步。
$cvs remove –f test.c
如果在提交之前想恢复刚才删除的文件，可以如下：
$cvs add test.c
如果只执行了第一步删除（rm），则可以用下面的方法恢复：
$cvs update test.c
对于重命名的文件，可以先删除再添加。
对于目录的修改（重命名），可能需要修改cvs 管理文件，一般应该遵循以下步
骤：
1) 确认所有有关的修改都已经提交；
2) 进入文件仓库中要修改的模块目录，对相应的目录进行修改（重命名或删除）
$cd $CVSROOT/modules
$mv old_dir new_dir
3) 如果有必要，修改管理文件，比如modules 文件
如果要删除目录，则应该先对目录中每个文件都进行了删除（包括使用cvs remo
ve ）处理之后再执行上面的第2步。
（3） 提交源文件
cvs commit [-Rl][-m mesg] files
-R 连子目录一起提交
-l 只提交本地目录（不提交子目录）
-m 注释信息
在检出源文件之后，在工作目录中对源文件进行的所有修改都必须在提交之后才
能对文件仓库中的源文件起作用，并且新的文件才能够被分配一个新的版本号。
（4） 释放工作目录
cvs release –d SOURCE
这个命令会删除工作目录 cvstest/c （建议在提交了修改的模块后执行这一步）
， 它比使用 rm –rf cvstest 要好。
3． 多用户开发
---------------
在多用户的情况下，如果不同用户修改的是同一个文件的不同部分，则使用下面
的命令就能进行版本合并（把检出的文件与当前的最新版本合并）：
$cvs update
（1） 冲突解决
在有多个用户对同一个文件进行修改时，如果修改了其中的相同部分，而修改后
的内容如果有不同的话，出现冲突是不可避免的。如果在CVS 文件仓库中有一个
文件 test.c ，它的版本是 1.4， 用户A 先检出该文件进行修改，而稍后有用户
B 检出该文件进行修改，并提前提交成 1.5， 而在用户A再提交时就会出现冲突
（如果文件内容不同的话），这时CVS会提示需要手工解决。
文件仓库中的版本1.4:
#include <stdio.h>
main()
{
int i;
for(i = 0; i < 100; i )
printf(“Count: %d\n”, i);
}
用户B 1.5:
#include <stdio.h>
main()
{
int i;
for(i = 0; i < 10; i )
printf(“Count: %d\n”, i);
printf(“Over\n”);
}
用户A :
#include <stdio.h>
main()
{
int i;
for(i = 0; i < 50; i )
printf(“Count: %d\n”, i);
return;
}
提交时会提示有冲突，需要手工编辑，这时运行了$cvs update 之后再编辑test
.c， 会看到：
#include <stdio.h>
main()
{
int i;
<<<<<<< test.c
for(i = 0; i < 50; i )
=======
for(i = 0; i < 10; i )
>>>>>>> 1.5
printf("Count: %d\n", i);
<<<<<<< test.c
return;
=======
printf("Over\n");
>>>>>>> 1.5
}
（2） 文件版本管理
cvs log [-lR][-r rev][-d date][-w login][files…]
-l 不处理子目录
-R 对子目录做同样处理
-r 指定版本号
-d 指定时间
-w 指定登录名
使用上面的命令可以参看当前模块或指定文件的所有历史版本信息。
cvs annotate [-lR][-r rev|-D date] files
-l 不处理子目录
-R 对子目录做同样处理
-r 指定版本号
使用上面的命令可以参看指定文件（检出之后）的所有修改信息。
例：$cvs annotate cvstest/c/test.c
输出：
版本 修改人 修改时间 源代码
1.1 (tang 18-Jan-00): #include <stdio.h>
1.1 (tang 18-Jan-00): #include <string.h>
1.1 (tang 18-Jan-00):
1.1 (tang 18-Jan-00): main()
1.1 (tang 18-Jan-00): {
1.1 (tang 18-Jan-00): int i = 0 ;
1.1 (tang 18-Jan-00):
1.1 (tang 18-Jan-00): for(i = 0; i < 20; i )
1.1 (tang 18-Jan-00): printf("Count: %d\n", i);
1.1 (tang 18-Jan-00):
1.3 (tang 18-Jan-00): printf("222222\n");
1.4 (tang 18-Jan-00): printf("333333\n");
1.1 (tang 18-Jan-00): }
使用下面的命令可以生成相对于一个指定主版本的分支版本：
cvs rtag –b –r rev_root rev_branch file_name
-b 指定生成一个分支版本
-r 指定该分支的主干节点版本号
rev_root 主干版本号
rev_branch 分支版本号
file_name 指定文件，使用“.”表示当前目录下所有文件
使用上面的命令可以生成一个对应版本号的分支版本，由于CVS 版本号是用数字
表示的，而且在同一个模块下不同文件的版本完全可能是不同的，所以使用标识
会更方便。
例：
$cvs rtag –b –r 1.2 tlb-1 SOURCE
以后要访问该分支版本，可以使用“-r” 选项
$cvs checkout –r tlb-1 SOURCE
从当前检出的版本切换到一个分支版本：
$cvs update –r tlb-1 SOURCE
使用下面的命令可以看版本信息：
cvs status [–vlR] files
-v 显示所有信息
-l 不显示子目录信息
-R 显示子目录信息
cvs update –j rev module
把当前所做的修改与指定版本的文件进行合并。
主干 1.1 ? 1.2 ? 1.3 ? 1.4 ? 1.5 ?
1.6
↓
分支tlb-1 ? 1.2.2.1 ? 1.2.2.2 ? 1.2.2.3
如果要合并分支tlb-1上的版本：
$cvs update –j 1.2.2.3 –j tlb-1 test.c
其中1.2.2.3可以通过tag命令生成一个容易记忆的标识。
如果要合并分支tlb-1到主干上1.2 ：
$cvs update –j tlb-1 test.c
如果要合并主干上的不同版本（注意顺序很重要，同时在指定版本之间的所有修
改将被丢弃）：
$cvs update –j 1.5 –j 1.2 test.c
如果在不同版本之间模块的文件有增减，则可以：
$cvs update –A
$cvs updata –jbranch_name
4． 在远程机器上使用CVS
----------------------
通过网络使用CVS 有很多种方式，但在这里只介绍比较简单的一种：通过rsh 执
行cvs 命令。
1) 在远程机器的.rhosts中加入对本地机的访问许可：
tom tang
2) 使用下面的命令检出模块ESMSTRG
$cvs –d :ext:tang@esmpro:/work/cvsroot checkout SOURCE
其中， ext 指明了连接方式为 rsh， tang 指明了本地用户， esmpro 指明了远
地主机，/work/cvsroot 指明了在远地主机上的$CVSROOT路径，可以在本地设置
CVS_SERVER环境变量指明这个目录。
5． 参看帮助
----------------
cvs –H command
可以参看指定命令的帮助信息。
