comparison README @ 67:bce7604e0465

updated README; added howto-report-bugs removed old future goals for masqmail, which oku had
author meillo@marmaro.de
date Sun, 30 May 2010 19:15:26 +0200
parents 08114f7dcc23
children 89467037cb36
comparison
equal deleted inserted replaced
66:4762e0d26d8e 67:bce7604e0465
1 MasqMail README 1 Masqmail README
2 ===============
2 3
3 MasqMail is a mail server designed for hosts that are not permanently 4 Masqmail is a mail server designed for hosts that are not permanently
4 connected to the internet. It handles outgoing messages, i.e. those 5 connected to the internet. It handles outgoing messages, i.e. those
5 that are to be sent over the non-permanent link (usually a ppp or slip 6 that are to be sent over the non-permanent link (usually a ppp or slip
6 connection over a modem or ISDN adapter) specially and delivers them 7 connection over a modem or ISDN adapter) specially and delivers them
7 only when explicitely told to do so. There is support for multiple 8 only when explicitely told to do so. There is support for multiple
8 providers, it is possible to write different configurations for each 9 providers, it is possible to write different configurations for each
9 one. The configuration chosen is selected at delivery time, so that if 10 one. The configuration chosen is selected at delivery time, so that if
10 for example a delivery of a message failed while connected with 11 for example a delivery of a message failed while connected with
11 provider 1, it may be delivered when connected to provider 2. For each 12 provider 1, it may be delivered when connected to provider 2. For each
12 provider another mail host (or none) can be specified. 13 provider another mail host (or none) can be specified.
13 14
14 MasqMail provides (a yet simple) mechanism to rewrite headers, also 15 Masqmail provides (a yet simple) mechanism to rewrite headers, also
15 depending on the current connection. This makes it possible to deliver 16 depending on the current connection. This makes it possible to deliver
16 messages with a return address on the local network which will be 17 messages with a return address on the local network which will be
17 rewitten at delivery time. The purpose of this is: 18 rewitten at delivery time. The purpose of this is:
18 19
19 - to allow delivery failure messages that are produced on the local 20 - to allow delivery failure messages that are produced on the local
27 you normally connect to only one provider, this is usually not a 28 you normally connect to only one provider, this is usually not a
28 problem as you can configure your mailer to a fixed address (but then 29 problem as you can configure your mailer to a fixed address (but then
29 there is still the problem with the failure messages...), but it is a 30 there is still the problem with the failure messages...), but it is a
30 problem if you use different ones from time to time. 31 problem if you use different ones from time to time.
31 32
32 MasqMail shall once be a complete replacement for sendmail (or other 33 Masqmail shall once be a complete replacement for sendmail (or other
33 MTAs such as exim, qmail or smail) on a local network, but it is NOT 34 MTAs such as exim, qmail or smail) on a local network, but it is NOT
34 supposed to be installed in a network with a permanent internet 35 supposed to be installed in a network with a permanent internet
35 connection (at least if it is not behind a secure firewall) because 36 connection (at least if it is not behind a secure firewall) because
36 it has no ability to check for undesired relaying or spam filtering. 37 it has no ability to check for undesired relaying or spam filtering.
37 38
38 Missing, but soon to be realized features:
39 39
40 - .forward file support (alias file is supported) 40 Masqmail's website is:
41 - mailer demon messages (mail from the server in cases of delivery failures
42 or malformed addresses)
43 41
44 Future plans are: 42 http://marmaro.de/prog/masqmail
45 43
46 - initiate connections on its own 44 The email address of it's mailing list is:
47 - integration to the masqdialer system (mserver) as an option 45
48 - possibly a pop3 server 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 ------------
49 56
50 For installation instructions, see INSTALL. 57 For installation instructions, see INSTALL.
51 58
52 Bugs: MasqMail is still very young, and there are probably at lot of
53 bugs in it. I need every bug reported to me! If you do, please send me
54 the configuration files, the logs, the version, and a good description
55 on how to reproduce the error. The more bug reports I get, the better
56 masqmail will get!
57 59
58 CREDITS: 60 BUGS
59 -------- 61 ----
62
63 There are probably a lot of bugs in masqmail. Please report any one you
64 discover to me. The more bug reports I get, the better masqmail will
65 get.
66
67 See docs/howto-report-bugs for detailed instructions.
68
69
70 CREDITS
71 -------
60 72
61 I would like to thank everyone who has submitted suggestions and bug 73 I would like to thank everyone who has submitted suggestions and bug
62 reports. Special thanks to: 74 reports. Special thanks to:
63 75
64 Gregor Hoffleit for beta testing and his suggestions for delivering 76 Gregor Hoffleit for beta testing and his suggestions for delivering
65 mail immediately when online. 77 mail immediately when online. And for supplying a patch which made
66 Gregor Hoffleit again for supplying a patch which made maqmail work with mutt. 78 masqmail work with mutt. And again for making the Debian package. And
67 And again for making the Debian package. And more patches. 79 more patches.
68 80
69 Dale Perkel for patiently trying to make MM compile and run with libc5 and 81 Dale Perkel for patiently trying to make MM compile and run with libc5
70 various bug reports. 82 and various bug reports.
71 83
72 Andre Masloch for finding most bugs. 84 Andre Masloch for finding most bugs.
73 85
74 Edouard G. Parmelan for many patches and bug reports 86 Edouard G. Parmelan for many patches and bug reports.
75 87
76 Iain Lea for the Redhat spec file 88 Iain Lea for the Redhat spec file.
77 89
78 ...and many others 90 Juergen Daubert for excellent bug reports including patches and various
79 -- 91 feedback.
80 Oliver Kurth <oku@masqmail.cx> 92
81 http://masqmail.cx/ 93 ... and many others.
82 last change: Feb. 3, 2000 94 See ChangeLog, the code repository log, and the mailing list for more.
95 Feel free to tell me if you think you are missing on this list.
96
97
98
99 This file was originally written by by Oliver Kurth <oku@masqmail.cx>.
100 Later updated and extended by markus schnalke <meillo@marmaro.de>.