ref: 685e107f4e4571c15c19f580590f5c683e6fa70c
parent: 049de17fd553d35a5a9c37356789e1e2f662facf
author: cinap_lenrek <cinap_lenrek@felloff.net>
date: Wed May 3 16:56:20 EDT 2017
ssh(1): document -T tries option, #subsys cmd behaviour
--- a/sys/man/1/ssh
+++ b/sys/man/1/ssh
@@ -11,6 +11,9 @@
.B -t
.I thumbfile
] [
+.B -T
+.I tries
+] [
.B -u
.I user
] [
@@ -47,26 +50,31 @@
.B -t
option.
.PP
-When no
+When
.I cmd
-is specified then ssh starts a shell on the
-remote side.
+is specified, it is concatenated with the list of quoted
+.I args
+and run on the remote side. No pseudo terminal will be requested.
+A
+.I cmd
+beginning with
+.B #
+is interpreted as a subsystem name such as sftp (see
+.IR sshfs (4)).
.PP
-If the
+Without
+.IR cmd ,
+a shell is started on the remote side.
+When the
.B $TERM
-environment variable is set then a pseudo terminal
-will be requested for the shell.
+environment variable is set (such as when started under
+a terminal emulator like
+.IR vt (1)),
+a pseudo terminal will be requested for the shell.
This can be disabled with the
.B -R
option.
.PP
-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
The
.B -d
option enables debug output.
@@ -77,8 +85,18 @@
the user's thumbfile of known host fingerprints
.SH SOURCE
.B /sys/src/cmd/ssh.c
+.SH BUGS
+If
+.I keyboard-interactive
+authentication fails, by default it is retried three times.
+The number of
+.I tries
+can be changed with
+.BR -T .
+Setting it to zero disables keyboard-interactive authentication.
.SH "SEE ALSO"
.IR vt (1),
.IR rsa (8),
.IR thumbprint (6),
-.IR factotum (4)
+.IR factotum (4),
+.IR sshfs (4)
--
⑨