| rev |
line source |
|
meillo@1
|
1 <HTML>
|
|
meillo@1
|
2 <HEAD>
|
|
meillo@1
|
3 <TITLE>MasqMail
|
|
meillo@1
|
4 </TITLE>
|
|
meillo@1
|
5 </HEAD>
|
|
meillo@1
|
6 <BODY TEXT="#000000" LINK="#0000ff" BGCOLOR="#ffffff">
|
|
meillo@1
|
7
|
|
meillo@1
|
8 <center>
|
|
meillo@1
|
9 <table width="80%">
|
|
meillo@1
|
10 <tr><td>
|
|
meillo@1
|
11 <table width="100%" bgcolor="#0000aa" cellspacing=0 cellpadding=0>
|
|
meillo@1
|
12 <tr>
|
|
meillo@1
|
13 <td align=center width="100%"><font size="6" color="#ffffff">MasqMail</font></td>
|
|
meillo@1
|
14 </tr>
|
|
meillo@1
|
15 </table>
|
|
meillo@1
|
16
|
|
meillo@1
|
17 <center><img src="logo_masqmail.jpg" alt="MasqMail"></img></center><br>
|
|
meillo@1
|
18
|
|
meillo@1
|
19 <a href="index.html#intro">Introduction</a><br>
|
|
meillo@1
|
20 <a href="index.html#features">Features</a><br>
|
|
meillo@1
|
21 <a href="index.html#how">How it works</a><br>
|
|
meillo@1
|
22 <a href="index.html#plat">Platforms</a><br>
|
|
meillo@1
|
23 <a href="index.html#limit">Limitations</a><br>
|
|
meillo@1
|
24 <a href="index.html#secure">Security</a><br>
|
|
meillo@1
|
25 <a href="index.html#require">Requirements</a><br>
|
|
meillo@1
|
26 <a href="index.html#down">Download</a><br>
|
|
meillo@1
|
27 <a href="index.html#docu">Documentation</a></br>
|
|
meillo@1
|
28 <a href="index.html#road">Roadmap</a><br>
|
|
meillo@1
|
29 <a href="index.html#list">Mailing List</a><br>
|
|
meillo@1
|
30 <a href="index.html#bugs">Bugs and Suggestions</a><br>
|
|
meillo@1
|
31 <br>
|
|
meillo@1
|
32
|
|
meillo@1
|
33
|
|
meillo@1
|
34 <h2>Introduction</h2>
|
|
meillo@1
|
35
|
|
meillo@1
|
36 <p>MasqMail is a mail server designed for hosts that do not have a
|
|
meillo@1
|
37 permanent internet connection eg. a home network or a single host at
|
|
meillo@1
|
38 home. It has special support for connections to different ISPs. It
|
|
meillo@1
|
39 replaces sendmail or other MTAs such as qmail or exim.<p>
|
|
meillo@1
|
40
|
|
meillo@1
|
41 <p>Since version 0.0.10 it supports alias address expansion and can
|
|
meillo@1
|
42 deliver to pipes.</p>
|
|
meillo@1
|
43
|
|
meillo@1
|
44 <p>MasqMail is released under the <a href="http://www.fsf.org">GPL</a>
|
|
meillo@1
|
45 license.</p>
|
|
meillo@1
|
46
|
|
meillo@1
|
47 <a name="features"></a> <h2>Features</h2>
|
|
meillo@1
|
48
|
|
meillo@1
|
49 <ul>
|
|
meillo@1
|
50 <li>Delivers only when online to a destination 'outside' your LAN</li>
|
|
meillo@1
|
51 <li>Support for multiple Providers (ie. Mail Servers, or direct delivery)</li>
|
|
meillo@1
|
52 <li>Rewriting of Return addresses (Return-Path:, From:, Reply-To:),
|
|
meillo@1
|
53 configurable for each Provider separately</li>
|
|
meillo@1
|
54 <li>can also be used as a Mail Server on a LAN</li>
|
|
meillo@1
|
55 <li>alias support</li>
|
|
meillo@1
|
56 <li>delivery to pipes</li>
|
|
meillo@1
|
57 <li>delivery to MDAs (eg. procmail)</li>
|
|
meillo@1
|
58 <li>Maildir support (version >= 0.2.5)</li>
|
|
meillo@1
|
59 <li>routing depending on sender</li>
|
|
meillo@1
|
60 <li>AUTH (RFC 2554) support (as client, since version 0.1.0)</li>
|
|
meillo@1
|
61 <li>SMTP-after-POP</li>
|
|
meillo@1
|
62 <li>POP3 client</li>
|
|
meillo@1
|
63 <li>POP3 client daemon (fetch mail in regular intervals if online)</li>
|
|
meillo@1
|
64 </ul>
|
|
meillo@1
|
65
|
|
meillo@1
|
66 <a name="how"></a> <h2>How it works</h2>
|
|
meillo@1
|
67
|
|
meillo@1
|
68 <p>When offline, MasqMail queues all mail with a destination outside
|
|
meillo@1
|
69 of the local network. When you connect to the internet, masqmail will
|
|
meillo@1
|
70 be called with a connection name as an argument. MasqMail then sends
|
|
meillo@1
|
71 the queued mail to the configured mailserver for that ISP. When a
|
|
meillo@1
|
72 message from the local net is received when online, MasqMail delivers
|
|
meillo@1
|
73 it immediately. If there is no mail server for that ISP, MasqMail can
|
|
meillo@1
|
74 also send the mails directly to their destinations.</p>
|
|
meillo@1
|
75
|
|
meillo@1
|
76 <p>For each ISP different return addresses can be configured. This
|
|
meillo@1
|
77 makes it possible to get around spam traps which desire your return
|
|
meillo@1
|
78 address to be from the same domain as the host the mail is coming
|
|
meillo@1
|
79 from. This is not a problem if you always connect to a single ISP, but
|
|
meillo@1
|
80 is one if you use different ones from time to time. It also makes it
|
|
meillo@1
|
81 possible to configure your mailer to a return address on your local
|
|
meillo@1
|
82 network which maybe totally unknown outside. So delivery failure
|
|
meillo@1
|
83 messages originating on your local net can be sent directly to you,
|
|
meillo@1
|
84 while those that occur outside will be sent to the configured
|
|
meillo@1
|
85 address. <em>(Note that the return path is different from the From:
|
|
meillo@1
|
86 address or the Reply-to: address. You can still have a single address
|
|
meillo@1
|
87 where you want replys to be sent to).</em></p>
|
|
meillo@1
|
88
|
|
meillo@1
|
89 <p>When offline, MasqMail behaves just like any other ordinary mail
|
|
meillo@1
|
90 server (with a few limitations, but these will be fixed in the
|
|
meillo@1
|
91 future).</p>
|
|
meillo@1
|
92
|
|
meillo@1
|
93 <p>To detect its online status, MasqMail can take advantage of the <a
|
|
meillo@1
|
94 href="http://cpwright.com/mserver/">masqdialer</a> system. But it also
|
|
meillo@1
|
95 works well without it.</p>
|
|
meillo@1
|
96
|
|
meillo@1
|
97 <p>See the <a href="manual.html">manual</a> for more information.</p>
|
|
meillo@1
|
98
|
|
meillo@1
|
99 <a name="plat"></a>
|
|
meillo@1
|
100 <h2>Platforms</h2>
|
|
meillo@1
|
101
|
|
meillo@1
|
102 <p>MasqMail is being developed for Linux. It may run on other Un*x like
|
|
meillo@1
|
103 platforms, but it will certainly not run on Windows or a
|
|
meillo@1
|
104 Mac. Currently I see no point in porting it to other platforms.</p>
|
|
meillo@1
|
105
|
|
meillo@1
|
106 <p>But it is possible to use a Windows (or Mac or any system that
|
|
meillo@1
|
107 knows about SMTP) host as a client. Just configure your mailer to use
|
|
meillo@1
|
108 the machine MasqMail is running on as your mail server.</p>
|
|
meillo@1
|
109
|
|
meillo@1
|
110 <a name="limit"></a>
|
|
meillo@1
|
111 <h2>Limitations</h2>
|
|
meillo@1
|
112
|
|
meillo@1
|
113 <p>MasqMail is still in an early stage of development so use it with
|
|
meillo@1
|
114 caution! There may still be serious bugs in it, so mail might
|
|
meillo@1
|
115 get lost. But in the nearly two years of its existence so far there
|
|
meillo@1
|
116 was only one time a bug which caused mail retrieved via pop3 to be
|
|
meillo@1
|
117 lost in rare circumstances.</p>
|
|
meillo@1
|
118
|
|
meillo@1
|
119 <p>There are also some features every MTA should have:</p>
|
|
meillo@1
|
120
|
|
meillo@1
|
121 <ul>
|
|
meillo@1
|
122
|
|
meillo@1
|
123 <li> it does not use .forward files (but it uses alias files since 0.0.10)</li>
|
|
meillo@1
|
124 <li> it does not support retrieving mail from a multi-drop mailboxes</li>
|
|
meillo@1
|
125
|
|
meillo@1
|
126 </ul>
|
|
meillo@1
|
127
|
|
meillo@1
|
128 <p>But these are worked on.</p>
|
|
meillo@1
|
129
|
|
meillo@1
|
130 <p>MasqMail is <em>not</em> designed to run on a host with a permanent
|
|
meillo@1
|
131 internet connection. It does not have the ability to check for spam
|
|
meillo@1
|
132 mail and it will relay everything from everywhere to everywhere. Use
|
|
meillo@1
|
133 another mail server such as <a href="http://www.exim.org">exim</a>
|
|
meillo@1
|
134 for permanent connections.</p>
|
|
meillo@1
|
135
|
|
meillo@1
|
136 <p>BTW: I am already using it...</p>
|
|
meillo@1
|
137
|
|
meillo@1
|
138 <a name="secure"></a>
|
|
meillo@1
|
139 <h2>Security</h2>
|
|
meillo@1
|
140
|
|
meillo@1
|
141 <p>I hope that I have not done anything stupid, but there may be
|
|
meillo@1
|
142 security holes in it. If you find one, please tell me.</p>
|
|
meillo@1
|
143
|
|
meillo@1
|
144 <p>MasqMail does not listen to a port to the internet (unless you
|
|
meillo@1
|
145 manage to configure it to do so... which is pretty senseless anyway),
|
|
meillo@1
|
146 so that door is closed.</p>
|
|
meillo@1
|
147
|
|
meillo@1
|
148 <p>MasqMail is designed to run with an own user and group id. It uses
|
|
meillo@1
|
149 root permission only when necessary, ie. to open a listening port and
|
|
meillo@1
|
150 to change identity to some user when it delivers local mail.</p>
|
|
meillo@1
|
151
|
|
meillo@1
|
152 <a name="require"></a>
|
|
meillo@1
|
153 <h2>Requirements</h2>
|
|
meillo@1
|
154
|
|
meillo@1
|
155 <p>MasqMail requires glib 1.2 or greater. You may find this strange
|
|
meillo@1
|
156 since glib was originally written for gimp and is used by <a
|
|
meillo@1
|
157 href="http://www.gtk.org">gtk</a>, but glib does not necessarily have
|
|
meillo@1
|
158 to do with GUIs. It has some useful list and string functions, and I
|
|
meillo@1
|
159 use only these. This may change in the future when I write my own
|
|
meillo@1
|
160 utilities.</p>
|
|
meillo@1
|
161
|
|
meillo@1
|
162 <p>I develop MasqMail with a Debian woody distribution, Kernel 2.4.x and
|
|
meillo@1
|
163 glibc (libc6) with gcc 2.95. There have been reports that it compiles and
|
|
meillo@1
|
164 runs under Redhat, SuSE, slackware, with libc5 (since 0.0.4) and Kernel
|
|
meillo@1
|
165 2.0.x and 2.2.x, and FreeBSD, OpenBSD and NetBSD.</p>
|
|
meillo@1
|
166
|
|
meillo@1
|
167 <a name="down"></a>
|
|
meillo@1
|
168 <h2>Download</h2>
|
|
meillo@1
|
169
|
|
meillo@1
|
170 <a href="download/masqmail-0.2.20.tar.gz">masqmail-0.2.20.tar.gz (http)</a> (unstable version, about 242K)<br>
|
|
meillo@1
|
171 <a href="download/masqmail-0.2.20.tar.gz.asc">masqmail-0.2.20.tar.gz.asc (http)</a>
|
|
meillo@1
|
172 detached <a href="http://www.gnupg.org">GnuPG</a> signature, signed with
|
|
meillo@1
|
173 <a href="oku.asc">451EAB1B</a>, fingerprint <pre>CDA0 CB53 83C6 84DF 760F 6BFE 5265 5226 451E AB1B</pre>
|
|
meillo@1
|
174 <a href="download/masqmail-0.2.18.tar.gz.md5sum">masqmail-0.2.20.tar.gz.md5sum (http)</a> (md5sum)<br>
|
|
meillo@1
|
175 <!--
|
|
meillo@1
|
176 <br>
|
|
meillo@1
|
177 <a href="http://www.sonic.net/~okurth/debian/dists/sid/main/binary-i386/masqmail_0.2.19-1_i386.deb">masqmail_0.2.19-1_i386.deb</a> Debian package for sid<br>
|
|
meillo@1
|
178 <br>
|
|
meillo@1
|
179 <a href="download/masqmail_0.2.18-0.sarge1_i386.deb">masqmail_0.2.18-0.sarge1_i386.deb</a> Debian package for sarge
|
|
meillo@1
|
180 -->
|
|
meillo@1
|
181 <br>
|
|
meillo@1
|
182 <br>
|
|
meillo@1
|
183 xdelta (binary patches), apply with
|
|
meillo@1
|
184 <pre>
|
|
meillo@1
|
185 xdelta patch file.xdelta old.tar.gz new.tar.gz
|
|
meillo@1
|
186 </pre>
|
|
meillo@1
|
187 <a href="download/masqmail-0.2.12-0.2.13.xdelta">masqmail-0.2.12-0.2.13.xdelta</a> (5K)<br>
|
|
meillo@1
|
188 <a href="download/masqmail-0.2.13-0.2.14.xdelta">masqmail-0.2.13-0.2.14.xdelta</a> (7K)<br>
|
|
meillo@1
|
189 <a href="download/masqmail-0.2.14-0.2.15.xdelta">masqmail-0.2.14-0.2.15.xdelta</a> (6K)<br>
|
|
meillo@1
|
190 <a href="download/masqmail-0.2.15-0.2.16.xdelta">masqmail-0.2.15-0.2.16.xdelta</a> (5K)<br>
|
|
meillo@1
|
191 <a href="download/masqmail-0.2.16-0.2.17.xdelta">masqmail-0.2.16-0.2.17.xdelta</a> (15K)<br>
|
|
meillo@1
|
192 <a href="download/masqmail-0.2.17-0.2.18.xdelta">masqmail-0.2.17-0.2.18.xdelta</a> (8K)<br>
|
|
meillo@1
|
193 <a href="download/masqmail-0.2.18-0.2.19.xdelta">masqmail-0.2.18-0.2.19.xdelta</a> (6K)<br>
|
|
meillo@1
|
194 <a href="download/masqmail-0.2.19-0.2.20.xdelta">masqmail-0.2.19-0.2.20.xdelta</a> (6K)<br>
|
|
meillo@1
|
195
|
|
meillo@1
|
196 <p>Note: the unstable version is pretty stable already.</p>
|
|
meillo@1
|
197
|
|
meillo@1
|
198 <a href="download/MasqMail-0.1.17.tar.gz">MasqMail-0.1.17.tar.gz (http)</a> (stable version, about 174K)<br>
|
|
meillo@1
|
199 <!--
|
|
meillo@1
|
200 <br>
|
|
meillo@1
|
201 <a href="../debian/dists/woody/main/binary-i386/masqmail_0.1.17-2_i386.deb">masqmail_0.1.17-2_i386.deb</a> Debian package for woody
|
|
meillo@1
|
202 -->
|
|
meillo@1
|
203 <br>
|
|
meillo@1
|
204
|
|
meillo@1
|
205 <p>Waldemar Brodkorb has made rpms for SuSE 7.0 and 7.1 <em>with</em> ESMTP AUTH,
|
|
meillo@1
|
206 see <a href="http://packman.links2linux.de/index.php4?action=091">this page</a></p>
|
|
meillo@1
|
207
|
|
meillo@1
|
208 <a href="download/ChangeLog">ChangeLog (unstable)</a><br>
|
|
meillo@1
|
209 <a href="download/ChangeLog-stable">ChangeLog (stable)</a><br>
|
|
meillo@1
|
210 <br>
|
|
meillo@1
|
211 See <a href="download/index.html">download/</a> if your are curious for older versions.
|
|
meillo@1
|
212
|
|
meillo@1
|
213 <p>masqmail is also in Debian. You will find it <a
|
|
meillo@1
|
214 href="http://packages.debian.org/masqmail">here</a>.</p>
|
|
meillo@1
|
215
|
|
meillo@1
|
216 <a name="docu"></a>
|
|
meillo@1
|
217 <h2>Documentation</h2>
|
|
meillo@1
|
218
|
|
meillo@1
|
219 <p>masqmail comes with a bunch of man pages, these are also available
|
|
meillo@1
|
220 <a href="manual.html">online</a>. Some people have written introductory pages
|
|
meillo@1
|
221 for the initial installation:</p>
|
|
meillo@1
|
222
|
|
meillo@1
|
223 <p>
|
|
meillo@1
|
224 Christoph Hertel has written a <a href="http://instruction.at/mmquickconfig">quick help</a> page for masqmail.
|
|
meillo@1
|
225 </p>
|
|
meillo@1
|
226
|
|
meillo@1
|
227 <a name="road"></a>
|
|
meillo@1
|
228 <h2>Roadmap</h2>
|
|
meillo@1
|
229
|
|
meillo@1
|
230 <p>MasqMail will be optimized for slow connections. It uses ESMTP
|
|
meillo@1
|
231 pipelining both when sending and receiving and sends all messages to a
|
|
meillo@1
|
232 single host in a single connection.</p>
|
|
meillo@1
|
233
|
|
meillo@1
|
234 <p>Apart from the missing things mentioned above, I plan to implement
|
|
meillo@1
|
235 the following features:</p>
|
|
meillo@1
|
236
|
|
meillo@1
|
237 <ul>
|
|
meillo@1
|
238 <li>ODMR support as a client</li>
|
|
meillo@1
|
239 <li>POP3 multidrop support</li>
|
|
meillo@1
|
240 </ul>
|
|
meillo@1
|
241
|
|
meillo@1
|
242 <a name="list"></a>
|
|
meillo@1
|
243 <h2>Mailing List</h2>
|
|
meillo@1
|
244
|
|
meillo@1
|
245 <p>There is now a <a
|
|
meillo@1
|
246 href="http://lists.masqmail.cx/cgi-bin/mailman/listinfo/masqmail">Mailing
|
|
meillo@1
|
247 List</a> for MasqMail. To subscribe or to view the archive use the
|
|
meillo@1
|
248 link.</p>
|
|
meillo@1
|
249
|
|
meillo@1
|
250 <a name="bugs"></a>
|
|
meillo@1
|
251 <h2>Bugs and Feedback</h2>
|
|
meillo@1
|
252
|
|
meillo@1
|
253 <p>Since MasqMail is very young, bugs are quite probable. If you
|
|
meillo@1
|
254 encounter one, send it to <a
|
|
meillo@1
|
255 href="mailto:oku@masqmail.cx">me</a>. Please tell me the versions of:
|
|
meillo@1
|
256 <ul>
|
|
meillo@1
|
257 <li>MasqMail</li>
|
|
meillo@1
|
258 <li>libc</li>
|
|
meillo@1
|
259 <li>OS (Linux) (use uname -a)</li>
|
|
meillo@1
|
260 <li>glib (use glib-config --version)</li>
|
|
meillo@1
|
261 <li>the compiler (use gcc -v)</li>
|
|
meillo@1
|
262 </ul>
|
|
meillo@1
|
263
|
|
meillo@1
|
264 <p>If not already so, set the debug level to at least 5 and send the
|
|
meillo@1
|
265 debug.log (only the important part please...).</p>
|
|
meillo@1
|
266
|
|
meillo@1
|
267 <p>To improve MasqMail, bug reports are really needed! The more bug
|
|
meillo@1
|
268 reports I get the more stable it will get.</p>
|
|
meillo@1
|
269
|
|
meillo@1
|
270 <p>Suggestions are always welcome. If there is a feature that you
|
|
meillo@1
|
271 would like to have in MasqMail, contact me, and I will think about
|
|
meillo@1
|
272 it. You are also welcome to send patches, but at this stage of
|
|
meillo@1
|
273 development there will be no CVS access.</p>
|
|
meillo@1
|
274
|
|
meillo@1
|
275 <p>If you are using it and are happy with, you can also write that to
|
|
meillo@1
|
276 me. To make <em>me</em> happy.</p>
|
|
meillo@1
|
277
|
|
meillo@1
|
278 <p>If you are not happy with it, you can keep that for
|
|
meillo@1
|
279 yourself. Before you send some flame, please read these pages very
|
|
meillo@1
|
280 carefully again.</p>
|
|
meillo@1
|
281
|
|
meillo@1
|
282 </ul>
|
|
meillo@1
|
283 </td></tr>
|
|
meillo@1
|
284
|
|
meillo@1
|
285 <tr><td>
|
|
meillo@1
|
286 <p>
|
|
meillo@1
|
287 <hr>
|
|
meillo@1
|
288 <address>Oliver Kurth <oku at masqmail dot cx></address>
|
|
meillo@1
|
289 </p>
|
|
meillo@1
|
290
|
|
meillo@1
|
291 </table>
|
|
meillo@1
|
292 </center>
|
|
meillo@1
|
293
|
|
meillo@1
|
294 </BODY>
|
|
meillo@1
|
295 </HEAD>
|
