From cd62853019533538b13c8312205dd10ca01e13bc Mon Sep 17 00:00:00 2001 From: Darko Poljak Date: Wed, 17 Aug 2016 19:32:43 +0200 Subject: [PATCH] Add CAVEATS section to cdist man page. --- docs/src/man1/cdist.rst | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/src/man1/cdist.rst b/docs/src/man1/cdist.rst index 89a2117e..47fe195c 100644 --- a/docs/src/man1/cdist.rst +++ b/docs/src/man1/cdist.rst @@ -220,6 +220,18 @@ AUTHORS ------- Nico Schottelius +CAVEATS +------- +When operating in parallel, either by operating in parallel for each host +(-p/--parallel) or by parallel jobs within a host (-j/--jobs), and depending +on target SSH server and its configuration you may encounter connection drops. +This is controlled with sshd :strong:`MaxStartups` configuration options. +You may also encounter session open refusal. This happens with ssh multiplexing +when you reach maximum number of open sessions permitted per network +connection. In this case ssh will disable multiplexing. +This limit is controlled with sshd :strong:`MaxSessions` configuration +options. For more details refer to :strong:`sshd_config`\ (5). + COPYING ------- Copyright \(C) 2011-2013 Nico Schottelius. Free use of this software is