1 7b682af0 2021-11-21 op # lstun -- lazy ssh tunnel
 2 7b682af0 2021-11-21 op 
 3 7b682af0 2021-11-21 op lstun is a simple utility to lazily (on demand) spawn a ssh tunnel to
 4 7b682af0 2021-11-21 op a remote machine and kill it after some time of inactivity.
 5 7b682af0 2021-11-21 op 
 6 7b682af0 2021-11-21 op To compile it just run
 7 7b682af0 2021-11-21 op 
 8 56be64f8 2021-11-25 op 	$ ./autogen.sh	# if building from a git checkout
 9 56be64f8 2021-11-25 op 	$ ./configure
10 56be64f8 2021-11-25 op 	$ make
11 56be64f8 2021-11-25 op 	# make install	# eventually
12 7b682af0 2021-11-21 op 
13 2040c43f 2021-11-25 op The only dependency is libevent.  It expects ssh to be `/usr/bin/ssh`,
14 2040c43f 2021-11-25 op compile with `-DSSH_PATH=...` to alter the path eventually.
15 7b682af0 2021-11-21 op 
16 355ad914 2021-12-01 op 
17 355ad914 2021-12-01 op ### Usage
18 355ad914 2021-12-01 op 
19 355ad914 2021-12-01 op ```
20 355ad914 2021-12-01 op usage: lstun [-dv] -B sshaddr -b addr [-t timeout] destination
21 355ad914 2021-12-01 op ```
22 355ad914 2021-12-01 op 
23 355ad914 2021-12-01 op Check out the manpage for further the usage.
24 355ad914 2021-12-01 op 
25 355ad914 2021-12-01 op 
26 355ad914 2021-12-01 op ### Motivation
27 355ad914 2021-12-01 op 
28 355ad914 2021-12-01 op It was written to forward lazily all the traffic on the local port
29 355ad914 2021-12-01 op 2525 to a remote port 25, thus using ssh as some sort of
30 355ad914 2021-12-01 op authentication.
31 355ad914 2021-12-01 op 
32 355ad914 2021-12-01 op The need for the "lazy" opening and closing of the tunnel is to avoid
33 355ad914 2021-12-01 op wasting resources when not needed.