1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/README	Fri Sep 26 17:05:23 2008 +0200
     1.3 @@ -0,0 +1,82 @@
     1.4 +MasqMail README
     1.5 +
     1.6 +MasqMail is a mail server designed for hosts that are not permanently
     1.7 +connected to the internet. It handles outgoing messages, i.e. those
     1.8 +that are to be sent over the non-permanent link (usually a ppp or slip
     1.9 +connection over a modem or ISDN adapter) specially and delivers them
    1.10 +only when explicitely told to do so. There is support for multiple
    1.11 +providers, it is possible to write different configurations for each
    1.12 +one. The configuration chosen is selected at delivery time, so that if
    1.13 +for example a delivery of a message failed while connected with
    1.14 +provider 1, it may be delivered when connected to provider 2. For each
    1.15 +provider another mail host (or none) can be specified.
    1.16 +
    1.17 +MasqMail provides (a yet simple) mechanism to rewrite headers, also
    1.18 +depending on the current connection. This makes it possible to deliver
    1.19 +messages with a return address on the local network which will be
    1.20 +rewitten at delivery time. The purpose of this is:
    1.21 +
    1.22 +- to allow delivery failure messages that are produced on the local
    1.23 +network to be delivered immediately, while those that are produced
    1.24 +outside can be delivered to a mailbox on the internet, to be retrieved
    1.25 +later.
    1.26 +
    1.27 +- to give mail servers a return address which they can accept if they
    1.28 +check for spam mail. Many mail servers require a return address which
    1.29 +has the same domain as the server it is getting the message from. If
    1.30 +you normally connect to only one provider, this is usually not a
    1.31 +problem as you can configure your mailer to a fixed address (but then
    1.32 +there is still the problem with the failure messages...), but it is a
    1.33 +problem if you use different ones from time to time.
    1.34 +
    1.35 +MasqMail shall once be a complete replacement for sendmail (or other
    1.36 +MTAs such as exim, qmail or smail) on a local network, but it is NOT
    1.37 +supposed to be installed in a network with a permanent internet
    1.38 +connection (at least if it is not behind a secure firewall) because
    1.39 +it has no ability to check for undesired relaying or spam filtering.
    1.40 +
    1.41 +Missing, but soon to be realized features:
    1.42 +
    1.43 +- .forward file support (alias file is supported)
    1.44 +- mailer demon messages (mail from the server in cases of delivery failures
    1.45 +or malformed addresses)
    1.46 +
    1.47 +Future plans are:
    1.48 +
    1.49 +- initiate connections on its own
    1.50 +- integration to the masqdialer system (mserver) as an option
    1.51 +- possibly a pop3 server
    1.52 +
    1.53 +For installation instructions, see INSTALL.
    1.54 +
    1.55 +Bugs: MasqMail is still very young, and there are probably at lot of
    1.56 +bugs in it. I need every bug reported to me! If you do, please send me
    1.57 +the configuration files, the logs, the version, and a good description
    1.58 +on how to reproduce the error. The more bug reports I get, the better
    1.59 +masqmail will get!
    1.60 +
    1.61 +CREDITS:
    1.62 +--------
    1.63 +
    1.64 +I would like to thank everyone who has submitted suggestions and bug
    1.65 +reports. Special thanks to:
    1.66 +
    1.67 +Gregor Hoffleit for beta testing and his suggestions for delivering
    1.68 +mail immediately when online.
    1.69 +Gregor Hoffleit again for supplying a patch which made maqmail work with mutt.
    1.70 +And again for making the Debian package. And more patches.
    1.71 +
    1.72 +Dale Perkel for patiently trying to make MM compile and run with libc5 and
    1.73 +various bug reports.
    1.74 +
    1.75 +Andre Masloch for finding most bugs.
    1.76 +
    1.77 +Edouard G. Parmelan for many patches and bug reports
    1.78 +
    1.79 +Iain Lea for the Redhat spec file
    1.80 +
    1.81 +...and many others
    1.82 +--
    1.83 +Oliver Kurth <oku@masqmail.cx>
    1.84 +http://masqmail.cx/
    1.85 +last change: Feb. 3, 2000