From 9574e3908f0323a9059d7918a8bfb315137f0c57 Mon Sep 17 00:00:00 2001
From: cinap_lenrek <cinap_lenrek@felloff.net>
Date: Sun, 23 Apr 2017 00:42:33 +0200
Subject: [PATCH] ssh(1): initial documentation, needs examples for
 authentication

---
 sys/man/1/ssh | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 51 insertions(+)
 create mode 100644 sys/man/1/ssh

diff --git a/sys/man/1/ssh b/sys/man/1/ssh
new file mode 100644
index 000000000..42d0c2c5e
--- /dev/null
+++ b/sys/man/1/ssh
@@ -0,0 +1,51 @@
+.TH SSH 1
+.SH NAME
+ssh - secure shell remote login client
+.SH SYNOPSIS
+.B ssh 
+[
+.B -d
+] [
+.B -R
+] [
+.B -u
+.I user
+] [
+.IR user @] host
+[
+.I cmd
+]
+.SH DESCRIPTION
+.I Ssh
+starts a remote shell or
+.I cmd
+on the computer 
+.I host
+logged in as
+.IR user .
+The input file descriptor is forwarded to the
+remote side and output and error descriptor
+are forwarded to the local side.
+The connection is authenticated and encrypted
+using the SSH2 protocol.
+.PP
+When no
+.I cmd
+is specified then ssh starts a shell on the
+remote side.
+.PP
+If the
+.B $TERM
+environment variable is set then a pseudo terminal
+will be requested for the shell.
+This can be disabled with the
+.B -R
+option.
+.PP
+The
+.B -d
+option enables debug output.
+.SH SOURCE
+.B /sys/src/cmd/ssh.c
+.SH SEE ALSO
+.IR vt (1)