GITFORMAT−BUNDLE - Online Linux Manual PageSection : 5
Updated : 2023−03−13
Source : Git 2​.40​.0
Note : Git Manual

NAMEgitformat-bundle − The bundle file format

SYNOPSIS*​.bundle *​.bdl

DESCRIPTIONThe Git bundle format is a format that represents both refs and Git objects​. A bundle is a header in a format similar to git-show-ref(1) followed by a pack in *​.pack format​. The format is created and read by the git-bundle(1) command, and supported by e​.g​. git-fetch(1) and git-clone(1)​.

FORMATWe will use ABNF notation to define the Git bundle format​. See gitprotocol-common(5) for the details​. A v2 bundle looks like this: 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 = ​.​.​. ; packfileA v3 bundle looks like this: 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

SEMANTICSA Git bundle consists of several parts​. •  "Capabilities", which are only in the v3 format, indicate functionality that the bundle requires to be read properly​. •  "Prerequisites" lists the objects that are NOT included in the bundle and the reader 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 (e​.g​. a tree object in the bundle can reference a blob that is reachable from a prerequisite) and/or expressed as a delta against prerequisite objects​. •  "References" record the tips of the history graph, iow, what the reader 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 writer of the bundle MAY put any string here​. The reader of the bundle MUST ignore the comment​.

Note on the shallow clone and a Git bundleNote that the prerequisites does not represent a shallow−clone boundary​. The semantics of the prerequisites and the shallow−clone boundaries are different, and the Git bundle v2 format cannot represent a shallow clone repository​.

CAPABILITIESBecause there is no opportunity for negotiation, unknown capabilities cause git bundle to abort​. •  object−format specifies the hash algorithm in use, and can take the same values as the extensions​.objectFormat configuration value​. •  filter specifies an object filter as in the −−filter option in git-rev-list(1)​. The resulting pack−file must be marked as a ​.promisor pack−file after it is unbundled​.

GITPart of the git(1) suite
0
Johanes Gumabo
Data Size   :   11,496 byte
man-gitformat-bundle.5Build   :   2024-12-05, 20:55   :  
Visitor Screen   :   x
Visitor Counter ( page / site )   :   3 / 182,436
Visitor ID   :     :  
Visitor IP   :   18.191.84.179   :  
Visitor Provider   :   AMAZON-02   :  
Provider Position ( lat x lon )   :   39.962500 x -83.006100   :   x
Provider Accuracy Radius ( km )   :   1000   :  
Provider City   :   Columbus   :  
Provider Province   :   Ohio ,   :   ,
Provider Country   :   United States   :  
Provider Continent   :   North America   :  
Visitor Recorder   :   Version   :  
Visitor Recorder   :   Library   :  
Online Linux Manual Page   :   Version   :   Online Linux Manual Page - Fedora.40 - march=x86-64 - mtune=generic - 24.12.05
Online Linux Manual Page   :   Library   :   lib_c - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Online Linux Manual Page   :   Library   :   lib_m - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Data Base   :   Version   :   Online Linux Manual Page Database - 24.04.13 - march=x86-64 - mtune=generic - fedora-38
Data Base   :   Library   :   lib_c - 23.02.07 - march=x86-64 - mtune=generic - fedora.36

Very long time ago, I have the best tutor, Wenzel Svojanovsky . If someone knows the email address of Wenzel Svojanovsky , please send an email to johanes_gumabo@yahoo.co.id .
If error, please print screen and send to johanes_gumabo@yahoo.co.id
Under development. Support me via PayPal.