man1/git-remote-fd.1

   1 '\" t
   2 .\"     Title: git-remote-fd
   3 .\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
   4 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
   5 .\"      Date: 2023-08-09
   6 .\"    Manual: Git Manual
   7 .\"    Source: Git 2.42.0.rc1
   8 .\"  Language: English
   9 .\"
  10 .TH "GIT\-REMOTE\-FD" "1" "2023\-08\-09" "Git 2\&.42\&.0\&.rc1" "Git Manual"
  11 .\" -----------------------------------------------------------------
  12 .\" * Define some portability stuff
  13 .\" -----------------------------------------------------------------
  14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  15 .\" http://bugs.debian.org/507673
  16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
  17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  18 .ie \n(.g .ds Aq \(aq
  19 .el       .ds Aq '
  20 .\" -----------------------------------------------------------------
  21 .\" * set default formatting
  22 .\" -----------------------------------------------------------------
  23 .\" disable hyphenation
  24 .nh
  25 .\" disable justification (adjust text to left margin only)
  26 .ad l
  27 .\" -----------------------------------------------------------------
  28 .\" * MAIN CONTENT STARTS HERE *
  29 .\" -----------------------------------------------------------------
  30 .SH "NAME"
  31 git-remote-fd \- Reflect smart transport stream back to caller
  32 .SH "SYNOPSIS"
  33 .sp
  34 "fd::<infd>[,<outfd>][/<anything>]" (as URL)
  35 .SH "DESCRIPTION"
  36 .sp
  37 This helper uses specified file descriptors to connect to a remote Git server\&. This is not meant for end users but for programs and scripts calling git fetch, push or archive\&.
  38 .sp
  39 If only <infd> is given, it is assumed to be a bidirectional socket connected to remote Git server (git\-upload\-pack, git\-receive\-pack or git\-upload\-archive)\&. If both <infd> and <outfd> are given, they are assumed to be pipes connected to a remote Git server (<infd> being the inbound pipe and <outfd> being the outbound pipe\&.
  40 .sp
  41 It is assumed that any handshaking procedures have already been completed (such as sending service request for git://) before this helper is started\&.
  42 .sp
  43 <anything> can be any string\&. It is ignored\&. It is meant for providing information to user in the URL in case that URL is displayed in some context\&.
  44 .SH "ENVIRONMENT VARIABLES"
  45 .PP
  46 GIT_TRANSLOOP_DEBUG
  47 .RS 4
  48 If set, prints debugging information about various reads/writes\&.
  49 .RE
  50 .SH "EXAMPLES"
  51 .PP
  52 \fBgit fetch fd::17 master\fR
  53 .RS 4
  54 Fetch master, using file descriptor #17 to communicate with git\-upload\-pack\&.
  55 .RE
  56 .PP
  57 \fBgit fetch fd::17/foo master\fR
  58 .RS 4
  59 Same as above\&.
  60 .RE
  61 .PP
  62 \fBgit push fd::7,8 master (as URL)\fR
  63 .RS 4
  64 Push master, using file descriptor #7 to read data from git\-receive\-pack and file descriptor #8 to write data to same service\&.
  65 .RE
  66 .PP
  67 \fBgit push fd::7,8/bar master\fR
  68 .RS 4
  69 Same as above\&.
  70 .RE
  71 .SH "SEE ALSO"
  72 .sp
  73 \fBgitremote-helpers\fR(7)
  74 .SH "GIT"
  75 .sp
  76 Part of the \fBgit\fR(1) suite