From c72dc56a0fabde39a8802f25db75702f083a88a2 Mon Sep 17 00:00:00 2001
From: don <>
Date: Thu, 28 Jul 2005 06:32:20 -0800
Subject: [PATCH] [project @ 2005-07-28 07:32:20 by don] * add instructions on
 using exim 4 (thanks to Marc Haber) (closes: #248335)

---
 debian/README.mail | 57 ++++++++++++++++++++++++++++++++++++++++++++--
 debian/changelog   |  3 ++-
 2 files changed, 57 insertions(+), 3 deletions(-)

diff --git a/debian/README.mail b/debian/README.mail
index e2eb2a53..a8fc0adf 100644
--- a/debian/README.mail
+++ b/debian/README.mail
@@ -6,9 +6,62 @@ Config
 Be sure to set the $gMailer variable correctly in /etc/debbugs/config.
 The options are (all lower case) exim, qmail and sendmail.
 
-Exim
+Exim 4
+------
+The exim 4 setup supports virtual domains. This doesn't hurt on a
+dedicated system. File names are for systems that use exim4's split
+config scheme. If you use something else, you'll need to put the
+configuration options in yourself at the appropriate place (most
+likely /etc/exim4/exim4.conf or /etc/exim4/exim4.conf.template).
+
+Create a non-root user with a non-root group as its primary group.
+We'll use Debian-debbugs as the user and group:
+ # adduser --system --group --home /var/lib/debbugs \
+   --no-create-home --disabled-login --force-badname Debian-debbugs
+
+This user needs to be able to write to /var/lib/debbugs.
+
+/etc/exim4/conf.d/main/03_debbugs:
+DEBBUGS_DOMAIN = <domain name>
+DEBBUGS_USER = Debian-debbugs
+DEBBUGS_GROUP = Debian-debbugs
+
+/etc/exim4/conf.d/transport/30_debbugs:
+debbugs_pipe:
+  debug_print = "T: debbugs_pipe for $local_part@$domain"
+  driver = pipe
+  user = DEBBUGS_USER
+  group = DEBBUGS_GROUP
+  command = /usr/lib/debbugs/receive
+  return_output
+
+/etc/exim4/conf.d/router/250_debbugs:
+debbugs:
+  debug_print = "R: debbugs for $local_part@$domain"
+  driver = accept
+  transport = debbugs_pipe
+  local_parts = submit : bugs : maintonly : quiet : forwarded : \
+                done : close : request : submitter : control : ^\\d+
+  domains = DEBBUGS_DOMAIN
+
+bounce_debbugs:
+  debug_print = "R: bounce_debbugs for $local_part@$domain"
+  driver = redirect
+  allow_fail
+  data = :fail: Unknown user
+  domains = DEBBUGS_DOMAIN
+
+The bounce_debbugs router bounces all mail for the DEBBUGS_DOMAIN that
+hasn't been picked up by the debbugs router. If you want addresses
+from that domain that do not belong to debbugs to be handled normally,
+simply omit that router. However, since the pattern on deb debbugs
+router match a significant subset of the domain's local parts, it is
+strongly recommended to use a dedicated domain for debbugs.
+
+
+Exim 3
 ----
-I've seen two types of setting up Exim used.
+I've seen two types of Exim 3 set ups being used:
 
  1) If the machine is dedicated and all e-mail goes to the debbugs script,
     add this in the transport section:
diff --git a/debian/changelog b/debian/changelog
index 9755cc30..0c11d55f 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -55,7 +55,8 @@ debbugs (2.4.2) UNRELEASED; urgency=low
     - Change spamscan.in to work with SA 3.0; This is an incompatible
       change with SA 2.6, and as such, we now Suggests: spamassassin 
       (>=3.0) (closes: #290501)
-    - Update MTA to exim4 (closes: #228597)
+    - Update MTA to exim4 (closes: #228597) and add instructions on using
+      exim 4 (thanks to Marc Haber) (closes: #248335)
     - Added per bug subscription support to debbugs, which relies on an
       external MLM to actually deal with the requests; currently works with
       eoc and sends messages to bugnum\@$gListDomain. (closes: #34071)
-- 
2.39.5