From: Oleg Broytman <phd@phdru.name>
Date: Wed, 14 Sep 2016 20:35:20 +0000 (+0300)
Subject: Add section "SSH connection sharing"
X-Git-Url: https://git.phdru.name/?p=git-wiki.git;a=commitdiff_plain;h=50d769beb87c5bce2af8bd70f3c00d117437fe66

Add section "SSH connection sharing"

SSH connection sharing is a way to speedup a lot of short ssh sessions
like git over ssh.
---

diff --git a/pep-103.txt b/pep-103.txt
index 803dad8..993ad2d 100644
--- a/pep-103.txt
+++ b/pep-103.txt
@@ -933,6 +933,38 @@ Read the detailed instructions in the file.
 Search the Net for "git prompt" to find other prompt variants.
 
 
+SSH connection sharing
+----------------------
+
+SSH connection sharing is a feature of OpenSSH and perhaps derivatives
+like PuTTY. SSH connection sharing is a way to decrease ssh client
+startup time by establishing one connection and reusing it for all
+subsequent clients connecting to the same server. SSH connection
+sharing can be used to speedup a lot of short ssh sessions like scp,
+sftp, rsync and of course git over ssh. If you regularly
+fetch/pull/push from/to remote repositories accessible over ssh then
+using ssh connection sharing is recommended.
+
+To turn on ssh connection sharing add something like this to your
+~/.ssh/config::
+
+    Host *
+    ControlMaster auto
+    ControlPath ~/.ssh/mux-%r@%h:%p
+    ControlPersist 600
+
+See `OpenSSH wikibook
+<https://en.wikibooks.org/wiki/OpenSSH/Cookbook/Multiplexing>`_ and
+`search <https://www.google.com/search?q=ssh+connection+sharing>`_ for
+more information.
+
+SSH connection sharing can be used at GitHub, GitLab and SourceForge
+repositories, but please be advised that BitBucket doesn't allow it
+and forcibly closes master connection after a short inactivity period
+so you will see errors like this from ssh: "Connection to bitbucket.org
+closed by remote host."
+
+
 git on server
 =============