CVS: tmda/htdocs config-pre.ht,1.18,1.19 config-pre.html,1.40,1.41 config-server.ht,1.27,1.28 config-server.html,1.52,1.53 requirements.ht,1.21,1.22 requirements.html,1.47,1.48
"Jason R. Mastaler" <[email protected]>
| Newsgroups | gmane.mail.spam.tmda.cvs |
|---|---|
| Message-ID | <[email protected]> |
Update of /cvsroot/tmda/tmda/htdocs
In directory sc8-pr-cvs1:/tmp/cvs-serv16375
Modified Files:
config-pre.ht config-pre.html config-server.ht
config-server.html requirements.ht requirements.html
Log Message:
Add instructions for using maildrop instead of procmail
to drive TMDA under Sendmail. Contributed by Andrew Armstrong.
Index: config-pre.ht
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/config-pre.ht,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- config-pre.ht 3 Jun 2003 21:31:50 -0000 1.18
+++ config-pre.ht 3 Jun 2003 22:27:56 -0000 1.19
@@ -192,18 +192,22 @@
In order to use TMDA, you need some way to obtain the necessary
envelope information and set the required environment variables. It
matters not how you do this, just as long as these variables are
-properly set by the time TMDA sees the message. We provide a solution
-below for sites with procmail configured as the local mailer.
+properly set by the time TMDA sees the message. We provide example solutions
+below for sites with
+<a href="http://www.procmail.org/" TARGET="Resource Window">procmail</a>
+or
+<a href="http://www.flounder.net/~mrsam/maildrop/" TARGET="Resource Window">maildrop</a>
+configured as the local mailer.
<br><br>
-If your Sendmail installation is using <a
-href="http://www.procmail.org/" TARGET="Resource Window">procmail</a>
-as its local mailer, the necessary information is passed as a command
-line argument to procmail, typically introduced by the "-a" flag.
-Your <b>.procmailrc</b> will then be able to construct the environment
+<u>Procmail</u><br><br>
+If your Sendmail installation is using procmail as its local mailer,
+the necessary envelope information is passed as a command line argument to
+procmail, typically introduced by the "-a" flag. Your
+<b>.procmailrc</b> will then be able to construct the environment
variables from this argument. The necessary Sendmail configuration
-changes are covered below, and a sample .procmailrc is given on the
-<a href="config-server.html">Server Configuration</a> page.
+changes are covered below, and a sample .procmailrc is given on the <a
+href="config-server.html">Server Configuration</a> page.
<ol>
<li>Make sure procmail is installed on your server, and then add the
@@ -217,6 +221,33 @@
<li>Now run <b>sendmail.mc</b> through <b>m4</b> to produce your new
<b>sendmail.cf</b> file, and restart Sendmail so the changes will take
effect.
+
+</ol>
+
+<u>Maildrop</u><br><br>
+If your Sendmail installation is using maildrop as its local mailer,
+the necessary envelope information is passed as command line arguments to
+maildrop. Your <b>.mailfilter</b> will then be able to construct the environment
+variables from these arguments. The necessary Sendmail configuration
+changes are covered below, and a sample .mailfilter is given on the
+<a href="config-server.html">Server Configuration</a> page.
+<ol>
+
+<li>Make sure maildrop is installed on your server, and then add the
+following rule to your <b>sendmail.mc</b> file if it is not
+already present:
+
+<blockquote><pre>
+FEATURE(local_procmail,`/usr/bin/maildrop',`maildrop -d $u $h $j $g')
+</blockquote></pre>
+
+<li>Now run <b>sendmail.mc</b> through <b>m4</b> to produce your new
+<b>sendmail.cf</b> file, and restart Sendmail so the changes will take
+effect.<br><br>
+
+<li>If for some reason any of your $ macros are not set properly
+please consult the Sendmail documentation. The example above was taken
+from a Redhat Linux 9 system.
</ol>
Index: config-pre.html
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/config-pre.html,v
retrieving revision 1.40
retrieving revision 1.41
diff -u -r1.40 -r1.41
--- config-pre.html 3 Jun 2003 21:31:50 -0000 1.40
+++ config-pre.html 3 Jun 2003 22:27:57 -0000 1.41
@@ -1,7 +1,7 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<!-- THIS PAGE IS AUTOMATICALLY GENERATED. DO NOT EDIT. -->
-<!-- Tue Jun 3 15:26:57 2003 -->
+<!-- Tue Jun 3 16:04:39 2003 -->
<!-- USING HT2HTML 2.0 -->
<!-- SEE http://ht2html.sf.net -->
<!-- User-specified headers:
@@ -377,18 +377,22 @@
In order to use TMDA, you need some way to obtain the necessary
envelope information and set the required environment variables. It
matters not how you do this, just as long as these variables are
-properly set by the time TMDA sees the message. We provide a solution
-below for sites with procmail configured as the local mailer.
+properly set by the time TMDA sees the message. We provide example solutions
+below for sites with
+<a href="http://www.procmail.org/" TARGET="Resource Window">procmail</a>
+or
+<a href="http://www.flounder.net/~mrsam/maildrop/" TARGET="Resource Window">maildrop</a>
+configured as the local mailer.
<br><br>
-If your Sendmail installation is using <a
-href="http://www.procmail.org/" TARGET="Resource Window">procmail</a>
-as its local mailer, the necessary information is passed as a command
-line argument to procmail, typically introduced by the "-a" flag.
-Your <b>.procmailrc</b> will then be able to construct the environment
+<u>Procmail</u><br><br>
+If your Sendmail installation is using procmail as its local mailer,
+the necessary envelope information is passed as a command line argument to
+procmail, typically introduced by the "-a" flag. Your
+<b>.procmailrc</b> will then be able to construct the environment
variables from this argument. The necessary Sendmail configuration
-changes are covered below, and a sample .procmailrc is given on the
-<a href="config-server.html">Server Configuration</a> page.
+changes are covered below, and a sample .procmailrc is given on the <a
+href="config-server.html">Server Configuration</a> page.
<ol>
<li>Make sure procmail is installed on your server, and then add the
@@ -402,6 +406,33 @@
<li>Now run <b>sendmail.mc</b> through <b>m4</b> to produce your new
<b>sendmail.cf</b> file, and restart Sendmail so the changes will take
effect.
+
+</ol>
+
+<u>Maildrop</u><br><br>
+If your Sendmail installation is using maildrop as its local mailer,
+the necessary envelope information is passed as command line arguments to
+maildrop. Your <b>.mailfilter</b> will then be able to construct the environment
+variables from these arguments. The necessary Sendmail configuration
+changes are covered below, and a sample .mailfilter is given on the
+<a href="config-server.html">Server Configuration</a> page.
+<ol>
+
+<li>Make sure maildrop is installed on your server, and then add the
+following rule to your <b>sendmail.mc</b> file if it is not
+already present:
+
+<blockquote><pre>
+FEATURE(local_procmail,`/usr/bin/maildrop',`maildrop -d $u $h $j $g')
+</blockquote></pre>
+
+<li>Now run <b>sendmail.mc</b> through <b>m4</b> to produce your new
+<b>sendmail.cf</b> file, and restart Sendmail so the changes will take
+effect.<br><br>
+
+<li>If for some reason any of your $ macros are not set properly
+please consult the Sendmail documentation. The example above was taken
+from a Redhat Linux 9 system.
</ol>
Index: config-server.ht
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/config-server.ht,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -r1.27 -r1.28
--- config-server.ht 3 Jun 2003 21:43:34 -0000 1.27
+++ config-server.ht 3 Jun 2003 22:27:57 -0000 1.28
@@ -231,24 +231,27 @@
<a name="sendmail"><h4>TMDA Server Configuration (Sendmail only)</h4></a>
-These instructions assume you are running procmail as your local
+These instructions assume you are running either procmail or maildrop as your local
mailer as described in the
<a href="config-pre.html#sendmail">Pre-Configuration</a> page.
-<ol>
-<li>Finish setting up your <b>~/.tmda/config</b> and optionally a
+<ol>
+<li>
+Finish setting up your <b>~/.tmda/config</b> and optionally a
system-wide <b>/etc/tmdarc</b> by reading through the
included <b>sample.config</b> file.
<b>MAIL_TRANSFER_AGENT</b>, <b>DELIVERY</b>, and
<b>RECIPIENT_DELIMITER</b> are required entries for non-qmail users.
<br><br>
-<li>Set the SENDER, RECIPIENT, and EXTENSION variables, and then
+<li>
+
+<u>Procmail as the local mailer</u><br><br>
+Set the SENDER, RECIPIENT, and EXTENSION variables, and then
invoke tmda-filter by adding the following snippet to the end of your
<b>~/.procmailrc</b>.
<blockquote><pre>
-
# Uncomment this for users without valid shells.
# SHELL=/bin/sh
@@ -271,7 +274,31 @@
# TMDA takes care of final delivery
DEFAULT=/dev/null
+</blockquote></pre>
+
+<u>Maildrop as the local mailer</u><br><br>
+Set the SENDER, RECIPIENT, and EXTENSION variables, and then
+invoke tmda-filter by adding the following snippet to the end of your
+<b>~/.mailfilter</b>.
+
+<blockquote><pre>
+# Uncomment this for users without valid shells.
+# SHELL=/bin/sh
+
+# Set the necessary environment variables.
+EXTENSION="$1"
+HOST="$2"
+SENDER="$3"
+if ( "$EXTENSION" ne "" )
+{
+ DELIMITER="+"
+}
+RECIPIENT="$LOGNAME$DELIMITER$EXTENSION@$HOST"
+# "to" will deliver to message to tmda-filter. It will exit with the
+# exit code of the program.
+to "| /path/to/bin/tmda-filter"
</blockquote></pre>
-</ol>
\ No newline at end of file
+</ol>
+<hr>
\ No newline at end of file
Index: config-server.html
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/config-server.html,v
retrieving revision 1.52
retrieving revision 1.53
diff -u -r1.52 -r1.53
--- config-server.html 3 Jun 2003 21:43:34 -0000 1.52
+++ config-server.html 3 Jun 2003 22:27:57 -0000 1.53
@@ -1,7 +1,7 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<!-- THIS PAGE IS AUTOMATICALLY GENERATED. DO NOT EDIT. -->
-<!-- Tue Jun 3 15:41:47 2003 -->
+<!-- Tue Jun 3 16:15:17 2003 -->
<!-- USING HT2HTML 2.0 -->
<!-- SEE http://ht2html.sf.net -->
<!-- User-specified headers:
@@ -416,24 +416,27 @@
<a name="sendmail"><h4>TMDA Server Configuration (Sendmail only)</h4></a>
-These instructions assume you are running procmail as your local
+These instructions assume you are running either procmail or maildrop as your local
mailer as described in the
<a href="config-pre.html#sendmail">Pre-Configuration</a> page.
-<ol>
-<li>Finish setting up your <b>~/.tmda/config</b> and optionally a
+<ol>
+<li>
+Finish setting up your <b>~/.tmda/config</b> and optionally a
system-wide <b>/etc/tmdarc</b> by reading through the
included <b>sample.config</b> file.
<b>MAIL_TRANSFER_AGENT</b>, <b>DELIVERY</b>, and
<b>RECIPIENT_DELIMITER</b> are required entries for non-qmail users.
<br><br>
-<li>Set the SENDER, RECIPIENT, and EXTENSION variables, and then
+<li>
+
+<u>Procmail as the local mailer</u><br><br>
+Set the SENDER, RECIPIENT, and EXTENSION variables, and then
invoke tmda-filter by adding the following snippet to the end of your
<b>~/.procmailrc</b>.
<blockquote><pre>
-
# Uncomment this for users without valid shells.
# SHELL=/bin/sh
@@ -456,10 +459,34 @@
# TMDA takes care of final delivery
DEFAULT=/dev/null
+</blockquote></pre>
+
+<u>Maildrop as the local mailer</u><br><br>
+Set the SENDER, RECIPIENT, and EXTENSION variables, and then
+invoke tmda-filter by adding the following snippet to the end of your
+<b>~/.mailfilter</b>.
+
+<blockquote><pre>
+# Uncomment this for users without valid shells.
+# SHELL=/bin/sh
+
+# Set the necessary environment variables.
+EXTENSION="$1"
+HOST="$2"
+SENDER="$3"
+if ( "$EXTENSION" ne "" )
+{
+ DELIMITER="+"
+}
+RECIPIENT="$LOGNAME$DELIMITER$EXTENSION@$HOST"
+# "to" will deliver to message to tmda-filter. It will exit with the
+# exit code of the program.
+to "| /path/to/bin/tmda-filter"
</blockquote></pre>
</ol>
+<hr>
</td><!-- end of body cell -->
</tr><!-- end of sidebar/body row -->
</table><!-- end of page table -->
Index: requirements.ht
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/requirements.ht,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -r1.21 -r1.22
--- requirements.ht 3 Jun 2003 21:31:50 -0000 1.21
+++ requirements.ht 3 Jun 2003 22:27:57 -0000 1.22
@@ -56,6 +56,7 @@
<br><br>
<li>The <a href="http://www.procmail.org/" TARGET="Resource Window">procmail</a>
+or <a href="http://www.flounder.net/~mrsam/maildrop/" TARGET="Resource Window">maildrop</a>
local delivery agent, <strong>if and only if</strong> you are running Sendmail as
your MTA.
Index: requirements.html
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/requirements.html,v
retrieving revision 1.47
retrieving revision 1.48
diff -u -r1.47 -r1.48
--- requirements.html 3 Jun 2003 21:31:50 -0000 1.47
+++ requirements.html 3 Jun 2003 22:27:57 -0000 1.48
@@ -1,7 +1,7 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<!-- THIS PAGE IS AUTOMATICALLY GENERATED. DO NOT EDIT. -->
-<!-- Tue Jun 3 13:48:00 2003 -->
+<!-- Tue Jun 3 16:23:44 2003 -->
<!-- USING HT2HTML 2.0 -->
<!-- SEE http://ht2html.sf.net -->
<!-- User-specified headers:
@@ -241,6 +241,7 @@
<br><br>
<li>The <a href="http://www.procmail.org/" TARGET="Resource Window">procmail</a>
+or <a href="http://www.flounder.net/~mrsam/maildrop/" TARGET="Resource Window">maildrop</a>
local delivery agent, <strong>if and only if</strong> you are running Sendmail as
your MTA.
_______________________________________
tmda-cvs mailing list
http://tmda.net/lists/listinfo/tmda-cvs