From f92cc520c13b44ab43221c80aa74d8a21d9703f1 Mon Sep 17 00:00:00 2001
From: cjwatson <>
Date: Sun, 17 Nov 2002 16:13:34 -0800
Subject: [PATCH] [project @ 2002-11-17 16:13:34 by cjwatson] Improve exim
 setup instructions with suggestions from me and Chad Miller (#78688).

---
 debian/README.mail | 40 +++++++++++++++++++++++++++++++++-------
 debian/changelog   |  2 ++
 2 files changed, 35 insertions(+), 7 deletions(-)

diff --git a/debian/README.mail b/debian/README.mail
index 4ae47cd8..80cf6a2f 100644
--- a/debian/README.mail
+++ b/debian/README.mail
@@ -32,17 +32,43 @@ debbugs:
   local_parts = submit:bugs:maintonly:quiet:forwarded:done:close:request:submitter:control:^\\d+
 
  2) If the domain is a virtual host on a machine that needs it, there are
-    many ways of handling it.  I think the neatest was:
+    many ways of handling it.  I think the neatest was to use the above
+    transport and director, except to add the following line to the
+    director's options:
 
-debbugs:
-  driver = aliasfile
   domains = <domain name>
-  file = /usr/lib/debbugs/receive
-  user = <some user>
-  group = <some group>
-  current_directory = /var/lib/debbugs/spool
+
+    Alternatively, Chad Miller <cmiller@surfsouth.com> suggests:
+
+    The method I discovered involved adding at the top of the routers section:
+
+debbugs_router:
+  driver = domainlist
+  transport = debbugs_transport
+  route_list = "bugs.foo.bar;bugs.baz.quux"
+
+    where bugs.foo.bar and bugs.baz.quux are mail-domains for which I want to
+    receive bug requests only.
+    Next, add anywhere in the transports section:
+
+debbugs_transport:
+  driver = pipe
+  command = /usr/lib/debbugs/receive
+  user = <some non-root user>
+  group = <some non-root group>
+  current_directory = /etc/debbugs
   home_directory = /var/lib/debbugs/spool
 
+    (current_directory may need to be /var/lib/debbugs/spool, depending on
+    your setup.)
+
+    Next, the mail domains MUST NOT be in the "local_domains" list!
+    Instead, we MUST put them in the "relay_domains" list.
+
+    Essentially, this tells exim that we agree ("relay_domains") to relay
+    mail for those zones ("debbugs_router") and "send" the mail using a pipe
+    ("debbugs_transport").
+
 Qmail
 -----
 From Tommi Virtanen (tv@debian.org), amended by Daniel Ruoso
diff --git a/debian/changelog b/debian/changelog
index edbce786..a86c1ff3 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -79,6 +79,8 @@ debbugs (2.4) experimental; urgency=low
     supports it. [Colin]
   * Prevent people from reading the first line of arbitrary files through
     bugreport.cgi, thanks to Max <rusmir@tula.net>. [Colin]
+  * Add working-for-me instructions for exim setup on non-dedicated sites,
+    together with Chad Miller's suggestions, closes: #78688. [Colin]
   * Fix a few typos, closes: #146745, #152751.
   * Various other things, not worth mentioning here.
 
-- 
2.39.5