Git
English ▾ 主题 ▾ 最新版本 ▾ 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 的行为。如果您想导入到不同的分支，请使用此选项。

对于继续由旧的 cvs2git 工具最初完成的导入，请使用 -o master。

-i

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

-k

删除关键字：将使用 -kk 从 CVS 存档中提取文件，以避免出现噪音变化集。强烈推荐，但默认情况下关闭以保持与早期导入的树的兼容性。

-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 <[email protected]>
	spawn=Simon Pawn <[email protected]> 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 将包含错误的内容。

  • 如果不同文件的 timestamps 顺序与在匹配时间的提交中的修订号顺序交叉，则提交顺序可能不正确。

与分支相关的问题

  • 未对任何提交进行过分支将不会导入。

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

  • 这适用于在创建子分支后添加到源分支中的文件：如果之前未对子分支进行过提交，则它们将错误地添加到 git 中的子分支中。

与标签相关的问题

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

如果您怀疑任何这些问题可能适用于您要导入的存储库，请考虑使用 cvs2git

  • cvs2git（cvs2svn 的一部分），https://subversion.org.cn/

GIT

是 git[1] 套件的一部分

scroll-to-top