X-Git-Url: https://git.adam-barratt.org.uk/?a=blobdiff_plain;f=web%2Fforward.html;h=48bc86660c5e2ac203ecf051ac645c5b56b978af;hb=589b5169cd37cf46848163806564963890d7f45e;hp=7fc890c82816b3abd9700da27c0f371ec64573ba;hpb=a5bf36beffbd877ead1d80f70b756bac547863fb;p=mirror%2Fuserdir-ldap.git diff --git a/web/forward.html b/web/forward.html index 7fc890c..48bc866 100644 --- a/web/forward.html +++ b/web/forward.html @@ -8,8 +8,8 @@ - - + + @@ -33,34 +33,83 @@

Email Forwarding

-Emails to @debian.org now go through a LDAP distributed email system. This -system uses the forwarding field in the LDAP directory to route mail without -passing it through a users .forward/.qmail file on a single computer. -Multiple machines participate in the forwarding to provide redudency. +Emails to @debian.org addresses now go through a LDAP distributed email system. +This system uses the forwarding field in the LDAP directory to route mail +without passing it through a users .forward file on a single host. +Multiple machines participate in the forwarding to provide redudancy.

-The system is very simple, each of the forwarders inspects the ldap database -to see if foo@debian.org has fowarding set to an address, if so the envelope -address to is rewritten and the message redirected to that address. +Each forwarders inspects the LDAP database +to see if foo@debian.org has forwarding set to an address, if so the envelope +to address is rewritten and the message redirected to the new address. Otherwise the message is relayed to master.debian.org for processing by the -users .qmail files. If email forwarding is setup then .qmail files are +users .forward files. If email forwarding is setup then .forward files are NOT considered. Extension addresses (foo-lists) are always routed directly to master for processing.

All machines also use the forwarding attribute as a default destination for email. If the user has a home directory and no .forward file the mail is forwarded rather than delivered to /var/spool/mail. This makes sure cron -reports, bug responses and other unexpected emails are not lost. +reports, bug responses and other unexpected emails are not misplaced. +

+If you set the forwarding address to be a specific Debian machine and do +not create a forward file then that machine will spool the mail to +/var/spool/mail instead of creating a mail loop.

The email forwarding can be easially reconfigured using GnuPG:

-echo "emailfoward: foo@bar.com" | gpg --clearsign | mail change@db.debian.org
+echo "emailforward: foo@bar.com" | gpg --clearsign | mail change@db.debian.org

-or by visiting db.debian.org/ +or by visiting db.debian.org +

+You can test the email routing by using the command /usr/sbin/exim -bt +foo@debian.org +

procmail

+If you use procmail for your main mailbox, PLEASE, erase your .forward +file and put a .procmailrc in its place instead. This feature has been +supported on debian.org machines for a good while now, and will continue to be +supported. +

+The correct way to invoke procmail for extension addresses is "|/usr/bin/procmail [options]" +Ignore the IFS=".." stuff in the procmail man page. +

MailBox formats

+Email can be saved to mailboxes or maildirs by using the correct lines in a +.forward file: +

+Mailbox format files "/debian/home/foo/Mbox" +
Maildir format files "/debian/home/foo/MDir/" +

+To deliver to /var/spool/mail/foo use a construct like '|/usr/bin/procmail +-m /dev/null'. Putting the mailbox path will not work. You must use +absolute paths for mailboxes, qmail-like ./ paths are not supported by +Exim. +

+Also, 'Exim Filter' files are deliberately turned off. +

Delivery Environment

+Some environment variables are set per-message (not quoted! Careful!) +It is important to note that the environment variables dealing with +addressing apply to the ENVELOPE address are are totally completely +unrelated to the actual contents of the message: +

+'Standard' Env Variables: +

EXTENSION (the 'foo' in .forward-foo) +
LOGNAME,USER (your user name) +
SENDER (envelope originator of message) +

+'Qmail' Env Variables: +

EXT == EXTENSION +
LOCAL = (the entire bit before the @) +
RECIPIENT = (the entire envelope to) +

+Such that, $RECIPIENT = $LOCAL-$EXTENSION@<something>.

Back to the Debian Project homepage.

You can contact us at admin@db.debian.org.