1 4d1f5654 2022-07-06 op .\" Copyright (c) 2021, 2022 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 4d1f5654 2022-07-06 op .Dd $Mdocdate: July 6 2022$
19 b542d800 2021-11-20 op .Nd lazy ssh tunnel
24 8947862e 2021-11-23 op .Fl B Ar sshaddr
26 b542d800 2021-11-20 op .Op Fl t Ar timeout
27 b542d800 2021-11-20 op .Ar destination
29 b542d800 2021-11-20 op .Sh DESCRIPTION
31 b542d800 2021-11-20 op binds the local
33 b542d800 2021-11-20 op and lazily spawns an
35 b542d800 2021-11-20 op instance to forward the traffic to a remote end.
39 b542d800 2021-11-20 op from the last client activity, the ssh tunnel is closed.
43 b542d800 2021-11-20 op tunnel is established by running
46 8947862e 2021-11-23 op .Fl L Ar sshaddr
48 b542d800 2021-11-20 op .Ar destination .
51 b542d800 2021-11-20 op The arguments are as follows:
52 b542d800 2021-11-20 op .Bl -tag -width Ds
55 8947862e 2021-11-23 op .Oo Ar bind_address : Oc
56 8947862e 2021-11-23 op .Ar port : host : hostport
63 c5cb3a17 2022-07-05 op .It Fl b Oo Ar host : Oc Ns Ar port
64 b542d800 2021-11-20 op Where to bind the local socket.
65 d2d81217 2022-12-02 op If not specified,
67 d2d81217 2022-12-02 op defaults to localhost.
69 3376f40a 2021-11-25 op Do not daemonize.
71 3376f40a 2021-11-25 op will run in the foregound and log to
73 b542d800 2021-11-20 op .It Fl t Ar timeout
74 534c038e 2021-11-25 op Number of seconds after the last client shutdown to kill the ssh
76 85b8fe26 2021-11-25 op Set to zero to keep the tunnel open indefinitely.
77 dd30c95b 2021-12-01 op Defaults to 600
78 dd30c95b 2021-12-01 op .Pq ten minutes .
80 3376f40a 2021-11-25 op Produce more verbose output.
83 3b34280e 2022-07-05 op Forward traffic on the local port 2525 to the remote port 25
84 3b34280e 2022-07-05 op .Po the port 2526 is binded by ssh while
86 68d87340 2021-11-25 op listens on 2525 and forwards the traffic
88 68d87340 2021-11-25 op .Bd -literal -offset indent
89 68d87340 2021-11-25 op $ lstun -B 2526:localhost:25 -b 2525 example.com
97 b542d800 2021-11-20 op utility was written by
98 b542d800 2021-11-20 op .An Omar Polo Aq Mt op@omarpolo.com .
100 4caeea22 2021-11-21 op Currently it's impossible to pass flags to the
103 4caeea22 2021-11-21 op This is especially painful when you need to use, say, a jump host.