Mercurial > masqmail

comparison docs/old-manual/faq.html @ 56:f6a6f55b7b9e

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
added old manual from the old website it is dated May/July 2000
author meillo@marmaro.de
date Sat, 29 May 2010 21:51:13 +0200
parents
children
comparison
equal deleted inserted replaced
55:185ba6c0e6f0 56:f6a6f55b7b9e
1 <HTML>
2 <HEAD>
3 <TITLE>MasqMail - Manual
4 </TITLE>
5 </HEAD>
6 <BODY TEXT="#000000" LINK="#0000ff" BGCOLOR="#ffffff">
7
8 <center>
9 <table width="80%">
10 <tr><td>
11 <table width="100%" bgcolor="#0000aa" cellspacing=0 cellpadding=0>
12 <tr>
13 <td>
14 <a href="manual.html">
15 <img width="20" src = "../images/u_arrow.gif" alt = "manual">
16 </a>
17 </td>
18 <td align=center width="100%"><font size="6" color = "#ffffff">Frequently Asked Questions</font></td>
19 <td>
20 <a href="./config.html">
21 <img width="20" src = "../images/l_arrow.gif" alt = "Configuration">
22 </a>
23 </td>
24 </tr>
25 </table>
26
27
28 Some of these questions were never asked, but I thought they will be
29 some time. Some <em>were</em> asked.
30
31 <h4>General Questions</h4>
32 <ul>
33 <li><a href="#1_0">1.0: When do I need MasqMail?</a></li>
34 <li><a href="#1_1">1.1: When do I <em>not</em> need MasqMail?</a></li>
35 <li><a href="#1_2">1.2: Can I retrieve mail with MasqMail?</a></li>
36 <li><a href="#1_3">1.3: Is there a mailing list for MasqMail?</a></li>
37 </ul>
38
39 <h4>Setup</h4>
40 <ul>
41 <li><a href="#2_0">2.0: After starting masmail, I get the following
42 message: "could not gain root privileges. Is the setuid bit set?"</a></li>
43 <li><a href="#2_1">2.1: After starting masmail, I get the following
44 message: "bind: (terminating): Address already in use"</a></li>
45 </ul>
46
47 <h4>Header Rewriting</h4>
48 <ul>
49 <li><a href="#3_0">3.0: My friends told me that they do not see my
50 full name in their inbox, although it is configured in my mail
51 client.</a></li>
52 </ul>
53
54 <h4>Delivering Online</h4>
55 <ul>
56 <li><a href="#4_0">4.0: With connection methed <em>file</em>, I get the following message in the log file: "Could not open /tmp/connect_route: Permission denied".</a></li>
57 <li><a href="#4_1">4.1: With connection methed <em>file</em>, I get the following message in the log file: "route with name <em>name</em> not found.".</a></li>
58 </ul>
59
60 <h4>Bugs</h4>
61 <ul>
62 <li><a href="#5_0">5.0: I found a bug.</a></li>
63 <li><a href="#5_1">5.1: I think I found a bug, but I am not sure whether I configured MasqMail incorrectly.</a></li>
64 </ul>
65
66 <a name="1_0"> <h4>1.0: When do I need MasqMail?</h4></a>
67
68 <p> You do not <em>need</em> it. But it makes sending mails via a
69 dialup connection a lot easier.</p>
70
71 <p>It is useful if you dial to the internet from time to time via a
72 modem and connect to different providers, each one with a different
73 configuration. Other MTAs are not flexible enough if you have to send
74 mails via different mail servers for each provider. With MasqMail you
75 can configure a different one for each provider and even set your
76 return addresses differently.</p>
77
78 <p>It is also useful if you have a LAN with a gateway which is
79 connected to the internet via a modem because you can rewrite your
80 address depending on whether the recipients are <em>inside</em> or
81 <em>outside</em> your LAN. So responses and delivery failures on your
82 LAN will be sent to you without leaving it, while those outside will
83 be delivered to your address outside. (But it does not yet send
84 delivery failures itself yet.)</p>
85
86 <p>MasqMail is also often used on notebooks.</p>
87
88 <a name="1_1"><h4>1.1: When do I <em>not</em> need MasqMail?</h4></a>
89
90 <p>The use of MasqMail is <em>strongly</em> discouraged if you have a
91 permanent connection to the internet without a firewall. First because
92 it does not have the ability to block relaying (it relays every mail)
93 and second because there are no capabilities to protect against
94 SPAM. You will not take advantages of its features anyway.</p>
95
96 <a name="1_2"><h4>1.2: Can I retrieve mail with MasqMail?</h4></a>
97
98 <p>Yes, for version >= 0.1.0 you can retrieve mail via the POP3 and
99 APOP protocol from single drop mailboxes (in case you do not know
100 about single/mutidrop, you probaby use single drop mailboxes).</p>
101
102 <p>You can also use fetchmail or other pop/imap clients to feed
103 it.</p>
104
105 <a name="1_3"><h4>1.3: Is there a mailing list for MasqMail?</h4></a>
106
107 <p>Yes, there is! See <a href="http://www.innominate.org/mailman/listinfo/masqmail">here</a>.</p>
108
109 <a name="2_0"><h4>2.0: After starting masmail, I get the following
110 message: "could not gain root privileges. Is the setuid bit set?"</h4></a>
111
112 <p>Set the set-user-id-bit with chmod u+s /usr/sbin/masqmail.</p>
113
114 <a name="2_1"><h4>2.1: After starting masmail, I get the following
115 message: "bind: (terminating): Address already in use"</h4></a>
116
117 <p>This means that there is already a process listening on a port,
118 usually 25. You either have another MTA running in background
119 (sendmail, exim, etc...) or another instance of masqmail.</p>
120
121 <p>It may also mean that the ports you configured MM to listen to
122 (with 'listen_addresses') are on the same IP address, eg. you may have
123 set your hostname to 127.0.0.1 and try to listen on localhost and your
124 host name. In this case either set your hostname to another IP address
125 or delete one of the conflicting entries.</p>
126
127 <a name="3_0"><h4>3.0: My friends told me that they do not see my full
128 name in their inbox, although it is configured in my mail
129 client.</h4></a>
130
131 <p>You probably used the <b>map_h_from_addresses</b> feature in the
132 route configuration and forgot to set your real name. The syntax
133 is:</p>
134
135 <pre>
136 map_h_from_addresses = "charlie:Charlie Miller &lt;cmiller@foo.com&gt";
137 </pre>
138
139 <p>Do not forget the <em>Charlie Miller</em>.</p>
140
141 <a name="4_0"><h4>4.0: With connection method <em>file</em>, I get the
142 following message in the log file: "Could not open /tmp/connect_route:
143 Permission denied".</h4></a>
144
145 <p>In your ip-up script, you have to set read permission to the user
146 masqmail runs as. After you write the file with the connection name,
147 set read permission to all with chmod ugo+r <em>file</em>.
148
149 <a name="4_1"><h4>4.1: With connection methed <em>file</em>, I get the
150 following message in the log file: "route with name <em>name</em> not
151 found.".</h4></a>
152
153 <p>Check whether the name in the file is really identical to name you
154 gave to the route configuration (case sensitive!). Maybe there is a
155 linefeed after the name in the file. Write it with echo -n.</p>
156
157 <a name="5_0"><h4>5.0: I found a bug.</h4></a>
158
159 <p>Make sure you are using the newest version, in case of doubt search
160 it in <a href="http://www.freshmeat.net">freshmeat</a>. If you do, tell
161 <a href = "mailto:Oliver Kurth <kurth@innominate.de>">me</a>. See
162 also the section <a href="index.html#bugs">bugs</a> on the <a
163 href="index.html">main</a> page.</p>
164
165 <a name="5_1"><h4>5.1: I think I found a bug, but I am not sure
166 whether I configured MasqMail incorrectly.</h4></a>
167
168 <p>Don't care. Tell <a href = "mailto:Oliver Kurth
169 <kurth@innominate.de>">me</a>. Or write to the <a
170 href="http://www.innominate.org/mailman/listinfo/masqmail">mailing
171 list</a>.</p>
172
173 </td></tr>
174
175 <tr><td>
176 <p>
177 <hr>
178 <address><a href = "mailto:kurth@innominate.de">Oliver Kurth</a></address>
179 Last modified: Tue May 30 15:19:56 CEST 2000
180 <br>
181 This page was created using <a href="http://www.freddyfrog.com/hacks/genpage/">Genpage</a> - Version: 1.0.6
182 </p>
183
184 </table>
185 </center>
186
187 </BODY>
188 </HEAD>
189