Skip to content

Commit 465fa5d

Browse files
committed
mingw: document the experimental standard handle redirection
This feature is still highly experimental and has not even been contributed to the Git mailing list yet: the feature still needs to be battle-tested more. Signed-off-by: Johannes Schindelin <[email protected]>
1 parent 300a707 commit 465fa5d

File tree

1 file changed

+17
-0
lines changed

1 file changed

+17
-0
lines changed

Documentation/git.txt

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -709,6 +709,23 @@ of clones and fetches.
709709
the background which do not want to cause lock contention with
710710
other operations on the repository. Defaults to `1`.
711711

712+
`GIT_REDIRECT_STDIN`::
713+
`GIT_REDIRECT_STDOUT`::
714+
`GIT_REDIRECT_STDERR`::
715+
(EXPERIMENTAL) Windows-only: allow redirecting the standard
716+
input/output/error handles. This is particularly useful in
717+
multi-threaded applications where the canonical way to pass
718+
standard handles via `CreateProcess()` is not an option because
719+
it would require the handles to be marked inheritable (and
720+
consequently *every* spawned process would inherit them, possibly
721+
blocking regular Git operations). The primary intended use case
722+
is to use named pipes for communication.
723+
+
724+
Two special values are supported: `off` will simply close the
725+
corresponding standard handle, and if `GIT_REDIRECT_STDERR` is
726+
`2>&1`, standard error will be redirected to the same handle as
727+
standard output.
728+
712729
Discussion[[Discussion]]
713730
------------------------
714731

0 commit comments

Comments
 (0)