NAME
ssh – secure shell remote login client

SYNOPSIS
ssh [ –d ] [ –R ] [ –r ] [ –t thumbfile ] [ –T tries ] [ –u user ] [ –h ] [ user@]host [ cmd args ... ]

DESCRIPTION
Ssh starts a remote shell or cmd on the computer host logged in as user. The input file descriptor is forwarded to the remote side and output and error descriptors are forwarded to the local side.

The connection is authenticated and encrypted using the SSH2 protocol. The user authenticates 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 $home/lib/sshthumbs file (see thumbprint(6)). The thumbfile location can be changed with the –t option.

When cmd is specified, it is concatenated with the list of quoted args and run on the remote side. No pseudo terminal will be requested. A cmd beginning with # is interpreted as a subsystem name such as sftp (see sshfs(4)).

Without cmd, a shell is started on the remote side. In that case and when the $TERM environment variable is set (such as when started under a terminal emulator like vt(1)), a pseudo terminal will be requested for the shell. This can be disabled with the –R option. A pseudo–terminal can be requested in all cases with the –r option.

The –d option enables debug output.

FILES
$home/lib/sshthumbs   the user's thumbfile of known host fingerprints

SOURCE
/sys/src/cmd/ssh.c

BUGS
If keyboard–interactive authentication fails, by default it is retried three times. The number of tries can be changed with –T. Setting it to zero disables keyboard–interactive authentication.

SEE ALSO
vt(1), rsa(8), thumbprint(6), factotum(4), sshfs(4)