From d89003fee31325dcc0f7d115d9e2b10109e25491 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Cl=C3=A9ment=20Zrounba?=
 <6691770+clement-z@users.noreply.github.com>
Date: Tue, 21 Nov 2023 13:47:35 +0100
Subject: update

---
 README.md | 43 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)

(limited to 'README.md')

diff --git a/README.md b/README.md
index e69de29..e6b11b7 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,43 @@
+# Establish persistent ssh tunnels
+
+Establish a persistent TCP tunnel between a local endpoint and a remote server.
+If the connection drops, reconnection attempts are made every 10 seconds.
+
+```
+SYNOPSYS
+    ./proxy-tcp-ssh.sh (-S|--ssh-host) SSHHOST (-t|--tunnel) TUNNELSPEC [OPTIONS]
+DESCRIPTION
+    Spawn TCP tunnels between your computer and a remote SSH server. If the
+    connection fail for some reason, the script will try to re-create the
+    tunnels automatically every TIMEOUT seconds.
+OPTIONS
+    -S,--ssh-host SSHHOST
+        Set the ssh host. SSHHOST can be either the full hostname as you would
+        specify it on the ssh command-line (e.g. [user@]myserver.com or hostname
+        if it is set up in your ssh config).
+
+    -t,--tunnel TUNNELSPEC
+        Specify the ports to tunnel as a comma-separated list of either single
+        ports or port pairs (e.g. -t 443,80:8080 will establish tunnels
+        local:443-remote:443  and local:8080-remote:80). Note that you have to
+        be a privileged user (i.e. a user with the CAP_NET_BIND_SERVICE
+        capability) to be able to bind to ports below 1024.
+
+    -p,--ssh-port SSHPORT /!\ Not implemented
+        Set the ssh remote port if different from the default.
+
+    -H,--host HOST
+        Set the tunnel host. HOST can be either the IP or hostname of the
+        server to tunnel to, as seen from the ssh host. Defaults to localhost.
+
+    -i,--interface IF /!\ Not implemented
+        Specify the local interface to bind to. Defaults to localhost. Setting
+        it to 0.0.0.0 will make the tunnel available to other clients on your
+        network (depending on your firewall rules).
+
+    -f
+        Fork the script to the background.
+
+    -h,--help
+        Print this help and exit.
+```
-- 
cgit v1.2.3