结合文档和一些网上资源,折腾了半天终于搞定了CVS,我写一点非常简单的"速成"
的教材.希望对大家有用.
下面是我的步骤和做法.
1,要求:
root
权限;
CVS软件,请找到相关的rpm,tgz,deb
等包装上,或者到
http://www.cvshome.org/CVS/Dev/code
下载原程序编译安装,这里我不准备介绍它的安装,请参考CVS自身的文档安装.
我使用Slackware的tgz包,安装的命令是
#installpkg
cvs*.tgz
其他包请参考对应包管理工具的命令.
一定的系统资源,要有一定内存(32M就能工作得很好),要一定的磁盘空间,看
你的项目的大小和多少而定.
2,架设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
和
/etc/services,分别加入下面一行:
在
/etc/inetd.conf
里加入:
cvsserver
stream
tcp
nowait
root
/usr/bin/cvs
cvs
--allow-root=/home/cvsroot
pserver
说明:上面的行是单独一整行,/usr/bin/cvs
应该是你的cvs版本的命令路径,
请根据自己的系统调整./home/cvsroot
是你建立的CVSROOT的路径,也请
根据上面建立目录的部分的内容做调整.
在/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
这样服务器就设置完成了.我们接着搞客户端.
3,设置客户端,如果是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项目:
进入到你的已有项目的目录,比如叫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");
<<<<<<<
foo.c
=======
...
puts("how
about
another
kind
of
bragging?");
>>>>>>>
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
好了,上面所有的东西,估计就是我们用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