2017-04-22 22:42:33 +00:00
|
|
|
.TH SSH 1
|
|
|
|
|
.SH NAME
|
|
|
|
|
ssh - secure shell remote login client
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
.B ssh
|
|
|
|
|
[
|
|
|
|
|
.B -d
|
|
|
|
|
] [
|
|
|
|
|
.B -R
|
|
|
|
|
] [
|
2017-04-23 00:59:32 +00:00
|
|
|
.B -t
|
|
|
|
|
.I thumbfile
|
|
|
|
|
] [
|
2017-04-22 22:42:33 +00:00
|
|
|
.B -u
|
|
|
|
|
.I user
|
|
|
|
|
] [
|
|
|
|
|
.IR user @] host
|
|
|
|
|
[
|
|
|
|
|
.I cmd
|
2017-04-22 23:11:12 +00:00
|
|
|
.I args
|
|
|
|
|
.I ...
|
2017-04-22 22:42:33 +00:00
|
|
|
]
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
.I Ssh
|
|
|
|
|
starts a remote shell or
|
|
|
|
|
.I cmd
|
|
|
|
|
on the computer
|
|
|
|
|
.I host
|
|
|
|
|
logged in as
|
|
|
|
|
.IR user .
|
|
|
|
|
The input file descriptor is forwarded to the
|
2017-04-22 23:11:12 +00:00
|
|
|
remote side and output and error descriptors
|
2017-04-22 22:42:33 +00:00
|
|
|
are forwarded to the local side.
|
2017-04-22 23:11:12 +00:00
|
|
|
.PP
|
2017-04-22 22:42:33 +00:00
|
|
|
The connection is authenticated and encrypted
|
2017-04-22 23:11:12 +00:00
|
|
|
using the SSH2 protocol. The user authenticates
|
2017-04-23 01:31:20 +00:00
|
|
|
itself to the host using his RSA key pair (stored
|
|
|
|
|
in factotum) or plaintext passwords. To authenticate
|
|
|
|
|
the host to the user, the hosts RSA public key is
|
|
|
|
|
hashed and compared to the entries in
|
2017-04-23 00:59:32 +00:00
|
|
|
.B $home/lib/sshthumbs
|
2017-04-24 00:21:43 +00:00
|
|
|
file (see
|
|
|
|
|
.IR thumbprint (6)).
|
|
|
|
|
The
|
2017-04-23 01:31:20 +00:00
|
|
|
.I thumbfile
|
|
|
|
|
location can be changed with the
|
2017-04-23 00:59:32 +00:00
|
|
|
.B -t
|
|
|
|
|
option.
|
2017-04-22 22:42:33 +00:00
|
|
|
.PP
|
|
|
|
|
When no
|
|
|
|
|
.I cmd
|
|
|
|
|
is specified then ssh starts a shell on the
|
|
|
|
|
remote side.
|
|
|
|
|
.PP
|
|
|
|
|
If the
|
|
|
|
|
.B $TERM
|
|
|
|
|
environment variable is set then a pseudo terminal
|
|
|
|
|
will be requested for the shell.
|
|
|
|
|
This can be disabled with the
|
|
|
|
|
.B -R
|
|
|
|
|
option.
|
|
|
|
|
.PP
|
2017-04-24 23:26:43 +00:00
|
|
|
If
|
|
|
|
|
.I keyboard-interactive
|
|
|
|
|
authentication fails, by default it is retried three times.
|
|
|
|
|
The number of tries can be changed with
|
|
|
|
|
.BR -T .
|
|
|
|
|
Setting it to zero disables keyboard-interactive authentication.
|
|
|
|
|
.PP
|
2017-04-22 22:42:33 +00:00
|
|
|
The
|
|
|
|
|
.B -d
|
|
|
|
|
option enables debug output.
|
2017-04-23 01:31:20 +00:00
|
|
|
.SH FILES
|
|
|
|
|
.TF $home/lib/sshthumbs
|
|
|
|
|
.TP
|
|
|
|
|
.B $home/lib/sshthumbs
|
|
|
|
|
the user's thumbfile of known host fingerprints
|
2017-04-22 22:42:33 +00:00
|
|
|
.SH SOURCE
|
|
|
|
|
.B /sys/src/cmd/ssh.c
|
2017-04-24 00:21:43 +00:00
|
|
|
.SH "SEE ALSO"
|
2017-04-22 23:11:12 +00:00
|
|
|
.IR vt (1),
|
|
|
|
|
.IR rsa (8),
|
2017-04-24 00:21:43 +00:00
|
|
|
.IR thumbprint (6),
|
2017-04-22 23:11:12 +00:00
|
|
|
.IR factotum (4)
|
