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