From 414d29e98f8d5242cc68161e61b66b7171e96634 Mon Sep 17 00:00:00 2001
From: cinap_lenrek <cinap_lenrek@felloff.net>
Date: Wed, 3 May 2017 20:56:20 +0200
Subject: [PATCH] ssh(1): document -T tries option, #subsys cmd behaviour

---
 sys/man/1/ssh | 46 ++++++++++++++++++++++++++++++++--------------
 1 file changed, 32 insertions(+), 14 deletions(-)

diff --git a/sys/man/1/ssh b/sys/man/1/ssh
index 1e5d6cce6..b6dcca8b4 100644
--- a/sys/man/1/ssh
+++ b/sys/man/1/ssh
@@ -11,6 +11,9 @@ ssh - secure shell remote login client
 .B -t
 .I thumbfile
 ] [
+.B -T
+.I tries
+] [
 .B -u
 .I user
 ] [
@@ -47,26 +50,31 @@ location can be changed with the
 .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 @@ option enables debug output.
 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)