1 <?xml version="1.0" encoding="UTF-8"?>
\r
2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
\r
4 <article lang="en" id="git-remote-fd(1)">
\r
6 <title>git-remote-fd(1)</title>
\r
8 <primary>git-remote-fd(1)</primary>
\r
11 <simplesect id="_name">
\r
13 <simpara>git-remote-fd - Reflect smart transport stream back to caller</simpara>
\r
15 <simplesect id="_synopsis">
\r
16 <title>SYNOPSIS</title>
\r
17 <simpara>"fd::<infd>[,<outfd>][/<anything>]" (as URL)</simpara>
\r
19 <simplesect id="_description">
\r
20 <title>DESCRIPTION</title>
\r
21 <simpara>This helper uses specified file descriptors to connect to a remote git server.
\r
22 This is not meant for end users but for programs and scripts calling git
\r
23 fetch, push or archive.</simpara>
\r
24 <simpara>If only <infd> is given, it is assumed to be a bidirectional socket connected
\r
25 to remote git server (git-upload-pack, git-receive-pack or
\r
26 git-upload-achive). If both <infd> and <outfd> are given, they are assumed
\r
27 to be pipes connected to a remote git server (<infd> being the inbound pipe
\r
28 and <outfd> being the outbound pipe.</simpara>
\r
29 <simpara>It is assumed that any handshaking procedures have already been completed
\r
30 (such as sending service request for git://) before this helper is started.</simpara>
\r
31 <simpara><anything> can be any string. It is ignored. It is meant for providing
\r
32 information to user in the URL in case that URL is displayed in some
\r
35 <simplesect id="_environment_variables">
\r
36 <title>ENVIRONMENT VARIABLES</title>
\r
44 If set, prints debugging information about various reads/writes.
\r
50 <simplesect id="_examples">
\r
51 <title>EXAMPLES</title>
\r
55 <emphasis>git fetch fd::17 master</emphasis>
\r
59 Fetch master, using file descriptor #17 to communicate with
\r
66 <emphasis>git fetch fd::17/foo master</emphasis>
\r
76 <emphasis>git push fd::7,8 master (as URL)</emphasis>
\r
80 Push master, using file descriptor #7 to read data from
\r
81 git-receive-pack and file descriptor #8 to write data to
\r
88 <emphasis>git push fd::7,8/bar master</emphasis>
\r
98 <simplesect id="_documentation">
\r
99 <title>Documentation</title>
\r
100 <simpara>Documentation by Ilari Liusvaara and the git list <<ulink url="mailto:git@vger.kernel.org">git@vger.kernel.org</ulink>></simpara>
\r
102 <simplesect id="_git">
\r
104 <simpara>Part of the <xref linkend="git(1)" /> suite</simpara>
\r