1 b542d800 2021-11-20 op .\" Copyright (c) 2021 Omar Polo <op@omarpolo.com>
3 b542d800 2021-11-20 op .\" Permission to use, copy, modify, and distribute this software for any
4 b542d800 2021-11-20 op .\" purpose with or without fee is hereby granted, provided that the above
5 b542d800 2021-11-20 op .\" copyright notice and this permission notice appear in all copies.
7 b542d800 2021-11-20 op .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
8 b542d800 2021-11-20 op .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
9 b542d800 2021-11-20 op .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
10 b542d800 2021-11-20 op .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
11 b542d800 2021-11-20 op .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
12 b542d800 2021-11-20 op .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
13 b542d800 2021-11-20 op .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
14 b542d800 2021-11-20 op .Dd $Mdocdate: November 20 2021$
19 b542d800 2021-11-20 op .Nd lazy ssh tunnel
23 b542d800 2021-11-20 op .Fl B Ar port:host:hostport
25 b542d800 2021-11-20 op .Op Fl t Ar timeout
26 b542d800 2021-11-20 op .Ar destination
28 b542d800 2021-11-20 op .Sh DESCRIPTION
30 b542d800 2021-11-20 op binds the local
32 b542d800 2021-11-20 op and lazily spawns an
34 b542d800 2021-11-20 op instance to forward the traffic to a remote end.
38 b542d800 2021-11-20 op from the last client activity, the ssh tunnel is closed.
42 b542d800 2021-11-20 op tunnel is established by running
44 b542d800 2021-11-20 op .Pa /usr/bin/ssh
45 b542d800 2021-11-20 op .Fl L Ar port:host:hostport
47 b542d800 2021-11-20 op .Ar destination .
50 b542d800 2021-11-20 op The arguments are as follows:
51 b542d800 2021-11-20 op .Bl -tag -width Ds
52 b542d800 2021-11-20 op .It Fl B Ar port:host:hostport
57 b542d800 2021-11-20 op .It Fl b Ar addr
58 b542d800 2021-11-20 op Where to bind the local socket.
59 b542d800 2021-11-20 op A port number or the tuple host:port.
60 b542d800 2021-11-20 op .It Fl t Ar timeout
61 b542d800 2021-11-20 op Number of seconds after after the last client shutdown to kill the ssh
63 b542d800 2021-11-20 op Defaults to 120.
69 b542d800 2021-11-20 op utility was written by
70 b542d800 2021-11-20 op .An Omar Polo Aq Mt op@omarpolo.com .
72 236c6984 2021-11-21 op There's a 5 second timeout after spawning
74 236c6984 2021-11-21 op to wait for the tunnel to be established.
75 236c6984 2021-11-21 op It should really sleep for a little less
76 236c6984 2021-11-21 op .Pq say one second
77 236c6984 2021-11-21 op and then retry to connect multiple times until it succeed.