From 1fc4a00db7b1f5ab46398ed99524c624827cd3fd Mon Sep 17 00:00:00 2001 From: Alexander Stehlik Date: Mon, 22 Feb 2016 11:18:57 +0100 Subject: [PATCH] Troubleshoot info about SSH ControlMaster Relates: #4180 --- doc/articles/troubleshooting.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/doc/articles/troubleshooting.md b/doc/articles/troubleshooting.md index 9aef7c26b..785b276ae 100644 --- a/doc/articles/troubleshooting.md +++ b/doc/articles/troubleshooting.md @@ -312,3 +312,20 @@ networksetup -setv6automatic Wi-Fi That said, if this fixes your problem, please talk to your ISP about it to try and resolve the routing errors. That's the best way to get things resolved for everyone. + +## Composer hangs with SSH ControlMaster + +When you try to install packages from a Git repository and you use the ```ControlMaster``` +setting for you SSH connection Composer might just hang endlessly and you see a ```sh``` +process in the ```defunct``` state in your process list + +The reason for this is a SSH Bug: https://bugzilla.mindrot.org/show_bug.cgi?id=1988 + +As a workaround, open a SSH connection to your Git host before running Composer: + +``` +ssh -t git@mygitserver.tld +composer update +``` + +See also https://github.com/composer/composer/issues/4180 for more information.