summaryrefslogtreecommitdiffstats
path: root/git-remote-helpers.html
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2012-11-13 14:32:04 -0800
committerJunio C Hamano <gitster@pobox.com>2012-11-13 14:32:04 -0800
commita129545d44f1f0fe9976ed87b9a7331bf239b7d8 (patch)
tree52268e539a6b33e18401455ea13cf579c615dc80 /git-remote-helpers.html
parent3b4382b85a92a6419a8f05510a9b583e711b5071 (diff)
downloadgit-htmldocs-a129545d44f1f0fe9976ed87b9a7331bf239b7d8.tar.gz
Autogenerated HTML docs for v1.8.0-150-gb0b00
Diffstat (limited to 'git-remote-helpers.html')
-rw-r--r--git-remote-helpers.html27
1 files changed, 25 insertions, 2 deletions
diff --git a/git-remote-helpers.html b/git-remote-helpers.html
index dbb1af6fd..4111c7e35 100644
--- a/git-remote-helpers.html
+++ b/git-remote-helpers.html
@@ -695,6 +695,25 @@ advertised with this capability must cover all refs reported by
the list command. If no <em>refspec</em> capability is advertised,
there is an implied <tt>refspec *:*</tt>.</p></div>
</dd>
+<dt class="hdlist1">
+<em>bidi-import</em>
+</dt>
+<dd>
+<p>
+ The fast-import commands <em>cat-blob</em> and <em>ls</em> can be used by remote-helpers
+ to retrieve information about blobs and trees that already exist in
+ fast-import&#8217;s memory. This requires a channel from fast-import to the
+ remote-helper.
+ If it is advertised in addition to "import", git establishes a pipe from
+ fast-import to the remote-helper&#8217;s stdin.
+ It follows that git and fast-import are both connected to the
+ remote-helper&#8217;s stdin. Because git can send multiple commands to
+ the remote-helper it is required that helpers that use <em>bidi-import</em>
+ buffer all <em>import</em> commands of a batch before sending data to fast-import.
+ This is to prevent mixing commands and fast-import responses on the
+ helper&#8217;s stdin.
+</p>
+</dd>
</dl></div>
<h3 id="_capabilities_for_pushing">Capabilities for Pushing</h3><div style="clear:left"></div>
<div class="dlist"><dl>
@@ -925,7 +944,11 @@ system.</p></div>
terminated with a blank line. For each batch of <em>import</em>, the remote
helper should produce a fast-import stream terminated by a <em>done</em>
command.</p></div>
-<div class="paragraph"><p>Supported if the helper has the "import" capability.</p></div>
+<div class="paragraph"><p>Note that if the <em>bidi-import</em> capability is used the complete batch
+sequence has to be buffered before starting to send data to fast-import
+to prevent mixing of commands and fast-import responses on the helper&#8217;s
+stdin.</p></div>
+<div class="paragraph"><p>Supported if the helper has the <em>import</em> capability.</p></div>
</dd>
<dt class="hdlist1">
<em>connect</em> &lt;service&gt;
@@ -1055,7 +1078,7 @@ capabilities reported by the helper.</p></div>
<div id="footnotes"><hr /></div>
<div id="footer">
<div id="footer-text">
-Last updated 2012-05-02 15:00:44 PDT
+Last updated 2012-11-13 14:31:09 PDT
</div>
</div>
</body>