File: README.html

package info (click to toggle)
maildrop 0.54a-2
  • links: PTS
  • area: main
  • in suites: slink
  • size: 872 kB
  • ctags: 883
  • sloc: cpp: 8,469; ansic: 658; sh: 327; makefile: 82
file content (123 lines) | stat: -rw-r--r-- 6,456 bytes parent folder | download
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
118
119
120
121
122
123
<!-- DSTART                                                                -->
<!--                                                                       -->
<!--           maildrop - mail delivery agent with filtering abilities     -->
<!--                                                                       -->
<!--  Copyright 1998, Double Precision Inc.                                -->
<!--                                                                       -->
<!--  This program is distributed under the terms of the GNU General Publi -->
<!--  License. See COPYING for additional information.                     -->
<!-- DEND                                                                  -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
   <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
   <META NAME="GENERATOR" CONTENT="Mozilla/4.06 [en] (X11; I; Linux 2.0.35 i586) [Netscape]">
   <TITLE>maildrop - mail delivery agent with filtering abilities</TITLE>
</HEAD>
<BODY TEXT="#000000" BGCOLOR="#FFFFFF" LINK="#0000EF" VLINK="#51188E" ALINK="#FF0000">
<!-- $Id: README.html 1.25 1998/08/31 22:37:59 mrsam Exp $ -->
<H1>
maildrop - mail delivery agent with filtering abilities</H1>
Current version is 0.54a
<P>Copyright 1998, Double Precision Inc.
<P>This program is distributed under the terms of the GNU General Public
License. See <TT>COPYING</TT> for additional information.
<H2>
Where to find <I>maildrop</I></H2>
The HTML version of the <I>maildrop</I> README is located at <TT><A HREF="http://www.geocities.com/SiliconValley/Peaks/5799/maildrop.README.html">http://www.geocities.com/SiliconValley/Peaks/5799/maildrop.README.html</A></TT>.
Although the following files may also be found there, please check your
favorite archive for any local copies:
<P><TT><A HREF="maildrop-0.54a.tar.gz">maildrop-0.54a.tar.gz</A></TT> -
the source code tarball.
<P><TT><A HREF="maildrop-0.54a-1.src.rpm">maildrop-0.54a-1.src.rpm</A>
</TT>-
the distribution source code in the RPM format. To build a binary RPM run
the command <TT>rpm --rebuild maildrop-0.54a-1.src.rpm</TT>.
<P><TT><A HREF="maildrop-0.54a-1.i386.rpm">maildrop-0.54a-1.i386.rpm</A></TT>
- prebuilt binary RPM for Red Hat 5.1 i386.
<P>The RPMs are signed with my PGP key: <TT><A HREF="http://www.geocities.com/SiliconValley/Peaks/5799/PGPKEY.txt">http://www.geocities.com/SiliconValley/Peaks/5799/PGPKEY.txt</A></TT>.
<P><I>maildrop</I> includes documention in HTML, as well as traditional
man pages. The HTML versions may also be found at <TT><A HREF="http://www.geocities.com/SiliconValley/Peaks/5799/maildrop.maildrop.html">http://www.geocities.com/SiliconValley/Peaks/5799/maildrop.maildrop.html</A>.</TT>
<BR>&nbsp;
<H2>
Introduction</H2>
<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><I>maildrop</I> can optionally read instructions from a file on how
to filter incoming mail, and, based upon the instructions, deliver mail
to alternate mailboxes, or forward it to somewhere else, like procmail.
Unlike procmail, <I>maildrop</I> uses a structured filtering language that's
a bit easier on the eyes.
<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 that file. Files are saved in the user's home directory. If the standard
input to <I>maildrop</I> is a file, not a pipe, no temporary file will
be necessary.
<P><I>maildrop</I> performs syntax checks on the filter file before attempting
to deliver a message. Unlike procmail, if the filter file contains syntax
errors, <I>maildrop</I> will terminate without delivering the message,
allowing the user to fix the typo, and try again later without losing any
mail.
<P><I>maildrop</I> uses the GNU autoconf configure script.
<H2>
Installation</H2>
See the file <TT>INSTALL</TT> for installation information. If you are
using an RPM-based Linux distribution, you can install the binary RPM (see
above), or rebuild the source RPM, normally.
<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 &lt;ejs<TT>@</TT>bfd.com>:
<PRE>&nbsp;
Mlocal,&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; P=/usr/local/bin/maildrop, F=lsAw5:/|@SPfhn, S=10/30, R=20/40,
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; T=DNS/RFC822/X-Unix,
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; A=maildrop -d $u</PRE>
You may also consider including the D, F, and M flags as well.
<H2>
Revision history</H2>

<UL>
<LI>
V0.54a - miscellaneous fixes. Changed the hasaddr() function to look at
<TT>Resent-To:</TT> and <TT>Resent-Cc: </TT>headers. Default <TT>SHELL</TT>
to <TT>/bin/sh</TT> if the shell is not specified in <TT>/etc/passwd</TT>.
FreeBSD does not support l<TT>ockf()</TT> on <TT>/dev/null</TT> - <TT>lockf()</TT>
will not cause a fatal error if it fails on a character or a block special
file. Fixed bug in configure script regarding failed initialization of
<TT>--enable-restrict-trusted</TT> flag.</LI>

<BR>&nbsp;
<LI>
V0.54 - edited the documentation. Added support for VPATH builds using
automake - suggested by Harlan Stenn &lt;Harlan.Stenn<TT>@</TT>pfcs.com>.
Major rework of the configuration code. Changed all <TT>#define-</TT>s
in config.h to use the <TT>configure</TT> script.</LI>

<BR>&nbsp;
<LI>
V0.51c - Fixed the subtraction operator bug. Added sendmail documentation.</LI>

<BR>&nbsp;
<LI>
V0.51b - Fixed compilation error for BSD. Fixed spurious "invalid directory
permission" error if <TT>$HOME/.mailfilters</TT> does not exist in special
embedded mode - maildrop will simply indicate quiet acceptance.</LI>

<BR>&nbsp;
<LI>
V0.51 - ported to RedHat 5.1, added <TT>/etc/maildroprc</TT> global filter
file.</LI>

<BR>&nbsp;
<LI>
V0.50 - first public release.</LI>
</UL>

</BODY>
</HTML>