歡迎來到Linux教程網
Linux教程網
Linux教程網
Linux教程網
您现在的位置: Linux教程網 >> UnixLinux >  >> Linux綜合 >> Linux資訊 >> Linux文化

CVS的常用命令速查手冊


最後更新:2002-08-30 13:18:41

版權聲明:可以任意轉載,轉載時請務必標明原始出處和作者信息

概述:CVS是一個C/S系統,多個開發人員通過一個中心版本控制系統來記錄文件版本,從而達到保證文件同步的目的。

       CVS服務器(文件版本庫)
     /     |       \
(版 本 同 步)
   /       |         \  
開發者1  開發者2   開發者3

以下是本文主要內容:開發人員可以主要挑選2, 6看就可以了,CVS的管理員則更需要懂的更多一些

CVS環境初始化:CVS環境的搭建                                          管理員 CVS的日常使用:日常開發中最常用的CVS命令,              開發人員      管理員 CVS的分支開發:項目按照不同進度和目標並發進行                         管理員 CVS的用戶認證:通過SSH的遠程用戶認證,安全,簡單                      管理員 CVSWEB:CVS的WEB訪問界面大大提高代碼版本比較的效率                    管理員 CVS TAG:將$Id$加入代碼注釋中,方便開發過程的跟蹤       開發人員 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:[email protected]#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
<<<<<<
content in your file
>>>>>>
標記出來,由你確認沖突內容的取捨。
版本沖突一般是在多個人修改一個文件造成的,但這種項目管理上的問題不應該指望由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:[email protected]#port:/path/to/cvsroot CVS_RSH=ssh; export CVSROOT CVS_RSH
所有客戶機所有本地用戶都可以映射到CVS服務器相應同名帳號了。

如果CVS所在服務器的SSH端口不在缺省的22,或者和客戶端與CVS服務器端SSH缺省端口不一致,有時候設置了:
:ext:[email protected]#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:

修改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: 增加
<Directory "/path/to/apache/cgi-bin/cvsweb/">
AuthName "CVS Authorization"
AuthType Basic
AuthUserFile /path/to/cvsweb.passwd
require valid-user
</Directory>

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
<?php
/*
* Copyright (c) 2002 Company Name.
* $Header$
*/

?>

====================================
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


摘自:http://www.chedong.com/tech/cvs_card.html


Copyright © Linux教程網 All Rights Reserved