meillo@56: <HTML>
meillo@56: <HEAD>
meillo@56: <TITLE>MasqMail - Manual
meillo@56: </TITLE>
meillo@56: </HEAD>
meillo@56:   <BODY TEXT="#000000" LINK="#0000ff" BGCOLOR="#ffffff">
meillo@56:     
meillo@56:     <center>
meillo@56:       <table width="80%">
meillo@56: 	<tr><td>
meillo@56: 	    <table width="100%" bgcolor="#0000aa" cellspacing=0 cellpadding=0>
meillo@56: 	      <tr>
meillo@56: 		<td>
meillo@56: 		  <a href="manual.html">
meillo@56: 		    <img width="20" src = "../images/u_arrow.gif" alt = "manual">
meillo@56: 		  </a>
meillo@56: 		</td>
meillo@56: 		<td align=center width="100%"><font size="6" color = "#ffffff">Frequently Asked Questions</font></td>
meillo@56: 		<td>
meillo@56: 		  <a href="./config.html">
meillo@56: 		    <img width="20" src = "../images/l_arrow.gif" alt = "Configuration">
meillo@56: 		  </a>
meillo@56: 		</td>
meillo@56: 	      </tr>
meillo@56: 	    </table>
meillo@56: 	    
meillo@56: 	    
meillo@56: 	    Some of these questions were never asked, but I thought they will be
meillo@56: 	    some time. Some <em>were</em> asked.
meillo@56: 	    
meillo@56: 	    <h4>General Questions</h4>
meillo@56: 	    <ul>
meillo@56: 	      <li><a href="#1_0">1.0: When do I need MasqMail?</a></li>
meillo@56: 	      <li><a href="#1_1">1.1: When do I <em>not</em> need MasqMail?</a></li>
meillo@56: 	      <li><a href="#1_2">1.2: Can I retrieve mail with MasqMail?</a></li>
meillo@56: 	      <li><a href="#1_3">1.3: Is there a mailing list for MasqMail?</a></li>
meillo@56: 	    </ul>
meillo@56: 	    
meillo@56: 	    <h4>Setup</h4>
meillo@56: 	    <ul>
meillo@56: 	      <li><a href="#2_0">2.0: After starting masmail, I get the following
meillo@56: 		  message: "could not gain root privileges. Is the setuid bit set?"</a></li>
meillo@56: 	      <li><a href="#2_1">2.1: After starting masmail, I get the following
meillo@56: 		  message: "bind: (terminating): Address already in use"</a></li>
meillo@56: 	    </ul>
meillo@56: 	    
meillo@56: 	    <h4>Header Rewriting</h4>
meillo@56: 	    <ul>
meillo@56: 	      <li><a href="#3_0">3.0: My friends told me that they do not see my
meillo@56: 		  full name in their inbox, although it is configured in my mail
meillo@56: 		  client.</a></li>
meillo@56: 	    </ul>
meillo@56: 	    
meillo@56: 	    <h4>Delivering Online</h4>
meillo@56: 	    <ul>
meillo@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>
meillo@56: 	      <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>
meillo@56: 	    </ul>
meillo@56: 	    
meillo@56: 	    <h4>Bugs</h4>
meillo@56: 	    <ul>
meillo@56: 	      <li><a href="#5_0">5.0: I found a bug.</a></li>
meillo@56: 	      <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>
meillo@56: 	    </ul>
meillo@56: 	    
meillo@56: 	    <a name="1_0"> <h4>1.0: When do I need MasqMail?</h4></a>
meillo@56: 	    
meillo@56: 	    <p> You do not <em>need</em> it. But it makes sending mails via a
meillo@56: 	      dialup connection a lot easier.</p>
meillo@56: 	    
meillo@56: 	    <p>It is useful if you dial to the internet from time to time via a
meillo@56: 	      modem and connect to different providers, each one with a different
meillo@56: 	      configuration. Other MTAs are not flexible enough if you have to send
meillo@56: 	      mails via different mail servers for each provider. With MasqMail you
meillo@56: 	      can configure a different one for each provider and even set your
meillo@56: 	      return addresses differently.</p>
meillo@56: 	    
meillo@56: 	    <p>It is also useful if you have a LAN with a gateway which is
meillo@56: 	      connected to the internet via a modem because you can rewrite your
meillo@56: 	      address depending on whether the recipients are <em>inside</em> or
meillo@56: 	      <em>outside</em> your LAN. So responses and delivery failures on your
meillo@56: 	      LAN will be sent to you without leaving it, while those outside will
meillo@56: 	      be delivered to your address outside. (But it does not yet send
meillo@56: 	      delivery failures itself yet.)</p>
meillo@56: 	    
meillo@56: 	    <p>MasqMail is also often used on notebooks.</p>
meillo@56: 	    
meillo@56: 	    <a name="1_1"><h4>1.1: When do I <em>not</em> need MasqMail?</h4></a>
meillo@56: 	    
meillo@56: 	    <p>The use of MasqMail is <em>strongly</em> discouraged if you have a
meillo@56: 	      permanent connection to the internet without a firewall. First because
meillo@56: 	      it does not have the ability to block relaying (it relays every mail)
meillo@56: 	      and second because there are no capabilities to protect against
meillo@56: 	      SPAM. You will not take advantages of its features anyway.</p>
meillo@56: 	    
meillo@56: 	    <a name="1_2"><h4>1.2: Can I retrieve mail with MasqMail?</h4></a>
meillo@56: 	    
meillo@56: 	    <p>Yes, for version >= 0.1.0 you can retrieve mail via the POP3 and
meillo@56: 	      APOP protocol from single drop mailboxes (in case you do not know
meillo@56: 	      about single/mutidrop, you probaby use single drop mailboxes).</p>
meillo@56: 	    
meillo@56: 	    <p>You can also use fetchmail or other pop/imap clients to feed
meillo@56: 	      it.</p>
meillo@56: 	    
meillo@56: 	    <a name="1_3"><h4>1.3: Is there a mailing list for MasqMail?</h4></a>
meillo@56: 	    
meillo@56: 	    <p>Yes, there is! See <a href="http://www.innominate.org/mailman/listinfo/masqmail">here</a>.</p>
meillo@56: 	    
meillo@56: 	    <a name="2_0"><h4>2.0: After starting masmail, I get the following
meillo@56: 	      message: "could not gain root privileges. Is the setuid bit set?"</h4></a>
meillo@56: 	    
meillo@56: 	    <p>Set the set-user-id-bit with chmod u+s /usr/sbin/masqmail.</p>
meillo@56: 	    
meillo@56: 	    <a name="2_1"><h4>2.1: After starting masmail, I get the following
meillo@56: 	      message: "bind: (terminating): Address already in use"</h4></a>
meillo@56: 	    
meillo@56: 	    <p>This means that there is already a process listening on a port,
meillo@56: 	      usually 25. You either have another MTA running in background
meillo@56: 	      (sendmail, exim, etc...) or another instance of masqmail.</p>
meillo@56: 	    
meillo@56: 	    <p>It may also mean that the ports you configured MM to listen to
meillo@56: 	      (with 'listen_addresses') are on the same IP address, eg. you may have
meillo@56: 	      set your hostname to 127.0.0.1 and try to listen on localhost and your
meillo@56: 	      host name. In this case either set your hostname to another IP address
meillo@56: 	      or delete one of the conflicting entries.</p>
meillo@56: 	    
meillo@56: 	    <a name="3_0"><h4>3.0: My friends told me that they do not see my full
meillo@56: 	      name in their inbox, although it is configured in my mail
meillo@56: 	      client.</h4></a>
meillo@56: 	    
meillo@56: 	    <p>You probably used the <b>map_h_from_addresses</b> feature in the
meillo@56: 	      route configuration and forgot to set your real name. The syntax
meillo@56: 	      is:</p>
meillo@56: 	    
meillo@56: 	    <pre>
meillo@56: map_h_from_addresses = "charlie:Charlie Miller &lt;cmiller@foo.com&gt";
meillo@56: 	    </pre>
meillo@56: 	    
meillo@56: 	    <p>Do not forget the <em>Charlie Miller</em>.</p>
meillo@56: 	    
meillo@56: 	    <a name="4_0"><h4>4.0: With connection method <em>file</em>, I get the
meillo@56: 	      following message in the log file: "Could not open /tmp/connect_route:
meillo@56: 	      Permission denied".</h4></a>
meillo@56: 	    
meillo@56: 	    <p>In your ip-up script, you have to set read permission to the user
meillo@56: 	      masqmail runs as. After you write the file with the connection name,
meillo@56: 	      set read permission to all with chmod ugo+r <em>file</em>.
meillo@56: 	      
meillo@56: 	      <a name="4_1"><h4>4.1: With connection methed <em>file</em>, I get the
meillo@56: 	      following message in the log file: "route with name <em>name</em> not
meillo@56: 	      found.".</h4></a>
meillo@56: 	    
meillo@56: 	    <p>Check whether the name in the file is really identical to name you
meillo@56: 	      gave to the route configuration (case sensitive!). Maybe there is a
meillo@56: 	      linefeed after the name in the file. Write it with echo -n.</p>
meillo@56: 	    
meillo@56: 	    <a name="5_0"><h4>5.0: I found a bug.</h4></a>
meillo@56: 	    
meillo@56: 	    <p>Make sure you are using the newest version, in case of doubt search
meillo@56: 	      it in <a href="http://www.freshmeat.net">freshmeat</a>. If you do, tell
meillo@56: 	      <a href = "mailto:Oliver Kurth <kurth@innominate.de>">me</a>. See
meillo@56: 	      also the section <a href="index.html#bugs">bugs</a> on the <a
meillo@56: 		href="index.html">main</a> page.</p>
meillo@56: 	    
meillo@56: 	    <a name="5_1"><h4>5.1: I think I found a bug, but I am not sure
meillo@56: 	      whether I configured MasqMail incorrectly.</h4></a>
meillo@56: 	    
meillo@56: 	    <p>Don't care. Tell <a href = "mailto:Oliver Kurth
meillo@56: 	      <kurth@innominate.de>">me</a>. Or write to the <a
meillo@56: 		href="http://www.innominate.org/mailman/listinfo/masqmail">mailing
meillo@56: 		list</a>.</p>
meillo@56: 	    
meillo@56: 	  </td></tr>
meillo@56: 	
meillo@56: 	<tr><td>
meillo@56: 	    <p>
meillo@56: 	    <hr>
meillo@56: 	    <address><a href = "mailto:kurth@innominate.de">Oliver Kurth</a></address>
meillo@56: 	    Last modified: Tue May 30 15:19:56 CEST 2000
meillo@56: 	    <br>
meillo@56: 	    This page was created using <a href="http://www.freddyfrog.com/hacks/genpage/">Genpage</a> - Version: 1.0.6
meillo@56: 	  </p>
meillo@56:     
meillo@56:       </table>
meillo@56:     </center>
meillo@56: 
meillo@56:   </BODY>
meillo@56: </HEAD>
meillo@56: