简体中文 ▾ 主题 ▾ 最新版本 ▾ gitformat-bundle 最后更新于 2.43.0

名称

gitformat-bundle - bundle 文件格式

概要

*.bundle
*.bdl

描述

Git bundle 格式是一种同时表示引用和 Git 对象的格式。bundle 是一个类似于 git-show-ref[1] 格式的头部，后跟一个 *.pack 格式的包。

该格式由 git-bundle[1] 命令创建和读取，并受例如 git-fetch[1] 和 git-clone[1] 的支持。

格式

我们将使用 ABNF 表示法定义 Git bundle 格式。有关详细信息，请参阅 gitprotocol-common[5]。

v2 bundle 如下所示

bundle    = signature *prerequisite *reference LF pack
signature = "# v2 git bundle" LF

prerequisite = "-" obj-id SP comment LF
comment      = *CHAR
reference    = obj-id SP refname LF

pack         = ... ; packfile

v3 bundle 如下所示

bundle    = signature *capability *prerequisite *reference LF pack
signature = "# v3 git bundle" LF

capability   = "@" key ["=" value] LF
prerequisite = "-" obj-id SP comment LF
comment      = *CHAR
reference    = obj-id SP refname LF
key          = 1*(ALPHA / DIGIT / "-")
value        = *(%01-09 / %0b-FF)

pack         = ... ; packfile

语义

Git bundle 由几个部分组成。

  • “功能”仅存在于 v3 格式中，表示 bundle 正常读取所需的功能。

  • “先决条件”列出了不包含在 bundle 中且 bundle 的读取者必须已经拥有的对象，以便使用 bundle 中的数据。存储在 bundle 中的对象可以引用先决条件对象以及从它们可访问的任何内容（例如，bundle 中的树对象可以引用从先决条件可访问的 blob），和/或表示为相对于先决条件对象的增量。

  • “引用”记录了历史图的尖端，即 bundle 的读取者可以从中“git fetch”的内容。

  • “包”是“git fetch”将发送的包数据流，如果您从具有上述“引用”中记录的引用的仓库中获取到具有指向上述“先决条件”中列出的对象的引用的仓库中。

在 bundle 格式中，先决条件 obj-id 后面可以跟着一个注释。这是一个注释，它没有特定的含义。bundle 的写入者可以在此处放置任何字符串。bundle 的读取者必须忽略该注释。

关于浅克隆和 Git bundles 的注意事项

请注意，先决条件不代表浅克隆边界。先决条件和浅克隆边界的语义是不同的，Git bundle v2 格式无法表示浅克隆仓库。

功能

因为没有协商的机会，未知功能会导致 git bundle 中止。

  • object-format 指定正在使用的哈希算法，并且可以采用与 extensions.objectFormat 配置值相同的值。

  • filter 指定一个对象过滤器，如 git-rev-list[1] 中的 --filter 选项。生成的包文件在解包后必须标记为 .promisor 包文件。

GIT

Git[1] 套件的一部分