CVS 簡單教程
v2.1
版權聲明：本文檔遵循 FDL 版權發布，有關 FDL 的詳細信息，請參考：
http://www.fsf.org/copyleft/fdl.html
何偉平
CVS 是 Concurrent VersionSystem（并行版本系統）的縮寫，用于版本管理．如果大家曾經參與過多人協作開發的項目，大家肯定有這樣的痛苦經歷：由于多個人同時修改同一個文件，自己辛辛苦苦修改的程序被別人徹底刪除了．另外，如果你的軟件/程序已經發布了三個版本，而這時候用戶需要你修改第二個版本的東西，也許你會因為只保留了最新版本而痛哭流涕．還有就是你對程序做了一些修改，但是修改很少，你只想給遠方的同事發一個兩個版本之間的差別文件，這樣可以免于郵箱不夠大，網速太慢之類的問題．為了解決類似這樣的問題，以及諸如生成補丁文件，歷史版本修改等，一幫黑客（褒義）在原先 Unix 體系里很成熟的 SCCS 和RCS 的基礎上，開發了 CVS．（SCCS：Source Code Control System，RCS：Revision ControlSystem）
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就能工作得很好），要一定的磁盤空間，看你的項目的大小和多少而定．
- 建立 CVSROOT 目錄，因為這里涉及到用戶對CVSROOT里的文件讀寫的權限問題，所以比較簡單的方法是建立一個組，然后再建立一個屬于該組的帳戶，而且以后有讀寫權限的用戶都要屬于該組．假設我們建一個組叫cvs，用戶名是cvsroot．建組和用戶的命令如下
- #groupadd cvs
#adduser 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 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
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
文章來源于領測軟件測試網 http://www.kjueaiud.com/
