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