diff --git a/doc/config.but b/doc/config.but index 7c21c0b9..258974bb 100644 --- a/doc/config.but +++ b/doc/config.but @@ -3389,13 +3389,13 @@ will be impossible. This is an SSH-1-specific bug. -\H{config-psusan} The \q{Bare \cw{ssh-connection}} protocol +\H{config-psusan} The \q{Bare \cw{\i{ssh-connection}}} protocol In addition to SSH itself, PuTTY also supports a second protocol that is derived from SSH. It's listed in the PuTTY GUI under the name \q{Bare \cw{ssh-connection}}. -This protocol consists of just the innermost of SSH's three layers: it +This protocol consists of just the innermost of SSH-2's three layers: it leaves out the cryptography layer providing network security, and it leaves out the authentication layer where you provide a username and prove you're allowed to log in as that user. @@ -3417,7 +3417,7 @@ network namespace. Explicit support for this protocol is new in PuTTY 0.75. As of 2021-04, the only known server for the bare \cw{ssh-connection} -protocol is the Unix program \cq{psusan} that is also part of the +protocol is the Unix program \cq{\i{psusan}} that is also part of the PuTTY tool suite. (However, this protocol is also the same one used between instances of @@ -3428,6 +3428,10 @@ possible to connect another instance of PuTTY directly to that Unix socket, by entering its pathname in the host name box and selecting \q{Bare \cw{ssh-connection}} as the protocol!) +Many of the options under the SSH panel also affect this protocol, +although options to do with cryptography and authentication do not, +for obvious reasons. + I repeat, \s{DON'T TRY TO USE THIS PROTOCOL FOR NETWORK CONNECTIONS!} That's not what it's for, and it's not at all safe to do it. diff --git a/doc/index.but b/doc/index.but index 5f9d59ea..5fd0e7fc 100644 --- a/doc/index.but +++ b/doc/index.but @@ -195,6 +195,11 @@ saved sessions from \IM{protocol selection} selecting a protocol \IM{protocol selection} choosing a protocol +\IM{ssh-connection} bare \cw{ssh-connection} protocol +\IM{ssh-connection} \cw{ssh-connection} protocol, bare + +\IM{psusan} \cq{psusan} program + \IM{login name}{username} login name \IM{login name}{username} user name \IM{login name}{username} account name diff --git a/doc/using.but b/doc/using.but index 9c86b196..b583dc8c 100644 --- a/doc/using.but +++ b/doc/using.but @@ -727,9 +727,8 @@ of these options: \b \i\c{-ssh} selects the SSH protocol. \b \i\c{-ssh-connection} selects the bare ssh-connection protocol. -(This is only useful in specialised circumstances.) -\#{FIXME: describe those circumstances somewhere in this manual, -with reference to the psusan man page} +(This is only useful in specialised circumstances; see \k{config-psusan} +for more information.) \b \i\c{-telnet} selects the Telnet protocol.