changelog shortlog tags branches changeset files revisions annotate raw help

Mercurial > hg > plan9front / sys/man/1/ssh

changeset 7123: 61c77ecfdb10
parent: f3850ed4100b
author: cinap_lenrek@felloff.net
date: Tue, 02 Apr 2019 18:46:00 +0200
permissions: -rw-r--r--
description: ssh(1): add sshnet(4) reference
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)