summaryrefslogtreecommitdiffhomepage
path: root/sites/www/faq.rst
diff options
context:
space:
mode:
authorJeff Forcier <jeff@bitprophet.org>2016-06-17 14:42:22 -0700
committerJeff Forcier <jeff@bitprophet.org>2016-06-17 14:42:22 -0700
commitb3342c9ff2d75bc8e4ada312e68bf392eb962554 (patch)
tree3fb35ff4a3871a3caa65a2d4211665e27eff9a34 /sites/www/faq.rst
parent0ebd247127043c57801b91898524738d712e527e (diff)
Enhance docs a bit re #520 and related hang issues.
Diffstat (limited to 'sites/www/faq.rst')
-rw-r--r--sites/www/faq.rst10
1 files changed, 10 insertions, 0 deletions
diff --git a/sites/www/faq.rst b/sites/www/faq.rst
index a5d9b383..74b7501e 100644
--- a/sites/www/faq.rst
+++ b/sites/www/faq.rst
@@ -24,3 +24,13 @@ However, **closed does not imply locked** - affected users can still post
comments on such tickets - and **we will always consider actual patch
submissions for these issues**, provided they can get +1s from similarly
affected users and are proven to not break existing functionality.
+
+I'm having strange issues with my code hanging at shutdown!
+===========================================================
+
+Make sure you explicitly ``.close()`` your connection objects (usually
+``SSHClient``) if you're having any sort of hang/freeze at shutdown time!
+
+Doing so isn't strictly necessary 100% of the time, but it is almost always the
+right solution if you run into the various corner cases that cause race
+conditions, etc.