disallow CNAME and any other RR type for the same name for DNS entries.
[mirror/userdir-ldap.git] / web / forward.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <html lang="en">
3 <head>
4 <meta http-equiv="Content-Type" content="text/html; charset=">
5 <title>Debian GNU/Linux -- Email Forwarding</title>
6 <link rev="made" href="mailto:webmaster@debian.org">
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="">
10 <meta name="Author"    content="Debian Webmaster, webmaster@debian.org">
11 <meta name="Generator" content="WML 2.0.8 (30-Oct-2001)">
12 <meta name="Modified"  content="2002-07-12 19:23:30">
13 </head>
14 <body text="#000000" bgcolor="#FFFFFF" link="#0000FF" vlink="#800080" alink="#FF0000">
15 <table width="100%" align="center" border="0" cellpadding="3" cellspacing="0" summary="">
16 <tr>
17   <td align="left" valign="middle">
18   <a href="http://www.debian.org/"><img src="http://www.debian.org/logos/openlogo-nd-50.png" border="0" hspace="0" vspace="0" alt=""></a>
19   <a href="http://www.debian.org/"><img src="http://www.debian.org/Pics/debian.jpg" border="0" hspace="0" vspace="0" alt="Debian Project"></a>
20   </td>
21 </tr>
22 </table>
23 <!--UdmComment-->
24 <table bgcolor="#DF0451" border="0" cellpadding="0" cellspacing="0" width="100%" summary="">
25 <tr>
26 <td valign="top">
27 <img src="http://www.debian.org/Pics/red-upperleft.png" align="left" border="0" hspace="0" vspace="0" alt="">
28 </td>
29 <td rowspan="2" align="center">
30 <a href="http://www.debian.org/intro/about"><img src="http://www.debian.org/Pics/about.en.gif" align="middle" border="0" hspace="4" vspace="7" alt="About Debian"></a>
31 <a href="http://www.debian.org/News/"><img src="http://www.debian.org/Pics/news.en.gif" align="middle" border="0" hspace="4" vspace="7" alt="News"></a>
32 <a href="http://www.debian.org/distrib/"><img src="http://www.debian.org/Pics/getting.en.gif" align="middle" border="0" hspace="4" vspace="7" alt="Getting Debian"></a>
33 <a href="http://www.debian.org/support"><img src="http://www.debian.org/Pics/support.en.gif" align="middle" border="0" hspace="4" vspace="7" alt="Support"></a>
34 <a href="http://www.debian.org/devel/"><img src="http://www.debian.org/Pics/devel.en.gif" align="middle" border="0" hspace="4" vspace="7" alt="Developers'&nbsp;Corner"></a>
35 <a href="http://www.debian.org/sitemap"><img src="http://www.debian.org/Pics/sitemap.en.gif" align="middle" border="0" hspace="4" vspace="7" alt="Site map"></a>
36 <a href="http://search.debian.org/"><img src="http://www.debian.org/Pics/search.en.gif" align="middle" border="0" hspace="4" vspace="7" alt="Search"></a>
37 </td>
38 <td valign="top">
39 <img src="http://www.debian.org/Pics/red-upperright.png" align="right" border="0" hspace="0" vspace="0" alt="">
40 </td>
41 </tr>
42 <tr>
43 <td valign="bottom">
44 <img src="http://www.debian.org/Pics/red-lowerleft.png" align="left" border="0" hspace="0" vspace="0" alt="">
45 </td>
46 <td valign="bottom">
47 <img src="http://www.debian.org/Pics/red-lowerright.png" align="right" border="0" hspace="0" vspace="0" alt="">
48 </td>
49 </tr>
50 </table>
51 <!--/UdmComment-->
52 <h1>Email Forwarding</h1>
53 <p>
54 Emails to @debian.org addresses now go through a LDAP distributed email system.
55 This system uses the forwarding field in the LDAP directory to route mail
56 without passing it through a users .forward file on a single host.
57 Multiple machines participate in the forwarding to provide redudancy.
58 <p>
59 Each forwarders inspects the LDAP database
60 to see if foo@debian.org has forwarding set to an address, if so the <i>envelope
61 to address</i> is rewritten and the message redirected to the new address.
62 Otherwise the message is relayed to master.debian.org for processing by the
63 users .forward files. If email forwarding is setup then .forward files are
64 <b>NOT</b> considered. Extension addresses (foo-lists) are always routed
65 directly to master for processing.
66 <p>
67 All machines also use the forwarding attribute as a default destination for
68 email. If the user has a home directory and no .forward file the mail is
69 forwarded rather than delivered to /var/spool/mail. This makes sure cron
70 reports, bug responses and other unexpected emails are not misplaced.
71 <p>
72 If you set the forwarding address to be a specific Debian machine and do
73 not create a forward file then that machine will spool the mail to
74 /var/spool/mail instead of creating a mail loop.
75 <p>
76 The email forwarding can be easially reconfigured using GnuPG:
77 <pre>
78 echo "emailforward: foo@bar.com" | gpg --clearsign | mail change@db.debian.org
79 </pre>
80 or by visiting <a href="https://db.debian.org/login.html">db.debian.org</a>
81 <p>
82 You can test the email routing by using the command <tt>/usr/sbin/exim -bt
83 foo@debian.org</tt>
84 <h2>procmail</h2>
85 If you use procmail for your main mailbox, PLEASE, erase your .forward
86 file and put a .procmailrc in its place instead. This feature has been
87 supported on debian.org machines for a good while now, and will continue to be
88 supported.
89 <p>
90 The correct way to invoke procmail for extension addresses is "|/usr/bin/procmail [options]"
91 Ignore the IFS=".." stuff in the procmail man page.
92 <h2>MailBox formats</h2>
93 Email can be saved to mailboxes or maildirs by using the correct lines in a
94 .forward file:
95 <p>
96 Mailbox format files "/debian/home/foo/Mbox"
97 <br>Maildir format files "/debian/home/foo/MDir/"
98 <p>
99 To deliver to /var/spool/mail/foo use a construct like '|/usr/bin/procmail
100 -m /dev/null'. Putting the mailbox path will not work. You must use
101 absolute paths for mailboxes, qmail-like ./ paths are not supported by
102 Exim.
103 <p>
104 Also, 'Exim Filter' files are deliberately turned off.
105 <h2>Delivery Environment</h2>
106 Some environment variables are set per-message (not quoted! Careful!)
107 It is important to note that the environment variables dealing with
108 addressing apply to the ENVELOPE address are are totally completely
109 unrelated to the actual contents of the message:
110 <p>
111 'Standard' Env Variables:
112 <ol>
113 <li>EXTENSION (the 'foo' in .forward-foo)
114 <li>LOGNAME,USER (your user name)
115 <li>SENDER (envelope originator of message)
116 </ol>
117 <p>
118 'Qmail' Env Variables:
119 <ol>
120 <li>EXT == EXTENSION
121 <li>LOCAL = (the entire bit before the @)
122 <li>RECIPIENT = (the entire envelope to)
123 </ol>
124 <p>
125 Such that, <i>$RECIPIENT = $LOCAL-$EXTENSION@&lt;something&gt;</i>.
126 <hr noshade width="100%" size="1">
127 Back to the <a href="http://www.debian.org/">Debian Project homepage</a>.
128 <hr noshade width="100%" size="1">
129 <small>
130 You can contact us at
131 <a href="mailto:admin@db.debian.org">admin@db.debian.org</a>.
132 </small>
133 <p>
134 <small>
135 Last Modified: Fri, Jul 12 17:23:30 UTC 2002
136   <br>
137   Copyright &copy; 1997-2002
138  <a href="http://www.spi-inc.org/">SPI</a>; See <a href="http://www.debian.org/license">license terms</a>
139 </small>
140 </body>
141 </html>