Git
简体中文 ▾ Topics ▾ Latest version ▾ git-cvsserver last updated in 2.43.0

名称

git-cvsserver - A CVS server emulator for Git

概述

{BASH_GNLV3_AMP}

export CVS_SERVER="git cvsserver"
cvs -d :ext:user@server/path/repo.git co <HEAD 名称>

pserver (/etc/inetd.conf):

cvspserver stream tcp nowait nobody /usr/bin/git-cvsserver git-cvsserver pserver

Usage:

git-cvsserver [<多个选项>] [pserver|server] [<目录> …​]

描述

该程序是 Git 的 CVS 仿真层。

它的功能性很强。然而，并非所有方法都能实现，而对于那些已实现的方法，并非所有开关都能实现。

测试使用 CLI CVS 客户端和 Eclipse CVS 插件进行。大多数功能在这两个客户端上都能正常运行。

选项

所有这些选项显然只有在服务器端执行时才有意义。 这些选项的实现尽可能与 git-daemon[1] 选项相似。

--base-path <path>

在请求的 CVSROOT 前加上 ‘路径’

--strict-paths

不允许递归到子目录中

--export-all

不要在配置中检查 gitcvs.enabled。如果要使用此选项，还必须指定允许使用的目录列表（见下文）。

-V
--version

Print version information and exit

-h
-H
--help

打印使用信息并退出

<directory>

其余参数提供了一个目录列表。如果没有给出目录，则允许所有目录。除非指定了 --export-all，否则这些目录中的仓库仍需要使用 gitcvs.enabled 配置选项。

局限

CVS 客户端不能标记、分支或执行 Git 合并。

git-cvsserver maps Git branches to CVS modules. This is very different from what most CVS users would expect since in CVS modules usually represent one or more directories.

INSTALLATION

  1. 如果要通过 pserver 提供 CVS 访问，请在 /etc/inetd.conf 中添加一行，如

       cvspserver stream tcp nowait nobody git-cvsserver pserver

    注意：有些 inetd 服务器允许您独立于 argv[0] 的值（即程序假定执行的名称）指定可执行文件的名称。在这种情况下，/etc/inetd.conf 中的正确行应如下所示

       cvspserver stream tcp nowait nobody /usr/bin/git-cvsserver git-cvsserver pserver

    pserver 默认只提供匿名访问。要提交您必须创建的 pserver 账户，只需在您希望 cvsserver 允许写入的软件源的配置文件中添加 gitcvs.authdb 设置即可，例如:

       [gitcvs]
	authdb = /etc/cvsserver/passwd

    例如，这些文件的格式是用户名，然后是加密密码:

       myuser:sqkNi8zPf01HI
   myuser:$1$9K7FzU28$VfF6EoPYCJEYcVQwATgOP/
   myuser:$5$.NqmNH1vwfzGpV8B$znZIcumu1tNLATgV2l6e1/mY8RzhUDHMOaVOeL1cxV3

    您可以使用 Apache 自带的 htpasswd 工具来创建这些文件，但只能使用 -d 选项（如果您的系统支持 -B）。

    最好使用在您的平台上管理密码哈希创建的特定系统实用程序（例如 Linux 中的 mkpasswd、OpenBSD 中的 encrypt 或 NetBSD 中的 pwhash），然后将其粘贴到正确的位置。

    然后通过 pserver 方法提供密码，例如:

       cvs -d:pserver:someuser:somepassword@server:/path/repo.git co <HEAD_name>

    SSH 访问无需特殊设置，只需在 PATH 中安装 Git 工具即可。如果客户端不接受 CVS_SERVER 环境变量，可以将 git-cvsserver 更名为 cvs。

    注意：较新的 CVS 版本（>= 1.12.11）也支持直接在 CVSROOT 中指定 CVS_SERVER，如

       cvs -d ":ext;CVS_SERVER=git cvsserver:user@server/path/repo.git" co <HEAD_name>

    这样做的好处是，它将保存在你的 CVS/Root 文件中，你不必担心总是设置正确的环境变量。 受限于 git-shell 的 SSH 用户不需要（也不应该）用 CVS_SERVER 覆盖默认值，因为 git-shell 会将 cvs 理解为 git-cvsserver，并假装另一端运行的是真正的 cvs。

  2. 对于希望从 CVS 访问的每个仓库，都需要在仓库中编辑配置并添加以下部分。

       [gitcvs]
        enabled=1
        # optional for debugging
	logFile=/path/to/logfile

    注意：需要确保每个调用 git-cvsserver 的用户都有写入日志文件和数据库的权限（参见 数据库后台）。如果要通过 SSH 提供写访问权限，用户当然也需要有写访问 Git 仓库本身的权限。

    你还需要确保每个仓库都是 "裸仓库"（没有 Git 索引文件），这样 cvs commit 才能工作。参见 gitcvs-migration[7]。

    所有配置变量都可以针对特定的访问方法进行重载。有效的方法名称是 "ext"（用于 SSH 访问）和 "pserver"。下面的配置示例将禁止 pserver 访问，但仍允许通过 SSH 访问。

       [gitcvs]
        enabled=0

   [gitcvs "ext"]
        enabled=1

  3. 如果您没有在签出命令中直接指定 CVSROOT/CVS_SERVER，而是将其自动保存在 CVS/Root 文件中，那么您就需要在环境中明确设置它们。 CVSROOT 应按常规设置，但目录应指向相应的 Git 仓库。 如上所述，对于不受限于 git-shell 的 SSH 客户端，CVS_SERVER 应设置为 git-cvsserver。

       export CVSROOT=:ext:user@server:/var/git/project.git
   export CVS_SERVER="git cvsserver"

  4. 对于会进行提交的 SSH 客户端，请确保其服务器端的 .ssh/environment 文件（或 .bashrc 等，根据其特定的 shell）导出了适当的 GIT_AUTHOR_NAME、GIT_AUTHOR_EMAIL、GIT_COMMITTER_NAME 和 GIT_COMMITTER_EMAIL 值。 对于登录 shell 为 bash 的 SSH 客户端，.bashrc 可能是一个合理的替代方案。

  5. 客户现在应该可以签出项目了。使用 CVS module（模块）名称来指明你要签出的 Git head（头）。 这也会设置新签出目录的名称，除非你用 -d <目录名> 另作说明。 例如，这将签出 master 分支到 project-master 目录：

       cvs co -d project-master master

数据库后台

git-cvsserver uses one database per Git head (i.e. CVS module) to store information about the repository to maintain consistent CVS revision numbers. The database needs to be updated (i.e. written to) after every commit.

如果直接使用 git（而不是使用 git-cvsserver）提交，则更新需要在下一次使用 git-cvsserver 访问仓库时进行，与访问方式和请求的操作无关。

这就意味着，即使只提供读取访问权限（例如使用 pserver 方法），git-cvsserver 也必须拥有对数据库的写入访问权限，才能可靠地工作（否则就需要确保在执行 git-cvsserver 的任何时候数据库都是最新的）。

默认情况下，它使用 Git 目录中的 SQLite 数据库，名为 gitcvs.<模块名>.sqlite。请注意，SQLite 后端在写入时会在与数据库文件相同的目录下创建临时文件，因此只授予使用 git-cvsserver 的用户对数据库文件的写入权限，而不授予他们对目录的写入权限可能是不够的。

跟踪的分支发生变化后，数据库无法以一致的形式可靠地重新生成。 例如对于合并的分支，git-cvsserver 只能跟踪一个开发分支，而在 git merge 之后，增量更新的数据库可能会与从头开始生成的数据库跟踪不同的分支，从而导致 CVS 版本号不一致。如果在合并前增量运行，git-cvsserver 无法知道自己会选择哪个分支。因此，如果你必须全部或部分（从旧备份）重新生成数据库，你就应该对已经存在的 CVS 沙箱有所怀疑。

您可以使用以下配置变量配置数据库后台：

配置数据库后台

git-cvsserver uses the Perl DBI module. Please also read its documentation if changing these variables, especially about DBI->connect().

gitcvs.dbName

数据库名称。具体含义取决于所选的数据库驱动程序，对于 SQLite，这是一个文件名。 支持变量替换（见下文）。不得包含分号 (;)。 默认：%Ggitcvs.%m.sqlite

gitcvs.dbDriver

使用的 DBI 驱动程序。cvsserver 已使用 DBD::SQLite 进行了测试，据报告可使用 DBD::Pg，但*不*能使用 DBD::mysql。 请将其视为试验性功能。不得包含冒号 (:)。 默认：SQLite

gitcvs.dbuser

数据库用户。只有在设置 dbDriver 时才有用，因为 SQLite 没有数据库用户的概念。支持变量替换（见下文）。

gitcvs.dbPass

数据库密码。 只有在设置 dbDriver 时才有用，因为 SQLite 没有数据库密码的概念。

gitcvs.dbTableNamePrefix

数据库表名前缀。 支持变量替换（见下文）。 任何非字母字符都将用下划线代替。

所有变量也可按访问方法设置，请参阅上文。

变量替换

在 dbDriver 和 dbUser 中，可以使用以下变量：

%G

Git 目录名称

%g

Git 目录名称，其中除字母数字、. 和 - 之外的所有字符均替换为 _（这样可以方便在文件名中使用该目录名称）

%m

CVS 模块/Git 头名称

%a

访问方法（"ext" 或 "pserver" 之一）

%u

运行 git-cvsserver 的用户名。 如果无法确定用户名，则使用数字 uid。

环境变量

在某些情况下，这些变量省去了命令行选项，从而可以通过 git-shell 更方便地限制使用。

GIT_CVSSERVER_BASE_PATH

该变量取代 --base-path 的参数。

GIT_CVSSERVER_ROOT

该变量指定了一个单一目录，取代了 <目录>... 参数列表。除非指定了 --export-all，否则仓库仍需要使用 gitcvs.enabled 配置选项。

设置这些环境变量后，可能无法使用相应的命令行参数。

ECLIPSE CVS 客户端说明

使用 Eclipse CVS 客户端进行签出：

  1. 选择 "创建新项目 → 从 CVS 签出"

  2. 创建新位置。有关如何选择正确协议的详细信息，请参阅下面的说明。

  3. 浏览可用的 "模块"。它将为你提供一份软件源中的模块头列表。在这里，你无法浏览模块树。只能浏览头部。

  4. 在询问要签出哪个分支/标记时，选择 HEAD。取消勾选 "launch commit wizard" （登录后提交）以避免提交 .project 文件。

协议说明：如果通过 pserver 使用匿名访问，只需选择该协议即可。 使用 SSH 访问的用户应选择 ext 协议，并在 偏好设置→团队→CVS→外部连接 窗格中配置 ext 访问。将 CVS_SERVER 设置为 "git cvsserver"。请注意，使用 ext 时不支持密码，因此一定要设置 SSH 密钥。

或者，你也可以使用 Eclipse 提供的非标准 extssh 协议。在这种情况下，CVS_SERVER 会被忽略，你必须用 git-cvsserver 替换服务器上的 cvs 工具，或者修改你的 .bashrc 以便调用 cvs 时能有效地调用 git-cvsserver。

已知工作的客户

  • 在 Debian 上的 CVS 1.12.9

  • MacOSX 上的 CVS 1.11.17（来自 Fink 软件包）

  • MacOSX 上的 Eclipse 3.0、3.1.2（参见 Eclipse CVS 客户端说明）

  • TortoiseCVS

支持的业务

支持正常使用所需的所有操作，包括签出、差异、状态、更新、日志、添加、删除、提交。

大多数 CVS 命令参数都能读取 CVS 标签或版本号（通常是 -r），而且还支持任何 git refspec（标签、分支、提交 ID 等）。 不过，非默认分支的 CVS 版本号并不能很好地模拟，而且 cvs log 根本不会显示标签或分支。 (非主分支的 CVS 版本号表面上与 CVS 版本号相似，但实际上它们直接编码了 git 的提交 ID，而不是代表自分支点以来的修订次数。）

请注意，有两种方法可以检出特定分支。 正如本页其他地方所述，cvs checkout 的 "模型" 参数会被解释为分支名称，并成为主分支。 即使使用 cvs update -r 将另一个分支暂时置为主干分支，它仍是指定沙盒的主干分支。 或者，-r 参数也可以指示实际签出的其他分支，即使模块仍是 "主" 分支。 权衡（目前的实现方式）：每个新的 "模块" 都会在磁盘上创建一个新的数据库，其中包含给定模块的历史记录。 或者，-r 不会占用任何额外的磁盘空间，但在许多操作（如 cvs 更新）上可能会明显慢一些。

如果要引用的 git refspec 包含 CVS 不允许的字符，有两种选择。 首先，直接向相应的 CVS -r 参数提供 git refspec 可能行得通；有些 CVS 客户端似乎不会对参数进行太多的正确性检查。 其次，如果方法失败，可以使用一种特殊的字符转义机制，它只使用 CVS 标记中有效的字符。 由 4 或 5 个字符（下划线 ("_") 、破折号 ("-")、一个或两个字符和破折号 ("-")）组成的序列可以根据一个或两个字母编码各种字符："s"`表示斜线 ("/")，"p"表示句号 (".")，"u"` 表示下划线 ("_")，或者两个十六进制数字表示任何字节值（通常是 ASCII 数字，也可能是 UTF-8 编码字符的一部分）。

不支持传统的监控操作（编辑、监视和相关）。 现阶段不支持导出和标记（标记和分支）。

CRLF 行尾转换

默认情况下，服务器会将所有文件的 -k 模式留空，这将导致 CVS 客户端将这些文件视为文本文件，并在某些平台上进行行尾转换。

通过设置 gitcvs.usecrlfattr 配置变量，可以让服务器使用行尾转换属性来设置文件的 k 模式。 有关行尾转换的更多信息，请参阅 gitattributes[5]。

另外，如果未启用 gitcvs.usecrlfattr 配置或属性不允许自动检测文件名，则服务器将使用 gitcvs.allBinary 配置作为默认设置。 如果设置了 gitcvs.allBinary，则未指定的文件将默认为 -kb 模式。否则，-k 模式将留空。但如果将 gitcvs.allBinary 设置为 "guess"（猜测），则将根据文件内容猜测正确的 k 模式。

为了与 cvs 保持一致，最好将 gitcvs.usecrlfattr 设为 true，将 gitcvs.allBinary 设为 "guess"，从而覆盖默认值。

依赖

git-cvsserver depends on DBD::SQLite.

GIT

属于 git[1] 文档

scroll-to-top