您的位置:首页 > 其它

CVS常用命令速查手册

2004-11-13 11:47 441 查看
CVS是一个C/S系统,多
保证文件同步的目的。工作
个开发人员通过一个中心版本控
模式如下:
制系统来记录文件版本,从而达到

  CVS服务器(文件版本库) 
  开发人员入门可以主要
简单介绍了一些Windows下
发环境的集成问题。
挑选2,6看就可以了,CVS的管理
的cvs客户端使用,远程用户认

员则更需要懂的更多一些,最后还
证的选择,及与BUG跟踪系统等开

  CVS环境初始化:CVS环境的搭建 管理员
  CVS的日常使用:日常开发中最常用的CVS命令, 开发人员 管理员
  CVS的分支开发:项目按照不同进度和目标并发进行 管理员
  CVS的用户认证:通过SSH的远程用户认证,安全,简单 管理员
  CVSWEB:CVS的WEB访问界面大大提高代码版本比较的效率 管理员
  CVS TAG:将$Header$加入代码注释中,方便开发过程的跟踪 开发人员
  CVS vs VSS: CVS和Vir
sual SourceSafe的比较 开发人
员 管理员
  WinCVS: 通过SSH认证的WinCVS认证设置
  基于CVSTrac的小组开发环境搭建:
跟踪和WIKI交流。
通过CVSTrac实现web界面的CVS用户管理及集成的BUG

  一个系统20%的功能往往能够满足80%
能还不到它全部命令选项的20%,更多的
不时回头看看经常有意外的收获。
的需求,CVS也不例外,以下是CVS最常用的功能,可
功能在实际应用过程中体会,你想用多少就学多少,

  CVS环境初始化
  环境设置:指定CVS库的路径CVSROOT
  tcsh
  setenv CVSROOT /path/to/cvsroot
  bash
  CVSROOT=/path/to/cvsroot export CVSROOT
  后面还提到远程CVS服务器的设置:
  CVSROOT=:ext:$USER@t
export CVSROOT CVS_RSH
est.server.address#port:/pat

h/to/cvsroot CVS_RSH=ssh;

  初始化:CVS版本库的初始化。
  cvs init
  一个项目的首次导入
  cvs import -m "write some commen
ts here" project_name vendor_tag release_tag
  执行后:会将所有源文
件及目录导入到/path/to/cvsro
ot/project_name目录下
  vender_tag: 开发商标记
  release_tag: 版本发布标记
  项目导出:将代码从CVS库里导出
  cvs checkout project_name
  cvs 将创建project_na
和Virvual SourceSafe中的
out是cvs update, check
me目录,并将最新版本的源代码
check out不是一个概念,相对
in是cvs commit。
导出到相应目录中。这个checkout
于Virvual SourceSafe的check

  CVS的日常使用
  注意:第一次导出以后
checkout project_name导
删除)操作。
,就不是通过cvs checkout来同
出的project_name目录下进行具

步文件了,而是要进入刚才cvs
体文件的版本同步(添加,修改,

  将文件同步到最新的版本
  cvs update
  不制定文件名,cvs将同步所有子目
录下的文件,也可以制定某个文件名/目录进行同步
  cvs update file_name
  最好每天开始工作前或将自己的工作
改”的习惯,和Virvual SourceSafe不同
commit之前解决,如果你修改过程中,有
冲突,并自动将冲突部分用
导入到CVS库里前都要做一次,并养成“先同步 后修
,CVS里没有文件锁定的概念,所有的冲突是在
其他人修改并commit到了CVS库中,CVS会通知你文件

  >>>>>>
  content on cvs server
  <<<<<<
  content in your file
  >>>>>>
  标记出来,由你确认冲突内容的取舍。
  版本冲突一般是在多个
CVS来解决。
人修改一个文件造成的,但这种

项目管理上的问题不应该指望由

  确认修改写入到CVS库里
  cvs commit -m "write
some comments here" file_na
me
  注意:CVS的很多动作都是通过cvs c
文件。在确认的前,还需要用户填写修改
用写-m "comments"而直接确认`cvs comm
字编辑器(一般是vi)要求你写入注释。
ommit进行最后确认并修改的,最好每次只修改一个
注释,以帮助其他开发人员了解修改的原因。如果不
it file_name` 的话,cvs会自动调用系统缺省的文

  注释的质量很重要:所
开发人员能够很好的理解
以不仅必须要写,而且必须写一

些比较有意义的内容:以方便其他

  不好的注释,很难让其
他的开发人员快速的理解:比如
: -m "bug fixed" 甚至 -m ""
  好的注释,甚至可以用中文: -m "在用户注册过程中加入了Email地址校验"
  修改某个版本注释:每次只确认一个
了指定文件名,把多个文件以同样注释co
件某个版本的注释:
文件到CVS库里是一个很好的习惯,但难免有时候忘
mmit到CVS库里了,以下命令可以允许你修改某个文

  cvs admin -m 1.3:"wr
ite some comments here" file
_name
  添加文件
  创建好新文件后,比如:touch new_file
  cvs add new_file
  注意:对于图片,Word文档等非纯文
式导入(k表示扩展选项,b表示binary),
本的项目,需要使用cvs add -kb选项按2进制文件方
否则有可能出现文件被破坏的情况
  比如:
  cvs add -kb new_file.gif
  cvs add -kb readme.doc
  然后确认修改并注释
  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/get; 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.nam
1.2版本
e加一个STICK TAG: "1.2" ,

虽然你的本意只是想将它恢复到

  正确的恢复版本的方法是:cvs update -p -r1.2 file_name >file_name
  如果不小心已经加成STICK TAG的话:用cvs update -A 解决
  移动文件/文件重命名
  cvs里没有cvs move或cvs rename,
old_file_name,然后cvs add new_file_
因为这两个操作是可以由先cvs remove
name实现的。
  删除/移动目录
  最方便的方法是让管理
目录都是独立的,移动到$C
意一枝都能独立存活),对
project_name 或者用cvs u
员直接移动,删除CVSROOT里相
VSROOT目录下都可以作为新的独
目录进行了修改后,要求其开发
pdate -dP同步。
应目录(因为CVS一个项目下的子
立项目:好比一颗树,其实砍下任
人员重新导出项目cvs checkout

  项目发布导出不带CVS目录的源文件
  做开发的时候你可能注意到了,每个
件用于记录当前目录和CVS库之间的对应
带着含有CVS信息的CVS目录吧,这个一次
针对一个TAG或者日期导出,比如:
开发目录下,CVS都创建了一个CVS/目录。里面有文
信息。但项目发布的时候你一般不希望把文件目录还
性的导出过程使用cvs export命令,不过export只能

  cvs export -r release1 project_name
  cvs export -D 20021023 project_name
  cvs export -D now project_name
  CVS Branch:项目多分支同步开发
  =============================
  确认版本里程碑:多个文件各自版本
定一个阶段里程碑版本号,方便以后按照
个分支开发的基础。
号不一样,项目到一定阶段,可以给所有文件统一指
这个阶段里程碑版本号导出项目,同时也是项目的多

  cvs tag release_1_0
  开始一个新的里程碑:
  cvs commit -r 2 标记所有文件开始进入2.x的开发
  注意:CVS里的revsion
版本一致的版本号比较有助
和软件包的发布版本可以没有直
于维护。
接的关系。但所有文件使用和发布

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

  cvs rtag -b -r release_1_0 relea
se_1_0_patch proj_dir
  一些人先在另外一个目录下导出rele
ase_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认为这些错误
release_1_0_patch_1中的
修改在2.0里也需要,也可以在2
修改到当前代码中:
.0的开发目录下合并

  cvs update -j release_1_0_patch_1
  CVS的远程认证:通过SSH远程访问CVS
  使用cvs本身基于pserv
码等,
er的远程认证很麻烦,需要定义

服务器和用户组,用户名,设置密

  常见的登陆格式如下:
  cvs -d :pserver:cvs_
user_name@cvs.server.address
:/path/to/cvsroot login
  例子:
  cvs -d :pserver:cvs@
samba.org:/cvsroot login
  不是很安全,因此一般是作为匿名只
认证并通过SSH传输是比较好的办法,通
读CVS访问的方式。从安全考虑,通过系统本地帐号
过在客户机的/etc/profile里设置一下内容:
  CVSROOT=:ext:$USER@c
export CVSROOT CVS_RSH
vs.server.address#port:/path

/to/cvsroot CVS_RSH=ssh;

  所有客户机所有本地用户都可以映射到CVS服务器相应同名帐号了。
  比如:
  CVS服务器是192.168.0
192.168.0.4,如果tom在2
.3,上面CVSROOT路径是/home/c
台机器上都有同名的帐号,那么
vsroot,另外一台开发客户机是
从192.168.0.4上设置了:
  export CVSROOT=:ext:tom@192.168.
0.3:/home/cvsroot
  export CVS_RSH=ssh
  tom就可以直接在192.1
68.0.4上对192.168.0.3的cvsro
ot进行访问了(如果有权限的话)
  cvs checkout project_name
  cd project_name
  cvs update
  ...
  cvs commit
  如果CVS所在服务器的SSH端口不在缺
一致,有时候设置了:
省的22,或者和客户端与CVS服务器端SSH缺省端口不

  :ext:$USER@test.serv
er.address#port:/path/to/cvs
root
  仍然不行,比如有以下错误信息:
  ssh: test.server.add
ress#port: Name or service n
ot known
  cvs [checkout aborted]: end of f
)
ile 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界面,可以大大提高程序员定位修改的效率:
  使用的样例可以看:ht
tp://www.freebsd.org/cgi/cvs
web.cgi
  CVSWEB的下载:CVSWEB从最初的版本
人感觉安装设置比较方便的:
已经演化出很多功能界面更丰富的版本,这个是我个

  http://www.spaghetti-code.de/sof
tware/linux/cvsweb/
  下载解包:
  tar zxf cvsweb.tgz
  把配置文件cvsweb.con
f放到安全的地方(比如和apach
e的配置放在同一个目录下),
  修改:cvsweb.cgi让CGI找到配置文件:
  $config = $ENV{'CVSWEB_CONFIG'}
|| '/path/to/apache/conf/cvsweb.conf';
  转到/path/to/apache/conf下并修改cvsweb.conf:
  修改CVSROOT路径设置:
  %CVSROOT = (
  'Development' => '/path/to/cvsroot', #<==修改指向本地的CVSROOT
  );
  缺省不显示已经删除的文档:
  "hideattic" => "1",#<==缺省不显示已经删除的文档
  在配置文件cvsweb.conf中还可以定
要的文字
制页头的描述信息,你可以修改$long_intro成你需

  CVSWEB可不能随便开放给所有用户,因此需要使用WEB用户认证:
  先生成 passwd:
  /path/to/apache/bin/htpasswd -c
cvsweb.passwd user
  修改httpd.conf: 增加
  
  AuthName "CVS Authorization"
  AuthType Basic
  AuthUserFile /path/to/cvsweb.passwd
  require valid-user
  
  CVS TAGS: who? when?
  将$Id$ 加在程序文件开头的注释里
容成:file_name version time user_na
2002/04/05 04:24:12 chedong Exp,可
是一个很好的习惯,cvs能够自动解释更新其中的内
me 的格式,比如:cvs_card.txt,v 1.1
以这些信息了解文件的最后修改人和修改时间
  CVS没有文件锁定模式,VSS在check
out同时,同时记录了文件被导出者锁定。
  CVS的update和commit
, VSS是get_lastest_version
和check in
  对应VSS的check out/u
ndo check out的CVS里是edit和
unedit
  在CVS中,标记自动更新功能缺省是
方式添加binary文件的话在cvs自动更新
打开的,这样也带来一个潜在的问题,就是不用-kb
时可能会导致文件失效。
  $Header$ $Date$这样的标记在Virsu
省是关闭的,需要通过OPITION打开,并
*.txt,*.java,*.html...
al SourceSafe中称之为Keyword Explaination,缺
指定需要进行源文件关键词扫描的文件类型:

  对于Virsual SourceSafe和CVS都通用的TAG有:
  $Header$
  $Author$
  $Date$
  $Revision$
  我建议尽量使用通用的关键词保证代码在CVS和VSS都能方便的跟踪。
  WinCVS
  下载:
  cvs Windows客户端:目前稳定版本为1.2
  http://www.wincvs.org/
  ssh Windows客户端
  http://www.networksimplicity.com
/openssh/
  安装好以上2个软件以后:
  WinCVS客户端的admin==>preference设置
  1 在general选单里
  设置CVSROOT: username@192.168.0
.123:/home/cvsroot
  设置Authorization: 选择SSH server
  2 Port选单里
  钩上:check for alternate rsh name
  并设置ssh.exe的路径
e
,缺省是装在 C:/Program File

s/NetworkSimplicity/ssh/ssh.ex

  然后就可以使用WinCVS进行cvs操作
端的认证密码。
了,所有操作都会跳出命令行窗口要求你输入服务器

  当然,如果你觉得这样很烦的话,还
并设置CVS使用基于公钥/私钥的SSH认证
有一个办法就是生成一个没有密码的公钥/私钥对,
(在general选单里)。
  可以选择的diff工具:examdiff
  下载:
  http://www.prestosof
t.com/examdiff/examdiff.htm
  还是在WinCVS菜单admin==>preference的WinCVS选单里
  选上:Externel diff program
  并设置diff工具的路径,比如:C:/P
rogram Files/ed16i/ExamDiff.exe
  在对文件进行版本diff
时,第一次需要将窗口右下角的
use externel diff选上。
  基于CVSTrac的小组开发环境搭建
  作为一个小组级的开发环境,版本控
何方便的将这些系统集成起来是一个非常
Offsite那样集成度很高的版本控制/BUG
制系统和BUG跟踪系统等都涉及到用户认证部分。如
困难的事情,毕竟我们不能指望Linux下有像Source
跟踪集成系统。
  我个人是很反对使用pserver模式的
户端进行开发的话,总体来说使用CVSROO
理比较麻烦。本来我打算自己用perl写一
界面的BUG跟踪系统,它外挂在CVS系统上
CVSROOT/passwd文件的管理,甚至还集成
远程用户认证的,但如果大部分组员使用WINDOWS客
T/passwd认证还是很难避免的,但CVS本身用户的管
个管理界面的,直到我发现了CVSTrac:一个基于WEB
的BUG跟踪系统,其中就包括了WEB界面的
了WIKIWIKI讨论组功能。
  这里首先说一下CVS的p

server模式下的用户认证,CVS

的用户认证服务是基于inetd中的

  cvspserver stream tcp nowait nob
llow-root=/home/cvsroot pserver
ody /usr/bin/cvs cvs --a

  一般在2401端口
  CVS用户数据库是基于CVSROOT/passwd文件,文件格式:
  [username]:[crypt_password]:[map
ping_system_user]
  由于密码都用的是UNIX
htpasswd格式的扩展(比AP
单的方法可以用
标准的CRYPT加密,这个passwd
ACHE的PASSWD文件多一个系统用

文件的格式基本上是apache的
户映射字段),所以这个文件最简

  apache/bin/htpasswd -b myname my
password
  创建。注意:通过htpasswd创建出来的文件会没有映射系统用户的字段
  例如:
  new:geBvosup/zKl2
  setup:aISQuNAAoY3qw
  test:hwEpz/BX.rEDU
  映射系统用户的目的在
/home/cvsroot目录下的所
号,但开发用户帐号最后的
户新建文件后的对于其他用
于:你可以创建一个专门的CVS
有权限赋予这个用户,然后在pa
文件读写权限都映射为cvs用户
户的文件读写权限问题。
服务帐号,比如叫cvs,并将
sswd文件里创建不同的开发用户帐
,避免了在SSH模式下多个开发用

  进一步的,你可以将用户分别映射到
组的文件互相访问。
2组用户上,利用2个用户的权限设置,避免2个项目

  new:geBvosup/zKl2:proj1
  setup:aISQuNAAoY3qw:proj2
  test:hwEpz/BX.rEDU:proj1
  CVSTrac很好的解决了CVSROOT/passw
WIKIWIKI交流功能等,使用的CGI方式的
d的管理问题,而且包含了BUG跟踪报告系统和集成
安装,并且基于GNU Public License:
  安装过程
  下载:可以从http://www.cvstrac.org 下载
  我用的是已经在Linux
上编译好的应用程序包:cvstra
c-1.1.1.bin.gz,
  %gzip -d cvstrac-1.1.1.bin.gz
  %chmod +x cvstrac-1.1.1.bin
  #mv cvstarc-1.1.1.bin /usr/bin/cvstrac
  初始化cvstrac数据库:假设数据库名是 myproj
  在已经装好的CVS服务
化在/home/cvsroot里),
器上(CVS库这时候应该已经是
运行一下
初始化好了,比如:cvs init初始

  %cvstrac init /home/cvsroot myproj
  运行后,/home/cvsroo
home/cvsroot/myproj.db /
VSROOT/writers /home/cvs
可写的,在RedHat8上,缺
件中设置了用apache用户运
t里会有一个的myproj.db库,使
home/cvsroot/CVSROOT/readers
root/CVSROOT/passwd这几个文
省就有一个叫apache用户和一个
行web服务:
用CVSTRAC服务,/
/home/cvsroot/C
件对于web服务的运行用户应该是
apache组,所以我在httpd.conf文

  User apache
  Group apache,
  如果服务器上apache用的是其他用户
用户/组都设置为nobody nogroup
,比如:nobody nogroup运行,则后面相应的配置中

  然后我设置了#chown -R apache:apa
che /home/cvsroot
  -rw-r--r-- 1 apache
apache 55296 Jan 5 19:40 myp
roj.db
  drwxrwxr-x 3 apache
apache 4096 Oct 24 13:04 CVS
ROOT/
  drwxrwxr-x 2 apache
apache 4096 Aug 30 19:47 som
e_proj/
  此外还在/home/cvsroot/CVSROOT中设置了:
  chmod 664 readers writers passwd
  在apche/cgi-bin目录中创建脚本cvstrac:
  #!/bin/sh
  /usr/bin/cvstrac cgi /home/cvsroot
  设置脚本可执行:
  chmod +x /home/apache/cgi-bin/cvstrac
  从 http://cvs.server .address/cgi-bin/cvstrac/myp
roj 进入管理界面
  缺省登录名:setup 密码 setup
  对于一般用户可以从:
  http://cvs.server.address/cgi-bi
n/cvstrac/myproj
  修改登录密码,进行BUG报告等,
  更多使用细节可以在使用中慢慢了解。
  备注:
  在inetd里加入cvspserver服务:
  cvspserver stream tc
t=/home/cvsroot pserver
p nowait apache /usr/bin/cvs

cvs --allow-roo

  xietd的配置文件:%cat cvspserver
  service cvspserver
  {
  disable = no
  socket_type = stream
  wait = no
  user = apache
  server = /usr/bin/cvs
  server_args = -f --a
llow-root=/home/cvsroot pser
ver
  log_on_failure += USERID
  }
  注意:这里的用户设置成apache目的
个这个用户对/home/cvsroot/下的CVSROO
限。
是和/home/cvsroot的所有用户一致,并且必须让这
T/passwd和cvstrac初始化生成的myproj.db有读取权

  对于前面提到的WinCVS在perference里设置:
  CVSROOT栏输入:usern
ame@ip.address.of.cvs:/home/
cvsroot
  Authenitication选择
:use passwd file on server
side
  就可以了从服务器上导出项目了。
  总结:
  
利用cvs + (WinCVS/cv
制环境。
sweb/cvstrac),构成了一个相

对完善的跨平台工作组开发版本控

内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签: