README FILE FOR etunnel VERSION 0.0.5 2004/05/03

ABOUT
=========================================================
etunnel is a TCP\UDP connections tunneling tool. It can
make direct tunnels or via proxy server.
It was writen by Kostas Petrikas and is totaly free to use and
change under GNU licence. It was developed on
FreeBSD4.9-STABLE and 5.0-RELEASE with GCC 3.2.3, but it
was reported that there are no problems on other
platforms and older GCC versions.

INSTALL
=========================================================
$ make
# make install
$ make clean

etunnel will be installed to /usr/local/bin. If you want
to change it edit PREFIX in Makefile.

UNINSTALL
=========================================================
# make uninstall

RUNING
=========================================================
etunnel [options] [local port] [port protocol] [remote host]
[remote port] [port protocol]

Options:
-t [type] :type of tunnel. Supported types: plain(plain
connection to remote host), socks5(connection using socks5
server), http(connection using HTTP proxy server)
-H [host] :proxy host option (will be ignored if -c was 
used)
-P [port] :proxy port number option (will be ignored if
-c was used)
-d :start as daemon
-c [server list file] :will make tunnel through chain of
proxy servers given in list file
-l [log file] :will not print to terminal but will log to
file
-s :no printing or loging in any way
-u [user] :use [user] as user name to login to proxy
-p [pass] :use [pass] as password to login to proxy
-A [list_file] :Filter connections with ip addreses from
file [list_file] with methond ALLOW (only ips from the
file will be allowed to connect)
-D [list_file] :Filter connections with ip addreses from
file [list_file] with methond DENY (only ips NOT from the
file will be allowed to connect)

Port protocols:
TCP and UDP

EXAMPLES
=========================================================

------------------------------------------
etunnel -t socks5 -H 192.168.1.254 -P 1080 3333 TCP irc.serv.com 6667 TCP

Will open tunnel on port 3333 on local machine using SOCKS5
server 192.168.1.254 port 1080 to IRC server irc.serv.com
port 6667.

------------------------------------------
server list file example:
*************************
socks5@192.168.1.1:1080
http@192.168.1.2:8000
*************************

Server syntax: [protocol]@[host]:[port]
------------------------------------------

CHANGE LOG
=========================================================
*2003-12-10* 0.0.1 released
Things made:
  -Multicasting deamon
  -Plain tunnel support
  -Socks5 tunnel support
  -Readme file

*2003-12-12* 0.0.2 released
Things made:
  -Socks5 chain tunnel support
  -Fixed some older version bugs
  -Added ChangeLog
  
*2003-02-08* 0.0.3 released
Things made:
  -HTTP protocol support for 'CONNECT' method
  -HTTP chain tunnel support
  -Code optimisation
  
 *2003-04-13* 0.0.4 released
Things made:
  -Bug fixes
  -Full UDP support
  -Aditional options
  
*2003-05-03* 0.0.5 released
Things made:
  -Bug fixes
  -Authorisation support
  -ALLOW-DENY support

CONTACTS
=========================================================
You can contact me on IRC server irc.ktu.lt:6667 nick
expl0oi. If am not there leave me a memoserv message with
your contacts and question(s).





