From aace4aeb397e844b42994462a10c77b439434d5a Mon Sep 17 00:00:00 2001 From: simon Date: Thu, 31 Mar 2005 18:52:21 +0000 Subject: [PATCH] Add text to the troubleshooting chapter about the errors that can be caused when an active connection times out due to outgoing data exceeding its maximum number of retries, and mention that this can occur even when you didn't think you'd sent anything due to rekeys and/or keepalives. Unix generates ETIMEDOUT in this situation. Windows, it turns out after doing an actual experiment by disabling my firewall, generates ECONNABORTED! So _that's_ what it means under Windows. I wish I'd done this experiment years ago now. git-svn-id: svn://svn.tartarus.org/sgt/putty@5585 cda61777-01e9-0310-a592-d414129be87e --- doc/errors.but | 26 +++++++++++++++++++++++--- 1 file changed, 23 insertions(+), 3 deletions(-) diff --git a/doc/errors.but b/doc/errors.but index 2cb53b82..d1352eee 100644 --- a/doc/errors.but +++ b/doc/errors.but @@ -260,13 +260,24 @@ happen if you pull the network cable out of the back of an Ethernet-connected computer, or if Windows has any other similar reason to believe the entire network has become unreachable. +Windows also generates this error if it has given up on the machine +at the other end of the connection ever responding to it. If the +network between your client and server goes down and your client +then tries to send some data, Windows will make several attempts to +send the data and will then give up and kill the connection. In +particular, this can occur even if you didn't type anything, if you +are using SSH-2 and PuTTY attempts a key re-exchange. (See +\k{config-ssh-kex-rekey} for more about key re-exchange.) + +(It can also occur if you are using keepalives in your connection. +Other people have reported that keepalives \e{fix} this error for +them. See \k{config-keepalive} for a discussion of the pros and cons +of keepalives.) + We are not aware of any reason why this error might occur that would represent a bug in PuTTY. The problem is between you, your Windows system, your network and the remote system. -Some people have reported that enabling keepalives (see -\k{config-keepalive}) fixes this error for them. - \H{errors-connreset} \q{Network error: Connection reset by peer} This error occurs when the machines at each end of a network @@ -305,3 +316,12 @@ the network, or because it is turned off. Check that you have correctly entered the host name or IP address of your server machine. If that fails, consult the administrator of your server. + +Unix also generates this error when it tries to send data down a +connection and contact with the server has been completely lost +during a connection. (There is a delay of minutes before Unix gives +up on receiving a reply from the server.) This can occur if you type +things into PuTTY while the network is down, but it can also occur +if PuTTY decides of its own accord to send data: due to a repeat key +exchange in SSH-2 (see \k{config-ssh-kex-rekey}) or due to +keepalives (\k{config-keepalive}). -- 2.11.0