Cross-reference all the host key docs.

[PuTTY.git] / doc / gs.but

diff --git a/doc/gs.but b/doc/gs.but
index 63cca5d93d7ad20e052da65725f06037bf7db6bb..56ab282a69155564bb9f6fa294e4e3538e38a6ae 100644 (file)
--- a/doc/gs.but
+++ b/doc/gs.but
@@ -1,5 +1,3 @@
-\define{versionidgs} \versionid $Id$
-

 \C{gs} Getting started with PuTTY
 
 This chapter gives a quick guide to the simplest types of
 \C{gs} Getting started with PuTTY
 
 This chapter gives a quick guide to the simplest types of


@@ -19,13 +17,16 @@ In the \q{Host Name} box, enter the Internet \i{host name} of the server
 you want to connect to. You should have been told this by the
 provider of your login account.
 
 you want to connect to. You should have been told this by the
 provider of your login account.
 

-Now select a login \i{protocol} to use, from the \q{Protocol}
+Now select a login \i{protocol} to use, from the \q{Connection type}

 buttons. For a login session, you should select \i{Telnet},
 \i{Rlogin} or \i{SSH}. See \k{which-one} for a description of the
 differences between the three protocols, and advice on which one to
 use. The fourth protocol, \I{raw protocol}\e{Raw}, is not used for
 interactive login sessions; you would usually use this for debugging
 buttons. For a login session, you should select \i{Telnet},
 \i{Rlogin} or \i{SSH}. See \k{which-one} for a description of the
 differences between the three protocols, and advice on which one to
 use. The fourth protocol, \I{raw protocol}\e{Raw}, is not used for
 interactive login sessions; you would usually use this for debugging

-other Internet services (see \k{using-rawprot}).
+other Internet services (see \k{using-rawprot}). The fifth option,
+\e{Serial}, is used for connecting to a local serial line, and works
+somewhat differently: see \k{using-serial} for more information on
+this.

 
 When you change the selected protocol, the number in the \q{Port}
 box will change. This is normal: it happens because the various
 
 When you change the selected protocol, the number in the \q{Port}
 box will change. This is normal: it happens because the various


@@ -76,13 +77,13 @@ server and it sends you a different host key from the one you were
 expecting, PuTTY can warn you that the server may have been switched
 and that a spoofing attack might be in progress.
 
 expecting, PuTTY can warn you that the server may have been switched
 and that a spoofing attack might be in progress.
 

-PuTTY records the host key for each server you connect to, in the
-Windows \i{Registry}. Every time you connect to a server, it checks
-that the host key presented by the server is the same host key as it
-was the last time you connected. If it is not, you will see a
-warning, and you will have the chance to abandon your connection
-before you type any private information (such as a password) into
-it.
+PuTTY \I{host key cache}records the host key for each server you
+connect to, in the Windows \i{Registry}. Every time you connect to a
+server, it checks that the host key presented by the server is the
+same host key as it was the last time you connected. If it is not,
+you will see a warning, and you will have the chance to abandon your
+connection before you type any private information (such as a
+password) into it.

 
 However, when you connect to a server you have not connected to
 before, PuTTY has no way of telling whether the host key is the
 
 However, when you connect to a server you have not connected to
 before, PuTTY has no way of telling whether the host key is the


@@ -96,11 +97,13 @@ network users are on the same side and spoofing attacks are
 unlikely, so you might choose to trust the key without checking it.
 If you are connecting across a hostile network (such as the
 Internet), you should check with your system administrator, perhaps
 unlikely, so you might choose to trust the key without checking it.
 If you are connecting across a hostile network (such as the
 Internet), you should check with your system administrator, perhaps

-by telephone or in person. (Some modern servers have more than one
+by telephone or in person. (Many servers have more than one

 host key. If the system administrator sends you more than one
 \I{host key fingerprint}fingerprint, you should make sure the one
 PuTTY shows you is on the list, but it doesn't matter which one it is.)
 
 host key. If the system administrator sends you more than one
 \I{host key fingerprint}fingerprint, you should make sure the one
 PuTTY shows you is on the list, but it doesn't matter which one it is.)
 

+See \k{config-ssh-hostkey} for advanced options for managing host keys.
+

 \# FIXME: this is all very fine but of course in practice the world
 doesn't work that way. Ask the team if they have any good ideas for
 changes to this section!
 \# FIXME: this is all very fine but of course in practice the world
 doesn't work that way. Ask the team if they have any good ideas for
 changes to this section!