1
0
mirror of https://git.tartarus.org/simon/putty.git synced 2025-01-09 09:27:59 +00:00

Docs: index and cross-reference ssh-connection.

This commit is contained in:
Jacob Nevins 2021-04-19 16:22:33 +01:00
parent a0a985957f
commit 20d5055a3a
3 changed files with 14 additions and 6 deletions

View File

@ -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.

View File

@ -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

View File

@ -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.