masqmail

view docs/old-manual/faq.html @ 64:0379789a847b

improved comments in test cases
author meillo@marmaro.de
date Sun, 30 May 2010 16:52:35 +0200
parents
children
line source
1 <HTML>
2 <HEAD>
3 <TITLE>MasqMail - Manual
4 </TITLE>
5 </HEAD>
6 <BODY TEXT="#000000" LINK="#0000ff" BGCOLOR="#ffffff">
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>
28 Some of these questions were never asked, but I thought they will be
29 some time. Some <em>were</em> asked.
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>
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>
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>
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>
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>
66 <a name="1_0"> <h4>1.0: When do I need MasqMail?</h4></a>
68 <p> You do not <em>need</em> it. But it makes sending mails via a
69 dialup connection a lot easier.</p>
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>
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>
86 <p>MasqMail is also often used on notebooks.</p>
88 <a name="1_1"><h4>1.1: When do I <em>not</em> need MasqMail?</h4></a>
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>
96 <a name="1_2"><h4>1.2: Can I retrieve mail with MasqMail?</h4></a>
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>
102 <p>You can also use fetchmail or other pop/imap clients to feed
103 it.</p>
105 <a name="1_3"><h4>1.3: Is there a mailing list for MasqMail?</h4></a>
107 <p>Yes, there is! See <a href="http://www.innominate.org/mailman/listinfo/masqmail">here</a>.</p>
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>
112 <p>Set the set-user-id-bit with chmod u+s /usr/sbin/masqmail.</p>
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>
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>
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>
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>
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>
135 <pre>
136 map_h_from_addresses = "charlie:Charlie Miller &lt;cmiller@foo.com&gt";
137 </pre>
139 <p>Do not forget the <em>Charlie Miller</em>.</p>
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>
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>.
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>
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>
157 <a name="5_0"><h4>5.0: I found a bug.</h4></a>
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>
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>
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>
173 </td></tr>
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>
184 </table>
185 </center>
187 </BODY>
188 </HEAD>