sys/man/1/ssh

   1 .TH SSH 1
   2 .SH NAME
   3 ssh - secure shell remote login client
   4 .SH SYNOPSIS
   5 .B ssh
   6 [
   7 .B -d
   8 ] [
   9 .B -R
  10 ] [
  11 .B -r
  12 ] [
  13 .B -t
  14 .I thumbfile
  15 ] [
  16 .B -T
  17 .I tries
  18 ] [
  19 .B -u
  20 .I user
  21 ] [
  22 .B -h
  23 ] [
  24 .IR user @] host
  25 [
  26 .B -W
  27 .I remote!port
  28 ] [
  29 .I cmd
  30 .I args
  31 .I ...
  32 ]
  33 .SH DESCRIPTION
  34 .I Ssh
  35 starts a remote shell or
  36 .I cmd
  37 on the computer
  38 .I host
  39 logged in as
  40 .IR user .
  41 The input file descriptor is forwarded to the
  42 remote side and output and error descriptors
  43 are forwarded to the local side.
  44 .PP
  45 The connection is authenticated and encrypted
  46 using the SSH2 protocol. The user authenticates
  47 itself to the host using his RSA key pair (stored
  48 in factotum) or plaintext  passwords. To authenticate
  49 the host to the user, the hosts RSA public key is
  50 hashed and compared to the entries in
  51 .B $home/lib/sshthumbs
  52 file (see
  53 .IR thumbprint (6)).
  54 The
  55 .I thumbfile
  56 location can be changed with the
  57 .B -t
  58 option.
  59 .PP
  60 When
  61 .I cmd
  62 is specified, it is concatenated with the list of quoted
  63 .I args
  64 and run on the remote side. No pseudo terminal will be requested.
  65 A
  66 .I cmd
  67 beginning with
  68 .B #
  69 is interpreted as a subsystem name such as sftp (see
  70 .IR sshfs (4)).
  71 .PP
  72 Without
  73 .IR cmd ,
  74 a shell is started on the remote side.
  75 In that case and when the
  76 .B $TERM
  77 environment variable is set (such as when started under
  78 a terminal emulator like
  79 .IR vt (1)),
  80 a pseudo terminal will be requested for the shell.
  81 This can be disabled with the
  82 .B -R
  83 option.
  84 A pseudo-terminal can be requested in all cases
  85 with the
  86 .B -r
  87 option.
  88 .PP
  89 With the
  90 .B -W
  91 option, instead of executing a command remotely, makes
  92 the server dial a tcp connection to
  93 .I remote!port
  94 which the client relays on standard input and output.
  95 For handling multiple connections transparently to
  96 programs, see
  97 .IR sshnet (4).
  98 .PP
  99 The
 100 .B -d
 101 option enables debug output.
 102 .SH FILES
 103 .TF $home/lib/sshthumbs
 104 .TP
 105 .B $home/lib/sshthumbs
 106 the user's thumbfile of known host fingerprints
 107 .SH SOURCE
 108 .B /sys/src/cmd/ssh.c
 109 .SH BUGS
 110 If
 111 .I keyboard-interactive
 112 authentication fails, by default it is retried three times.
 113 The number of
 114 .I tries
 115 can be changed with
 116 .BR -T .
 117 Setting it to zero disables keyboard-interactive authentication.
 118 .SH "SEE ALSO"
 119 .IR vt (1),
 120 .IR rsa (8),
 121 .IR thumbprint (6),
 122 .IR factotum (4),
 123 .IR sshfs (4),
 124 .IR sshnet (4)