Host key q: mention kh2reg.py

[u/mdw/putty] / doc / faq.but

diff --git a/doc/faq.but b/doc/faq.but
index 0a6aa89..dc5c574 100644 (file)
--- a/doc/faq.but
+++ b/doc/faq.but
@@ -1,10 +1,30 @@
-\versionid $Id: faq.but,v 1.51 2003/11/19 19:09:07 jacob Exp $
+\versionid $Id: faq.but,v 1.54 2004/02/04 18:39:14 jacob Exp $
 
 \A{faq} PuTTY FAQ
 
 This FAQ is published on the PuTTY web site, and also provided as an
 appendix in the manual.
 
+\H{faq-intro} Introduction
+
+\S{faq-what} What is PuTTY?
+
+PuTTY is a client program for the SSH, Telnet and Rlogin network
+protocols.
+
+These protocols are all used to run a remote session on a computer,
+over a network. PuTTY implements the client end of that session: the
+end at which the session is displayed, rather than the end at which
+it runs.
+
+In really simple terms: you run PuTTY on a Windows machine, and tell
+it to connect to (for example) a Unix machine. PuTTY opens a window.
+Then, anything you type into that window is sent straight to the
+Unix machine, and everything the Unix machine sends back is
+displayed in the window. So you can work on the Unix machine as if
+you were sitting at its console, while actually sitting somewhere
+else.
+
 \H{faq-support} Features supported in PuTTY
 
 In general, if you want to know if PuTTY supports a particular
@@ -130,6 +150,12 @@ of host key checking: the right key will be accepted and the wrong
 ones will not. Adding an option to turn host key checking off
 completely is the wrong solution and we will not do it.
 
+If you have host keys available in the common \c{known_hosts} format,
+we have a script called 
+\W{http://cvs.tartarus.org/putty/contrib/kh2reg.py}\c{kh2reg.py}
+to convert them to a Windows .REG file, which can be installed ahead of
+time by double-clicking or using \c{REGEDIT}.
+
 \S{faq-server}{Question} Will you write an SSH server for the PuTTY
 suite, to go with the client?
 
@@ -190,10 +216,10 @@ or any other port of PuTTY, they were mistaken. We don't.
 
 It's currently being worked on. If you look at the nightly source
 snapshots, you should find a \c{unix} subdirectory, which should
-build you Unix ports of Plink, PuTTY itself, PSCP, PSFTP, and
-also \c{pterm} - an \cw{xterm}-type program which supports the
-same terminal emulation as PuTTY. We do not yet have Unix ports of
-Pageant or PuTTYgen.
+build you Unix ports of Plink, PuTTY itself, PuTTYgen, PSCP, PSFTP,
+and also \c{pterm} - an \cw{xterm}-type program which supports the
+same terminal emulation as PuTTY. We do not yet have a Unix port of
+Pageant.
 
 \S{faq-wince}{Question} Will there be a port to Windows CE or PocketPC?