html/forward.wml

   1 #use wml::db.d.o title="Email Forwarding"
   2 #use wml::vbar
   3
   4 <dsatoc/>
   5
   6 <p>
   7 Emails to @debian.org addresses now go through a LDAP distributed email system.
   8 This system uses the forwarding field in the LDAP directory to route mail
   9 without passing it through a users .forward file on a single host.
  10 Multiple machines participate in the forwarding to provide redundancy.
  11
  12 <p>
  13 Each forwarders inspects the LDAP database
  14 to see if foo@debian.org has forwarding set to an address, if so the <i>envelope
  15 to address</i> is rewritten and the message redirected to the new address.
  16 Otherwise the message is relayed to master.debian.org for processing by the
  17 users .forward files. If email forwarding is setup then .forward files are
  18 <b>NOT</b> considered. Extension addresses (foo-lists) are always routed
  19 directly to master for processing.
  20
  21 <p>
  22 All machines also use the forwarding attribute as a default destination for
  23 email. If the user has a home directory and no .forward file the mail is
  24 forwarded rather than delivered to /var/spool/mail. This makes sure cron
  25 reports, bug responses and other unexpected emails are not misplaced.
  26
  27 <p>
  28 If you set the forwarding address to be a specific Debian machine and do
  29 not create a forward file then that machine will spool the mail to
  30 /var/spool/mail instead of creating a mail loop.
  31
  32 <p>
  33 The email forwarding can be easily reconfigured using GnuPG:
  34 <pre>
  35 echo "emailforward: foo@bar.com" | gpg --clearsign | mail changes@db.debian.org
  36 </pre>
  37 or by visiting <a href="https://db.debian.org/login.html">db.debian.org</a>
  38
  39 <p>
  40 You can test the email routing by using the command <tt>/usr/sbin/exim -bt
  41 foo@debian.org</tt>
  42
  43 <h2>procmail</h2>
  44 If you use procmail for your main mailbox, PLEASE, erase your .forward
  45 file and put a .procmailrc in its place instead. This feature has been
  46 supported on debian.org machines for a good while now, and will continue to be
  47 supported.  .procmailrc files won't be synchronised to all hosts in
  48 the LDAP directory.
  49
  50 <p>
  51 The correct way to invoke procmail for extension addresses is "|/usr/bin/procmail [options]"
  52 Ignore the IFS=".." stuff in the procmail man page.
  53
  54 <h2>MailBox formats</h2>
  55 Email can be saved to mailboxes or maildirs by using the correct lines in a
  56 .forward file:
  57 <p>
  58 Mailbox format files "/debian/home/foo/Mbox"
  59 <br>Maildir format files "/debian/home/foo/MDir/"
  60
  61 <p>
  62 To deliver to /var/spool/mail/foo use a construct like '|/usr/bin/procmail
  63 -m /dev/null'. Putting the mailbox path will not work. You must use
  64 absolute paths for mailboxes, qmail-like ./ paths are not supported by
  65 Exim.
  66
  67 <p>
  68 Also, 'Exim Filter' files are deliberately turned off.