X-Git-Url: https://git.distorted.org.uk/u/mdw/putty/blobdiff_plain/35cffede3bf184026cc35c666063b6dd8e3c892e..9234175a8cc19eac28c5fd815052b05966e0d07c:/doc/config.but?ds=sidebyside diff --git a/doc/config.but b/doc/config.but index 4026798e..9216b84d 100644 --- a/doc/config.but +++ b/doc/config.but @@ -1,4 +1,4 @@ -\versionid $Id: config.but,v 1.80 2004/05/22 11:09:31 simon Exp $ +\versionid $Id: config.but,v 1.89 2004/09/17 14:26:39 jacob Exp $ \C{config} Configuring PuTTY @@ -28,14 +28,14 @@ address, of the server you want to connect to. \b The \q{Protocol} radio buttons let you choose what type of connection you want to make: a raw connection, a Telnet connection, an rlogin connection or an SSH connection. (See \k{which-one} for a -summary of the differences between SSH, Telnet and rlogin.) +summary of the differences between SSH, Telnet and rlogin, and +\k{using-rawprot} for an explanation of \q{raw} connections.) \b The \q{Port} box lets you specify which port number on the server to connect to. If you select Telnet, Rlogin, or SSH, this box will be filled in automatically to the usual value, and you will only need to change it if you have an unusual server. If you select Raw -mode (see \k{using-rawprot}), you will almost certainly need to fill -in the \q{Port} box. +mode, you will almost certainly need to fill in the \q{Port} box. \S{config-saving} Loading and storing saved sessions @@ -638,6 +638,8 @@ use the Sound configurer in the Windows Control Panel. this mode, when the server sends a Control-G, the whole PuTTY window will flash white for a fraction of a second. +\b \q{Beep using the PC speaker} is self-explanatory. + \b \q{Play a custom sound file} allows you to specify a particular sound file to be used by PuTTY alone, or even by a particular individual PuTTY session. This allows you to distinguish your PuTTY @@ -914,8 +916,9 @@ scrolls off the top of the screen (see \k{using-scrollback}). The \q{Lines of scrollback} box lets you configure how many lines of text PuTTY keeps. The \q{Display scrollbar} options allow you to hide the scrollbar (although you can still view the scrollback using -Shift-PgUp and Shift-PgDn). You can separately configure whether the -scrollbar is shown in full-screen mode and in normal modes. +the keyboard as described in \k{using-scrollback}). You can separately +configure whether the scrollbar is shown in full-screen mode and in +normal modes. If you are viewing part of the scrollback when the server sends more text to PuTTY, the screen will revert to showing the current @@ -1012,7 +1015,11 @@ followed by \q{PuTTY}, for example \c{server1.example.com - PuTTY}. If you want a different window title, this is where to set it. PuTTY allows the server to send \c{xterm} control sequences which -modify the title of the window in mid-session. There is also an +modify the title of the window in mid-session (unless this is disabled - +see \k{config-features-retitle}); the title string set here +is therefore only the \e{initial} window title. + +As well as the \e{window} title, there is also an \c{xterm} sequence to modify the title of the window's \e{icon}. This makes sense in a windowing system where the window becomes an icon when minimised, such as Windows 3.1 or most X Window System @@ -1440,8 +1447,9 @@ badly to the default value. The format is a pair of numbers separated by a comma, for instance, \c{38400,38400}. The first number represents the output speed -(\e{from} the server), and the second is the input speed (\e{to} the -server). (Only the first is used in the Rlogin protocol.) +(\e{from} the server) in bits per second, and the second is the input +speed (\e{to} the server). (Only the first is used in the Rlogin +protocol.) This option has no effect on Raw connections. @@ -1499,7 +1507,8 @@ what \e{kind} of network problems you have between you and the server. Keepalives are only supported in Telnet and SSH; the Rlogin and Raw -protocols offer no way of implementing them. +protocols offer no way of implementing them. (For an alternative, see +\k{config-tcp-keepalives}.) Note that if you are using SSH1 and the server has a bug that makes it unable to deal with SSH1 ignore messages (see @@ -1518,6 +1527,34 @@ types of server. The Nagle algorithm is disabled by default. +\S{config-tcp-keepalives} \q{Enable TCP keepalives} + +\cfg{winhelp-topic}{connection.tcpkeepalive} + +\e{NOTE:} TCP keepalives should not be confused with the +application-level keepalives described in \k{config-keepalive}. If in +doubt, you probably want application-level keepalives; TCP keepalives +are provided for completeness. + +The idea of TCP keepalives is similar to application-level keepalives, +and the same caveats apply. The main differences are: + +\b TCP keepalives are available on \e{all} connection types, including +Raw and Rlogin. + +\b The interval between TCP keepalives is usually much longer, +typically two hours; this is set by the operating system, and cannot +be configured within PuTTY. + +\b If the operating system does not receive a response to a keepalive, +it may send out more in quick succession and if terminate the connection +if no response is received. + +TCP keepalives may be more useful for ensuring that half-open connections +are terminated than for keeping a connection alive. + +TCP keepalives are disabled by default. + \H{config-proxy} The Proxy panel \cfg{winhelp-topic}{proxy.main} @@ -1638,6 +1675,18 @@ Authentication is not fully supported for all forms of proxy: \b Username and password authentication is supported for HTTP proxies and SOCKS 5 proxies. +\lcont{ + +\b With SOCKS 5, authentication is via \i{CHAP} if the proxy +supports it (this is not supported in \i{PuTTYtel}); otherwise the +password is sent to the proxy in plain text. + +\b With HTTP proxying, the only currently supported authentication +method is \q{basic}, where the password is sent to the proxy in plain +text. + +} + \b SOCKS 4 can use the \q{Username} field, but does not support passwords.