Ilari Liusvaara | 3a9ed4b | 2010-10-12 19:39:42 +0300 | [diff] [blame] | 1 | git-remote-fd(1) |
Ilari Liusvaara | 7851b1e | 2010-11-17 09:15:34 -0800 | [diff] [blame] | 2 | ================ |
Ilari Liusvaara | 3a9ed4b | 2010-10-12 19:39:42 +0300 | [diff] [blame] | 3 | |
| 4 | NAME |
| 5 | ---- |
| 6 | git-remote-fd - Reflect smart transport stream back to caller |
| 7 | |
| 8 | SYNOPSIS |
| 9 | -------- |
| 10 | "fd::<infd>[,<outfd>][/<anything>]" (as URL) |
| 11 | |
| 12 | DESCRIPTION |
| 13 | ----------- |
Thomas Ackermann | 2de9b71 | 2013-01-21 20:17:53 +0100 | [diff] [blame] | 14 | This helper uses specified file descriptors to connect to a remote Git server. |
Ilari Liusvaara | 3a9ed4b | 2010-10-12 19:39:42 +0300 | [diff] [blame] | 15 | This is not meant for end users but for programs and scripts calling git |
Elijah Newren | 4d54268 | 2023-10-08 06:45:24 +0000 | [diff] [blame] | 16 | fetch, push, or archive. |
Ilari Liusvaara | 3a9ed4b | 2010-10-12 19:39:42 +0300 | [diff] [blame] | 17 | |
Ralf Wildenhues | 469bfc9 | 2011-01-03 20:03:34 +0100 | [diff] [blame] | 18 | If only <infd> is given, it is assumed to be a bidirectional socket connected |
Elijah Newren | 4d54268 | 2023-10-08 06:45:24 +0000 | [diff] [blame] | 19 | to a remote Git server (git-upload-pack, git-receive-pack, or |
Ville Skyttä | 2e3a16b | 2016-08-09 11:53:38 +0300 | [diff] [blame] | 20 | git-upload-archive). If both <infd> and <outfd> are given, they are assumed |
Thomas Ackermann | 2de9b71 | 2013-01-21 20:17:53 +0100 | [diff] [blame] | 21 | to be pipes connected to a remote Git server (<infd> being the inbound pipe |
Elijah Newren | 5fbcdb2 | 2023-10-08 06:45:27 +0000 | [diff] [blame] | 22 | and <outfd> being the outbound pipe). |
Ilari Liusvaara | 3a9ed4b | 2010-10-12 19:39:42 +0300 | [diff] [blame] | 23 | |
| 24 | It is assumed that any handshaking procedures have already been completed |
| 25 | (such as sending service request for git://) before this helper is started. |
| 26 | |
Ralf Wildenhues | 469bfc9 | 2011-01-03 20:03:34 +0100 | [diff] [blame] | 27 | <anything> can be any string. It is ignored. It is meant for providing |
Elijah Newren | 0a4f051 | 2023-10-08 06:45:17 +0000 | [diff] [blame] | 28 | information to the user in the URL in case that URL is displayed in some |
Ilari Liusvaara | 3a9ed4b | 2010-10-12 19:39:42 +0300 | [diff] [blame] | 29 | context. |
| 30 | |
Ilari Liusvaara | 7851b1e | 2010-11-17 09:15:34 -0800 | [diff] [blame] | 31 | ENVIRONMENT VARIABLES |
| 32 | --------------------- |
Ilari Liusvaara | 3a9ed4b | 2010-10-12 19:39:42 +0300 | [diff] [blame] | 33 | GIT_TRANSLOOP_DEBUG:: |
| 34 | If set, prints debugging information about various reads/writes. |
| 35 | |
Ilari Liusvaara | 7851b1e | 2010-11-17 09:15:34 -0800 | [diff] [blame] | 36 | EXAMPLES |
| 37 | -------- |
Jeff King | 5d2fc91 | 2011-08-03 20:13:29 -0600 | [diff] [blame] | 38 | `git fetch fd::17 master`:: |
Ilari Liusvaara | 3a9ed4b | 2010-10-12 19:39:42 +0300 | [diff] [blame] | 39 | Fetch master, using file descriptor #17 to communicate with |
| 40 | git-upload-pack. |
| 41 | |
Jeff King | 5d2fc91 | 2011-08-03 20:13:29 -0600 | [diff] [blame] | 42 | `git fetch fd::17/foo master`:: |
Ilari Liusvaara | 3a9ed4b | 2010-10-12 19:39:42 +0300 | [diff] [blame] | 43 | Same as above. |
| 44 | |
Jeff King | 5d2fc91 | 2011-08-03 20:13:29 -0600 | [diff] [blame] | 45 | `git push fd::7,8 master (as URL)`:: |
Ilari Liusvaara | 3a9ed4b | 2010-10-12 19:39:42 +0300 | [diff] [blame] | 46 | Push master, using file descriptor #7 to read data from |
| 47 | git-receive-pack and file descriptor #8 to write data to |
Elijah Newren | 0a4f051 | 2023-10-08 06:45:17 +0000 | [diff] [blame] | 48 | the same service. |
Ilari Liusvaara | 3a9ed4b | 2010-10-12 19:39:42 +0300 | [diff] [blame] | 49 | |
Jeff King | 5d2fc91 | 2011-08-03 20:13:29 -0600 | [diff] [blame] | 50 | `git push fd::7,8/bar master`:: |
Ilari Liusvaara | 3a9ed4b | 2010-10-12 19:39:42 +0300 | [diff] [blame] | 51 | Same as above. |
| 52 | |
Max Horn | 2672671 | 2014-11-11 21:17:07 +0100 | [diff] [blame] | 53 | SEE ALSO |
| 54 | -------- |
Johannes Schindelin | 439cc74 | 2019-03-25 14:41:36 -0700 | [diff] [blame] | 55 | linkgit:gitremote-helpers[7] |
Max Horn | 2672671 | 2014-11-11 21:17:07 +0100 | [diff] [blame] | 56 | |
Ilari Liusvaara | 3a9ed4b | 2010-10-12 19:39:42 +0300 | [diff] [blame] | 57 | GIT |
| 58 | --- |
| 59 | Part of the linkgit:git[1] suite |