Update of /cvsroot/tmda/tmda/htdocs
In directory usw-pr-cvs1:/tmp/cvs-serv24877/htdocs
Modified Files:
ChangeLog config-filter.ht config-filter.html
Log Message:
Document TMDA's new local mail delivery agent capabilities.
Index: ChangeLog
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/ChangeLog,v
retrieving revision 1.104
retrieving revision 1.105
diff -u -r1.104 -r1.105
--- ChangeLog 1 Mar 2002 01:28:54 -0000 1.104
+++ ChangeLog 1 Mar 2002 22:04:09 -0000 1.105
@@ -1,3 +1,8 @@
+2002-03-01 Jason R. Mastaler <jasonrm@xxxxxxxxxxxxxxxxxxxxxxxxxx>
+
+ * config-filter.ht: Document the instruction option to the
+ ok,accept,deliver incoming action.
+
2002-02-28 Jason R. Mastaler <jasonrm@xxxxxxxxxxxxxxxxxxxxxxxxxx>
* index.ht (Links): Mention TMDA's local mail delivery agent
Index: config-filter.ht
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/config-filter.ht,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- config-filter.ht 22 Feb 2002 07:42:07 -0000 1.13
+++ config-filter.ht 1 Mar 2002 22:04:10 -0000 1.14
@@ -250,9 +250,120 @@
bounce,reject (bounce the message)
drop,exit,stop (silently drop the message)
ok,accept,deliver (deliver the message)
+ok,accept,deliver=instruction (deliver to a Maildir, mbox, program, or address)
confirm (request confirmation for the message)
</blockquote></pre>
+
+The <b>instruction</b> option to <b>ok,accept,deliver</b> can be
+
+used to short-circuit the default delivery method by delivering the
+message to a specific location. Delivery to
+qmail-style <a href="http://www.qmail.org/man/man5/maildir.html";
TARGET="Resource Window">
+Maildirs</a>, mboxrd-format
+<a href="http://www.qmail.org/man/man5/mbox.html"; TARGET="Resource Window">
+mboxes</a>,
+programs (pipe), and different e-mail addresses
+are supported.
+<br><br>
+
+<table border cellpadding=4 cellspacing=2>
+
+<tr>
+<th>instruction:</th>
+<th>format:</th>
+<th>examples:</th>
+</td>
+
+<tr>
+<td>program (pipe)</td>
+<td>
+A program instruction begins with a vertical bar. The rest of the line will
+be passed to /bin/sh. Whitespace and shell variables (i.e, $HOME and
+~) are allowed.
+</td>
+<td>
+<code>
+deliver=|/usr/ucb/vacation jason<br>
+deliver=| /usr/bin/maildrop $HOME/.mailfilter
+</code>
+</td>
+</tr>
+
+<tr>
+<td>forward</td>
+<td>
+A forward instruction begins with an ampersand. If the address begins with
+a letter or number, you may leave out the ampersand.
+</td>
+<td>
+<code>
+deliver=&johndoe@xxxxxxxxxxx<br>
+deliver=janedoe@xxxxxxxxxxx
+</code>
+</td>
+</tr>
+
+<tr>
+<td>mbox</td>
+<td>
+An mbox instruction begins with a slash or tilde, and does not end with a
+slash. Please note the following restrictions below.
+</td>
+<td>
+<code>
+deliver=/home/jason/Mailbox<br>
+deliver=~/Mailbox
+</code>
+</td>
+</tr>
+
+<tr>
+<td>maildir</td>
+<td>
+A maildir instruction begins with a slash or tilde and ends with a slash.
+Please note the following restrictions below.
+</td>
+<td>
+<code>
+deliver=/home/jason/Maildir/<br>
+deliver=~/Maildir/
+</code>
+</td>
+</tr>
+
+</table>
+<br>
+
+<u>Please note the following restrictions to mbox and Maildir delivery:</u><br>
+<ul>
+
+<li>
+TMDA will not create Maildirs or mbox files if they do not exist. You
+must create them prior to having TMDA deliver mail to them with
+commands like
+<a href="http://www.qmail.org/man/man1/maildirmake.html"; TARGET="Resource
Window">
+<em>maildirmake</em></a>
+and <em>touch</em>.
+<br><br>
+
+<li>
+TMDA requires write access to any Maildir or mbox file you wish to
+deliver mail to.
+<br><br>
+
+<li>
+TMDA will not deliver to an mbox symlink. Specify the path to the
+actual mbox file instead.
+<br><br>
+
+<li>
+Do not deliver to mbox files located on an NFS filesystem. This is
+unsafe and can corrupt your mbox file -- this applies to all MDAs, not
+just TMDA. Use Maildir instead as it is immune to such
+problems.
+</ul>
+<br>
(for outgoing, action can be one of):
<blockquote><pre>
Index: config-filter.html
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/config-filter.html,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- config-filter.html 22 Feb 2002 07:48:47 -0000 1.16
+++ config-filter.html 1 Mar 2002 22:04:10 -0000 1.17
@@ -1,6 +1,6 @@
<HTML>
<!-- THIS PAGE IS AUTOMATICALLY GENERATED. DO NOT EDIT. -->
-<!-- Fri Feb 22 01:48:23 2002 -->
+<!-- Fri Mar 1 14:57:20 2002 -->
<!-- USING HT2HTML 1.2 -->
<!-- SEE http://barry.wooz.org/software/ht2html -->
<!-- User-specified headers:
@@ -400,9 +400,120 @@
bounce,reject (bounce the message)
drop,exit,stop (silently drop the message)
ok,accept,deliver (deliver the message)
+ok,accept,deliver=instruction (deliver to a Maildir, mbox, program, or address)
confirm (request confirmation for the message)
</blockquote></pre>
+
+The <b>instruction</b> option to <b>ok,accept,deliver</b> can be
+
+used to short-circuit the default delivery method by delivering the
+message to a specific location. Delivery to
+qmail-style <a href="http://www.qmail.org/man/man5/maildir.html";
TARGET="Resource Window">
+Maildirs</a>, mboxrd-format
+<a href="http://www.qmail.org/man/man5/mbox.html"; TARGET="Resource Window">
+mboxes</a>,
+programs (pipe), and different e-mail addresses
+are supported.
+<br><br>
+
+<table border cellpadding=4 cellspacing=2>
+
+<tr>
+<th>instruction:</th>
+<th>format:</th>
+<th>examples:</th>
+</td>
+
+<tr>
+<td>program (pipe)</td>
+<td>
+A program instruction begins with a vertical bar. The rest of the line will
+be passed to /bin/sh. Whitespace and shell variables (i.e, $HOME and
+~) are allowed.
+</td>
+<td>
+<code>
+deliver=|/usr/ucb/vacation jason<br>
+deliver=| /usr/bin/maildrop $HOME/.mailfilter
+</code>
+</td>
+</tr>
+
+<tr>
+<td>forward</td>
+<td>
+A forward instruction begins with an ampersand. If the address begins with
+a letter or number, you may leave out the ampersand.
+</td>
+<td>
+<code>
+deliver=&johndoe@xxxxxxxxxxx<br>
+deliver=janedoe@xxxxxxxxxxx
+</code>
+</td>
+</tr>
+
+<tr>
+<td>mbox</td>
+<td>
+An mbox instruction begins with a slash or tilde, and does not end with a
+slash. Please note the following restrictions below.
+</td>
+<td>
+<code>
+deliver=/home/jason/Mailbox<br>
+deliver=~/Mailbox
+</code>
+</td>
+</tr>
+
+<tr>
+<td>maildir</td>
+<td>
+A maildir instruction begins with a slash or tilde and ends with a slash.
+Please note the following restrictions below.
+</td>
+<td>
+<code>
+deliver=/home/jason/Maildir/<br>
+deliver=~/Maildir/
+</code>
+</td>
+</tr>
+
+</table>
+<br>
+
+<u>Please note the following restrictions to mbox and Maildir delivery:</u><br>
+<ul>
+
+<li>
+TMDA will not create Maildirs or mbox files if they do not exist. You
+must create them prior to having TMDA deliver mail to them with
+commands like
+<a href="http://www.qmail.org/man/man1/maildirmake.html"; TARGET="Resource
Window">
+<em>maildirmake</em></a>
+and <em>touch</em>.
+<br><br>
+
+<li>
+TMDA requires write access to any Maildir or mbox file you wish to
+deliver mail to.
+<br><br>
+
+<li>
+TMDA will not deliver to an mbox symlink. Specify the path to the
+actual mbox file instead.
+<br><br>
+
+<li>
+Do not deliver to mbox files located on an NFS filesystem. This is
+unsafe and can corrupt your mbox file -- this applies to all MDAs, not
+just TMDA. Use Maildir instead as it is immune to such
+problems.
+</ul>
+<br>
(for outgoing, action can be one of):
<blockquote><pre>
_______________________________________________
tmda-cvs mailing list
http://libertine.org/lists/listinfo/tmda-cvs
|
