56
+ − 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 <cmiller@foo.com>";
+ − 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
