1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/REC-html401/loose.dtd">
<html>
<head>
<title>maildrop - mail delivery agent with filtering abilities</title>
<meta name="MSSmartTagsPreventParsing" content="TRUE">
</head>
<body text="#000000" bgcolor="#FFFFFF" link="#0000EF" vlink="#51188E"
alink="#FF0000">
<!-- $Id: README.html.in,v 1.11 2001/06/25 21:49:15 mrsam Exp $ -->
<!-- Copyright 1998 - 2001 Double Precision, Inc. See COPYING for -->
<!-- distribution information. -->
<h1>maildrop - mail delivery agent with filtering abilities</h1>
<p>Copyright 1998-2001, Double Precision Inc.</p>
<p>This program is distributed under the terms of the GNU General Public
License. See <code>COPYING</code> for additional information.</p>
<h2>Where to find <i>maildrop</i></h2>
Join the maildrop mailing list - <code><a
href="http://lists.sourceforge.net/lists/listinfo/courier-maildrop">http://lists.sourceforge.net/lists/listinfo/courier-maildrop</a></code>.
<p>I've started a list of "<a href="maildroptips.html">tips and tricks</a>"
for writing mail filters with maildrop.</p>
<p>The HTML version of the <i>maildrop</i> README is located at
<code>http://www.flounder.net/~mrsam/maildrop/</code>. Although the following
files may also be found there, please check your favorite archive for any
local copies.</p>
<p>Download <i>maildrop</i>: <code><a
href="http://www.courier-mta.org/download.php#maildrop">http://www.courier-mta.org/download.php#maildrop</a></code></p>
<h2>Building RPMs</h2>
<p>Starting with version 0.99, it is possible to build binary RPMs directly
from the source tarball, so there's no longer a need to provide a separate set
of source and binary RPMs. You will need RPM 3.0 or higher in order to build
a binary RPM. Execute the following command:</p>
<pre> rpm -ta maildrop-@VERSION@.tar.gz</pre>
<p>The binary RPM will be built with a customized configuration (userdb, GDBM,
and quota enhancements enabled). Afterwards, simply execute <code>rpm
-i</code> to install it. That's it.</p>
<p>If you would like to change the RPM build options, move
<code>maildrop-@VERSION@.tar.gz</code> to your <code>SOURCES</code> directory,
extract the file <code>maildrop.spec</code>, move it to your
<code>SPECS</code> directory, customize it if necessary, then build from the
spec file.</p>
<p><i>maildrop</i> includes documentation in HTML, as well as traditional man
pages. The HTML versions may also be found at <code><a
href="maildrop.html">http://www.flounder.net/~mrsam/maildrop/maildrop.html</a>.</code>
<br>
</p>
<h2>Introduction</h2>
<p><i>maildrop</i> is the mail filter/mail deilvery agent that's used by the
<a href="http://www.courier-mta.org">Courier Mail Server</a>. You do not need
to download <i>maildrop</i> from here if you already have Courier installed.
This is a standalone build of the <i>maildrop</i> mail filter that can be used
with other mail servers.</p>
<p><i>maildrop</i> is a replacement for your local mail delivery agent.
<i>maildrop</i> reads a mail message from standard input, then delivers the
message to your mailbox. <i>maildrop</i> knows how to deliver mail to
mbox-style mailboxes, and maildirs. "maildir" is a mailbox format used by the
<a href="http://www.qmail.org">Qmail</a> MTA.</p>
<p><i>maildrop</i> will optionally read instructions from a file, which
describes how to filter incoming mail. Instructions can be provided having
mail delivered to alternate mailboxes, or forwarded somewhere else. Unlike
procmail, <i>maildrop</i> uses a structured filtering language.</p>
<p><i>maildrop</i> is written in C++, and is significantly larger than
procmail in compiled form. However, it uses resources much more efficiently.
Unlike procmail, <i>maildrop</i> will not read a 10 megabyte mail message into
memory. Large messages are saved in a temporary file, and are filtered from
the temporary file. Temporary files are saved in the user's home directory. If
the standard input to <i>maildrop</i> is a file, and not a pipe, a temporary
file will not be necessary.</p>
<p><i>maildrop</i> checks the syntax of the mail delivery instructions the
filter file, before attempting to deliver a message. Unlike procmail, if the
filter file contains syntax errors, <i>maildrop</i> terminates without
delivering the message. The user can fix the typo without causing any mail to
be lost.</p>
<h2>Installation</h2>
See <code><a href="INSTALL.html">INSTALL</a></code> for installation
information. If you are using an RPM-based Linux distribution, you can install
build a binary RPM directly from the source code.
<h2>Using maildrop with sendmail</h2>
Maildrop can be easily used as sendmail's local delivery agent, instead of
procmail. Here is the suggested entry for sendmail.cf, courtesy of Eric J.
Schwertfeger <ejs<code>@</code>bfd.com>:
<pre>
Mlocal, P=/usr/local/bin/maildrop, F=lsAw5:/|@SPfhn, S=10/30, R=20/40,
T=DNS/RFC822/X-Unix,
A=maildrop -d $u</pre>
You may also consider including the D, F, and M flags as well.
<h2>Other Links</h2>
<p><a href="http://www.tcob1.net">SuSE RPMs of maildrop</a></p>
<h2>Revision history (including development versions)</h2>
<p><a href="ChangeLog.txt">Change Log</a></p>
</body>
</html>
|
