Various accelerator clashes (due to the addition of the global Help
[u/mdw/putty] / doc / faq.but
CommitLineData
32c37ecd 1\versionid $Id: faq.but,v 1.18 2002/01/14 12:16:58 simon Exp $
8f1529bc 2
ee46ef84 3\A{faq} PuTTY FAQ
4
5This FAQ is published on the PuTTY web site, and also provided as an
6appendix in the manual.
7
8\H{faq-support} Features supported in PuTTY
9
10In general, if you want to know if PuTTY supports a particular
11feature, you should look for it on the
12\W{http://www.chiark.greenend.org.uk/~sgtatham/putty/}{PuTTY web site}.
13In particular:
14
15\b try the
16\W{http://www.chiark.greenend.org.uk/~sgtatham/putty/changes.html}{changes
17page}, and see if you can find the feature on there. If a feature is
18listed there, it's been implemented. If it's listed as a change made
19\e{since} the latest version, it should be available in the
20development snapshots, in which case testing will be very welcome.
21
22\b try the
23\W{http://www.chiark.greenend.org.uk/~sgtatham/putty/wishlist.html}{Wishlist
24page}, and see if you can find the feature there. If it's on there,
25it probably \e{hasn't} been implemented.
26
a1d2976b 27\S{faq-ssh2}{Question} Does PuTTY support SSH v2?
ee46ef84 28
29Yes. SSH v2 support has been available in PuTTY since version 0.50.
30However, currently the \e{default} SSH protocol is v1; to select SSH
31v2 if your server supports both, go to the SSH panel and change the
32\e{Preferred SSH protocol version} option.
33
32c37ecd 34Public key authentication (both RSA and DSA) in SSH v2 is new in
35version 0.52.
ee46ef84 36
a1d2976b 37\S{faq-ssh2-keyfmt}{Question} Does PuTTY support reading OpenSSH or
ee46ef84 38\cw{ssh.com} SSHv2 private key files?
39
40Not at present. OpenSSH and \cw{ssh.com} have totally different
41formats for private key files, and neither one is particularly
42pleasant, so PuTTY has its own. We do plan to write a converter at
43some stage.
44
a1d2976b 45\S{faq-ssh1}{Question} Does PuTTY support SSH v1?
ee46ef84 46
47Yes. SSH 1 support has always been available in PuTTY.
48
a1d2976b 49\S{faq-localecho}{Question} Does PuTTY support local echo?
ee46ef84 50
32c37ecd 51Yes. Version 0.52 has proper support for local echo.
ee46ef84 52
32c37ecd 53In version 0.51 and before, local echo could not be separated from
ee46ef84 54local line editing (where you type a line of text locally, and it is
55not sent to the server until you press Return, so you have the
56chance to edit it and correct mistakes \e{before} the server sees
32c37ecd 57it). New in version 0.52, local echo and local line editing are
58separate options, and by default PuTTY will try to determine
59automatically whether to enable them or not, based on which protocol
60you have selected and also based on hints from the server. If you
61have a problem with PuTTY's default choice, you can force each
62option to be enabled or disabled as you choose. The controls are in
63the Terminal panel, in the section marked \q{Line discipline
64options}.
ee46ef84 65
a1d2976b 66\S{faq-disksettings}{Question} Does PuTTY support storing its
70706890 67settings in a disk file?
ee46ef84 68
69Not at present, although \k{config-file} in the documentation gives
70a method of achieving the same effect.
71
a1d2976b 72\S{faq-fullscreen}{Question} Does PuTTY support full-screen mode,
70706890 73like a DOS box?
ee46ef84 74
32c37ecd 75Yes; this is a new feature in version 0.52.
ee46ef84 76
babac7bd 77\S{faq-password-remember}{Question} Does PuTTY have the ability to
78remember my password so I don't have to type it every time?
ee46ef84 79
80No, it doesn't.
81
82Remembering your password is a bad plan for obvious security
83reasons: anyone who gains access to your machine while you're away
84from your desk can find out the remembered password, and use it,
85abuse it or change it.
86
87In addition, it's not even \e{possible} for PuTTY to automatically
88send your password in a Telnet session, because Telnet doesn't give
89the client software any indication of which part of the login
90process is the password prompt. PuTTY would have to guess, by
91looking for words like \q{password} in the session data; and if your
92login program is written in something other than English, this won't
93work.
94
95In SSH, remembering your password would be possible in theory, but
96there doesn't seem to be much point since SSH supports public key
97authentication, which is more flexible and more secure. See
98\k{pubkey} in the documentation for a full discussion of public key
99authentication.
100
a1d2976b 101\S{faq-hostkeys}{Question} Is there an option to turn off the
70706890 102annoying host key prompts?
cad566a9 103
104No, there isn't. And there won't be. Even if you write it yourself
105and send us the patch, we won't accept it.
106
107Those annoying host key prompts are the \e{whole point} of SSH.
108Without them, all the cryptographic technology SSH uses to secure
109your session is doing nothing more than making an attacker's job
110slightly harder; instead of sitting between you and the server with
111a packet sniffer, the attacker must actually subvert a router and
112start modifying the packets going back and forth. But that's not all
113that much harder than just sniffing; and without host key checking,
114it will go completely undetected by client or server.
115
116Host key checking is your guarantee that the encryption you put on
117your data at the client end is the \e{same} encryption taken off the
118data at the server end; it's your guarantee that it hasn't been
119removed and replaced somewhere on the way. Host key checking makes
120the attacker's job \e{astronomically} hard, compared to packet
121sniffing, and even compared to subverting a router. Instead of
122applying a little intelligence and keeping an eye on Bugtraq, the
123attacker must now perform a brute-force attack against at least one
124military-strength cipher. That insignificant host key prompt really
125does make \e{that} much difference.
126
127If you're having a specific problem with host key checking - perhaps
128you want an automated batch job to make use of PSCP or Plink, and
129the interactive host key prompt is hanging the batch process - then
130the right way to fix it is to add the correct host key to the
131Registry in advance. That way, you retain the \e{important} feature
132of host key checking: the right key will be accepted and the wrong
133ones will not. Adding an option to turn host key checking off
134completely is the wrong solution and we will not do it.
135
a1d2976b 136\S{faq-server}{Question} Will you write an SSH server for the PuTTY
70706890 137suite, to go with the client?
ae915483 138
139No. The only reason we might want to would be if we could easily
140re-use existing code and significantly cut down the effort. We don't
141believe this is the case; there just isn't enough common ground
142between an SSH client and server to make it worthwhile.
143
144If someone else wants to use bits of PuTTY in the process of writing
145a Windows SSH server, they'd be perfectly welcome to of course, but
146I really can't see it being a lot less effort for us to do that than
147it would be for us to write a server from the ground up. We don't
148have time, and we don't have motivation. The code is available if
149anyone else wants to try it.
150
ee46ef84 151\H{faq-ports} Ports to other operating systems
152
153The eventual goal is for PuTTY to be a multi-platform program, able
154to run on at least Windows, MacOS and Unix. Whether this will
155actually ever happen I have no idea, but it is the plan. A Mac port
156has been started, but is only half-finished and currently not moving
157very fast.
158
159Porting will become easier once PuTTY has a generalised porting
160layer, drawing a clear line between platform-dependent and
161platform-independent code. The general intention is for this porting
162layer to evolve naturally as part of the process of doing the first
163port. One particularly nasty part of this will be separating the
164many configuration options into platform-dependent and
165platform-independent ones; for example, the options controlling when
166the Windows System menu appears will be pretty much meaningless
167under X11 or perhaps other windowing systems, whereas Telnet Passive
168Mode is universal and shouldn't need to be specified once for each
169platform.
170
a1d2976b 171\S{faq-wince}{Question} Will there be a port to Windows CE?
ee46ef84 172
173Probably not in the particularly near future. Despite sharing large
174parts of the Windows API, in practice WinCE doesn't appear to be
175significantly easier to port to than a totally different operating
176system.
177
178However, PuTTY on portable devices would clearly be a useful thing,
179so in the long term I hope there will be a WinCE port.
180
f82f00d0 181\S{faq-win31}{Question} Is there a port to Windows 3.1?
182
183PuTTY is a 32-bit application from the ground up, so it won't run on
184Windows 3.1 as a native 16-bit program; and it would be \e{very}
185hard to port it to do so, because of Windows 3.1's vile memory
186allocation mechanisms.
187
188However, it is possible in theory to compile the existing PuTTY
189source in such a way that it will run under Win32s (an extension to
190Windows 3.1 to let you run 32-bit programs). In order to do this
191you'll need the right kind of C compiler - modern versions of Visual
192C at least have stopped being backwards compatible to Win32s. Also,
193the last time we tried this it didn't work very well.
194
195If you're interested in running PuTTY under Windows 3.1, help and
196testing in this area would be very welcome!
197
babac7bd 198\S{faq-mac-port}{Question} Will there be a port to the Mac?
ee46ef84 199
200A Mac port was started once and is half-finished, but development
201has been static for some time and the main PuTTY code has moved on,
202so it's not clear how quickly development would resume even if
203developer effort were available.
204
a1d2976b 205\S{faq-unix}{Question} Will there be a port to Unix?
ee46ef84 206
207I hope so, if only so that I can have an \cw{xterm}-like program
208that supports exactly the same terminal emulation as PuTTY. If and
209when we do do a Unix port, it will have a local-terminal back end so
210it can be used like an \cw{xterm}, rather than only being usable as
211a network utility.
212
a1d2976b 213\S{faq-epoc}{Question} Will there be a port to EPOC?
ee46ef84 214
215I hope so, but given that ports aren't really progressing very fast
216even on systems the developers \e{do} already know how to program
217for, it might be a long time before any of us get round to learning
218a new system and doing the port for that.
219
220\H{faq-embedding} Embedding PuTTY in other programs
221
a1d2976b 222\S{faq-dll}{Question} Is the SSH or Telnet code available as a DLL?
ee46ef84 223
224No, it isn't. It would take a reasonable amount of rewriting for
225this to be possible, and since the PuTTY project itself doesn't
226believe in DLLs (they make installation more error-prone) none of us
227has taken the time to do it.
228
229Most of the code cleanup work would be a good thing to happen in
230general, so if anyone feels like helping, we wouldn't say no.
231
a1d2976b 232\S{faq-vb}{Question} Is the SSH or Telnet code available as a Visual
70706890 233Basic component?
ee46ef84 234
235No, it isn't. None of the PuTTY team uses Visual Basic, and none of
236us has any particular need to make SSH connections from a Visual
237Basic application. In addition, all the preliminary work to turn it
238into a DLL would be necessary first; and furthermore, we don't even
239know how to write VB components.
240
241If someone offers to do some of this work for us, we might consider
242it, but unless that happens I can't see VB integration being
243anywhere other than the very bottom of our priority list.
244
a1d2976b 245\S{faq-ipc}{Question} How can I use PuTTY to make an SSH connection
70706890 246from within another program?
ee46ef84 247
248Probably your best bet is to use Plink, the command-line connection
249tool. If you can start Plink as a second Windows process, and
250arrange for your primary process to be able to send data to the
251Plink process, and receive data from it, through pipes, then you
252should be able to make SSH connections from your program.
253
254This is what CVS for Windows does, for example.
255
256\H{faq-details} Details of PuTTY's operation
257
a1d2976b 258\S{faq-term}{Question} What terminal type does PuTTY use?
ee46ef84 259
260For most purposes, PuTTY can be considered to be an \cw{xterm}
32c37ecd 261terminal.
ee46ef84 262
263PuTTY also supports some terminal control sequences not supported by
264the real \cw{xterm}: notably the Linux console sequences that
265reconfigure the colour palette, and the title bar control sequences
266used by \cw{DECterm} (which are different from the \cw{xterm} ones;
267PuTTY supports both).
268
269By default, PuTTY announces its terminal type to the server as
270\c{xterm}. If you have a problem with this, you can reconfigure it
271to say something else; \c{vt220} might help if you have trouble.
272
a1d2976b 273\S{faq-settings}{Question} Where does PuTTY store its data?
ee46ef84 274
275PuTTY stores most of its data (saved sessions, SSH host keys) in the
276Registry. The precise location is
277
278\c HKEY_CURRENT_USER\Software\SimonTatham\PuTTY
279
280and within that area, saved sessions are stored under \c{Sessions}
281while host keys are stored under \c{SshHostKeys}.
282
283PuTTY also requires a random number seed file, to improve the
284unpredictability of randomly chosen data needed as part of the SSH
285cryptography. This is stored by default in your Windows home
286directory (\c{%HOMEDRIVE%\\%HOMEPATH%}), or in the actual Windows
287directory (such as \c{C:\\WINDOWS}) if the home directory doesn't
288exist, for example if you're using Win95. If you want to change the
289location of the random number seed file, you can put your chosen
290pathname in the Registry, at
291
292\c HKEY_CURRENT_USER\Software\SimonTatham\PuTTY\RandSeedFile
293
294\H{faq-howto} HOWTO questions
295
a1d2976b 296\S{faq-startmax}{Question} How can I make PuTTY start up maximised?
ee46ef84 297
298Create a Windows shortcut to start PuTTY from, and set it as \q{Run
299Maximized}.
300
a1d2976b 301\S{faq-startsess}{Question} How can I create a Windows shortcut to
70706890 302start a particular saved session directly?
ee46ef84 303
304To run a PuTTY session saved under the name \q{\cw{mysession}},
305create a Windows shortcut that invokes PuTTY with a command line
306like
307
308\c \path\name\to\putty.exe @mysession
309
a1d2976b 310\S{faq-startssh}{Question} How can I start an SSH session straight
70706890 311from the command line?
ee46ef84 312
313Use the command line \c{putty -ssh host.name}. Alternatively, create
314a saved session that specifies the SSH protocol, and start the saved
315session as shown in \k{faq-startsess}.
316
a1d2976b 317\S{faq-cutpaste}{Question} How do I copy and paste between PuTTY and
70706890 318other Windows applications?
ee46ef84 319
320Copy and paste works similarly to the X Window System. You use the
321left mouse button to select text in the PuTTY window. The act of
322selection \e{automatically} copies the text to the clipboard: there
323is no need to press Ctrl-Ins or Ctrl-C or anything else. In fact,
324pressing Ctrl-C will send a Ctrl-C character to the other end of
325your connection (just like it does the rest of the time), which may
326have unpleasant effects. The \e{only} thing you need to do, to copy
327text to the clipboard, is to select it.
328
329To paste the clipboard contents into a PuTTY window, by default you
330click the right mouse button. If you have a three-button mouse and
331are used to X applications, you can configure pasting to be done by
332the middle button instead, but this is not the default because most
333Windows users don't have a middle button at all.
334
335You can also paste by pressing Shift-Ins.
336
a1d2976b 337\S{faq-tunnels}{Question} How do I use X forwarding and port
70706890 338forwarding? I can't find the Tunnels panel.
f2003e32 339
32c37ecd 340This is a new feature in version 0.52. You should upgrade.
f2003e32 341
a1d2976b 342\S{faq-options}{Question} How do I use all PuTTY's features (public
70706890 343keys, port forwarding, SSH v2, etc.) in PSCP, PSFTP and Plink?
72be5b5e 344
345The command-line tools are currently rather short of command line
346options to enable this sort of thing. However, you can use most of
347PuTTY's features if you create a PuTTY saved session, and then use
348the name of the saved session on the command line in place of a
349hostname. This works for PSCP, PSFTP and Plink (but don't expect
350port forwarding in the file transfer applications!).
f2003e32 351
a1d2976b 352\S{faq-pscp}{Question} How do I use PSCP.EXE? When I double-click it
70706890 353gives me a command prompt window which then closes instantly.
ee46ef84 354
355PSCP is a command-line application, not a GUI application. If you
356run it without arguments, it will simply print a help message and
357terminate.
358
359To use PSCP properly, run it from a Command Prompt window. See
360\k{pscp} in the documentation for more details.
361
a1d2976b 362\S{faq-pscp-spaces}{Question} How do I use PSCP to copy a file whose
70706890 363name has spaces in?
ee46ef84 364
365If PSCP is using the traditional SCP protocol, this is confusing. If
366you're specifying a file at the local end, you just use one set of
367quotes as you would normally do:
368
369\c pscp "local filename with spaces" user@host:
370\c pscp user@host:myfile "local filename with spaces"
371
372But if the filename you're specifying is on the \e{remote} side, you
373have to use backslashes and two sets of quotes:
374
375\c pscp user@host:"\"remote filename with spaces\"" local_filename
376\c pscp local_filename user@host:"\"remote filename with spaces\""
377
378Worse still, in a remote-to-local copy you have to specify the local
379file name explicitly, otherwise PSCP will complain that they don't
380match (unless you specified the \c{-unsafe} option). The following
381command will give an error message:
382
383\c c:\>pscp user@host:"\"oo er\"" .
e9cee352 384\c warning: remote host tried to write to a file called 'oo er'
385\c when we requested a file called '"oo er"'.
ee46ef84 386
e9cee352 387Instead, you need to specify the local file name in full:
388
389\c c:\>pscp user@host:"\"oo er\"" "oo er"
390
ee46ef84 391If PSCP is using the newer SFTP protocol, none of this is a problem,
392and all filenames with spaces in are specified using a single pair
393of quotes in the obvious way:
394
395\c pscp "local file" user@host:
396\c pscp user@host:"remote file" .
397
398\H{faq-trouble} Troubleshooting
399
babac7bd 400\S{faq-incorrect-mac}{Question} Why do I see \q{Incorrect MAC
401received on packet}?
ee46ef84 402
403This is due to a bug in old SSH 2 servers distributed by
404\cw{ssh.com}. Version 2.3.0 and below of their SSH 2 server
405constructs Message Authentication Codes in the wrong way, and
406expects the client to construct them in the same wrong way. PuTTY
407constructs the MACs correctly by default, and hence these old
408servers will fail to work with it.
409
32c37ecd 410If you are using PuTTY version 0.52 or better, this should work
411automatically: PuTTY should detect the buggy servers from their
412version number announcement, and automatically start to construct
413its MACs in the same incorrect manner as they do, so it will be able
414to work with them.
ee46ef84 415
32c37ecd 416If you are using PuTTY version 0.51 or below, you can enable the
417workaround by going to the SSH panel and ticking the box labelled
418\q{Imitate SSH 2 MAC bug}. It's possible that you might have to do
419this with 0.52 as well, if a buggy server exists that PuTTY doesn't
420know about.
ee46ef84 421
b7e2c163 422In this context MAC stands for Message Authentication Code. It's a
423cryptographic term, and it has nothing at all to do with Ethernet
424MAC (Media Access Control) addresses.
425
a1d2976b 426\S{faq-colours}{Question} I clicked on a colour in the Colours
70706890 427panel, and the colour didn't change in my terminal.
ee46ef84 428
429That isn't how you're supposed to use the Colours panel.
430
431During the course of a session, PuTTY potentially uses \e{all} the
432colours listed in the Colours panel. It's not a question of using
433only one of them and you choosing which one; PuTTY will use them
434\e{all}. The purpose of the Colours panel is to let you adjust the
435appearance of all the colours. So to change the colour of the
436cursor, for example, you would select \q{Cursor Colour}, press the
437\q{Modify} button, and select a new colour from the dialog box that
438appeared. Similarly, if you want your session to appear in green,
439you should select \q{Default Foreground} and press \q{Modify}.
440Clicking on \q{ANSI Green} won't turn your session green; it will
441only allow you to adjust the \e{shade} of green used when PuTTY is
442instructed by the server to display green text.
443
a1d2976b 444\S{faq-winsock2}{Question} Plink on Windows 95 says it can't find
70706890 445\cw{WS2_32.DLL}.
ee46ef84 446
447Plink requires the extended Windows network library, WinSock version
4482. This is installed as standard on Windows 98 and above, and on
449Windows NT, and even on later versions of Windows 95; but early
450Win95 installations don't have it.
451
452In order to use Plink on these systems, you will need to download
453the
454\W{http://www.microsoft.com/windows95/downloads/contents/wuadmintools/s_wunetworkingtools/w95sockets2/}{WinSock 2 upgrade}:
455
456\c http://www.microsoft.com/windows95/downloads/contents/wuadmintools/
457\c s_wunetworkingtools/w95sockets2/
458
a1d2976b 459\S{faq-rekey}{Question} My PuTTY sessions close after an hour and
70706890 460tell me \q{Server failed host key check}.
ee46ef84 461
462This is a bug in all versions of PuTTY up to and including 0.51. SSH
463v2 servers from \cw{ssh.com} will require the key exchange to be
464repeated one hour after the start of the connection, and PuTTY will
465get this wrong.
466
32c37ecd 467Upgrade to version 0.52 and the problem should go away.
ee46ef84 468
a1d2976b 469\S{faq-outofmem}{Question} After trying to establish an SSH 2
70706890 470connection, PuTTY says \q{Out of memory} and dies.
ee46ef84 471
472If this happens just while the connection is starting up, this often
473indicates that for some reason the client and server have failed to
474establish a session encryption key. Somehow, they have performed
475calculations that should have given each of them the same key, but
476have ended up with different keys; so data encrypted by one and
477decrypted by the other looks like random garbage.
478
479This causes an \q{out of memory} error because the first encrypted
480data PuTTY expects to see is the length of an SSH message. Normally
481this will be something well under 100 bytes. If the decryption has
482failed, PuTTY will see a completely random length in the region of
483two \e{gigabytes}, and will try to allocate enough memory to store
484this non-existent message. This will immediately lead to it thinking
485it doesn't have enough memory, and panicking.
486
487If this happens to you, it is quite likely to still be a PuTTY bug
488and you should report it (although it might be a bug in your SSH
489server instead); but it doesn't necessarily mean you've actually run
490out of memory.
491
a1d2976b 492\S{faq-bce}{Question} When I run full-colour applications, I see
70706890 493areas of black space where colour ought to be.
f1453e5c 494
495You almost certainly need to enable the \q{Use background colour to
496erase screen} setting in the Terminal panel. Note that if you do
497this in mid-session, it won't take effect until you reset the
498terminal (see \k{faq-resetterm}).
499
a1d2976b 500\S{faq-resetterm}{Question} When I change some terminal settings,
70706890 501nothing happens.
f1453e5c 502
503Some of the terminal options (notably Auto Wrap and
504background-colour screen erase) actually represent the \e{default}
505setting, rather than the currently active setting. The server can
506send sequences that modify these options in mid-session, but when
507the terminal is reset (by server action, or by you choosing \q{Reset
508Terminal} from the System menu) the defaults are restored.
509
510If you want to change one of these options in the middle of a
511session, you will find that the change does not immediately take
512effect. It will only take effect once you reset the terminal.
513
a1d2976b 514\S{faq-altgr}{Question} I can't type characters that require the
70706890 515AltGr key.
ee46ef84 516
32c37ecd 517In PuTTY version 0.51, the AltGr key was broken. Upgrade to version
5180.52.
ee46ef84 519
a1d2976b 520\S{faq-idleout}{Question} My PuTTY sessions unexpectedly close after
70706890 521they are idle for a while.
ee46ef84 522
523Some types of firewall, and almost any router doing Network Address
524Translation (NAT, also known as IP masquerading), will forget about
525a connection through them if the connection does nothing for too
526long. This will cause the connection to be rudely cut off when
527contact is resumed.
528
529You can try to combat this by telling PuTTY to send \e{keepalives}:
530packets of data which have no effect on the actual session, but
531which reassure the router or firewall that the network connection is
532still active and worth remembering about.
533
534Keepalives don't solve everything, unfortunately; although they
535cause greater robustness against this sort of router, they can also
536cause a \e{loss} of robustness against network dropouts. See
537\k{config-keepalive} in the documentation for more discussion of
538this.
539
a1d2976b 540\S{faq-timeout}{Question} PuTTY's network connections time out too
70706890 541quickly when network connectivity is temporarily lost.
ee46ef84 542
543This is a Windows problem, not a PuTTY problem. The timeout value
544can't be set on per application or per session basis. To increase
545the TCP timeout globally, you need to tinker with the Registry.
546
547On Windows 95, 98 or ME, the registry key you need to change is
548
549\c HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\VxD\
550\c MSTCP\MaxDataRetries
551
552(it must be of type DWORD in Win95, or String in Win98/ME).
553
554On Windows NT or 2000, the registry key is
555
556\c HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\
557\c Parameters\TcpMaxDataRetransmissions
558
559and it must be of type DWORD.
560
561Set the key's value to something like 10. This will cause Windows to
562try harder to keep connections alive instead of abandoning them.
563
a1d2976b 564\S{faq-puttyputty}{Question} When I \cw{cat} a binary file, I get
ee46ef84 565`PuTTYPuTTYPuTTY' on my command line.
566
a5a6cb30 567Don't do that, then.
ee46ef84 568
569This is designed behaviour; when PuTTY receives the character
570Control-E from the remote server, it interprets it as a request to
571identify itself, and so it sends back the string \q{\cw{PuTTY}} as
572if that string had been entered at the keyboard. Control-E should
573only be sent by programs that are prepared to deal with the
574response. Writing a binary file to your terminal is likely to output
575many Control-E characters, and cause this behaviour. Don't do it.
576It's a bad plan.
577
a5a6cb30 578To mitigate the effects, you could configure the answerback string
579to be empty (see \k{config-answerback}); but writing binary files to
580your terminal is likely to cause various other unpleasant behaviour,
581so this is only a small remedy.
582
babac7bd 583\S{faq-wintitle}{Question} When I \cw{cat} a binary file, my window
584title changes to a nonsense string.
ee46ef84 585
a5a6cb30 586Don't do that, then.
ee46ef84 587
588It is designed behaviour that PuTTY should have the ability to
589adjust the window title on instructions from the server. Normally
590the control sequence that does this should only be sent
591deliberately, by programs that know what they are doing and intend
592to put meaningful text in the window title. Writing a binary file to
593your terminal runs the risk of sending the same control sequence by
594accident, and cause unexpected changes in the window title. Don't do
595it.
596
babac7bd 597\S{faq-password-fails}{Question} My keyboard stops working once
598PuTTY displays the password prompt.
59c1f1f6 599
600No, it doesn't. PuTTY just doesn't display the password you type, so
601that someone looking at your screen can't see what it is.
602
603Unlike the Windows login prompts, PuTTY doesn't display the password
604as a row of asterisks either. This is so that someone looking at
605your screen can't even tell how \e{long} your password is, which
606might be valuable information.
607
b5bee048 608\S{faq-keyboard}{Question} One or more function keys don't do what I
609expected in a server-side application.
610
611If you've already tried all the relevant options in the PuTTY
612Keyboard panel, you may need to mail the PuTTY maintainers and ask.
613
614It is \e{not} usually helpful just to tell us which application,
615which server operating system, and which key isn't working; in order
616to replicate the problem we would need to have a copy of every
617operating system, and every application, that anyone has ever
618complained about.
619
620PuTTY responds to function key presses by sending a sequence of
621control characters to the server. If a function key isn't doing what
622you expect, it's likely that the character sequence your application
623is expecting to receive is not the same as the one PuTTY is sending.
624Therefore what we really need to know is \e{what} sequence the
625application is expecting.
626
627The simplest way to investigate this is to find some other terminal
628environment, in which that function key \e{does} work; and then
629investigate what sequence the function key is sending in that
630situation. One reasonably easy way to do this on a Unix system is to
631type the command \c{cat}, and then press the function key. This is
632likely to produce output of the form \c{^[[11~}. You can also do
633this in PuTTY, to find out what sequence the function key is
634producing in that. Then you can mail the PuTTY maintainers and tell
635us \q{I wanted the F1 key to send \c{^[[11~}, but instead it's
636sending \c{^[OP}, can this be done?}, or something similar.
637
638You should still read the
639\W{http://www.chiark.greenend.org.uk/~sgtatham/putty/feedback.html}{Feedback
640page} on the PuTTY website (also provided as \k{feedback} in the
641manual), and follow the guidelines contained in that.
642
ee46ef84 643\H{faq-secure} Security questions
644
a1d2976b 645\S{faq-publicpc}{Question} Is it safe for me to download PuTTY and
70706890 646use it on a public PC?
ee46ef84 647
648It depends on whether you trust that PC. If you don't trust the
649public PC, don't use PuTTY on it, and don't use any other software
650you plan to type passwords into either. It might be watching your
651keystrokes, or it might tamper with the PuTTY binary you download.
652There is \e{no} program safe enough that you can run it on an
653actively malicious PC and get away with typing passwords into it.
654
655If you do trust the PC, then it's probably OK to use PuTTY on it
656(but if you don't trust the network, then the PuTTY download might
657be tampered with, so it would be better to carry PuTTY with you on a
658floppy).
659
a1d2976b 660\S{faq-cleanup}{Question} What does PuTTY leave on a system? How can
70706890 661I clean up after it?
ee46ef84 662
663PuTTY will leave some Registry entries, and a random seed file, on
664the PC (see \k{faq-settings}). If you are using PuTTY on a public
665PC, or somebody else's PC, you might want to clean these up when you
666leave. You can do that automatically, by running the command
667\c{putty -cleanup}.
668
a1d2976b 669\S{faq-dsa}{Question} How come PuTTY now supports DSA, when the
70706890 670website used to say how insecure it was?
ee46ef84 671
672DSA has a major weakness \e{if badly implemented}: it relies on a
673random number generator to far too great an extent. If the random
674number generator produces a number an attacker can predict, the DSA
675private key is exposed - meaning that the attacker can log in as you
676on all systems that accept that key.
677
678The PuTTY policy changed because the developers were informed of
679ways to implement DSA which do not suffer nearly as badly from this
680weakness, and indeed which don't need to rely on random numbers at
681all. For this reason we now believe PuTTY's DSA implementation is
682probably OK. However, if you have the choice, we still recommend you
683use RSA instead.
684
685\H{faq-admin} Administrative questions
686
a1d2976b 687\S{faq-domain}{Question} Would you like me to register you a nicer
70706890 688domain name?
ee46ef84 689
690No, thank you. Even if you can find one (most of them seem to have
691been registered already, by people who didn't ask whether we
692actually wanted it before they applied), we're happy with the PuTTY
693web site being exactly where it is. It's not hard to find (just type
694\q{putty} into \W{http://www.google.com/}{google.com} and we're the
695first link returned), and we don't believe the administrative hassle
696of moving the site would be worth the benefit.
697
698In addition, if we \e{did} want a custom domain name, we would want
699to run it ourselves, so we knew for certain that it would continue
700to point where we wanted it, and wouldn't suddenly change or do
701strange things. Having it registered for us by a third party who we
702don't even know is not the best way to achieve this.
703
a1d2976b 704\S{faq-webhosting}{Question} Would you like free web hosting for the
70706890 705PuTTY web site?
ee46ef84 706
707We already have some, thanks.
708
a1d2976b 709\S{faq-sourceforge}{Question} Why don't you move PuTTY to
70706890 710SourceForge?
ee46ef84 711
712Partly, because we don't want to move the web site location (see
713\k{faq-domain}).
714
715Also, security reasons. PuTTY is a security product, and as such it
716is particularly important to guard the code and the web site against
717unauthorised modifications which might introduce subtle security
718flaws. Therefore, we prefer that the CVS repository, web site and
719FTP site remain where they are, under the direct control of system
720administrators we know and trust personally, rather than being run
721by a large organisation full of people we've never met and which is
722known to have had breakins in the past.
723
724No offence to SourceForge; I think they do a wonderful job. But
725they're not ideal for everyone, and in particular they're not ideal
726for us.
727
a1d2976b 728\S{faq-mailinglist1}{Question} Why can't I subscribe to the
70706890 729putty-bugs mailing list?
ee46ef84 730
731Because you're not a member of the PuTTY core development team. The
732putty-bugs mailing list is not a general newsgroup-like discussion
733forum; it's a contact address for the core developers, and an
734\e{internal} mailing list for us to discuss things among ourselves.
735If we opened it up for everybody to subscribe to, it would turn into
736something more like a newsgroup and we would be completely
737overwhelmed by the volume of traffic. It's hard enough to keep up
738with the list as it is.
739
a1d2976b 740\S{faq-mailinglist2}{Question} If putty-bugs isn't a
70706890 741general-subscription mailing list, what is?
ee46ef84 742
743There isn't one, that we know of.
744
745If someone else wants to set up a mailing list for PuTTY users to
746help each other with common problems, that would be fine with us;
747but the PuTTY team would almost certainly not have the time to read
748it, so any questions the list couldn't answer would have to be
749forwarded on to us by the questioner. In any case, it's probably
750better to use the established newsgroup \cw{comp.security.ssh} for
751this purpose.
752
a1d2976b 753\S{faq-donations}{Question} How can I donate to PuTTY development?
ee46ef84 754
755Please, \e{please} don't feel you have to. PuTTY is completely free
756software, and not shareware. We think it's very important that
757\e{everybody} who wants to use PuTTY should be able to, whether they
758have any money or not; so the last thing we would want is for a
759PuTTY user to feel guilty because they haven't paid us any money. If
760you want to keep your money, please do keep it. We wouldn't dream of
761asking for any.
762
763Having said all that, if you still really \e{want} to give us money,
764we won't argue :-) The easiest way for us to accept donations is if
765you go to \W{http://www.e-gold.com}\cw{www.e-gold.com}, and deposit
766your donation in account number 174769. Then send us e-mail to let
767us know you've done so (otherwise we might not notice for months!).
768
769Small donations (tens of dollars or tens of euros) will probably be
770spent on beer or curry, which helps motivate our volunteer team to
771continue doing this for the world. Larger donations will be spent on
772something that actually helps development, if we can find anything
773(perhaps new hardware, or a copy of Windows 2000), but if we can't
774find anything then we'll just distribute the money among the
775developers. If you want to be sure your donation is going towards
776something worthwhile, ask us first. If you don't like these terms,
777feel perfectly free not to donate. We don't mind.
778
606398fb 779\S{faq-sillyputty}{Question} Where can I buy silly putty?
780
781You're looking at the wrong web site; the only PuTTY we know about
782here is the name of a computer program.
783
784If you want the kind of putty you can buy as an executive toy, the
785PuTTY team can personally recommend Thinking Putty, which you can
786buy from Crazy Aaron's Putty World, at
787\W{http://www.puttyworld.com}\cw{www.puttyworld.com}.
788
a1d2976b 789\S{faq-pronounce}{Question} How do I pronounce PuTTY?
ee46ef84 790
791Exactly like the normal word \q{putty}. Just like the stuff you put
792on window frames. (One of the reasons it's called PuTTY is because
793it makes Windows usable. :-)