masqmail-0.2

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

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
line diff
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/docs/old-manual/faq.html	Sat May 29 21:51:13 2010 +0200
     1.3 @@ -0,0 +1,189 @@
     1.4 +<HTML>
     1.5 +<HEAD>
     1.6 +<TITLE>MasqMail - Manual
     1.7 +</TITLE>
     1.8 +</HEAD>
     1.9 +  <BODY TEXT="#000000" LINK="#0000ff" BGCOLOR="#ffffff">
    1.10 +    
    1.11 +    <center>
    1.12 +      <table width="80%">
    1.13 +	<tr><td>
    1.14 +	    <table width="100%" bgcolor="#0000aa" cellspacing=0 cellpadding=0>
    1.15 +	      <tr>
    1.16 +		<td>
    1.17 +		  <a href="manual.html">
    1.18 +		    <img width="20" src = "../images/u_arrow.gif" alt = "manual">
    1.19 +		  </a>
    1.20 +		</td>
    1.21 +		<td align=center width="100%"><font size="6" color = "#ffffff">Frequently Asked Questions</font></td>
    1.22 +		<td>
    1.23 +		  <a href="./config.html">
    1.24 +		    <img width="20" src = "../images/l_arrow.gif" alt = "Configuration">
    1.25 +		  </a>
    1.26 +		</td>
    1.27 +	      </tr>
    1.28 +	    </table>
    1.29 +	    
    1.30 +	    
    1.31 +	    Some of these questions were never asked, but I thought they will be
    1.32 +	    some time. Some <em>were</em> asked.
    1.33 +	    
    1.34 +	    <h4>General Questions</h4>
    1.35 +	    <ul>
    1.36 +	      <li><a href="#1_0">1.0: When do I need MasqMail?</a></li>
    1.37 +	      <li><a href="#1_1">1.1: When do I <em>not</em> need MasqMail?</a></li>
    1.38 +	      <li><a href="#1_2">1.2: Can I retrieve mail with MasqMail?</a></li>
    1.39 +	      <li><a href="#1_3">1.3: Is there a mailing list for MasqMail?</a></li>
    1.40 +	    </ul>
    1.41 +	    
    1.42 +	    <h4>Setup</h4>
    1.43 +	    <ul>
    1.44 +	      <li><a href="#2_0">2.0: After starting masmail, I get the following
    1.45 +		  message: "could not gain root privileges. Is the setuid bit set?"</a></li>
    1.46 +	      <li><a href="#2_1">2.1: After starting masmail, I get the following
    1.47 +		  message: "bind: (terminating): Address already in use"</a></li>
    1.48 +	    </ul>
    1.49 +	    
    1.50 +	    <h4>Header Rewriting</h4>
    1.51 +	    <ul>
    1.52 +	      <li><a href="#3_0">3.0: My friends told me that they do not see my
    1.53 +		  full name in their inbox, although it is configured in my mail
    1.54 +		  client.</a></li>
    1.55 +	    </ul>
    1.56 +	    
    1.57 +	    <h4>Delivering Online</h4>
    1.58 +	    <ul>
    1.59 +	      <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>
    1.60 +	      <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>
    1.61 +	    </ul>
    1.62 +	    
    1.63 +	    <h4>Bugs</h4>
    1.64 +	    <ul>
    1.65 +	      <li><a href="#5_0">5.0: I found a bug.</a></li>
    1.66 +	      <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>
    1.67 +	    </ul>
    1.68 +	    
    1.69 +	    <a name="1_0"> <h4>1.0: When do I need MasqMail?</h4></a>
    1.70 +	    
    1.71 +	    <p> You do not <em>need</em> it. But it makes sending mails via a
    1.72 +	      dialup connection a lot easier.</p>
    1.73 +	    
    1.74 +	    <p>It is useful if you dial to the internet from time to time via a
    1.75 +	      modem and connect to different providers, each one with a different
    1.76 +	      configuration. Other MTAs are not flexible enough if you have to send
    1.77 +	      mails via different mail servers for each provider. With MasqMail you
    1.78 +	      can configure a different one for each provider and even set your
    1.79 +	      return addresses differently.</p>
    1.80 +	    
    1.81 +	    <p>It is also useful if you have a LAN with a gateway which is
    1.82 +	      connected to the internet via a modem because you can rewrite your
    1.83 +	      address depending on whether the recipients are <em>inside</em> or
    1.84 +	      <em>outside</em> your LAN. So responses and delivery failures on your
    1.85 +	      LAN will be sent to you without leaving it, while those outside will
    1.86 +	      be delivered to your address outside. (But it does not yet send
    1.87 +	      delivery failures itself yet.)</p>
    1.88 +	    
    1.89 +	    <p>MasqMail is also often used on notebooks.</p>
    1.90 +	    
    1.91 +	    <a name="1_1"><h4>1.1: When do I <em>not</em> need MasqMail?</h4></a>
    1.92 +	    
    1.93 +	    <p>The use of MasqMail is <em>strongly</em> discouraged if you have a
    1.94 +	      permanent connection to the internet without a firewall. First because
    1.95 +	      it does not have the ability to block relaying (it relays every mail)
    1.96 +	      and second because there are no capabilities to protect against
    1.97 +	      SPAM. You will not take advantages of its features anyway.</p>
    1.98 +	    
    1.99 +	    <a name="1_2"><h4>1.2: Can I retrieve mail with MasqMail?</h4></a>
   1.100 +	    
   1.101 +	    <p>Yes, for version >= 0.1.0 you can retrieve mail via the POP3 and
   1.102 +	      APOP protocol from single drop mailboxes (in case you do not know
   1.103 +	      about single/mutidrop, you probaby use single drop mailboxes).</p>
   1.104 +	    
   1.105 +	    <p>You can also use fetchmail or other pop/imap clients to feed
   1.106 +	      it.</p>
   1.107 +	    
   1.108 +	    <a name="1_3"><h4>1.3: Is there a mailing list for MasqMail?</h4></a>
   1.109 +	    
   1.110 +	    <p>Yes, there is! See <a href="http://www.innominate.org/mailman/listinfo/masqmail">here</a>.</p>
   1.111 +	    
   1.112 +	    <a name="2_0"><h4>2.0: After starting masmail, I get the following
   1.113 +	      message: "could not gain root privileges. Is the setuid bit set?"</h4></a>
   1.114 +	    
   1.115 +	    <p>Set the set-user-id-bit with chmod u+s /usr/sbin/masqmail.</p>
   1.116 +	    
   1.117 +	    <a name="2_1"><h4>2.1: After starting masmail, I get the following
   1.118 +	      message: "bind: (terminating): Address already in use"</h4></a>
   1.119 +	    
   1.120 +	    <p>This means that there is already a process listening on a port,
   1.121 +	      usually 25. You either have another MTA running in background
   1.122 +	      (sendmail, exim, etc...) or another instance of masqmail.</p>
   1.123 +	    
   1.124 +	    <p>It may also mean that the ports you configured MM to listen to
   1.125 +	      (with 'listen_addresses') are on the same IP address, eg. you may have
   1.126 +	      set your hostname to 127.0.0.1 and try to listen on localhost and your
   1.127 +	      host name. In this case either set your hostname to another IP address
   1.128 +	      or delete one of the conflicting entries.</p>
   1.129 +	    
   1.130 +	    <a name="3_0"><h4>3.0: My friends told me that they do not see my full
   1.131 +	      name in their inbox, although it is configured in my mail
   1.132 +	      client.</h4></a>
   1.133 +	    
   1.134 +	    <p>You probably used the <b>map_h_from_addresses</b> feature in the
   1.135 +	      route configuration and forgot to set your real name. The syntax
   1.136 +	      is:</p>
   1.137 +	    
   1.138 +	    <pre>
   1.139 +map_h_from_addresses = "charlie:Charlie Miller &lt;cmiller@foo.com&gt";
   1.140 +	    </pre>
   1.141 +	    
   1.142 +	    <p>Do not forget the <em>Charlie Miller</em>.</p>
   1.143 +	    
   1.144 +	    <a name="4_0"><h4>4.0: With connection method <em>file</em>, I get the
   1.145 +	      following message in the log file: "Could not open /tmp/connect_route:
   1.146 +	      Permission denied".</h4></a>
   1.147 +	    
   1.148 +	    <p>In your ip-up script, you have to set read permission to the user
   1.149 +	      masqmail runs as. After you write the file with the connection name,
   1.150 +	      set read permission to all with chmod ugo+r <em>file</em>.
   1.151 +	      
   1.152 +	      <a name="4_1"><h4>4.1: With connection methed <em>file</em>, I get the
   1.153 +	      following message in the log file: "route with name <em>name</em> not
   1.154 +	      found.".</h4></a>
   1.155 +	    
   1.156 +	    <p>Check whether the name in the file is really identical to name you
   1.157 +	      gave to the route configuration (case sensitive!). Maybe there is a
   1.158 +	      linefeed after the name in the file. Write it with echo -n.</p>
   1.159 +	    
   1.160 +	    <a name="5_0"><h4>5.0: I found a bug.</h4></a>
   1.161 +	    
   1.162 +	    <p>Make sure you are using the newest version, in case of doubt search
   1.163 +	      it in <a href="http://www.freshmeat.net">freshmeat</a>. If you do, tell
   1.164 +	      <a href = "mailto:Oliver Kurth <kurth@innominate.de>">me</a>. See
   1.165 +	      also the section <a href="index.html#bugs">bugs</a> on the <a
   1.166 +		href="index.html">main</a> page.</p>
   1.167 +	    
   1.168 +	    <a name="5_1"><h4>5.1: I think I found a bug, but I am not sure
   1.169 +	      whether I configured MasqMail incorrectly.</h4></a>
   1.170 +	    
   1.171 +	    <p>Don't care. Tell <a href = "mailto:Oliver Kurth
   1.172 +	      <kurth@innominate.de>">me</a>. Or write to the <a
   1.173 +		href="http://www.innominate.org/mailman/listinfo/masqmail">mailing
   1.174 +		list</a>.</p>
   1.175 +	    
   1.176 +	  </td></tr>
   1.177 +	
   1.178 +	<tr><td>
   1.179 +	    <p>
   1.180 +	    <hr>
   1.181 +	    <address><a href = "mailto:kurth@innominate.de">Oliver Kurth</a></address>
   1.182 +	    Last modified: Tue May 30 15:19:56 CEST 2000
   1.183 +	    <br>
   1.184 +	    This page was created using <a href="http://www.freddyfrog.com/hacks/genpage/">Genpage</a> - Version: 1.0.6
   1.185 +	  </p>
   1.186 +    
   1.187 +      </table>
   1.188 +    </center>
   1.189 +
   1.190 +  </BODY>
   1.191 +</HEAD>
   1.192 +