da-manager@d.o not new-mainainter. new-maintainer is FD who don't care.
[mirror/userdir-ldap.git] / web / forward.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2 <HTML lang="en">
3 <HEAD>
4 <TITLE>Debian GNU/Linux -- Email Forwarding</TITLE>
5 <LINK REV="made" HREF="mailto:webmaster@debian.org">
6 <META http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
7 <META NAME="Description" CONTENT="Debian GNU/Linux is a free distribution of the GNU/Linux operating system. It is maintained and updated through the work of many users who volunteer their time and effort.">
8 <META NAME="Keywords" CONTENT="debian, GNU, linux, unix, open source, free, DFSG ">
9 <META NAME="Language" CONTENT="English">
10 <meta name="Author"    content="Debian Webmaster, webmaster@debian.org">
11 <meta name="Generator" content="WML 1.6.8 (12-01-1999)">
12 <meta name="Modified"  content="09-05-2000 22:51:33">
13 </HEAD>
14 <BODY text="#000000" bgcolor="#FFFFFF" link="#0000FF" vlink="#800080" alink="#FF0000">
15 <TABLE border="0" cellpadding="3" cellspacing="0" width="100%">
16 <TR>
17 <TD>
18 <A HREF="http://www.debian.org/logos/" BORDER="0"><IMG src="/Pics/logo-50.jpg" border="0" hspace="0" vspace="0" alt=""></A>
19 <IMG src="/Pics/debian.jpg" border="0" hspace="0" vspace="0" alt="Debian Project">
20 </TD>
21 </TR>
22 <TR>
23 <TD bgcolor="#DF0451">
24 <A href="http://www.debian.org/"><IMG src="/Pics/home.en.gif" border="0" hspace="2" vspace="3" alt="Home"></A>
25 <A href="http://www.debian.org/intro/about"><IMG src="/Pics/about.en.gif" border="0" hspace="2" vspace="3" alt="About&nbsp;Debian"></A>
26 <A href="http://www.debian.org/News/"><IMG src="/Pics/news.en.gif" border="0" hspace="2" vspace="3" alt="News"></A>
27 <A href="http://www.debian.org/distrib/"><IMG src="/Pics/distrib.en.gif" border="0" hspace="2" vspace="3" alt="Distribution"></A>
28 <A href="http://www.debian.org/support"><IMG src="/Pics/support.en.gif" border="0" hspace="2" vspace="3" alt="Support"></A>
29 <A href="http://www.debian.org/devel/"><IMG src="/Pics/devel.en.gif" border="0" hspace="2" vspace="3" alt="Developers'&nbsp;Corner"></A>
30 <A href="http://www.debian.org/search"><IMG src="/Pics/search.en.gif" border="0" hspace="2" vspace="3" alt="Search"></A>
31 </TD>
32 </TR>
33 </TABLE>
34 <H1>Email Forwarding</H1>
35 <p>
36 Emails to @debian.org now go through a LDAP distributed email system. This
37 system uses the forwarding field in the LDAP directory to route mail without
38 passing it through a users .forward file on a single computer.
39 Multiple machines participate in the forwarding to provide redudency.
40 <p>
41 Each of the forwarders inspects the LDAP database
42 to see if foo@debian.org has forwarding set to an address, if so the <i>envelope
43 to address</i> is rewritten and the message redirected to the new address.
44 Otherwise the message is relayed to master.debian.org for processing by the
45 users .forward files. If email forwarding is setup then .forward files are
46 <b>NOT</b> considered. Extension addresses (foo-lists) are always routed
47 directly to master for processing.
48 <p>
49 All machines also use the forwarding attribute as a default destination for
50 email. If the user has a home directory and no .forward file the mail is
51 forwarded rather than delivered to /var/spool/mail. This makes sure cron
52 reports, bug responses and other unexpected emails are not misplaced.
53 <p>
54 The email forwarding can be easially reconfigured using GnuPG:
55 <pre>
56 echo "emailforward: foo@bar.com" | gpg --clearsign | mail change@db.debian.org
57 </pre>
58 or by visiting <a href="https://db.debian.org/login.html">db.debian.org</a>
59 <h2>procmail</h2>
60 If you use procmail for your main mailbox, PLEASE, erase your .forward
61 file and put a .procmailrc in its place instead. This feature has been
62 supported on debian.org machines for a good while now, and will continue to be
63 supported.
64 <p>
65 The correct way to invoke procmail for extension addresses is "|/usr/bin/procmail [options]"
66 Ignore the IFS=".." stuff in the procmail man page.
67 <h2>MailBox formats</h2>
68 Emails can be saved to mailboxes or maildirs by using the correct lines in a
69 .forward file:
70 <p>
71 Mailbox format files "/debian/home/foo/Mbox"
72 <br>Maildir format files "/debian/home/foo/MDir/"
73 <p>
74 To deliver to /var/spool/mail/foo use a construct like '|/usr/bin/procmail
75 -m /dev/null'. Putting the mailbox path will not work. You must use
76 absolute paths for mailboxes, qmail-like ./ paths are not supported by
77 Exim.
78 <p>
79 Also, 'Exim Filter' files are deliberately turned off.
80 <h2>Delivey Environment</h2>
81 Some environment variables are set per-message (not quoted! Carefull!)
82 It is important to note that the environment variables dealing with
83 addressing apply to the ENVELOPE address are are totally completely
84 unrelated to the actual contents of the message:
85 <p>
86 'Standard' Env Variables:
87 <ol>
88 <li>EXTENSION (the 'foo' in .forward-foo)
89 <li>LOGNAME,USER (your user name)
90 <li>SENDER (envelope originator of message)
91 </ol>
92 <p>
93 'Qmail' Env Variables:
94 <ol>
95 <li>EXT == EXTENSION
96 <li>LOCAL = (the entire bit before the @)
97 <li>RECIPIENT = (the entire envelope to)
98 </ol>
99 <p>
100 Such that, <i>$RECIPIENT = $LOCAL-EXTENSION@&lt;something&gt;</i>.
101 <HR>
102 <P>Back to the <A href="http://www.debian.org/">Debian Project homepage</A>.
103 <HR>
104 <SMALL>You can contact us at <A href="mailto:admin@db.debian.org">admin@db.debian.org</A>.</SMALL><P>
105 <SMALL>Last Modified: Wed, May 10 04:51:33 UTC 2000<BR>
106 Copyright &copy; 1997-1999 <A href="http://www.spi-inc.org/">SPI</A>; See <A href="http://www.debian.org/license">license terms</A>
107         
108          </SMALL>
109 </BODY>
110 </HTML>