Bug#248335: debbugs: [patch] README.mail for exim4
Package: debbugs
Severity: wishlist
Tags: patch
Hi,
here is a patch to README.mail, delivering an example configuration
for debbugs to use the Debian exim4 packages. Thanks to Bill
Allombert, who asked me for help and did most of the testing.
The debbugs package is free to dump the files listed in the patch into
the mentioend directories under /etc/exim4/conf.d, resulting in a
working debbugs configuration right after installation if the local
admin chose the split config option when installing exim4, or doing no
harm if the local admin chose a different method of configuration.
Greetings
Marc
--- README.mail.orig 2004-05-09 18:51:59.000000000 +0200
+++ README.mail 2004-05-10 18:01:01.000000000 +0200
@@ -6,9 +6,61 @@
Be sure to set the $gMailer variable correctly in /etc/debbugs/config.
The options are (all lower case) exim, qmail and sendmail.
-Exim
-----
-I've seen two types of setting up Exim used.
+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 in the
+configuration options in yourself at the appropriate place (most
+probably /etc/exim4/exim4.conf or /etc/exim4/exim4.conf.template).
+
+Create a non-root user with a non-root group as its primary group.
+This document will use Debian-debbugs as user and group name:
+ # adduser --system --group --home /var/lib/debbugs \
+ --no-create-home --disabled-login --force-badname Debian-debbugs
+That 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 3 used.
1) If the machine is dedicated and all e-mail goes to the debbugs script,
add this in the transport section:
-- System Information:
Debian Release: testing/unstable
APT prefers unstable
APT policy: (500, 'unstable')
Architecture: i386 (i686)
Kernel: Linux 2.4.26-darren
Locale: LANG=C, LC_CTYPE=C
Reply to: