                      TCP Link Mapper (mlink) v0.8.2

 About
~~~~~~~
TCP Link Mapper (mlink) intended for creating TCP mapped links - 
Client <-> Gateway <-> Server.

TCP mapped links are connection-based, bidirectional, links directed to a 
specific server, suitable for protocols such as NNTP, POP3, SMTP, IRC, Telnet.
Connections to specific ports of gateway machine will be redirected
to specific servers.

Using mlink, you can make gateway for protocols such as NNTP, POP3, SMTP,
IRC, Telnet. 


 Configuration
~~~~~~~~~~~~~~~
To configure mlink edit mlink.cnf. This file have comments, also see
"Examples" section below. mlink will check config file for updates
with interval as specifed in directive "cnfcheckinterval". If mlink
detects changes, it will reread config file.

 Socks v5 support
~~~~~~~~~~~~~~~~~~
mlink can use socks daemon for outgoing connections. Look in config file.

 Examples
~~~~~~~~~~
For example: If pop3 server of your ISP is pop3.yourprovider.com, 
smtp server is smtp.yourprovider.com, and your gateway
machine IP is 192.168.1.1 - in mlink.cnf you specify: 

link  smtp  0.0.0.0:2025  smtp.yourprovider.com:25
link  pop3  0.0.0.0:2110  pop3.yourprovider.com:110

Also, define access rules:

access  smtp  192.168.1.0/24
access  pop3  192.168.1.0/24

With these access rules mlink will accept connections from 192.168.1.* network.

So, all connections to port 2110 of gateway machine will be redirected to 
pop3.yourprovider.com port 110 and all connections to port 2025 will be 
redirected to smtp.yourprovider.com port 25. In account settings of your 
mailer specify pop3 address: 192.168.1.1, port:2110, smtp address: 192.168.1.1,
port:2025 - now your mailer will be work through mlink gateway.

And, one more example. If your ISP have http-proxy (nearly all providers have
proxy) you can use mlink to enable http-clients (browsers, etc.) on your
network work with Internet. So, if http-proxy of your ISP is 
proxy.yourprovider.com on port 3128, and your gateway machine IP is 
192.168.1.1 - in mlink.cnf you specify: 

link    web  0.0.0.0:3128  proxy.yourprovider.com:3128
access  web  192.168.1.0/24

In proxy settings of web-browser on your network set proxy address - 
192.168.1.1, port 3128 - and your network can surf Internet.

 Command line options
~~~~~~~~~~~~~~~~~~~~~~
To run mlink:
  type "mlink" at command prompt, for terminate press Ctrl-C.
  or
  type "detach mlink" at command prompt, for terminate type "mlink -k".

Valid options:
  -h                Display short help text 
  -l                Log to console - write log messages to console and 
  	                log-file. (Has no effect if started detached).
  -d                Display configuration - parse config file, write
                    configuration to console and exit. Useful for checking
                    configuration.
  -c <config_file>  Specify config file - Specify alternate location of 
                    config file.
  -k                Send terminate signal to running copy. (You can use
                    any "kill" utility for terminating mlink. For example,
                    you can use go.exe - "go -k mlink").
                    

Eugene "ErOs2" Romanenko. <eros2@os2.ru>.
http://os2.dhs.org/~eros2/
IRC: ErOs2 on #os2russian in EFNet network.
