summaryrefslogtreecommitdiff
path: root/Documentation
diff options
context:
space:
mode:
authorJohannes Schindelin <johannes.schindelin@gmx.de>2017-11-01 17:10:33 (GMT)
committerJunio C Hamano <gitster@pobox.com>2017-11-02 02:19:44 (GMT)
commitb2f55717c7f9b335b7ac2e3358b0498116b94a5d (patch)
treeef496315fc91fb1b1177408b252278090d8ee6bd /Documentation
parent1a172e4ac1719a068c76384bd077ee65d915ebea (diff)
downloadgit-b2f55717c7f9b335b7ac2e3358b0498116b94a5d.zip
git-b2f55717c7f9b335b7ac2e3358b0498116b94a5d.tar.gz
git-b2f55717c7f9b335b7ac2e3358b0498116b94a5d.tar.bz2
mingw: document the standard handle redirection
This feature has been in Git for Windows since v2.11.0(2), as an experimental option. Now it is considered mature, and it is high time to document it properly. Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/git.txt18
1 files changed, 18 insertions, 0 deletions
diff --git a/Documentation/git.txt b/Documentation/git.txt
index 7a1d629..463b0eb 100644
--- a/Documentation/git.txt
+++ b/Documentation/git.txt
@@ -709,6 +709,24 @@ of clones and fetches.
the background which do not want to cause lock contention with
other operations on the repository. Defaults to `1`.
+`GIT_REDIRECT_STDIN`::
+`GIT_REDIRECT_STDOUT`::
+`GIT_REDIRECT_STDERR`::
+ Windows-only: allow redirecting the standard input/output/error
+ handles to paths specified by the environment variables. This is
+ particularly useful in multi-threaded applications where the
+ canonical way to pass standard handles via `CreateProcess()` is
+ not an option because it would require the handles to be marked
+ inheritable (and consequently *every* spawned process would
+ inherit them, possibly blocking regular Git operations). The
+ primary intended use case is to use named pipes for communication
+ (e.g. `\\.\pipe\my-git-stdin-123`).
++
+Two special values are supported: `off` will simply close the
+corresponding standard handle, and if `GIT_REDIRECT_STDERR` is
+`2>&1`, standard error will be redirected to the same handle as
+standard output.
+
Discussion[[Discussion]]
------------------------