--- a/ChangeLog	Thu Mar 17 21:21:17 2005 +1100
+++ b/ChangeLog	Sat Mar 19 00:41:27 2005 +1100
@@ -1,3 +1,5 @@
+ o Add README.sendmail from Andrea Barisani
+ o Add README.exim4 from Jakob Hirsch
  o Skip addresses without a @ when sending
  o Set SO_KEEPALIVE for our connection socket
 1.2.4

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/README.exim4	Sat Mar 19 00:41:27 2005 +1100
@@ -0,0 +1,64 @@
+README.exim4                                                   March 16th 2005
+
+
+This is a step-by-step guide to run mlmmj with Exim4.
+
+
+
+Notes:
+- We assume that you have a user and group called mlmmj to use with mlmmj
+- The exim user needs read access rights to mlmmj's spool directory and its
+  subdirectories
+- Existence of mailing lists is automatically checked and you don't need to
+  put anything into your aliases file
+
+
+1. In the main configuration section:
+
+MLMMJ_HOME=/var/spool/mlmmj
+domainlist mlmmj_domains = list.your.domain
+
+
+2. Add +mlmmj_domains to relay_to_domains:
+
+domainlist relay_to_domains = other.domain : +mlmmj_domains
+
+
+3. In the routers section (before the dnslookup router, preferably at the
+beginning):
+
+mlmmj_router:
+  driver = accept
+  domains = +mlmmj_domains
+  require_files = MLMMJ_HOME/${lc::$local_part}/index
+  local_part_suffix = +*
+  local_part_suffix_optional
+  transport = mlmmj_transport
+
+
+4. Somewhere in the transports section (change the path of mlmmj-recieve if you
+don't use the default location):
+
+mlmmj_transport:
+  driver = pipe
+  return_path_add
+  user = mlmmj
+  group = mlmmj
+  home_directory = MLMMJ_HOME
+  current_directory = MLMMJ_HOME
+  command = /usr/local/bin/mlmmj-recieve -F -L MLMMJ_HOME/${lc::$local_part}
+
+
+5. Test your setup with
+
+$ exim -bt mlmmj-test@your.list.domain
+mlmmj-test@your.list.domain
+  router = mlmmj_router, transport = mlmmj_transport
+
+If you get different output, run it with -d to see what's going wrong.
+If not, you're done!
+
+
+
+	Jakob Hirsch (jh at plonk dot de)
+

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/README.sendmail	Sat Mar 19 00:41:27 2005 +1100
@@ -0,0 +1,96 @@
+Using sendmail + VERP
+
+--------------------------------------------------------------------------------
+
+The following configuration enables VERP (http://cr.yp.to/proto/verp.txt) which
+is useful for mailing list managers that are able to take advantage of that 
+feature.
+
+This configuration is currently used for using the mlmmj manager 
+(http://mlmmj.mmj.dk) with VERP enabled + sendmail.
+
+The hack consists in hooking VERP rewriting in a replacement ruleset for the 
+existing EnvFromSMTP one (called VerpEnvFromSMTP). This is going to work *only*
+if we are splitting messages with multiple recipients in separate queue files 
+since the macro we are using for the rewriting ($u) is not set when multiple 
+rcpt are present.
+
+The first step consists in forcing envelope splitting, this is done using the 
+QUEUE_GROUP feature, here we are definining r=1 (max 1 rcpt per message) for the
+default queue group:
+
+
+QUEUE_GROUP(`mqueue', `P=/var/spool/mqueue, F=f, I=1m,  R=2, r=1')
+
+
+Since we are going to split a lot it's advisable to use the FAST_SPLIT option, 
+additionally we need to enforce return-path inclusion in the local mailer:
+
+
+define(`confFAST_SPLIT', `100')dnl
+define(`LOCAL_SHELL_FLAGS', `eu9P')dnl
+
+
+Then we define a regex map for matching the addresses that we are going to 
+rewrite, in our example we'll rewrite addresses like 
+
+<listname+bounces-123@domain.net> 
+
+with
+
+<listname+bounces-123-user=foo.net@domain.net> 
+
+where user@foo.net is the recipient address of the message. So we need to apply 
+our verp ruleset *only* to those addresses. Additionally we are also adding the 
+Delivered-To header:
+
+
+LOCAL_CONFIG
+Kmatch_verp regex -m -a@VERP (listname\+bounces\-[0-9]+<@domain\.net\.?>)
+H?l?Delivered-To: $u
+
+
+Here's the ruleset, the first half of the ruleset is the existing EnvFromSMTP 
+ruleset present in default sendmail.cf, the seconf half is the VERP stuff:
+
+
+SVerpEnvFromSMTP
+R$+                     $: $>PseudoToReal $1            sender/recipient common
+R$* :; <@>              $@                              list:; special case
+R$*                     $: $>MasqSMTP $1                qualify unqual'ed names
+R$+                     $: $>MasqEnv $1                 do masquerading
+
+R $*                                    $: $(match_verp $1 $)                            match the address
+R $* + $* < @ $* . > $* @VERP           $: $1 + $2 - $&u < @ $3 . > $4 VERP              rewrite it using $u macro and add VERP string for failsafe
+R $* - < @ $* . > $* VERP               $: $1 < @ $2 . > $3                              if $u wasn't defined rewrite the address back
+R $* - < $+ @ $+ > < @ $* . > $* VERP   $: $(dequote $1 "-" $2 "=" $3 $) < @ $4 . > $5   replace the "@" in rcpt address with "="
+R $* - $+ @ $+ < @ $* . > $* VERP       $: $(dequote $1 "-" $2 "=" $3 $) < @ $4 . > $5   replace the "@" in rcpt address with "="
+
+
+Finally we need to rewrite the mailer definition for the used mailer (typically 
+esmtp) specifying VerpEnvFromSMTP as the sender rewrite ruleset:
+
+
+MAILER_DEFINITIONS
+Mesmtp,		P=[IPC], F=mDFMuXa, S=VerpEnvFromSMTP/HdrFromSMTP, R=EnvToSMTP, E=\r\n, L=990,
+		T=DNS/RFC822/SMTP,
+		A=TCP $h
+
+
+
+NOTE: for mailing list servers it's also a good idea keeping existing 
+Delivered-To headers, sendmail needs the following patch for doing this 
+
+--- sendmail/conf.c.orig	2004-07-14 21:54:23.000000000 +0000
++++ sendmail/conf.c	2004-12-06 15:22:05.000000000 +0000
+@@ -117,6 +117,7 @@
+ 	{ "content-length",		H_ACHECK,		NULL	},
+ 	{ "subject",			H_ENCODABLE,		NULL	},
+ 	{ "x-authentication-warning",	H_FORCE,		NULL	},
++	{ "delivered-to",	    H_FORCE,		NULL	},
+ 
+ 	{ NULL,				0,			NULL	}
+ };
+
+
+-- lcars@gentoo.org