1
0
mirror of https://git.tartarus.org/simon/putty.git synced 2025-01-25 01:02:24 +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. 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 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 is derived from SSH. It's listed in the PuTTY GUI under the name
\q{Bare \cw{ssh-connection}}. \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 cryptography layer providing network security, and it
leaves out the authentication layer where you provide a username and leaves out the authentication layer where you provide a username and
prove you're allowed to log in as that user. 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 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} 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. PuTTY tool suite.
(However, this protocol is also the same one used between instances of (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 socket, by entering its pathname in the host name box and selecting
\q{Bare \cw{ssh-connection}} as the protocol!) \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!} 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. 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} selecting a protocol
\IM{protocol selection} choosing 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} login name
\IM{login name}{username} user name \IM{login name}{username} user name
\IM{login name}{username} account 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} selects the SSH protocol.
\b \i\c{-ssh-connection} selects the bare ssh-connection protocol. \b \i\c{-ssh-connection} selects the bare ssh-connection protocol.
(This is only useful in specialised circumstances.) (This is only useful in specialised circumstances; see \k{config-psusan}
\#{FIXME: describe those circumstances somewhere in this manual, for more information.)
with reference to the psusan man page}
\b \i\c{-telnet} selects the Telnet protocol. \b \i\c{-telnet} selects the Telnet protocol.