通过 CVSup 获取源代码

使用匿名 CVS 检索 Postgres 源码树的另一个方法是 CVSup。CVSup 是由 John Polstra 开发的,用于为 FreeBSD 项目 分发 CVS 仓库和其他文件树。

使用 CVSup 的主要优点是它可以可靠地在你的本地机器上复制整个 CVS 仓库,允许快速的本地使用 cvs 操作,象  log 和 diff。其他优点包括与 Postgres 服务器的快速同步,因为它使用一种高效的流传输协议,该协议只传输最后更新(以来)的修改。

准备一个 CVSup 客户端系统

做这件事需要为 CVSup 准备两个目录区域:一个本地 CVS 仓库(或者就是一个目录区域 — 如果你只是抓取一个快照而不是整个仓库;见下文)和一个本地CVSup 簿记区域。这些东西可以在同一个目录树里面共存。

确定你将在哪个目录里面安放你的 CVS 仓库的本地拷贝。在我们的一个系统中,我们最近在 /home/cvs/ 设立了仓库,但是以前我们把它放在 /opt/postgres/cvs/ 里的一个 Postgres 开发版的目录树里。如果你想把你的仓库放在 /home/cvs/ 那么把

setenv CVSROOT /home/cvs
放到你的 .cshrc 文件,或者根据你用的 shell 把类似的行放到你的 .bashrc 或 .profile 文件里。

cvs 仓库区域必须被初始化。一旦设置了 CVSROOT,那么初始化可以简单地用下面的命令完成:
 

$ cvs init
之后,你列举 CVSROOT 目录时,你至少能看到一个名为 CVSROOT 的目录。
$ ls $CVSROOT
CVSROOT/

运行 CVSup 客户端

先证实 cvsup 在你的路径里;在大多数系统上你可以键入下面命令核实这些
which cvsup
然后,只需要用下面命令运行 cvsup :
$ cvsup -L 2 postgres.cvsup
这里的 -L 2 打开了一些状态消息,这样你就可以监控更新的进展过程,而 postgres.cvsup 是你赋予你的 CVSup 配置文件的路径和名称。

这里是一份为特定安装修改过的 CVSup 配置文件,它维护着一个完整的本地 CVS 仓库:

# This file represents the standard CVSup distribution file
# for the PostgreSQL ORDBMS project
# Modified by lockhart@alumni.caltech.edu 1997-08-28
# - Point to my local snapshot source tree
# - Pull the full CVS repository, not just the latest snapshot
#
# Defaults that apply to all the collections
*default host=postgresql.org
*default compress
*default release=cvs
*default delete use-rel-suffix
# enable the following line to get the latest snapshot
#*default tag=.
# enable the following line to get whatever was specified above or by default
# at the date specified below
#*default date=97.08.29.00.00.00

# base directory points to where CVSup will store its 'bookmarks' file(s)
# will create subdirectory sup/
#*default base=/opt/postgres # /usr/local/pgsql
*default base=/home/cvs

# prefix directory points to where CVSup will store the actual distribution(s)
*default prefix=/home/cvs

# complete distribution, including all below 
pgsql

# individual distributions vs 'the whole thing'
# pgsql-doc
# pgsql-perl5
# pgsql-src

下面的是 Postgres ftp 站点 建议的 CVSup 配置文件,它将只是抓取目前(版本)的快照:
# This file represents the standard CVSup distribution file
# for the PostgreSQL ORDBMS project
#
# Defaults that apply to all the collections
*default host=postgresql.org
*default compress
*default release=cvs
*default delete use-rel-suffix
*default tag=.

# base directory points to where CVSup will store its 'bookmarks' file(s)
*default base=/usr/local/pgsql

# prefix directory points to where CVSup will store the actual distribution(s)
*default prefix=/usr/local/pgsql

# complete distribution, including all below 
pgsql

# individual distributions vs 'the whole thing'
# pgsql-doc
# pgsql-perl5
# pgsql-src

安装 CVSup

CVSup 可以以源代码的形式、制作好了的二进制形式、或者 Linux RPM 的形式获得。使用二进制的形式要远比从源代码里面制作要容易得多,主要是因为编译需要高效但是庞大的 Modula-3 编译器。
 
从二进制安装 CVSup

如果你拥有一个在 Postgresftp 站点 里贴出来的平台,或者你正在运行 FreeBSD,你就可以使用制作好了的二进制形式,这时候CVSup 是以一个已移植好了的形式获得的。

注意:CVSup 最初是作为一个用于分发 FreeBSD 源码树的工具开发的。对于那些运行 FreeBSD 的人来说,它可以当作 "port"(移植)获取,如果这些描述不足以说明如何获取和安装它的问题,那么请为我们在这里贡献一个过程。
在写作这些的时候,可以获得下面平台的二进制 Alpha/Tru64,ix86/xBSD,HPPA/HPUX-10.20,MIPS/irix,ix86/linux-libc5,ix86/linux-glibc,Sparc/Solaris 和 Sparc/SunOS。
    检索适合你的平台的 cvsup (做客户端不需要 cvsupd)二进制文件。
     
      如果你用 FreeBSD,安装 CVSup 移植。

      如果你使用其他平台,在 Postgresftp 站点上 找出并下载适合你的二进制文件。
       

    如果需要,检查 tar 文以核实内容和目录结构。至少对于 linux 的 tar 文件而言,静态二进制和 手册页是不包括任何目录包信息的。
     
      如果二进制在 tar 文件的顶层,那么只需要把他们解包到你的目标目录里面:
      $ cd /usr/local/bin
      $ tar zxvf /usr/local/src/cvsup-16.0-linux-i386.tar.gz
      $ mv cvsup.1 ../doc/man/man1/
      如果 tar 文件里面有一个目录结构,那么把 tar 文件解包到 /usr/local/src 里,然后把二进制移动到上面对应的合适路径里。
    确保新的二进制在你的路径里。
    $ rehash
    $ which cvsup
    $ set path=(path to cvsup $path)
    $ which cvsup
    /usr/local/bin/cvsup

从源代码安装

从源代码安装 CVSup 并不是易如反掌的,主要是因为大多数系统将需要先安装一个 Modula-3 编译器。这个编译器可以以 Linux RPM、FreeBSD 的包或者源代码的形式获得。
注意:一个 Modula-3 的净代码安装大约需要 200MB 磁盘空间,当把源代码删除后大约只有 50MB。
Linux 安装
    安装 Modula-3.
      从 Polytechnique Montr閍l 获取 Modula-3 发布,他们还在积极地维护着基于 DEC 系统研究中心 的代码。“PM3” RPM 版本压缩后大约 30MB。在我们写作的时候,1.1.10-1 版在 RH-5.2 上干净利落的安装好了,而 1.1.11-1 版本显然是为另外一个版本(RH-6.0?)制作的,无法在 RH-5.2 上运行。
      小技巧:这些 rpm 包有许多RPM 文件,因此你可能会喜欢把它们放在独立的一个目录里。
      安装 Modula-3 rpm:
      # rpm -Uvh pm3*.rpm
    解包 cvsup 版本:
    # cd /usr/local/src
    # tar zxf cvsup-16.0.tar.gz
    制作 cvsup 的发布版,禁止 GUI 界面以避免要求 X11 库:
    # make M3FLAGS="-DNOGUI"
    如果你想制作一个静态的二进制以便于装到一个没有安装 Modula-3 的系统,用:
    # make M3FLAGS="-DNOGUI -DSTATIC"
    安装制作好了的二进制:
    # make M3FLAGS="-DNOGUI -DSTATIC" install
�