CVS 简单教程

mantou

CVS 是 Concurrent Version
System（并行版本系统）的缩写，用于版本管理．如果大家曾经参与过多人协作开发的项目，大家肯定有这样的痛苦经历：由于多个人同时修改同一个文件，
自己辛辛苦苦修改的程序被别人彻底删除了．另外，如果你的软件/程序已经发布了三个版本，而这时候用户需要你修改第二个版本的东西，也许你会因为只保留了
最新版本而痛哭流涕．还有就是你对程序做了一些修改，但是修改很少，你只想给远方的同事发一个两个版本之间的差别文件，这样可以免于邮箱不够大，网速太慢
之类的问题．为了解决类似这样的问题，以及诸如生成补丁文件，历史版本修改等，一帮黑客（褒义）在原先 Unix 体系里很成熟的 SCCS 和
RCS 的基础上，开发了 CVS．（SCCS：Source Code Control System，RCS：Revision Control
System）
[color="#0000ff"]CVS 简单教程   

v2.1
版权声明：本文档遵循 FDL 版权发布，有关 FDL 的详细信息，请参考：   
http://www.fsf.org/copyleft/fdl.html  
何伟平

CVS 是 Concurrent Version
System（并行版本系统）的缩写，用于版本管理．如果大家曾经参与过多人协作开发的项目，大家肯定有这样的痛苦经历：由于多个人同时修改同一个文件，
自己辛辛苦苦修改的程序被别人彻底删除了．另外，如果你的软件/程序已经发布了三个版本，而这时候用户需要你修改第二个版本的东西，也许你会因为只保留了
最新版本而痛哭流涕．还有就是你对程序做了一些修改，但是修改很少，你只想给远方的同事发一个两个版本之间的差别文件，这样可以免于邮箱不够大，网速太慢
之类的问题．为了解决类似这样的问题，以及诸如生成补丁文件，历史版本修改等，一帮黑客（褒义）在原先 Unix 体系里很成熟的 SCCS 和
RCS 的基础上，开发了 CVS．（SCCS：Source Code Control System，RCS：Revision Control
System）
CVS
的基本工作思路是这样的：在一台服务器上建立一个仓库，仓库里可以存放许多不同项目的源程序．由仓库管理员统一管理这些源程序．这样，就好象只有一个人在
修改文件一样．避免了冲突．每个用户在使用仓库之前，首先要把仓库里的项目文件下载到本地．用户做的任何修改首先都是在本地进行，然后用 cvs
命令进行提交，由 cvs 仓库管理员统一修改．这样就可以做到跟踪文件变化，冲突控制等等．
由于 CVS 是典型的 C/S   
结构的软件，因此它也分成服务器端和客户端两部分．不过大多数   
CVS 软件都把它们合二为一了．
    



   
   
    结合文档和一些网上资源，我写一点非常简单的“速成”的教材．希望对大家有用．  
      
下面是我的步骤和做法：
      
前提要求：
      

• root 权限；   
          
• CVS软件，请找到相关的rpm，tgz，deb 等包装上，或者到 
  http://www.cvshome.org/CVS/Dev/code   
          
  下载原程序编译安装，这里我不准备介绍它的安装，请参考CVS自身的文档安装．我使用Slackware的tgz包，安装的命令是
          
  #installpkg cvs*.tgz
  其他包请参考对应包管理工具的命令．   
          
• 一定的系统资源，要有一定内存（32M就能工作得很好），要一定的磁盘空间，看你的项目的大小和多少而定．

      架设CVS服务器：
      

建立 CVSROOT 目录，因为这里涉及到用户对CVSROOT里的文件读写的权限问题，所以比较简单的方法是建立一个组，然后再建立一个属于该组的帐户，而且以后有读写权限的用户都要属于该组．假设我们建一个组叫cvs，用户名是cvsroot．建组和用户的命令如下
         
　  
        
#groupadd cvs
#adduser   
        cvsroot
         
　
生成的用户家目录在/home/cvsroot（根据自己的系统调整）
         
　  
        

用 cvsroot 用户登陆，修改 /home/cvsroot （CVSROOT）的权限，赋与同组人有读写的权限：
         
　   
        
$chmod 771 . （或者770应该也可以）   
         
注意：这一部分工作是按照文档说明做的，是否一定需要这样没有试验，我会在做试验后在以后版本的教程说得仔细一点．如果您有这方面的经验请提供给我，谢谢．
 

        

建立CVS仓库，（仍然是 cvsroot 用户），用下面命令：
         
　  
        
$cvs    -d /home/cvsroot init
         
　
  
        

以root身份登陆，修改 /etc/inetd.conf（使用 xinetd 的系统没有此文件）和 /etc/services，   
        
如果用的是 inetd 的系统，在 /etc/inetd.conf 里加入：
cvsserver      
          stream    tcp      
          nowait    root      
          /usr/bin/cvs    cvs -f  --allow-root=/home/cvsroot   
          pserver
说明：上面的行是单独一整行，/usr/bin/cvs 应该是你的cvs版本的命令路径，请根据自己的系统调整．/home/cvsroot 是你建立的CVSROOT的路径，也请根据上面建立目录的部分的内容做调整．
如果是使用
          xinetd 的系统，需要在 /etc/xinetd.d/ 目录下创建文件 cvspserver（此名字可以自己定义），内容如下：

          # default: on
  
          # description: The cvs server sessions;
  
         
          service cvsserver
  
          {
          socket_type = stream
  
          wait = no
  
          user = root
  
          server = /usr/bin/cvs
  
          server_args = -f --allow-root=/cvsroot pserver
  
          log_on_failure += USERID
  
          only_from = 192.168.0.0/24
  
          }
          其中only_from是用来限制访问的，可以根据实际情况不要或者修改。修改该文件权限：
          # chmod 644 cvspserver
  
         
在/etc/services里加入：
         

cvsserver    2401/tcp   
         
说明：cvsserver 是任意的名称，但是不能和已有的服务重名，也要和上面修改
          /etc/inetd.conf 那行的第一项一致．这里我用的是 CVS 的口令认证方式，CVS
          还有其他认证方式，我没有做试验，如果您有经验，请补充，谢谢．
 

        

添加可以使用 CVS 服务的用户到 cvs 组：  
        以 root 身份修改 /etc/group，把需要使用 CVS 的用户名加到
          cvs 组里，比如我想让用户 laser 和gumpwu 能够使用 CVS 服务，那么修改以后的
          /etc/group 应该有下面这样一行：
         
cvs:x:105:laser,gumpwu
  
         
在你的系统上GID可能不是105，没有关系．主要是要把laser和gumpwu用逗号分隔开写在最后一个冒号后面．当然，象RedHat等分发版有类似linuxconf这样的工具的话，用工具做这件事会更简单些．

        

重起inetd使修改生效：
         
　  
        
#killall -HUP inetd
如果使用的是 xinetd 的系统：
          # /etc/rc.d/init.d/xined restart
      
这样服务器就设置完成了．我们接着搞客户端．
      
设置客户端
如果是 Linux（或者其他 *nix），客户端和服务器端的软件是一样的，如果是Win，MAC等平台，请到
http://www.loria.fr/cgi-bin/molli/wilma.cgi/rel
找相应的客户端软件，这里我先说一下在
      Linux（*nix）里怎么做：  
      

设置环境变量CVSROOT：
         
　  
        
$export CVSROOT=:pserver:laser@the_server_name:/home/cvsroot   
         
注
意：这里的pserver是访问方式，我在上面设置的是口令认证，所以这里是pserver，如果你的CVS服务器设置成别的访问模式，那么需要相应修
改．laser是可以使用
CVS服务器的用户名，这里可以根据你的设置修改，我在这个版本设置的是直接使用系统用户的口令文件，也就是说laser必须是CVS服务器上的合法用
户，这里当然有安全问题，CVS可以设置成为拥有自己的用户，我将在以后的版本里面增加这些内容，或者您也可以提供一些补充，或者直接读CVS的文档．
the_server_name是CVS服务器的名称或者IP地址，根据你的情况填写，/home/cvsroot是你的CVS服务器的CVSROOT目
录，根据你的CVS服务器设置做修改或者询问管理员．你可以把这行放到你的shell的profile里（.bash_profile，.profile
等）这样就不用每次敲一长串命令了．
 

        

登陆CVS服务器：
         
　  
        
$ cvs login，这时候 cvs 会问你口令，请把你在 CVS 服务器上的口令敲进去，这里是
          laser 在 CVS服务器上的系统用户的口令：
 Passwd:xxxxxxxx
         
   
         
成功登陆后将在你的家目录建立一个 .cvspass 文件，以后就不用输入口令了．
好，客户端设置完成，简单吧．
管理 cvs
      服务器
服务器可以用了，现在大家最关心的就是如何管理服务器，比如，我想让一些人有读和/或写 CVS   
      仓库的权限，但是不想给它系统权限怎么办呢？

不难，在 cvs 管理员用户（在我这里是 cvsroot 用户）的家目录里有一个 CVSROOT   
      目录，这个目录里有三个配置文件，passwd, readers, writers，我们可以通过设置这三个文件来配置 CVS   
      服务器，下面分别介绍这几个文件的作用：  
      
passwd：cvs 用户的用户列表文件，它的格式很象 shadow 文件：   
      
{cvs 用户名}:[加密的口令]:[等效系统用户名]   
      
如果你希望一个用户只是 cvs 用户，而不是系统用户，那么你就要设置这个文件，刚刚安装完之后这个文件可能不存在，你需要以 cvs   
      管理员用户手工创建，当然要按照上面格式，第二个字段是该用户的加密口令，就是用 crypt (3)   
      加密的，你可以自己写一个程序来做加密，也可以用我介绍的偷懒的方法：先创建一个系统用户，名字和 cvs 用户一样，口令就是准备给它的 cvs   
      用户口令，创建完之后从 /etc/shadow 把该用户第二个字段拷贝过来，然后再把这个用户删除．这个方法对付数量少的用户比较方便，人一多就不合适了，而且还有冲突条件(race   
      condition)的安全隐患，还要 root 权限，实在不怎么样．不过权益之计而已．写一个小程序并不难，可以到 linuxforum   
      的编程版搜索一下，有个朋友已经写了一个贴在上面了．  
      
第三个字段就是等效系统用户名，实际上就是赋与一个 cvs 用户一个等效的系统用户的权限，看下面的例子你就明白它的功能了．   
      
readers：有 cvs 读权限的用户列表文件．就是一个一维列表．在这个文件中的用户对 cvs只有读权限．   
      
writers：有 cvs 写权限的用户的列表文件．和 readers 一样，是一个一维列表．在这个文件中的用户对 cvs 有写权限．   
      
上面三个文件在缺省安装的时候可能都不存在，需要我们自己创建，好吧，现在还是让我们用一个例子来教学吧．假设我们有下面几个用户需要使用 cvs：   
      
laser, gumpwu, henry, betty, anonymous．   
      
其中 laser 和 gumpwu 是系统用户，而 henry, betty, anonymous 我们都不想给系统用户权限，并且   
      betty 和 anonymous 都是只读用户，而且 anonymous 更是连口令都没有．那么好，我们先做一些准备工作，先创建一个   
      cvspub 用户，这个用户的责任是代表所有非系统用户的 cvs 用户读写 cvs 仓库．   
      
#adduser 
...  
      
然后编辑 /etc/group，令 cvspub 用户在 cvs 组里，同时把其它有系统用户权限的用户加到
      cvs 组里．（见上文）   
      
然后编辑 cvs 管理员家目录里 CVSROOT/passwd 文件，加入下面几行：   
      
laser:$xxefajfka;faffa33:cvspub
gumpwu:$ajfaal;323r0ofeeanv:cvspub  
      
henry:$fajkdpaieje:cvspub
betty:fjkal;ffjieinfn/:cvspub  
      
anonymous::cvspub  
      
注意：上面的第二个字段（分隔符为 :）是密文口令，你要用程序或者用我的土办法生成．   
      
编辑 readers 文件，加入下面几行：   
      
anonymous
betty  
      
编辑 writer 文件，加入下面几行：   
      
laser
gumpwu
henry  
      
这样就 ok 了，你再用几个用户分别登陆测试，就会发现一切都 ok 了．这里面的原理和说明我想就不多说了，其实很简单，和系统管理用户的概念是一样的．
    
      
现在服务器和客户端都设置好了，那么怎么用呢，我在这里写一个最简单的（估计也是最常用的）命令介绍：  
      
首先，建立一个新的CVS项目，一般我们都已经有一些项目文件了，这样我们可以用下面步骤生成一个新的CVS项目：  
      

进入到你的已有项目的目录，比如叫 cvstest：   
        $cd  cvstest   
        

运行命令：  
        $cvs import -m "this is a cvstest project"   
          cvstest     v_0_0_1     start   
         
说明：import 是cvs的命令之一，表示向cvs仓库输入项目文件．   
         
                
          -m参数后面的字串是描述文本，随便写些有意义的东西，如果不加 -m 参   
         
数，那么cvs会自动运行一个编辑器（一般是vi，但是可以通过修改环境变量  
         
EDITOR来改成你喜欢用的编辑器．）让你输入信息，  
         
               
          cvstest 是项目名称（实际上是仓库名，在CVS服务器上会存储在以这个名字
命名的仓库里．）   
         
               
          v_0_0_1是这个分支的总标记．没啥用（或曰不常用．）  
         
               
          start 是每次 import   
      标识文件的输入层次的标记，没啥用．这样我们就建立了一个CVS仓库了，然后，我们可以把这个测试项目的文件删除．试验一下如何从仓库获取文件．这里我假设上面的所有客户端工作你都已经做过了．
运行下面的命令：  
         $cvs checkout   
      cvstest从仓库中检索出cvstest项目的源文件．  
      
如果你已经做过一次checkout了，那么不需要重新checkout，只需要进入cvstest项目的目录，更新一把就行了：  
      $cd cvstest
$cvs   
      update一下即可．又或者你不想直接更新，只是想看看有没有更新的东西，那么：  
      $cvs   
      status这时后会打印出一长串状态报告（你可能需要用类似less这样的命令分页显示，或者定向到一个输出文件里慢慢看．），对项目中的每个文件有一份状态报告，类似这样：  
      
===================================================================  
      
File:   
      foo.c               
      Status: Up-to-date   
      
   Working revision:    1.1.1.1 'Some Date'   
      
   Repository revision: 1.2       
      /home/cvsroot/cvstest/foo.c,v
   Sticky   
      Tag:          (none)   
      
   Sticky   
      Date:         (none)   
      
   Sticky Options:      (none)   
      
这里最重要的就是 Status 栏，这里总共可能有四种状态：
Up-to-date：表明你要到的文件是最新的．
Locally   
      Modified：表明你曾经修改过该文件，但还没有提交，你的版本比仓库里的新．
Needing   
      Patch：表明有个哥们已经修改过该文件并且已经提交了！你的版本比仓库里的旧．
Needs   
      Merge：表明你曾经修改过该文件，但是偏偏有个不识相的也修改了这个文件，而且还提交给仓库了！  
      
如果你只是想保持软件的同步的话（象我），那么上面的东西就足够用了．可是如果多人协作开发项目的话，可就不是了这么简单了．当你参加项目，维护文件时，就需要更多命令，比如说你我都是某   
      nasdaq 项目的开发人员：   
      
1，你对某个文件做了修改，比如说改了ceo.c，加了一行程序：printf("where can I find VC to cheat!");   
      
改完之后你要把修改提交给仓库，用命令：
$cvs commit -m "add a complain" ceo.c   
      
或者就是：
$cvs commit -m "worry about money"
让cvs帮你检查哪个文件需要提交．   
      
2，当我开始干活的时候，可能我先：
$cvs status
一把，这时候我会看到：   
      
==================================================================  
      
File:   
      ceo.c               
      Status: Needing Patch   
      
   Working revision:    1.1.1.1 'Some Date'   
      
   Repository revision: 1.2       
      /home/cvsroot/nastaq/ceo.c,v
   Sticky   
      Tag:          (none)   
      
   Sticky   
      Date:         (none)   
      
   Sticky Options:      (none)   
      
于是我知道有人改了ceo.c，于是我就：
$cvs update ceo.c
或者干脆：
$cvs update   
      
把ceo.c这个文件更新为最新版本，然后再干活．然后提交．  
      
如果这天你修改了coo.c，加了一行 puts("how about another kind of bragging?");   
      
并且提交了，但是这时候我已经 $cvs status 过了，就是说我不知道你的修改．
而我加了一行printf("You must   
      shamelessly and seems knowingness to act as a coo");
并且傻乎乎地提交：   
      
$cvs commit coo.c
这时候，CVS会告诉我
cvs commit: Examing .
cvs   
      server: Up-to-date check failed for 'coo.c'
cvs [server aborted]:   
      correct above error first!   
      
于是我知道有个狗屎在我修改文件的当口做了提交，于是我
$cvs update
这时cvs会报告：
RCS file:   
      /home/cvsroot/nasdaq/coo.c,v
retrieving revision 1.1.1.1   
      
retrieving revision 1.2
Merging differences between 1.1.1.1 and   
      1.2 into coo.c
rcsmerge: warning: conflicts during merge
cvs   
      update: conflicts found in coo.c
C coo.c   
      
告诉你coo.c有版本冲突，于是我编辑coo.c，这时一般文件里看起来象这样：
  ...
printf("You   
      must shamelessly and seems knowingness to act as a coo");   
      
>>>>>> 1.2
...   
      
于是我把上面改成：
printf("You must shamelessly and seems knowingness to act   
      as a coo");
puts("how about another kind of bragging?");
然后   
      
$cvs commit -m "merged" coo.c
于是下回你再更新的时候就有新的补钉要打．．．如此往复，直到完成所有修改．   
      
不过这里有一些要注意的地方就是删除程序，如果你删掉一行对你可能没有用的程序
puts("to be honest");   
      而我不想删除（因为我有用），而我不知情地直接：
$cvs update   
      
了，那么我的这行程序也完蛋了，所以这里我们要注意所有开发人员的协调，千万不要乱删东西，大不了用  
      
#if    0
#endif
宏定义对括起来．实在要删东西，那最好先标记一个版本：   
      
$cvs tag v_0_0_1   
      
然后你可以发布并删除你自己的工作目录里这个版本的文件（注意：不是删除仓库里的．）：  
      
$cvs release -d nasdaq   
      
然后你再生成一个新分支：  
      
$cvs rtag -b -r v_0_0_1 v_0_0_1_1 nasdaq   
      
然后再建立v_0_0_1_1的分支  
      
$cvs checkout -r v_0_0_1_1 nasdaq   
      
编辑并修改这个分支的文件，这样的做法比较好．  
      
不
过要注意的是，新标记和新分支的建立最好由项目的管理人员负责，否则每个人都做一个分支，那么仓库就太乱了．因此，比较的开发人员之间的直接沟通是不能忽
略的．一般来说，在互联网上的标准模式是有一个管理员（可能自己并不写程序），有一个邮递列表，大家都在邮递列表上交流看法和做各种决议．当形成决议之
后，管理员做一个新版本的标记．以此循环．
   
      
还有一些命令，比如要增加一个文件 garbage_china_concept_stocks_list：   
      
$cvs add garbage_china_concept_stocks_list   
      
然后还要：  
      
$cvs commit  garbage_china_concert_stocks_list   
      
看起来有点象数据库里的事务？的确是这样．CVS维护着一个本地的参考文件（在CVS/Entries里），这样提交的时候就可以一次地把所有改变放到服务器端，这样也更安全．同样，如果想删除文件 bankrupted_web_site：   
      
$rm bankrupted_web_site
$cvs remove bankrupted_web_site
$cvs   
      commit bankrupted_web_site   
      
3，一些小技巧：
$Header$ 标记：把这个标记放在文件的任何地方都会被 cvs 替换成最后修改的 cvs 用户名，该文件当前版本号，最后修改时间，该文件的 cvs 仓库路径，看起来象下面这个样子：   
      
// $Header: /home/cvsroot/simhost/simhost.cpp,v 1.2 2001/04/20 08:26:10   
      jqliu Exp $   
      
一般我们把它放在开头，这样对程序员修改文件非常便利，很多时候你只要看一眼开头就知道文件是否最新．  
      
$Id$标记：把这个标记放在文件的任何地方都会被 cvs 替换成最后修改的 cvs 用户名，该文件当前版本号，最后修改时间，该文件的 cvs   
      仓库路径，看起来象下面这个样子：  
      
$Id: simhost.cpp,v 1.3 2001/04/24 02:27:36 simhost Exp $   
      
好
了，上面所有的东西，估计就是我们用cvs时80%情况下用的命令和内容，包括文件的更新，提交，冲突的解决，分支的派生，增删文件等．实际上cvs的功
能之强大，远远超出我在这里描述的内容，我这个＂速成＂也就管不了太多了，希望随着时间的推移，我们能够更加有效地使用CVS．也希望大家能够不断补充这
篇文章，最后能够成为手册，而不仅仅是速成．当然，还要更多地参考别的文档．
参考资料：  
      
http://www.loria.fr/cgi-bin/molli/wilma.cgi/doc.865331095.html  
      
http://www.loria.fr/~molli/cvs/doc/cvs_toc.html  
      


本文来自ChinaUnix博客，如果查看原文请点：http://blog.chinaunix.net/u/3188/showart_10331.html