设置和配置
获取和创建项目
基本快照
分支与合并
共享和更新项目
检查和比较
打补丁
调试
电子邮件
外部系统
服务器管理
指南
管理
底层命令
- 2.48.1 → 2.50.1 无更改
-
2.48.0
2025-01-10
- 2.44.1 → 2.47.3 无变化
-
2.44.0
2024-02-23
- 2.43.1 → 2.43.7 无更改
-
2.43.0
2023-11-20
- 2.42.1 → 2.42.4 无更改
-
2.42.0
2023-08-21
- 2.36.1 → 2.41.3 无更改
-
2.36.0
2022-04-18
- 2.34.1 → 2.35.8 无更改
-
2.34.0
2021-11-15
- 2.31.1 → 2.33.8 无变化
-
2.31.0
2021-03-15
- 2.29.1 → 2.30.9 无变更
-
2.29.0
2020-10-19
- 2.28.1 无更改
-
2.28.0
2020-07-27
- 2.18.1 → 2.27.1 无变化
-
2.18.0
2018-06-21
- 2.17.1 → 2.17.6 无更改
-
2.17.0
2018-04-02
- 2.12.5 → 2.16.6 无变化
-
2.11.4
2017-09-22
- 2.1.4 → 2.10.5 无更改
-
2.0.5
2014-12-17
概要
git index-pack [-v] [-o <index-file>] [--[no-]rev-index] <pack-file> git index-pack --stdin [--fix-thin] [--keep] [-v] [-o <index-file>] [--[no-]rev-index] [<pack-file>]
描述
从指定文件读取打包存档 (.pack),为其构建一个 pack 索引文件 (.idx),并可选择为指定 pack 写入一个反向索引 (.rev)。打包存档与 pack 索引一起,可以放置在 Git 仓库的 objects/pack/ 目录下。
选项
- -v
-
详细说明正在进行的操作,包括进度状态。
- -o <index-file>
-
将生成的 pack 索引写入指定文件。如果未指定此选项,pack 索引文件的名称将通过将打包存档文件名称中的 .pack 替换为 .idx 来构建(如果打包存档的名称不以 .pack 结尾,程序将失败)。
- --[no-]rev-index
-
提供此标志时,生成与给定 pack 对应的反向索引(一个
.rev
文件)。如果指定了--verify
,则确保现有反向索引是正确的。此项优先于pack.writeReverseIndex
。 - --stdin
-
提供此标志时,pack 将从标准输入读取,然后将副本写入 <pack-file>。如果未指定 <pack-file>,则 pack 将写入当前 Git 仓库的 objects/pack/ 目录,名称根据 pack 内容确定。如果未指定 <pack-file>,请考虑使用 --keep 来防止此进程与 git repack 之间出现竞争条件。
- --fix-thin
-
通过将增量化对象所基于的排除对象添加到 pack 中,修复由
git
pack-objects
--thin
生成的“瘦” pack(详见 git-pack-objects[1])。此选项仅在与 --stdin 结合使用时才有意义。 - --keep
-
在将索引移动到最终目的地之前,为关联的 pack 文件创建一个空的 .keep 文件。此选项通常与 --stdin 一起使用,以防止同时进行的 git repack 进程在引用更新以使用 pack 中包含的对象之前删除新构建的 pack 和索引。
- --keep=<msg>
-
与 --keep 类似,在将索引移动到最终目的地之前创建 .keep 文件。但是,不创建空文件,而是将 <msg> 后跟一个 LF 放入 .keep 文件中。稍后可以在所有 .keep 文件中搜索 <msg> 消息,以找到任何已失去其用途的文件。
- --index-version=<version>[,<offset>]
-
此选项仅供测试套件使用。它允许强制生成 pack 索引的版本,并强制对位于给定偏移量之上的对象使用 64 位索引条目。
- --strict[=<msg-id>=<severity>…]
-
如果 pack 包含损坏的对象或链接,则终止。可以传递一个可选的逗号分隔的 <msg-id>
=
<severity> 列表,以更改某些可能问题的严重性,例如,--strict="missingEmail=ignore,badTagName=error"
。有关 <msg-id> 和 <severity> 可能值的更多信息,请参阅 git-fsck[1] 中fsck.
<msg-id> 配置选项的条目。 - --progress-title
-
仅供内部使用。
设置进度条的标题。标题默认为“接收对象”,当指定
--stdin
时为“索引对象”。 - --check-self-contained-and-connected
-
如果 pack 包含损坏的链接,则终止。仅供内部使用。
- --fsck-objects[=<msg-id>=<severity>…]
-
如果 pack 包含损坏的对象,则终止;但与
--strict
不同,不会因损坏的链接而终止。如果 pack 包含指向不存在的 .gitmodules blob 的树,则在 pack/idx 文件名中的哈希之后打印该 blob 的哈希(供调用者检查)(参见“注释”)。可以传递一个可选的逗号分隔的 <msg-id>
=
<severity> 列表,以更改某些可能问题的严重性,例如,--fsck-objects="missingEmail=ignore,badTagName=ignore"
。有关 <msg-id> 和 <severity> 可能值的更多信息,请参阅 git-fsck[1] 中fsck.
<msg-id> 配置选项的条目。 - --threads=<n>
-
指定解析增量时要生成的线程数。这要求 index-pack 使用 pthreads 编译,否则此选项将被忽略并发出警告。这旨在减少多处理器机器上的打包时间。但是,增量搜索窗口所需的内存量将乘以线程数。指定 0 将导致 Git 自动检测 CPU 数量并最多使用 3 个线程。
- --max-input-size=<size>
-
如果 pack 大于 <size>,则终止。
- --object-format=<hash-algorithm>
-
为 pack 指定给定的对象格式(哈希算法)。有效值为 sha1 和(如果启用)sha256。默认值是当前仓库的算法(由
extensions.objectFormat
设置),如果未设置值或在仓库外部则为 sha1。此选项不能与 --stdin 一起使用。
注意:目前,SHA-256 仓库与 SHA-1 仓库之间不具备互操作性。
从历史上看,我们曾警告说,当我们引入此类互操作性功能时,SHA-256 仓库可能需要向后不兼容的更改。如今,我们只期望兼容的更改。此外,如果此类更改确实必要,可以预期使用当前 Git 创建的 SHA-256 仓库将可供未来版本的 Git 使用而不会丢失数据。
- --promisor[=<message>]
-
在提交 pack 索引之前,为此 pack 创建一个 .promisor 文件。当使用 --fix-thin 写入 promisor 包时特别有用,因为 pack 的名称直到 pack 完全写入后才确定。如果提供了 <message>,则该内容将写入 .promisor 文件以供将来参考。有关更多信息,请参阅 部分克隆。
此外,如果给定 pack 中存在引用非 promisor 对象(在仓库中)的对象,则将这些非 promisor 对象重新打包到 promisor 包中。这避免了仓库中存在可通过 promisor 对象访问的非 promisor 对象的情况。
要求不指定 <pack-file>。
注意事项
索引创建完成后,将 pack/idx 文件名中的哈希打印到标准输出。如果同时使用了 --stdin,则此哈希将以“pack\t”为前缀,或者如果成功创建了新的 .keep 文件,则以“keep\t”为前缀。这有助于删除用作锁的 .keep 文件,以防止上述与 git repack 的竞争。