$Id: README,v 1.4 2007/01/03 16:57:15 mardan Exp $ Description: ------------------------------------------------------------------------------- Rcpt-relay is a program which checks if users exists at another MTA, using the Sendmail milter API. ------------------------------------------------------------------------------- Requirements and known to work with: ------------------------------------------------------------------------------- Sendmail with milter support. (tested with v8.13.1 and v8.13.8) BerkelyDB (tested with v4.1.x and v4.2.x) Linux x86 Solaris 8 sparc ------------------------------------------------------------------------------- Compiling: ------------------------------------------------------------------------------- Go see the INSTALL file. ------------------------------------------------------------------------------- Changelog: ------------------------------------------------------------------------------- Look into the CHANGELOG file. ------------------------------------------------------------------------------- Troubleshooting: ------------------------------------------------------------------------------- - Make sure you use the correct -mcpu/-march for your system in the Makefile. - You have setup your mailertable correctly. - If your system doesn't support getaddrinfo() function, disable it in Makefile, it shall build using the gethostbyname() ------------------------------------------------------------------------------- Usage: ------------------------------------------------------------------------------- options: -h :this help -p :socket-address (default: local:/var/spammilt/spammilt.sock) -H :manually set MTA servername, otherwise autodetect -t :set socket timeout ------------------------------------------------------------------------------- Some notes: ------------------------------------------------------------------------------- Rcpt-relay uses the milter API of Sendmail to check whether users exists at another MTA. It does that by acting as a client connecting to the MTA where the user should exists. Rcpt-relay indirectly uses the mailertable to check the email address at the "next" MTA. Example: When Sendmail is configured as a mailproxy to scan the mail for viruses etc. it doesn't know the users which should be accepted for the domain. Since it only scans the email and passes it though to another MTA (which is for example in the safe zone). When an user doesn't exist the 2nd MTA replies 'User unknown' to the first MTA. This is where rcpt-relay kicks in. When the email is recieved at the first MTA it checks at the 2nd MTA whether the user exists. If an user is unknown the first MTA replies immediately 'User unknown'. This saves a lot of bounces and data traffic. ------------------------------------------------------------------------------- Homepage: ------------------------------------------------------------------------------- http://www.tweegy.nl/projects/rcpt-relay/index.html ------------------------------------------------------------------------------- Files: ------------------------------------------------------------------------------- AUTHORS COPYING NEWS ChangeLog README INSTALL Makefile Makefile.Solaris-sparc rcpt-relay.c rcpt-relay.h ------------------------------------------------------------------------------- Credits: ------------------------------------------------------------------------------- John Merriam, for writing the local caching part and contributing code which uses the sendmail mailertable function instead of hardcoded forward-MTA, other fixes and testing new code. -------------------------------------------------------------------------------