X-Git-Url: https://git.distorted.org.uk/u/mdw/putty/blobdiff_plain/bb0e31ffb405971a418bd40c3bf1ab76e55ed847..b7a5df6665ba439c03e70e17a1fdbdce26680ddd:/doc/errors.but?ds=sidebyside diff --git a/doc/errors.but b/doc/errors.but index bbd87a3d..59338ebc 100644 --- a/doc/errors.but +++ b/doc/errors.but @@ -1,4 +1,4 @@ -\versionid $Id: errors.but,v 1.5 2003/03/17 16:57:23 simon Exp $ +\versionid $Id: errors.but,v 1.8 2004/05/20 12:48:19 simon Exp $ \C{errors} Common error messages @@ -144,6 +144,24 @@ type of message, the first thing you should do is check your the server may have sent diagnostic messages explaining exactly what problem it had with your setup. +\H{errors-access-denied} \q{Access denied}, \q{Authentication refused} + +Various forms of this error are printed in the PuTTY window, or +written to the PuTTY Event Log (see \k{using-eventlog}) during +authentication. + +If you see one of these messages, it means that the server has refused +all the forms of authentication PuTTY has tried and it has no further +ideas. + +It may be worth checking the Event Log for diagnostic messages from +the server giving more detail. + +This error can be caused by buggy SSH-1 servers that fail to cope with +the various strategies we use for camouflaging passwords in transit. +Upgrade your server, or use the workarounds described in +\k{config-ssh-bug-ignore1} and possibly \k{config-ssh-bug-plainpw1}. + \H{errors-crc} \q{Incorrect CRC received on packet} or \q{Incorrect MAC received on packet} @@ -170,11 +188,11 @@ panel (see \k{config-ssh-bug-derivekey2}). Another known server problem which can cause this error is described in \k{faq-openssh-bad-openssl} in the FAQ. -\H{errors-x11-proxy} \q{Authentication failed at PuTTY X11 proxy} +\H{errors-x11-proxy} \q{PuTTY X11 proxy: \e{various errors}} -This error is reported when PuTTY is doing X forwarding. It is sent -back to the X application running on the SSH server, which will -usually report the error to the user. +This family of errors are reported when PuTTY is doing X forwarding. +They are sent back to the X application running on the SSH server, +which will usually report the error to the user. When PuTTY enables X forwarding (see \k{using-x-forwarding}) it creates a virtual X display running on the SSH server. This display @@ -185,10 +203,10 @@ details it needs to enable clients to connect, and the server should put this mechanism in place automatically, so your X applications should just work. -A common reason why people see this message is because they used SSH -to log in as one user (let's say \q{fred}), and then used the Unix -\c{su} command to become another user (typically \q{root}). The -original user, \q{fred}, has access to the X authentication data +A common reason why people see one of these messages is because they +used SSH to log in as one user (let's say \q{fred}), and then used +the Unix \c{su} command to become another user (typically \q{root}). +The original user, \q{fred}, has access to the X authentication data provided by the SSH server, and can run X applications which are forwarded over the SSH connection. However, the second user (\q{root}) does not automatically have the authentication data @@ -238,7 +256,7 @@ Check that you are connecting with the correct protocol (SSH, Telnet or Rlogin), and check that the port number is correct. If that fails, consult the administrator of your server. -\H{errors-connrefused} \q{Network error: Connection timed out} +\H{errors-conntimedout} \q{Network error: Connection timed out} This error means that the network connection PuTTY tried to make to your server received no response at all from the server. Usually