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