简体中文 ▾ 主题 ▾ 最新版本 ▾ git-cvsimport 最后更新于 2.43.1

名称

git-cvsimport - 从另一个 SCM 中挽救你的数据，人们喜欢憎恨它

概要

git cvsimport [-o <branch-for-HEAD>] [-h] [-v] [-d <CVSROOT>]
	      [-A <author-conv-file>] [-p <options-for-cvsps>] [-P <file>]
	      [-C <git-repository>] [-z <fuzz>] [-i] [-k] [-u] [-s <subst>]
	      [-a] [-m] [-M <regex>] [-S <regex>] [-L <commit-limit>]
	      [-r <remote>] [-R] [<CVS-module>]

描述

警告： git cvsimport 使用 cvsps 版本 2，该版本被认为是过时的；它不适用于 cvsps 版本 3 及更高版本。如果你正在进行一次性的 CVS 存储库导入，请考虑使用 cvs2git 或 cvs-fast-export。

将 CVS 存储库导入 Git。它将创建一个新存储库，或以增量方式导入到现有存储库中。

将 CVS 日志分割成补丁集由 cvsps 完成。至少需要版本 2.1。

警告： 在某些情况下，导入会导致不正确的结果。请参阅 问题 部分以获取进一步参考。

你 **永远不应该** 在 git cvsimport 创建的分支上进行任何自己的工作。默认情况下，初始导入将从 CVS 存储库的主分支创建并填充一个“master”分支，你可以自由地在此分支上工作；之后，你需要自己 git merge 增量导入或任何 CVS 分支。建议通过 -r 指定一个命名远程，以区分和保护传入的分支。

如果你打算设置一个所有开发人员都可以读/写的共享公共存储库，或者你想使用 git-cvsserver[1]，那么你可能想做一个导入存储库的裸克隆，并使用该克隆作为共享存储库。参见 gitcvs-migration[7]。

选项

-v

详细程度：让 cvsimport 报告它正在做什么。

-d <CVSROOT>

CVS 存档的根目录。可以是本地的（一个简单的路径）或远程的；目前，只支持 :local:, :ext: 和 :pserver: 访问方法。如果未给出，git cvsimport 将尝试从 CVS/Root 读取。如果不存在这样的文件，它会检查 CVSROOT 环境变量。

<CVS-module>

你想要导入的 CVS 模块。相对于 <CVSROOT>。如果未给出，git cvsimport 尝试从 CVS/Repository 读取。

-C <target-dir>

要导入到的 Git 存储库。如果目录不存在，它将被创建。默认为当前目录。

-r <remote>

要将此 CVS 存储库导入到的 Git 远程。将所有 CVS 分支移动到 remotes/<remote>/<branch>，类似于 git clone 默认使用 origin 的方式。

-o <branch-for-HEAD>

当没有指定远程（通过 -r）时，CVS 的 HEAD 分支被导入到 Git 存储库内的 origin 分支，因为 HEAD 对于 Git 已经有特殊含义。当指定了远程时，HEAD 分支被命名为 remotes/<remote>/master，镜像 git clone 的行为。如果你想导入到不同的分支，请使用此选项。

使用 -o master 继续最初由旧的 cvs2git 工具进行的导入。

-i

仅导入：导入后不执行签出。此选项确保工作目录和索引保持不变，如果它们不存在，也不会创建它们。

-k

删除关键字：将从 CVS 存档中提取 -kk 文件，以避免不必要的更改集。强烈推荐，但默认关闭以保持与早期导入树的兼容性。

-u

将标签和分支名称中的下划线转换为点。

-s <subst>

将分支名称中的字符 "/" 替换为 <subst>。

-p <options-for-cvsps>

cvsps 的附加选项。选项 -u 和 -A 是隐式的，不应在此处使用。

如果你需要传递多个选项，请用逗号分隔它们。

-z <fuzz>

将时间戳模糊因子（以秒为单位）传递给 cvsps。如果未设置，cvsps 默认为 300 秒。

-P <cvsps-output-file>

不调用 cvsps，而是读取提供的 cvsps 输出文件。用于调试或当 cvsps 由 cvsimport 外部处理时。

-m

尝试根据提交消息检测合并。此选项将启用默认的正则表达式，这些正则表达式会尝试从提交消息中捕获源分支名称。

-M <regex>

尝试根据提交消息和自定义正则表达式检测合并。它也可以与 -m 一起使用以启用默认的正则表达式。你必须转义斜杠。

正则表达式必须捕获源分支名称在 $1 中。

此选项可以多次使用以提供多个检测正则表达式。

-S <regex>

跳过与正则表达式匹配的路径。

-a

导入所有提交，包括最近的提交。cvsimport 默认会跳过时间戳在 10 分钟前的提交。

-L <limit>

限制导入的提交数量。用于解决 cvsimport 内存泄漏的情况。

-A <author-conv-file>

CVS 默认在写入其提交日志时使用 Unix 用户名。使用此选项和一个 author-conv-file 将 CVS 中记录的名称映射到作者姓名、电子邮件和可选的时区。

	exon=Andreas Ericsson <ae@op5.se>
	spawn=Simon Pawn <spawn@frog-pond.org> America/Chicago

git cvsimport 将使其看起来好像这些作者一直设置了正确的 GIT_AUTHOR_NAME 和 GIT_AUTHOR_EMAIL。如果指定了时区，GIT_AUTHOR_DATE 将应用相应的偏移量。

为方便起见，每次提供 -A 选项时，这些数据都会保存到 $GIT_DIR/cvs-authors，并且每次运行 git cvsimport 时都会从该文件中读取。

如果你打算稍后使用 git cvsexportcommit 将更改导出回 CVS，则不建议使用此功能。

-R

生成一个 $GIT_DIR/cvs-revisions 文件，其中包含从 CVS 修订号到新创建的 Git 提交 ID 的映射。生成的文件将包含每个（文件名，修订号）对的导入行；每行看起来像

src/widget.c 1.1 1d862f173cdc7325b6fa6d2ae1cfd61fd1b512b7

如果文件已存在，则将修订数据追加到该文件中，用于进行增量导入。

如果你在提交消息、错误跟踪系统、电子邮件存档等中存储了 CVS 修订号，此选项可能很有用。

-h

打印一个简短的用法消息并退出。

输出

如果指定了 -v，脚本会报告它正在做什么。

否则，成功将以 Unix 的方式指示，即通过简单地以零退出状态退出。

问题

与时间戳相关的问题

  • 如果 CVS 存储库中的提交时间戳不够稳定，无法用于排序提交，则更改可能会以错误的顺序显示。

  • 如果任何文件曾被“cvs import”超过一次（例如，导入多个供应商发布），则 HEAD 包含错误的内容。

  • 如果不同文件的顺序时间戳交叉了提交匹配时间窗口内的修订顺序，则提交的顺序可能错误。

与分支相关的问题

  • 未提交任何提交的分支不会被导入。

  • 来自分支点的所有文件都会添加到分支，即使它们从未在 CVS 中添加。

  • 这适用于在创建子分支 **之后** 添加到源分支的文件：如果之前在子分支上没有进行任何提交，它们将错误地添加到 Git 中的子分支。

与标签相关的问题

  • 同一修订上的多个标签不会被导入。

如果你怀疑这些问题中的任何一个可能适用于你想导入的存储库，请考虑使用 cvs2git。

  • cvs2git (cvs2svn 的一部分)，https://subversion.org.cn/

GIT

Git[1] 套件的一部分