git-bundle.html - external/gitster/git-htmldocs - Git at Google

 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
  "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
 <meta name="generator" content="AsciiDoc 8.2.5" />
 <style type="text/css">
 /* Debug borders */
 p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
 /*
  border: 1px solid red;
 */
 }

 body {
  margin: 1em 5% 1em 5%;
 }

 a {
  color: blue;
  text-decoration: underline;
 }
 a:visited {
  color: fuchsia;
 }

 em {
  font-style: italic;
 }

 strong {
  font-weight: bold;
 }

 tt {
  color: navy;
 }

 h1, h2, h3, h4, h5, h6 {
  color: #527bbd;
  font-family: sans-serif;
  margin-top: 1.2em;
  margin-bottom: 0.5em;
  line-height: 1.3;
 }

 h1, h2, h3 {
  border-bottom: 2px solid silver;
 }
 h2 {
  padding-top: 0.5em;
 }
 h3 {
  float: left;
 }
 h3 + * {
  clear: left;
 }

 div.sectionbody {
  font-family: serif;
  margin-left: 0;
 }

 hr {
  border: 1px solid silver;
 }

 p {
  margin-top: 0.5em;
  margin-bottom: 0.5em;
 }

 pre {
  padding: 0;
  margin: 0;
 }

 span#author {
  color: #527bbd;
  font-family: sans-serif;
  font-weight: bold;
  font-size: 1.1em;
 }
 span#email {
 }
 span#revision {
  font-family: sans-serif;
 }

 div#footer {
  font-family: sans-serif;
  font-size: small;
  border-top: 2px solid silver;
  padding-top: 0.5em;
  margin-top: 4.0em;
 }
 div#footer-text {
  float: left;
  padding-bottom: 0.5em;
 }
 div#footer-badges {
  float: right;
  padding-bottom: 0.5em;
 }

 div#preamble,
 div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
 div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
 div.admonitionblock {
  margin-right: 10%;
  margin-top: 1.5em;
  margin-bottom: 1.5em;
 }
 div.admonitionblock {
  margin-top: 2.5em;
  margin-bottom: 2.5em;
 }

 div.content { /* Block element content. */
  padding: 0;
 }

 /* Block element titles. */
 div.title, caption.title {
  font-family: sans-serif;
  font-weight: bold;
  text-align: left;
  margin-top: 1.0em;
  margin-bottom: 0.5em;
 }
 div.title + * {
  margin-top: 0;
 }

 td div.title:first-child {
  margin-top: 0.0em;
 }
 div.content div.title:first-child {
  margin-top: 0.0em;
 }
 div.content + div.title {
  margin-top: 0.0em;
 }

 div.sidebarblock > div.content {
  background: #ffffee;
  border: 1px solid silver;
  padding: 0.5em;
 }

 div.listingblock {
  margin-right: 0%;
 }
 div.listingblock > div.content {
  border: 1px solid silver;
  background: #f4f4f4;
  padding: 0.5em;
 }

 div.quoteblock > div.content {
  padding-left: 2.0em;
 }

 div.attribution {
  text-align: right;
 }
 div.verseblock + div.attribution {
  text-align: left;
 }

 div.admonitionblock .icon {
  vertical-align: top;
  font-size: 1.1em;
  font-weight: bold;
  text-decoration: underline;
  color: #527bbd;
  padding-right: 0.5em;
 }
 div.admonitionblock td.content {
  padding-left: 0.5em;
  border-left: 2px solid silver;
 }

 div.exampleblock > div.content {
  border-left: 2px solid silver;
  padding: 0.5em;
 }

 div.verseblock div.content {
  white-space: pre;
 }

 div.imageblock div.content { padding-left: 0; }
 div.imageblock img { border: 1px solid silver; }
 span.image img { border-style: none; }

 dl {
  margin-top: 0.8em;
  margin-bottom: 0.8em;
 }
 dt {
  margin-top: 0.5em;
  margin-bottom: 0;
  font-style: italic;
 }
 dd > *:first-child {
  margin-top: 0;
 }

 ul, ol {
  list-style-position: outside;
 }
 div.olist2 ol {
  list-style-type: lower-alpha;
 }

 div.tableblock > table {
  border: 3px solid #527bbd;
 }
 thead {
  font-family: sans-serif;
  font-weight: bold;
 }
 tfoot {
  font-weight: bold;
 }

 div.hlist {
  margin-top: 0.8em;
  margin-bottom: 0.8em;
 }
 div.hlist td {
  padding-bottom: 5px;
 }
 td.hlist1 {
  vertical-align: top;
  font-style: italic;
  padding-right: 0.8em;
 }
 td.hlist2 {
  vertical-align: top;
 }

 @media print {
  div#footer-badges { display: none; }
 }

 div#toctitle {
  color: #527bbd;
  font-family: sans-serif;
  font-size: 1.1em;
  font-weight: bold;
  margin-top: 1.0em;
  margin-bottom: 0.1em;
 }

 div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
  margin-top: 0;
  margin-bottom: 0;
 }
 div.toclevel2 {
  margin-left: 2em;
  font-size: 0.9em;
 }
 div.toclevel3 {
  margin-left: 4em;
  font-size: 0.9em;
 }
 div.toclevel4 {
  margin-left: 6em;
  font-size: 0.9em;
 }
 include1::./stylesheets/xhtml11-manpage.css[]
 /* Workarounds for IE6's broken and incomplete CSS2. */

 div.sidebar-content {
  background: #ffffee;
  border: 1px solid silver;
  padding: 0.5em;
 }
 div.sidebar-title, div.image-title {
  font-family: sans-serif;
  font-weight: bold;
  margin-top: 0.0em;
  margin-bottom: 0.5em;
 }

 div.listingblock div.content {
  border: 1px solid silver;
  background: #f4f4f4;
  padding: 0.5em;
 }

 div.quoteblock-content {
  padding-left: 2.0em;
 }

 div.exampleblock-content {
  border-left: 2px solid silver;
  padding-left: 0.5em;
 }

 /* IE6 sets dynamically generated links as visited. */
 div#toc a:visited { color: blue; }
 </style>
 <title>git-bundle(1)</title>
 </head>
 <body>
 <div id="header">
 <h1>
 git-bundle(1) Manual Page
 </h1>
 <h2>NAME</h2>
 <div class="sectionbody">
 <p>git-bundle -
  Move objects and refs by archive
 </p>
 </div>
 </div>
 <h2>SYNOPSIS</h2>
 <div class="sectionbody">
 <div class="verseblock">
 <div class="content"><em>git bundle</em> create &lt;file&gt; &lt;git-rev-list args&gt;
 <em>git bundle</em> verify &lt;file&gt;
 <em>git bundle</em> list-heads &lt;file&gt; [refname&#8230;]
 <em>git bundle</em> unbundle &lt;file&gt; [refname&#8230;]</div></div>
 </div>
 <h2 id="_description">DESCRIPTION</h2>
 <div class="sectionbody">
 <div class="para"><p>Some workflows require that one or more branches of development on one
 machine be replicated on another machine, but the two machines cannot
 be directly connected so the interactive git protocols (git, ssh,
 rsync, http) cannot be used. This command provides support for
 <em>git-fetch</em> and <em>git-pull</em> to operate by packaging objects and references
 in an archive at the originating machine, then importing those into
 another repository using <em>git-fetch</em> and <em>git-pull</em>
 after moving the archive by some means (i.e., by sneakernet). As no
 direct connection between repositories exists, the user must specify a
 basis for the bundle that is held by the destination repository: the
 bundle assumes that all objects in the basis are already in the
 destination repository.</p></div>
 </div>
 <h2 id="_options">OPTIONS</h2>
 <div class="sectionbody">
 <div class="vlist"><dl>
 <dt>
 create &lt;file&gt;
 </dt>
 <dd>
 <p>
  Used to create a bundle named <em>file</em>. This requires the
  <em>git-rev-list</em> arguments to define the bundle contents.
 </p>
 </dd>
 <dt>
 verify &lt;file&gt;
 </dt>
 <dd>
 <p>
  Used to check that a bundle file is valid and will apply
  cleanly to the current repository. This includes checks on the
  bundle format itself as well as checking that the prerequisite
  commits exist and are fully linked in the current repository.
  <em>git-bundle</em> prints a list of missing commits, if any, and exits
  with non-zero status.
 </p>
 </dd>
 <dt>
 list-heads &lt;file&gt;
 </dt>
 <dd>
 <p>
  Lists the references defined in the bundle. If followed by a
  list of references, only references matching those given are
  printed out.
 </p>
 </dd>
 <dt>
 unbundle &lt;file&gt;
 </dt>
 <dd>
 <p>
  Passes the objects in the bundle to <em>git-index-pack</em>
  for storage in the repository, then prints the names of all
  defined references. If a reflist is given, only references
  matching those in the given list are printed. This command is
  really plumbing, intended to be called only by <em>git-fetch</em>.
 </p>
 </dd>
 <dt>
 [git-rev-list-args&#8230;]
 </dt>
 <dd>
 <p>
  A list of arguments, acceptable to <em>git-rev-parse</em> and
  <em>git-rev-list</em>, that specify the specific objects and references
  to transport. For example, "master~10..master" causes the
  current master reference to be packaged along with all objects
  added since its 10th ancestor commit. There is no explicit
  limit to the number of references and objects that may be
  packaged.
 </p>
 </dd>
 <dt>
 [refname&#8230;]
 </dt>
 <dd>
 <p>
  A list of references used to limit the references reported as
  available. This is principally of use to <em>git-fetch</em>, which
  expects to receive only those references asked for and not
  necessarily everything in the pack (in this case, <em>git-bundle</em> is
  acting like <em>git-fetch-pack</em>).
 </p>
 </dd>
 </dl></div>
 </div>
 <h2 id="_specifying_references">SPECIFYING REFERENCES</h2>
 <div class="sectionbody">
 <div class="para"><p><em>git-bundle</em> will only package references that are shown by
 <em>git-show-ref</em>: this includes heads, tags, and remote heads. References
 such as master<sub>1 cannot be packaged, but are perfectly suitable for
 defining the basis. More than one reference may be packaged, and more
 than one basis can be specified. The objects packaged are those not
 contained in the union of the given bases. Each basis can be
 specified explicitly (e.g., ^master</sub>10), or implicitly (e.g.,
 master~10..master, master --since=10.days.ago).</p></div>
 <div class="para"><p>It is very important that the basis used be held by the destination.
 It is okay to err on the side of conservatism, causing the bundle file
 to contain objects already in the destination as these are ignored
 when unpacking at the destination.</p></div>
 </div>
 <h2 id="_example">EXAMPLE</h2>
 <div class="sectionbody">
 <div class="para"><p>Assume two repositories exist as R1 on machine A, and R2 on machine B.
 For whatever reason, direct connection between A and B is not allowed,
 but we can move data from A to B via some mechanism (CD, email, etc).
 We want to update R2 with developments made on branch master in R1.</p></div>
 <div class="para"><p>To create the bundle you have to specify the basis. You have some options:</p></div>
 <div class="ilist"><ul>
 <li>
 <p>
 Without basis.
 </p>
 <div class="para"><p>This is useful when sending the whole history.</p></div>
 </li>
 </ul></div>
 <div class="listingblock">
 <div class="content">
 <pre><tt>$ git bundle create mybundle master</tt></pre>
 </div></div>
 <div class="ilist"><ul>
 <li>
 <p>
 Using temporally tags.
 </p>
 <div class="para"><p>We set a tag in R1 (lastR2bundle) after the previous such transport,
 and move it afterwards to help build the bundle.</p></div>
 </li>
 </ul></div>
 <div class="listingblock">
 <div class="content">
 <pre><tt>$ git bundle create mybundle master ^lastR2bundle
 $ git tag -f lastR2bundle master</tt></pre>
 </div></div>
 <div class="ilist"><ul>
 <li>
 <p>
 Using a tag present in both repositories
 </p>
 </li>
 </ul></div>
 <div class="listingblock">
 <div class="content">
 <pre><tt>$ git bundle create mybundle master ^v1.0.0</tt></pre>
 </div></div>
 <div class="ilist"><ul>
 <li>
 <p>
 A basis based on time.
 </p>
 </li>
 </ul></div>
 <div class="listingblock">
 <div class="content">
 <pre><tt>$ git bundle create mybundle master --since=10.days.ago</tt></pre>
 </div></div>
 <div class="ilist"><ul>
 <li>
 <p>
 With a limit on the number of commits
 </p>
 </li>
 </ul></div>
 <div class="listingblock">
 <div class="content">
 <pre><tt>$ git bundle create mybundle master -n 10</tt></pre>
 </div></div>
 <div class="para"><p>Then you move mybundle from A to B, and in R2 on B:</p></div>
 <div class="listingblock">
 <div class="content">
 <pre><tt>$ git bundle verify mybundle
 $ git fetch mybundle master:localRef</tt></pre>
 </div></div>
 <div class="para"><p>With something like this in the config in R2:</p></div>
 <div class="listingblock">
 <div class="content">
 <pre><tt>[remote "bundle"]
  url = /home/me/tmp/file.bdl
  fetch = refs/heads/*:refs/remotes/origin/*</tt></pre>
 </div></div>
 <div class="para"><p>You can first sneakernet the bundle file to ~/tmp/file.bdl and
 then these commands on machine B:</p></div>
 <div class="listingblock">
 <div class="content">
 <pre><tt>$ git ls-remote bundle
 $ git fetch bundle
 $ git pull bundle</tt></pre>
 </div></div>
 <div class="para"><p>would treat it as if it is talking with a remote side over the
 network.</p></div>
 </div>
 <h2 id="_author">Author</h2>
 <div class="sectionbody">
 <div class="para"><p>Written by Mark Levedahl &lt;mdl123@verizon.net&gt;</p></div>
 </div>
 <h2 id="_git">GIT</h2>
 <div class="sectionbody">
 <div class="para"><p>Part of the <a href="git.html">git(1)</a> suite</p></div>
 </div>
 <div id="footer">
 <div id="footer-text">
 Last updated 2008-07-06 05:16:36 UTC
 </div>
 </div>
 </body>
 </html>
	<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
	"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
	<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
	<head>
	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
	<meta name="generator" content="AsciiDoc 8.2.5" />
	<style type="text/css">
	/* Debug borders */
	p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
	/*
	border: 1px solid red;
	*/
	}

	body {
	margin: 1em 5% 1em 5%;
	}

	a {
	color: blue;
	text-decoration: underline;
	}
	a:visited {
	color: fuchsia;
	}

	em {
	font-style: italic;
	}

	strong {
	font-weight: bold;
	}

	tt {
	color: navy;
	}

	h1, h2, h3, h4, h5, h6 {
	color: #527bbd;
	font-family: sans-serif;
	margin-top: 1.2em;
	margin-bottom: 0.5em;
	line-height: 1.3;
	}

	h1, h2, h3 {
	border-bottom: 2px solid silver;
	}
	h2 {
	padding-top: 0.5em;
	}
	h3 {
	float: left;
	}
	h3 + * {
	clear: left;
	}

	div.sectionbody {
	font-family: serif;
	margin-left: 0;
	}

	hr {
	border: 1px solid silver;
	}

	p {
	margin-top: 0.5em;
	margin-bottom: 0.5em;
	}

	pre {
	padding: 0;
	margin: 0;
	}

	span#author {
	color: #527bbd;
	font-family: sans-serif;
	font-weight: bold;
	font-size: 1.1em;
	}
	span#email {
	}
	span#revision {
	font-family: sans-serif;
	}

	div#footer {
	font-family: sans-serif;
	font-size: small;
	border-top: 2px solid silver;
	padding-top: 0.5em;
	margin-top: 4.0em;
	}
	div#footer-text {
	float: left;
	padding-bottom: 0.5em;
	}
	div#footer-badges {
	float: right;
	padding-bottom: 0.5em;
	}

	div#preamble,
	div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
	div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
	div.admonitionblock {
	margin-right: 10%;
	margin-top: 1.5em;
	margin-bottom: 1.5em;
	}
	div.admonitionblock {
	margin-top: 2.5em;
	margin-bottom: 2.5em;
	}

	div.content { /* Block element content. */
	padding: 0;
	}

	/* Block element titles. */
	div.title, caption.title {
	font-family: sans-serif;
	font-weight: bold;
	text-align: left;
	margin-top: 1.0em;
	margin-bottom: 0.5em;
	}
	div.title + * {
	margin-top: 0;
	}

	td div.title:first-child {
	margin-top: 0.0em;
	}
	div.content div.title:first-child {
	margin-top: 0.0em;
	}
	div.content + div.title {
	margin-top: 0.0em;
	}

	div.sidebarblock > div.content {
	background: #ffffee;
	border: 1px solid silver;
	padding: 0.5em;
	}

	div.listingblock {
	margin-right: 0%;
	}
	div.listingblock > div.content {
	border: 1px solid silver;
	background: #f4f4f4;
	padding: 0.5em;
	}

	div.quoteblock > div.content {
	padding-left: 2.0em;
	}

	div.attribution {
	text-align: right;
	}
	div.verseblock + div.attribution {
	text-align: left;
	}

	div.admonitionblock .icon {
	vertical-align: top;
	font-size: 1.1em;
	font-weight: bold;
	text-decoration: underline;
	color: #527bbd;
	padding-right: 0.5em;
	}
	div.admonitionblock td.content {
	padding-left: 0.5em;
	border-left: 2px solid silver;
	}

	div.exampleblock > div.content {
	border-left: 2px solid silver;
	padding: 0.5em;
	}

	div.verseblock div.content {
	white-space: pre;
	}

	div.imageblock div.content { padding-left: 0; }
	div.imageblock img { border: 1px solid silver; }
	span.image img { border-style: none; }

	dl {
	margin-top: 0.8em;
	margin-bottom: 0.8em;
	}
	dt {
	margin-top: 0.5em;
	margin-bottom: 0;
	font-style: italic;
	}
	dd > *:first-child {
	margin-top: 0;
	}

	ul, ol {
	list-style-position: outside;
	}
	div.olist2 ol {
	list-style-type: lower-alpha;
	}

	div.tableblock > table {
	border: 3px solid #527bbd;
	}
	thead {
	font-family: sans-serif;
	font-weight: bold;
	}
	tfoot {
	font-weight: bold;
	}

	div.hlist {
	margin-top: 0.8em;
	margin-bottom: 0.8em;
	}
	div.hlist td {
	padding-bottom: 5px;
	}
	td.hlist1 {
	vertical-align: top;
	font-style: italic;
	padding-right: 0.8em;
	}
	td.hlist2 {
	vertical-align: top;
	}

	@media print {
	div#footer-badges { display: none; }
	}

	div#toctitle {
	color: #527bbd;
	font-family: sans-serif;
	font-size: 1.1em;
	font-weight: bold;
	margin-top: 1.0em;
	margin-bottom: 0.1em;
	}

	div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
	margin-top: 0;
	margin-bottom: 0;
	}
	div.toclevel2 {
	margin-left: 2em;
	font-size: 0.9em;
	}
	div.toclevel3 {
	margin-left: 4em;
	font-size: 0.9em;
	}
	div.toclevel4 {
	margin-left: 6em;
	font-size: 0.9em;
	}
	include1::./stylesheets/xhtml11-manpage.css[]
	/* Workarounds for IE6's broken and incomplete CSS2. */

	div.sidebar-content {
	background: #ffffee;
	border: 1px solid silver;
	padding: 0.5em;
	}
	div.sidebar-title, div.image-title {
	font-family: sans-serif;
	font-weight: bold;
	margin-top: 0.0em;
	margin-bottom: 0.5em;
	}

	div.listingblock div.content {
	border: 1px solid silver;
	background: #f4f4f4;
	padding: 0.5em;
	}

	div.quoteblock-content {
	padding-left: 2.0em;
	}

	div.exampleblock-content {
	border-left: 2px solid silver;
	padding-left: 0.5em;
	}

	/* IE6 sets dynamically generated links as visited. */
	div#toc a:visited { color: blue; }
	</style>
	<title>git-bundle(1)</title>
	</head>
	<body>
	<div id="header">
	<h1>
	git-bundle(1) Manual Page
	</h1>
	<h2>NAME</h2>
	<div class="sectionbody">
	<p>git-bundle -
	Move objects and refs by archive
	</p>
	</div>
	</div>
	<h2>SYNOPSIS</h2>
	<div class="sectionbody">
	<div class="verseblock">
	<div class="content"><em>git bundle</em> create <file> <git-rev-list args>
	<em>git bundle</em> verify <file>
	<em>git bundle</em> list-heads <file> [refname…]
	<em>git bundle</em> unbundle <file> [refname…]</div></div>
	</div>
	<h2 id="_description">DESCRIPTION</h2>
	<div class="sectionbody">
	<div class="para"><p>Some workflows require that one or more branches of development on one
	machine be replicated on another machine, but the two machines cannot
	be directly connected so the interactive git protocols (git, ssh,
	rsync, http) cannot be used. This command provides support for
	<em>git-fetch</em> and <em>git-pull</em> to operate by packaging objects and references
	in an archive at the originating machine, then importing those into
	another repository using <em>git-fetch</em> and <em>git-pull</em>
	after moving the archive by some means (i.e., by sneakernet). As no
	direct connection between repositories exists, the user must specify a
	basis for the bundle that is held by the destination repository: the
	bundle assumes that all objects in the basis are already in the
	destination repository.</p></div>
	</div>
	<h2 id="_options">OPTIONS</h2>
	<div class="sectionbody">
	<div class="vlist"><dl>
	<dt>
	create <file>
	</dt>
	<dd>
	<p>
	Used to create a bundle named <em>file</em>. This requires the
	<em>git-rev-list</em> arguments to define the bundle contents.
	</p>
	</dd>
	<dt>
	verify <file>
	</dt>
	<dd>
	<p>
	Used to check that a bundle file is valid and will apply
	cleanly to the current repository. This includes checks on the
	bundle format itself as well as checking that the prerequisite
	commits exist and are fully linked in the current repository.
	<em>git-bundle</em> prints a list of missing commits, if any, and exits
	with non-zero status.
	</p>
	</dd>
	<dt>
	list-heads <file>
	</dt>
	<dd>
	<p>
	Lists the references defined in the bundle. If followed by a
	list of references, only references matching those given are
	printed out.
	</p>
	</dd>
	<dt>
	unbundle <file>
	</dt>
	<dd>
	<p>
	Passes the objects in the bundle to <em>git-index-pack</em>
	for storage in the repository, then prints the names of all
	defined references. If a reflist is given, only references
	matching those in the given list are printed. This command is
	really plumbing, intended to be called only by <em>git-fetch</em>.
	</p>
	</dd>
	<dt>
	[git-rev-list-args…]
	</dt>
	<dd>
	<p>
	A list of arguments, acceptable to <em>git-rev-parse</em> and
	<em>git-rev-list</em>, that specify the specific objects and references
	to transport. For example, "master~10..master" causes the
	current master reference to be packaged along with all objects
	added since its 10th ancestor commit. There is no explicit
	limit to the number of references and objects that may be
	packaged.
	</p>
	</dd>
	<dt>
	[refname…]
	</dt>
	<dd>
	<p>
	A list of references used to limit the references reported as
	available. This is principally of use to <em>git-fetch</em>, which
	expects to receive only those references asked for and not
	necessarily everything in the pack (in this case, <em>git-bundle</em> is
	acting like <em>git-fetch-pack</em>).
	</p>
	</dd>
	</dl></div>
	</div>
	<h2 id="_specifying_references">SPECIFYING REFERENCES</h2>
	<div class="sectionbody">
	<div class="para"><p><em>git-bundle</em> will only package references that are shown by
	<em>git-show-ref</em>: this includes heads, tags, and remote heads. References
	such as master<sub>1 cannot be packaged, but are perfectly suitable for
	defining the basis. More than one reference may be packaged, and more
	than one basis can be specified. The objects packaged are those not
	contained in the union of the given bases. Each basis can be
	specified explicitly (e.g., ^master</sub>10), or implicitly (e.g.,
	master~10..master, master --since=10.days.ago).</p></div>
	<div class="para"><p>It is very important that the basis used be held by the destination.
	It is okay to err on the side of conservatism, causing the bundle file
	to contain objects already in the destination as these are ignored
	when unpacking at the destination.</p></div>
	</div>
	<h2 id="_example">EXAMPLE</h2>
	<div class="sectionbody">
	<div class="para"><p>Assume two repositories exist as R1 on machine A, and R2 on machine B.
	For whatever reason, direct connection between A and B is not allowed,
	but we can move data from A to B via some mechanism (CD, email, etc).
	We want to update R2 with developments made on branch master in R1.</p></div>
	<div class="para"><p>To create the bundle you have to specify the basis. You have some options:</p></div>
	<div class="ilist"><ul>
	<li>
	<p>
	Without basis.
	</p>
	<div class="para"><p>This is useful when sending the whole history.</p></div>
	</li>
	</ul></div>
	<div class="listingblock">
	<div class="content">
	<pre><tt>$ git bundle create mybundle master</tt></pre>
	</div></div>
	<div class="ilist"><ul>
	<li>
	<p>
	Using temporally tags.
	</p>
	<div class="para"><p>We set a tag in R1 (lastR2bundle) after the previous such transport,
	and move it afterwards to help build the bundle.</p></div>
	</li>
	</ul></div>
	<div class="listingblock">
	<div class="content">
	<pre><tt>$ git bundle create mybundle master ^lastR2bundle
	$ git tag -f lastR2bundle master</tt></pre>
	</div></div>
	<div class="ilist"><ul>
	<li>
	<p>
	Using a tag present in both repositories
	</p>
	</li>
	</ul></div>
	<div class="listingblock">
	<div class="content">
	<pre><tt>$ git bundle create mybundle master ^v1.0.0</tt></pre>
	</div></div>
	<div class="ilist"><ul>
	<li>
	<p>
	A basis based on time.
	</p>
	</li>
	</ul></div>
	<div class="listingblock">
	<div class="content">
	<pre><tt>$ git bundle create mybundle master --since=10.days.ago</tt></pre>
	</div></div>
	<div class="ilist"><ul>
	<li>
	<p>
	With a limit on the number of commits
	</p>
	</li>
	</ul></div>
	<div class="listingblock">
	<div class="content">
	<pre><tt>$ git bundle create mybundle master -n 10</tt></pre>
	</div></div>
	<div class="para"><p>Then you move mybundle from A to B, and in R2 on B:</p></div>
	<div class="listingblock">
	<div class="content">
	<pre><tt>$ git bundle verify mybundle
	$ git fetch mybundle master:localRef</tt></pre>
	</div></div>
	<div class="para"><p>With something like this in the config in R2:</p></div>
	<div class="listingblock">
	<div class="content">
	<pre><tt>[remote "bundle"]
	url = /home/me/tmp/file.bdl
	fetch = refs/heads/:refs/remotes/origin/</tt></pre>
	</div></div>
	<div class="para"><p>You can first sneakernet the bundle file to ~/tmp/file.bdl and
	then these commands on machine B:</p></div>
	<div class="listingblock">
	<div class="content">
	<pre><tt>$ git ls-remote bundle
	$ git fetch bundle
	$ git pull bundle</tt></pre>
	</div></div>
	<div class="para"><p>would treat it as if it is talking with a remote side over the
	network.</p></div>
	</div>
	<h2 id="_author">Author</h2>
	<div class="sectionbody">
	<div class="para"><p>Written by Mark Levedahl <mdl123@verizon.net></p></div>
	</div>
	<h2 id="_git">GIT</h2>
	<div class="sectionbody">
	<div class="para"><p>Part of the <a href="git.html">git(1)</a> suite</p></div>
	</div>
	<div id="footer">
	<div id="footer-text">
	Last updated 2008-07-06 05:16:36 UTC
	</div>
	</div>
	</body>
	</html>