projects / mirror / userdir-ldap.git / commitdiff
? search:
summary | shortlog | log | commit | commitdiff | tree
raw | patch | inline | side by side (parent: ba1408e)
forward docs update
authorjgg <>
Wed, 10 May 2000 02:52:00 +0000 (02:52 +0000)
committerjgg <>
Wed, 10 May 2000 02:52:00 +0000 (02:52 +0000)
web/doc-general.html patch | blob | history
web/forward.html patch | blob | history
web/forward.wml patch | blob | history

diff --git a/web/doc-general.html b/web/doc-general.html
index cb594d4..cf38433 100644 (file)
--- a/web/doc-general.html
+++ b/web/doc-general.html
@@ -9,7 +9,7 @@
 <META NAME="Language" CONTENT="English">
 <meta name="Author"    content="Debian Webmaster, webmaster@debian.org">
 <meta name="Generator" content="WML 1.6.8 (12-01-1999)">
 <META NAME="Language" CONTENT="English">
 <meta name="Author"    content="Debian Webmaster, webmaster@debian.org">
 <meta name="Generator" content="WML 1.6.8 (12-01-1999)">
-<meta name="Modified"  content="07-03-2000 00:49:35">
+<meta name="Modified"  content="02-05-2000 21:59:30">
 </HEAD>
 <BODY text="#000000" bgcolor="#FFFFFF" link="#0000FF" vlink="#800080" alink="#FF0000">
 <TABLE border="0" cellpadding="3" cellspacing="0" width="100%">
 </HEAD>
 <BODY text="#000000" bgcolor="#FFFFFF" link="#0000FF" vlink="#800080" alink="#FF0000">
 <TABLE border="0" cellpadding="3" cellspacing="0" width="100%">
@@ -39,8 +39,9 @@ also provides services for leaving vacation notices, updating
 <a href="http://www.debian.org/devel/developers.loc">xplanet</a> coordinates,
 email forwarding, ssh authentication keys and other information.
 <p>
 <a href="http://www.debian.org/devel/developers.loc">xplanet</a> coordinates,
 email forwarding, ssh authentication keys and other information.
 <p>
-Note: master does not presently use the LDAP directory. All machines running
-OpenSSH are using replicated SSH RSA authentication keys.
+Note: the 'passwd' program and 'chfn' do not work with LDAP information.
+Please use the web page or email gateway for the time being. All machines
+running OpenSSH are using replicated SSH RSA authentication keys.
 <h1>Security and Privacy</h1>
 Three levels of information security are provided by the database. The first
 is completely public information that anyone can see either by issuing an
 <h1>Security and Privacy</h1>
 Three levels of information security are provided by the database. The first
 is completely public information that anyone can see either by issuing an
@@ -74,7 +75,7 @@ The directory has several means to access it:
 <P>Back to the <A href="http://www.debian.org/">Debian Project homepage</A>.
 <HR>
 <SMALL>You can contact us at <A href="mailto:admin@db.debian.org">admin@db.debian.org</A>.</SMALL><P>
 <P>Back to the <A href="http://www.debian.org/">Debian Project homepage</A>.
 <HR>
 <SMALL>You can contact us at <A href="mailto:admin@db.debian.org">admin@db.debian.org</A>.</SMALL><P>
-<SMALL>Last Modified: Tue, Mar 7 07:49:35 UTC 2000<BR>
+<SMALL>Last Modified: Wed, May 3 03:59:30 UTC 2000<BR>
 Copyright &copy; 1997-1999 <A href="http://www.spi-inc.org/">SPI</A>; See <A href="http://www.debian.org/license">license terms</A>
        
         </SMALL>
 Copyright &copy; 1997-1999 <A href="http://www.spi-inc.org/">SPI</A>; See <A href="http://www.debian.org/license">license terms</A>
        
         </SMALL>
diff --git a/web/forward.html b/web/forward.html
index 7fc890c..207af53 100644 (file)
--- a/web/forward.html
+++ b/web/forward.html
@@ -9,7 +9,7 @@
 <META NAME="Language" CONTENT="English">
 <meta name="Author"    content="Debian Webmaster, webmaster@debian.org">
 <meta name="Generator" content="WML 1.6.8 (12-01-1999)">
 <META NAME="Language" CONTENT="English">
 <meta name="Author"    content="Debian Webmaster, webmaster@debian.org">
 <meta name="Generator" content="WML 1.6.8 (12-01-1999)">
-<meta name="Modified"  content="02-05-2000 21:52:52">
+<meta name="Modified"  content="09-05-2000 22:51:33">
 </HEAD>
 <BODY text="#000000" bgcolor="#FFFFFF" link="#0000FF" vlink="#800080" alink="#FF0000">
 <TABLE border="0" cellpadding="3" cellspacing="0" width="100%">
 </HEAD>
 <BODY text="#000000" bgcolor="#FFFFFF" link="#0000FF" vlink="#800080" alink="#FF0000">
 <TABLE border="0" cellpadding="3" cellspacing="0" width="100%">
@@ -35,32 +35,74 @@
 <p>
 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
 <p>
 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.
+passing it through a users .forward file on a single computer.
 Multiple machines participate in the forwarding to provide redudency.
 <p>
 Multiple machines participate in the forwarding to provide redudency.
 <p>
-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 of the forwarders inspects the LDAP database
+to see if foo@debian.org has forwarding set to an address, if so the <i>envelope
+to address</i> is rewritten and the message redirected to the new address.
 Otherwise the message is relayed to master.debian.org for processing by the
 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
 <b>NOT</b> considered. Extension addresses (foo-lists) are always routed
 directly to master for processing.
 <p>
 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
 <b>NOT</b> considered. Extension addresses (foo-lists) are always routed
 directly to master for processing.
 <p>
 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.
 <p>
 The email forwarding can be easially reconfigured using GnuPG:
 <pre>
 <p>
 The email forwarding can be easially reconfigured using GnuPG:
 <pre>
-echo "emailfoward: foo@bar.com" | gpg --clearsign | mail change@db.debian.org
+echo "emailforward: foo@bar.com" | gpg --clearsign | mail change@db.debian.org
 </pre>
 </pre>
-or by visiting <a href="https://db.debian.org/login.html">db.debian.org/</a>
+or by visiting <a href="https://db.debian.org/login.html">db.debian.org</a>
+<h2>procmail</h2>
+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.
+<p>
+The correct way to invoke procmail for extension addresses is "|/usr/bin/procmail [options]"
+Ignore the IFS=".." stuff in the procmail man page.
+<h2>MailBox formats</h2>
+Emails can be saved to mailboxes or maildirs by using the correct lines in a
+.forward file:
+<p>
+Mailbox format files "/debian/home/foo/Mbox"
+<br>Maildir format files "/debian/home/foo/MDir/"
+<p>
+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.
+<p>
+Also, 'Exim Filter' files are deliberately turned off.
+<h2>Delivey Environment</h2>
+Some environment variables are set per-message (not quoted! Carefull!)
+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:
+<p>
+'Standard' Env Variables:
+<ol>
+<li>EXTENSION (the 'foo' in .forward-foo)
+<li>LOGNAME,USER (your user name)
+<li>SENDER (envelope originator of message)
+</ol>
+<p>
+'Qmail' Env Variables:
+<ol>
+<li>EXT == EXTENSION
+<li>LOCAL = (the entire bit before the @)
+<li>RECIPIENT = (the entire envelope to)
+</ol>
+<p>
+Such that, <i>$RECIPIENT = $LOCAL-EXTENSION@&lt;something&gt;</i>.
 <HR>
 <P>Back to the <A href="http://www.debian.org/">Debian Project homepage</A>.
 <HR>
 <SMALL>You can contact us at <A href="mailto:admin@db.debian.org">admin@db.debian.org</A>.</SMALL><P>
 <HR>
 <P>Back to the <A href="http://www.debian.org/">Debian Project homepage</A>.
 <HR>
 <SMALL>You can contact us at <A href="mailto:admin@db.debian.org">admin@db.debian.org</A>.</SMALL><P>
-<SMALL>Last Modified: Wed, May 3 03:52:52 UTC 2000<BR>
+<SMALL>Last Modified: Wed, May 10 04:51:33 UTC 2000<BR>
 Copyright &copy; 1997-1999 <A href="http://www.spi-inc.org/">SPI</A>; See <A href="http://www.debian.org/license">license terms</A>
        
         </SMALL>
 Copyright &copy; 1997-1999 <A href="http://www.spi-inc.org/">SPI</A>; See <A href="http://www.debian.org/license">license terms</A>
        
         </SMALL>
diff --git a/web/forward.wml b/web/forward.wml
index 0a374af..ec56f37 100644 (file)
--- a/web/forward.wml
+++ b/web/forward.wml
@@ -2,15 +2,15 @@
 <p>
 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
 <p>
 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.
+passing it through a users .forward file on a single computer.
 Multiple machines participate in the forwarding to provide redudency.
 
 <p>
 Multiple machines participate in the forwarding to provide redudency.
 
 <p>
-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 of the forwarders inspects the LDAP database
+to see if foo@debian.org has forwarding set to an address, if so the <i>envelope
+to address</i> is rewritten and the message redirected to the new address.
 Otherwise the message is relayed to master.debian.org for processing by the
 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
 <b>NOT</b> considered. Extension addresses (foo-lists) are always routed
 directly to master for processing.
 
 <b>NOT</b> considered. Extension addresses (foo-lists) are always routed
 directly to master for processing.
 
@@ -18,12 +18,62 @@ 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
 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.
 
 <p>
 The email forwarding can be easially reconfigured using GnuPG:
 <pre>
 
 <p>
 The email forwarding can be easially reconfigured using GnuPG:
 <pre>
-echo "emailfoward: foo@bar.com" | gpg --clearsign | mail change@db.debian.org
+echo "emailforward: foo@bar.com" | gpg --clearsign | mail change@db.debian.org
 </pre>
 </pre>
-or by visiting <a href="https://db.debian.org/login.html">db.debian.org/</a>
+or by visiting <a href="https://db.debian.org/login.html">db.debian.org</a>
 
 
+<h2>procmail</h2>
+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.
+
+<p>
+The correct way to invoke procmail for extension addresses is "|/usr/bin/procmail [options]"
+Ignore the IFS=".." stuff in the procmail man page.
+
+<h2>MailBox formats</h2>
+Emails can be saved to mailboxes or maildirs by using the correct lines in a
+.forward file:
+<p>
+Mailbox format files "/debian/home/foo/Mbox"
+<br>Maildir format files "/debian/home/foo/MDir/"
+
+<p>
+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.
+
+<p>
+Also, 'Exim Filter' files are deliberately turned off.
+
+<h2>Delivey Environment</h2>
+Some environment variables are set per-message (not quoted! Carefull!)
+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:
+<p>
+'Standard' Env Variables:
+<ol>
+<li>EXTENSION (the 'foo' in .forward-foo)
+<li>LOGNAME,USER (your user name)
+<li>SENDER (envelope originator of message)
+</ol>
+
+<p>
+'Qmail' Env Variables:
+<ol>
+<li>EXT == EXTENSION
+<li>LOCAL = (the entire bit before the @)
+<li>RECIPIENT = (the entire envelope to)
+</ol>
+
+<p>
+Such that, <i>$RECIPIENT = $LOCAL-EXTENSION@&lt;something&gt;</i>.
+  
Mirror of Debian's userdir-ldap repository