docs/diploma

diff docs/masqmail.cx/index.html @ 1:7b2a5fe2aedd

find changesets by author, revision, files, or words in the commit message
added old website masqmail.cx
author meillo@marmaro.de
date Thu, 18 Sep 2008 18:57:02 +0200
parents
children
line diff
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/docs/masqmail.cx/index.html	Thu Sep 18 18:57:02 2008 +0200
     1.3 @@ -0,0 +1,295 @@
     1.4 +<HTML>
     1.5 +<HEAD>
     1.6 +<TITLE>MasqMail
     1.7 +</TITLE>
     1.8 +</HEAD>
     1.9 +  <BODY TEXT="#000000" LINK="#0000ff" BGCOLOR="#ffffff">
    1.10 +    
    1.11 +    <center>
    1.12 +      <table width="80%">
    1.13 +	<tr><td>
    1.14 +	    <table width="100%" bgcolor="#0000aa" cellspacing=0 cellpadding=0>
    1.15 +<tr>
    1.16 +<td align=center width="100%"><font size="6" color="#ffffff">MasqMail</font></td>
    1.17 +</tr>
    1.18 +</table>
    1.19 +
    1.20 +<center><img src="logo_masqmail.jpg" alt="MasqMail"></img></center><br>
    1.21 +
    1.22 +<a href="index.html#intro">Introduction</a><br>
    1.23 +<a href="index.html#features">Features</a><br>
    1.24 +<a href="index.html#how">How it works</a><br>
    1.25 +<a href="index.html#plat">Platforms</a><br>
    1.26 +<a href="index.html#limit">Limitations</a><br>
    1.27 +<a href="index.html#secure">Security</a><br>
    1.28 +<a href="index.html#require">Requirements</a><br>
    1.29 +<a href="index.html#down">Download</a><br>
    1.30 +<a href="index.html#docu">Documentation</a></br>
    1.31 +<a href="index.html#road">Roadmap</a><br>
    1.32 +<a href="index.html#list">Mailing List</a><br>
    1.33 +<a href="index.html#bugs">Bugs and Suggestions</a><br>
    1.34 +<br>
    1.35 +
    1.36 +
    1.37 +<h2>Introduction</h2>
    1.38 +
    1.39 +<p>MasqMail is a mail server designed for hosts that do not have a
    1.40 +permanent internet connection eg. a home network or a single host at
    1.41 +home. It has special support for connections to different ISPs. It
    1.42 +replaces sendmail or other MTAs such as qmail or exim.<p>
    1.43 +
    1.44 +<p>Since version 0.0.10 it supports alias address expansion and can
    1.45 +deliver to pipes.</p>
    1.46 +
    1.47 +<p>MasqMail is released under the <a href="http://www.fsf.org">GPL</a>
    1.48 +license.</p>
    1.49 +
    1.50 +<a name="features"></a> <h2>Features</h2>
    1.51 +
    1.52 +<ul>
    1.53 +<li>Delivers only when online to a destination 'outside' your LAN</li>
    1.54 +<li>Support for multiple Providers (ie. Mail Servers, or direct delivery)</li>
    1.55 +<li>Rewriting of Return addresses (Return-Path:, From:, Reply-To:),
    1.56 +configurable for each Provider separately</li>
    1.57 +<li>can also be used as a Mail Server on a LAN</li>
    1.58 +<li>alias support</li>
    1.59 +<li>delivery to pipes</li>
    1.60 +<li>delivery to MDAs (eg. procmail)</li>
    1.61 +<li>Maildir support (version >= 0.2.5)</li>
    1.62 +<li>routing depending on sender</li>
    1.63 +<li>AUTH (RFC 2554) support (as client, since version 0.1.0)</li>
    1.64 +<li>SMTP-after-POP</li>
    1.65 +<li>POP3 client</li>
    1.66 +<li>POP3 client daemon (fetch mail in regular intervals if online)</li>
    1.67 +</ul>
    1.68 +
    1.69 +<a name="how"></a> <h2>How it works</h2>
    1.70 +
    1.71 +<p>When offline, MasqMail queues all mail with a destination outside
    1.72 +of the local network. When you connect to the internet, masqmail will
    1.73 +be called with a connection name as an argument. MasqMail then sends
    1.74 +the queued mail to the configured mailserver for that ISP. When a
    1.75 +message from the local net is received when online, MasqMail delivers
    1.76 +it immediately. If there is no mail server for that ISP, MasqMail can
    1.77 +also send the mails directly to their destinations.</p>
    1.78 +
    1.79 +<p>For each ISP different return addresses can be configured. This
    1.80 +makes it possible to get around spam traps which desire your return
    1.81 +address to be from the same domain as the host the mail is coming
    1.82 +from. This is not a problem if you always connect to a single ISP, but
    1.83 +is one if you use different ones from time to time. It also makes it
    1.84 +possible to configure your mailer to a return address on your local
    1.85 +network which maybe totally unknown outside. So delivery failure
    1.86 +messages originating on your local net can be sent directly to you,
    1.87 +while those that occur outside will be sent to the configured
    1.88 +address. <em>(Note that the return path is different from the From:
    1.89 +address or the Reply-to: address. You can still have a single address
    1.90 +where you want replys to be sent to).</em></p>
    1.91 +
    1.92 +<p>When offline, MasqMail behaves just like any other ordinary mail
    1.93 +server (with a few limitations, but these will be fixed in the
    1.94 +future).</p>
    1.95 +
    1.96 +<p>To detect its online status, MasqMail can take advantage of the <a
    1.97 +href="http://cpwright.com/mserver/">masqdialer</a> system. But it also
    1.98 +works well without it.</p>
    1.99 +
   1.100 +<p>See the <a href="manual.html">manual</a> for more information.</p>
   1.101 +
   1.102 +<a name="plat"></a>
   1.103 +<h2>Platforms</h2>
   1.104 +
   1.105 +<p>MasqMail is being developed for Linux. It may run on other Un*x like
   1.106 +platforms, but it will certainly not run on Windows or a
   1.107 +Mac. Currently I see no point in porting it to other platforms.</p>
   1.108 +
   1.109 +<p>But it is possible to use a Windows (or Mac or any system that
   1.110 +knows about SMTP) host as a client. Just configure your mailer to use
   1.111 +the machine MasqMail is running on as your mail server.</p>
   1.112 +
   1.113 +<a name="limit"></a>
   1.114 +<h2>Limitations</h2>
   1.115 +
   1.116 +<p>MasqMail is still in an early stage of development so use it with
   1.117 +caution! There may still be serious bugs in it, so mail might
   1.118 +get lost. But in the nearly two years of its existence so far there
   1.119 +was only one time a bug which caused mail retrieved via pop3 to be
   1.120 +lost in rare circumstances.</p>
   1.121 +
   1.122 +<p>There are also some features every MTA should have:</p>
   1.123 +
   1.124 +<ul>
   1.125 +
   1.126 +<li> it does not use .forward files (but it uses alias files since 0.0.10)</li>
   1.127 +<li> it does not support retrieving mail from a multi-drop mailboxes</li>
   1.128 +
   1.129 +</ul>
   1.130 +
   1.131 +<p>But these are worked on.</p>
   1.132 +
   1.133 +<p>MasqMail is <em>not</em> designed to run on a host with a permanent
   1.134 +internet connection. It does not have the ability to check for spam
   1.135 +mail and it will relay everything from everywhere to everywhere. Use
   1.136 +another mail server such as <a href="http://www.exim.org">exim</a>
   1.137 +for permanent connections.</p>
   1.138 +
   1.139 +<p>BTW: I am already using it...</p>
   1.140 +
   1.141 +<a name="secure"></a>
   1.142 +<h2>Security</h2>
   1.143 +
   1.144 +<p>I hope that I have not done anything stupid, but there may be
   1.145 +security holes in it. If you find one, please tell me.</p>
   1.146 +
   1.147 +<p>MasqMail does not listen to a port to the internet (unless you
   1.148 +manage to configure it to do so... which is pretty senseless anyway),
   1.149 +so that door is closed.</p>
   1.150 +
   1.151 +<p>MasqMail is designed to run with an own user and group id. It uses
   1.152 +root permission only when necessary, ie. to open a listening port and
   1.153 +to change identity to some user when it delivers local mail.</p>
   1.154 +
   1.155 +<a name="require"></a>
   1.156 +<h2>Requirements</h2>
   1.157 +
   1.158 +<p>MasqMail requires glib 1.2 or greater. You may find this strange
   1.159 +since glib was originally written for gimp and is used by <a
   1.160 +href="http://www.gtk.org">gtk</a>, but glib does not necessarily have
   1.161 +to do with GUIs. It has some useful list and string functions, and I
   1.162 +use only these. This may change in the future when I write my own
   1.163 +utilities.</p>
   1.164 +
   1.165 +<p>I develop MasqMail with a Debian woody distribution, Kernel 2.4.x and
   1.166 +glibc (libc6) with gcc 2.95. There have been reports that it compiles and
   1.167 +runs under Redhat, SuSE, slackware, with libc5 (since 0.0.4) and Kernel
   1.168 +2.0.x and 2.2.x, and FreeBSD, OpenBSD and NetBSD.</p>
   1.169 +
   1.170 +<a name="down"></a>
   1.171 +<h2>Download</h2>
   1.172 +
   1.173 +<a href="download/masqmail-0.2.20.tar.gz">masqmail-0.2.20.tar.gz (http)</a> (unstable version, about 242K)<br>
   1.174 +<a href="download/masqmail-0.2.20.tar.gz.asc">masqmail-0.2.20.tar.gz.asc (http)</a>
   1.175 +detached <a href="http://www.gnupg.org">GnuPG</a> signature, signed with
   1.176 +<a href="oku.asc">451EAB1B</a>, fingerprint <pre>CDA0 CB53 83C6 84DF 760F  6BFE 5265 5226 451E AB1B</pre>
   1.177 +<a href="download/masqmail-0.2.18.tar.gz.md5sum">masqmail-0.2.20.tar.gz.md5sum (http)</a> (md5sum)<br>
   1.178 +<!--
   1.179 +<br>
   1.180 +<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>
   1.181 +<br>
   1.182 +<a href="download/masqmail_0.2.18-0.sarge1_i386.deb">masqmail_0.2.18-0.sarge1_i386.deb</a> Debian package for sarge
   1.183 +-->
   1.184 +<br>
   1.185 +<br>
   1.186 +xdelta (binary patches), apply with
   1.187 +<pre>
   1.188 +xdelta patch file.xdelta old.tar.gz new.tar.gz
   1.189 +</pre>
   1.190 +<a href="download/masqmail-0.2.12-0.2.13.xdelta">masqmail-0.2.12-0.2.13.xdelta</a> (5K)<br>
   1.191 +<a href="download/masqmail-0.2.13-0.2.14.xdelta">masqmail-0.2.13-0.2.14.xdelta</a> (7K)<br>
   1.192 +<a href="download/masqmail-0.2.14-0.2.15.xdelta">masqmail-0.2.14-0.2.15.xdelta</a> (6K)<br>
   1.193 +<a href="download/masqmail-0.2.15-0.2.16.xdelta">masqmail-0.2.15-0.2.16.xdelta</a> (5K)<br>
   1.194 +<a href="download/masqmail-0.2.16-0.2.17.xdelta">masqmail-0.2.16-0.2.17.xdelta</a> (15K)<br>
   1.195 +<a href="download/masqmail-0.2.17-0.2.18.xdelta">masqmail-0.2.17-0.2.18.xdelta</a> (8K)<br>
   1.196 +<a href="download/masqmail-0.2.18-0.2.19.xdelta">masqmail-0.2.18-0.2.19.xdelta</a> (6K)<br>
   1.197 +<a href="download/masqmail-0.2.19-0.2.20.xdelta">masqmail-0.2.19-0.2.20.xdelta</a> (6K)<br>
   1.198 +
   1.199 +<p>Note: the unstable version is pretty stable already.</p>
   1.200 +
   1.201 +<a href="download/MasqMail-0.1.17.tar.gz">MasqMail-0.1.17.tar.gz (http)</a> (stable version, about 174K)<br>
   1.202 +<!--
   1.203 +<br>
   1.204 +<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
   1.205 +-->
   1.206 +<br>
   1.207 +
   1.208 +<p>Waldemar Brodkorb has made rpms for SuSE 7.0 and 7.1 <em>with</em> ESMTP AUTH,
   1.209 +see <a href="http://packman.links2linux.de/index.php4?action=091">this page</a></p>
   1.210 +
   1.211 +<a href="download/ChangeLog">ChangeLog (unstable)</a><br>
   1.212 +<a href="download/ChangeLog-stable">ChangeLog (stable)</a><br>
   1.213 +<br>
   1.214 +See <a href="download/index.html">download/</a> if your are curious for older versions.
   1.215 +
   1.216 +<p>masqmail is also in Debian. You will find it <a
   1.217 +href="http://packages.debian.org/masqmail">here</a>.</p>
   1.218 +
   1.219 +<a name="docu"></a>
   1.220 +<h2>Documentation</h2>
   1.221 +
   1.222 +<p>masqmail comes with a bunch of man pages, these are also available
   1.223 +<a href="manual.html">online</a>. Some people have written introductory pages
   1.224 +for the initial installation:</p>
   1.225 +
   1.226 +<p>
   1.227 +Christoph Hertel has written a <a href="http://instruction.at/mmquickconfig">quick help</a> page for masqmail.
   1.228 +</p>
   1.229 +
   1.230 +<a name="road"></a>
   1.231 +<h2>Roadmap</h2>
   1.232 +
   1.233 +<p>MasqMail will be optimized for slow connections. It uses ESMTP
   1.234 +pipelining both when sending and receiving and sends all messages to a
   1.235 +single host in a single connection.</p>
   1.236 +
   1.237 +<p>Apart from the missing things mentioned above, I plan to implement
   1.238 +the following features:</p>
   1.239 +
   1.240 +<ul>
   1.241 +<li>ODMR support as a client</li>
   1.242 +<li>POP3 multidrop support</li>
   1.243 +</ul>
   1.244 +
   1.245 +<a name="list"></a>
   1.246 +<h2>Mailing List</h2>
   1.247 +
   1.248 +<p>There is now a <a
   1.249 +href="http://lists.masqmail.cx/cgi-bin/mailman/listinfo/masqmail">Mailing
   1.250 +List</a> for MasqMail. To subscribe or to view the archive use the
   1.251 +link.</p>
   1.252 +
   1.253 +<a name="bugs"></a>
   1.254 +<h2>Bugs and Feedback</h2>
   1.255 +
   1.256 +<p>Since MasqMail is very young, bugs are quite probable. If you
   1.257 +encounter one, send it to <a
   1.258 +href="mailto:oku@masqmail.cx">me</a>. Please tell me the versions of:
   1.259 +<ul>
   1.260 +<li>MasqMail</li>
   1.261 +<li>libc</li>
   1.262 +<li>OS (Linux) (use uname -a)</li>
   1.263 +<li>glib (use glib-config --version)</li>
   1.264 +<li>the compiler (use gcc -v)</li>
   1.265 +</ul>
   1.266 +
   1.267 +<p>If not already so, set the debug level to at least 5 and send the
   1.268 +debug.log (only the important part please...).</p>
   1.269 +
   1.270 +<p>To improve MasqMail, bug reports are really needed! The more bug
   1.271 +reports I get the more stable it will get.</p>
   1.272 +
   1.273 +<p>Suggestions are always welcome. If there is a feature that you
   1.274 +would like to have in MasqMail, contact me, and I will think about
   1.275 +it. You are also welcome to send patches, but at this stage of
   1.276 +development there will be no CVS access.</p>
   1.277 +
   1.278 +<p>If you are using it and are happy with, you can also write that to
   1.279 +me. To make <em>me</em> happy.</p>
   1.280 +
   1.281 +<p>If you are not happy with it, you can keep that for
   1.282 +yourself. Before you send some flame, please read these pages very
   1.283 +carefully again.</p>
   1.284 +
   1.285 +</ul>
   1.286 +	  </td></tr>
   1.287 +    
   1.288 +	<tr><td>
   1.289 +	    <p>
   1.290 +	    <hr>
   1.291 +	    <address>Oliver Kurth &lt;oku at masqmail dot cx&gt;</address>
   1.292 +	  </p>
   1.293 +    
   1.294 +      </table>
   1.295 +    </center>
   1.296 +
   1.297 +  </BODY>
   1.298 +</HEAD>