masqmail

view README @ 333:0bd27f603910

find changesets by author, revision, files, or words in the commit message
Added debug level 9 for msgs to stderr during reading config See changes to man page, included in this changeset.
author markus schnalke <meillo@marmaro.de>
date Sat, 27 Aug 2011 16:54:14 +0200
parents 413dbf3b1153
children
line source
1 Masqmail README
2 ===============
3
4 Masqmail is a mail server designed for hosts that are not permanently
5 connected to the internet. It handles outgoing messages, i.e. those
6 that are to be sent over the non-permanent link (usually a ppp or slip
7 connection over a modem or ISDN adapter) specially and delivers them
8 only when explicitely told to do so. There is support for multiple
9 providers, it is possible to write different configurations for each
10 one. The configuration chosen is selected at delivery time, so that if
11 for example a delivery of a message failed while connected with
12 provider 1, it may be delivered when connected to provider 2. For each
13 provider another mail host (or none) can be specified.
14
15 Masqmail provides (a yet simple) mechanism to rewrite headers, also
16 depending on the current connection. This makes it possible to deliver
17 messages with a return address on the local network which will be
18 rewitten at delivery time. The purpose of this is:
19
20 - to allow delivery failure messages that are produced on the local
21 network to be delivered immediately, while those that are produced
22 outside can be delivered to a mailbox on the internet, to be retrieved
23 later.
24
25 - to give mail servers a return address which they can accept if they
26 check for spam mail. Many mail servers require a return address which
27 has the same domain as the server it is getting the message from. If
28 you normally connect to only one provider, this is usually not a
29 problem as you can configure your mailer to a fixed address (but then
30 there is still the problem with the failure messages...), but it is a
31 problem if you use different ones from time to time.
32
33 Masqmail shall once be a complete replacement for sendmail (or other
34 MTAs such as exim, qmail or smail) on a local network, but it is NOT
35 supposed to be installed in a network with a permanent internet
36 connection (at least if it is not behind a secure firewall) because
37 it has no ability to check for undesired relaying or spam filtering.
38
39
40 Masqmail's website is:
41
42 http://marmaro.de/prog/masqmail
43
44 The email address of it's mailing list is:
45
46 <masqmail@marmaro.de>
47
48 To subscribe yourself to the list, send a mail with the subject
49 ``subscribe masqmail'' to <minimalist@marmaro.de>. The mailing list
50 archive is accessible at: http://lists.marmaro.de/masqmail/ . If you
51 have any problems, contact me: markus schnalke <meillo@marmaro.de>.
52
53
54 INSTALLATION
55 ------------
56
57 For installation instructions, see INSTALL.
58
59
60 BUGS
61 ----
62
63 There are probably bugs in masqmail. Please report any one you discover
64 to me. The more bug reports I get, the better masqmail will get.
65
66 See docs/howto-report-bugs for detailed instructions.
67
68
69 CREDITS
70 -------
71
72 I would like to thank everyone who has submitted suggestions and bug
73 reports.
74
75 See THANKS.
76
77
78
79 This file was originally written by by Oliver Kurth <oku@masqmail.cx>.
80 Later updated and extended by markus schnalke <meillo@marmaro.de>.