git@vger.kernel.org list mirror (unofficial, one of many)
 help / color / mirror / Atom feed
f568fcd7d11d5d7980182b66903cb93bd0982626 blob 1421 bytes (raw)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
 
= Git bundle v2 format

The Git bundle format is a format that represents both refs and Git objects.

== Format

We will use ABNF notation to define the Git bundle format. See
protocol-common.txt for the details.

----
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
----

== Semantics

A Git bundle consists of three parts.

* "Prerequisites" lists the objects that are NOT included in the bundle and the
  receiver of the bundle MUST already have, in order to use the data in the
  bundle. The objects stored in the bundle may refer to prerequisite objects and
  anything reachable from them and/or expressed as a delta against prerequisite
  objects.

* "References" record the tips of the history graph, iow, what the receiver of
  the bundle CAN "git fetch" from it.

* "Pack" is the pack data stream "git fetch" would send, if you fetch from a
  repository that has the references recorded in the "References" above into a
  repository that has references pointing at the objects listed in
  "Prerequisites" above.

In the bundle format, there can be a comment following a prerequisite obj-id.
This is a comment and it has no specific meaning. The sender of the bundle MAY
put any string here. The receiver of the bundle MUST ignore the comment.
debug log:

solving f568fcd7d1 ...
found f568fcd7d1 in https://public-inbox.org/git/20200131221800.240352-1-masayasuzuki@google.com/

applying [1/1] https://public-inbox.org/git/20200131221800.240352-1-masayasuzuki@google.com/
diff --git a/Documentation/technical/bundle-format.txt b/Documentation/technical/bundle-format.txt
new file mode 100644
index 0000000000..f568fcd7d1

Checking patch Documentation/technical/bundle-format.txt...
Applied patch Documentation/technical/bundle-format.txt cleanly.

index at:
100644 f568fcd7d11d5d7980182b66903cb93bd0982626	Documentation/technical/bundle-format.txt

git@vger.kernel.org list mirror (unofficial, one of many)

This inbox may be cloned and mirrored by anyone:

	git clone --mirror https://public-inbox.org/git
	git clone --mirror http://ou63pmih66umazou.onion/git
	git clone --mirror http://czquwvybam4bgbro.onion/git
	git clone --mirror http://hjrcffqmbrq6wope.onion/git

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V1 git git/ https://public-inbox.org/git \
		git@vger.kernel.org
	public-inbox-index git

Example config snippet for mirrors.
Newsgroups are available over NNTP:
	nntp://news.public-inbox.org/inbox.comp.version-control.git
	nntp://ou63pmih66umazou.onion/inbox.comp.version-control.git
	nntp://czquwvybam4bgbro.onion/inbox.comp.version-control.git
	nntp://hjrcffqmbrq6wope.onion/inbox.comp.version-control.git
	nntp://news.gmane.io/gmane.comp.version-control.git
 note: .onion URLs require Tor: https://www.torproject.org/

code repositories for the project(s) associated with this inbox:

	https://80x24.org/mirrors/git.git

AGPL code for this site: git clone https://public-inbox.org/public-inbox.git