masqmail
changeset 214:ecd8d737d78e
removed the old manual because it is really outdated now
In masqmail's 0.3 branch, so much changed that the old manual
causes more harm than it improves the distribution.
Most content is covered by the man pages anyway.
You'll still find the old manual on masqmail's homepage.
| author | meillo@marmaro.de |
|---|---|
| date | Mon, 19 Jul 2010 14:06:08 +0200 |
| parents | 3f0b10d41938 |
| children | 08b32edca1d5 |
| files | docs/README docs/old-manual/README docs/old-manual/alias.html docs/old-manual/config.html docs/old-manual/docs/masqmail.8.html docs/old-manual/docs/masqmail.aliases.5.html docs/old-manual/docs/masqmail.conf.5.html docs/old-manual/docs/masqmail.get.5.html docs/old-manual/docs/masqmail.route.5.html docs/old-manual/faq.html docs/old-manual/install.html docs/old-manual/manual.html docs/old-manual/options.html |
| diffstat | 13 files changed, 1 insertions(+), 2653 deletions(-) [+] |
line diff
1.1 --- a/docs/README Sun Jul 18 22:40:09 2010 +0200 1.2 +++ b/docs/README Mon Jul 19 14:06:08 2010 +0200 1.3 @@ -1,9 +1,1 @@ 1.4 -The `old-manual' directory contains the old manual (as expected) and 1.5 -html versions of man pages from that time (May/July 2000). The files 1.6 -have been copied from the old project website. 1.7 - 1.8 -There are installation instructions for various systems available. Some 1.9 -of them are outdated and may not work anymore. 1.10 - 1.11 - 1.12 -meillo 1.13 +Note: Parts of the documentation may be outdated.
2.1 --- a/docs/old-manual/README Sun Jul 18 22:40:09 2010 +0200 2.2 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 2.3 @@ -1,10 +0,0 @@ 2.4 -This is the old manual by oku, dated May/July 2000. At this time the 2.5 -development must just have started with the 0.1 versions. 2.6 - 2.7 -Many things are still the same as then, but there are things that 2.8 -changed. Please keep this in mind when you read the manual. 2.9 - 2.10 -Start reading at manual.html. 2.11 - 2.12 - 2.13 -meillo
3.1 --- a/docs/old-manual/alias.html Sun Jul 18 22:40:09 2010 +0200 3.2 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 3.3 @@ -1,84 +0,0 @@ 3.4 - 3.5 - 3.6 - 3.7 - 3.8 - 3.9 - 3.10 - 3.11 - 3.12 -<HTML> 3.13 -<HEAD> 3.14 -<TITLE>MasqMail - Manual 3.15 -</TITLE> 3.16 -</HEAD> 3.17 - <BODY TEXT="#000000" LINK="#0000ff" BGCOLOR="#ffffff"> 3.18 - 3.19 - <center> 3.20 - <table width="80%"> 3.21 - <tr><td> 3.22 - <table width="100%" bgcolor="#0000aa" cellspacing=0 cellpadding=0> 3.23 -<tr> 3.24 - <td> 3.25 - <a href="manual.html"> 3.26 - <img width="20" src = "../images/u_arrow.gif" alt = "manual"> 3.27 - </a> 3.28 - </td> 3.29 -<td align=center width="100%"><font size="6" color = "#ffffff">Alias Format</font></td> 3.30 -<td> 3.31 - <a href="./options.html"> 3.32 - <img width="20" src = "../images/l_arrow.gif" alt = "Options"> 3.33 - </a> 3.34 -</td> 3.35 -<td> 3.36 - <a href="./config.html"> 3.37 - <img width="20" src = "../images/r_arrow.gif" alt = "Configuration"> 3.38 - </a> 3.39 -</td> 3.40 -</tr> 3.41 -</table> 3.42 - 3.43 - 3.44 -<p>The alias file consists of lines of the form:</p> 3.45 -<pre> 3.46 -local_part: item1, item2, ... 3.47 -</pre> 3.48 - 3.49 -<p>Items can be surrounded by quotes '"'. If within the quotes other 3.50 -quotes are needed for an address they can be escaped with a leading 3.51 -backslash '\'.</p> 3.52 - 3.53 -<p>A leading '\' indicates that this address shall not be further 3.54 -expanded.</p> 3.55 - 3.56 -<p>A leading pipe symbol '|' indicates that the item shall be treated 3.57 -as a pipe command. The content of the message will then be sent to the 3.58 -standard input of a command. The command will run under the user id 3.59 -and group id masqmail is running as. If quotes are needed, the pipe 3.60 -symbol must appear <i>within</i> the quotes.</p> 3.61 - 3.62 -<p>Loops will be detected, the offending address will be ignored.</p> 3.63 - 3.64 -<p>Aliases will be expanded at <i>delivery</i> time. This means that 3.65 -if there is a message still in the queue and you change any alias 3.66 -which matches one of the recipient addresses, the change will have 3.67 -effect next time a delivery is attemped.</p> 3.68 - 3.69 -<p>There is no need to restart masqmail or run any command when the 3.70 -alias file has been changed.</p> 3.71 - </td></tr> 3.72 - 3.73 - <tr><td> 3.74 - <p> 3.75 - <hr> 3.76 - <address><a href = "mailto:kurth@innominate.de">Oliver Kurth</a></address> 3.77 - Last modified: Tue May 30 15:19:57 CEST 2000 3.78 - <br> 3.79 - This page was created using <a href="http://www.freddyfrog.com/hacks/genpage/">Genpage</a> - Version: 1.0.6 3.80 - </p> 3.81 - 3.82 - </table> 3.83 - </center> 3.84 - 3.85 - </BODY> 3.86 -</HEAD> 3.87 -
4.1 --- a/docs/old-manual/config.html Sun Jul 18 22:40:09 2010 +0200 4.2 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 4.3 @@ -1,385 +0,0 @@ 4.4 - 4.5 - 4.6 - 4.7 - 4.8 - 4.9 - 4.10 - 4.11 - 4.12 -<HTML> 4.13 -<HEAD> 4.14 -<TITLE>MasqMail - Manual 4.15 -</TITLE> 4.16 -</HEAD> 4.17 - <BODY TEXT="#000000" LINK="#0000ff" BGCOLOR="#ffffff"> 4.18 - 4.19 - <center> 4.20 - <table width="80%"> 4.21 - <tr><td> 4.22 - <table width="100%" bgcolor="#0000aa" cellspacing=0 cellpadding=0> 4.23 -<tr> 4.24 - <td> 4.25 - <a href="manual.html"> 4.26 - <img width="20" src = "../images/u_arrow.gif" alt = "manual"> 4.27 - </a> 4.28 - </td> 4.29 -<td align=center width="100%"><font size="6" color = "#ffffff">Configuration</font></td> 4.30 -<td> 4.31 - <a href="./alias.html"> 4.32 - <img width="20" src = "../images/l_arrow.gif" alt = "Alias Format"> 4.33 - </a> 4.34 -</td> 4.35 -<td> 4.36 - <a href="./faq.html"> 4.37 - <img width="20" src = "../images/r_arrow.gif" alt = "Frequently Asked Questions"> 4.38 - </a> 4.39 -</td> 4.40 -</tr> 4.41 -</table> 4.42 - 4.43 - 4.44 -<p>The configuration consists of lines of the form</p> 4.45 - 4.46 -<i>val</i> = <i>expression</i> 4.47 - 4.48 -<p>Where <i>val</i> is a variable name and <i>expression</i> a string, 4.49 -which can be quoted with '"'. If the expression is on multiple lines 4.50 -or contains characters other than letters, digits or the charcaters 4.51 -'.', '-', '_', '/', it <em>must</em> be quoted. Unfortunately, you 4.52 -cannot use quotes inside quotes. (Will be implemented in a later 4.53 -version.)</p> 4.54 - 4.55 -<p>Each val has a <i>type</i>, which can be boolean, numeric, string 4.56 -or list. A boolean variable can be set with one of the values 'on', 4.57 -'yes', and 'true' or 'off', 'no' and 'false'. List items are separated 4.58 -with ';'. For some values patterns (like '*','?') can be used. The 4.59 -spaces before and after the '=' are optional.</p> 4.60 - 4.61 -<p>Most lists (exceptions: local_hosts, local_nets and 4.62 -listen_addresses) accept files. These will be recognized by a leading 4.63 -slash '/'. The contents of these files will be included at the 4.64 -position of the file name, there can be items or other files before 4.65 -and after the file entry. The format of the files is different 4.66 -though, within these files each entry is on another line. (And not 4.67 -separated by semicolons). This makes it easy to include large lists 4.68 -which are common in different configuration files, so they do not have 4.69 -to appear in every configuration file.</p> 4.70 - 4.71 -<p>Blank lines and lines starting with '#' are ignored.</p> 4.72 - 4.73 -<h4><font color = "#ff0000">Main Configuration</font></h4> 4.74 - 4.75 -<b>run_as_user</b>, Type: <i>boolean</i>, default: <i>false</i> 4.76 - 4.77 -<p>If this is set, masqmail runs with the user id of the user who 4.78 -invoked it and never changes it. This is for debugging purposes 4.79 -<em>only</em>. If the user is not root, masqmail will not be able to 4.80 -listen on a port < 1000 and will not be able to deliver local mail 4.81 -to others than the user.</p> 4.82 - 4.83 -<b>use_syslog</b>, Type: <i>boolean</i>, default: <i>false</i> 4.84 - 4.85 -<p>If this is set, masqmail uses syslogd for logging. It uses facility 4.86 -<i>MAIL</i>. You still have to set <b>log_dir</b> for debug files.</p> 4.87 - 4.88 -<b>debug_level</b>, Type: <i>numeric</i>, default: <i>0</i> 4.89 - 4.90 -<p>Set the debug level. Valid values are 0 to 6, increasing it further 4.91 -makes no difference. Be careful if you set this as high as 5 or higher, 4.92 -the logs may very soon fill your hard drive.</p> 4.93 - 4.94 -<b>mail_dir</b>, Type: <i>string</i>, default: <i>none</i> 4.95 - 4.96 -<p>The directory where local mail is stored, usually /var/spool/mail.</p> 4.97 - 4.98 -<b>spool_dir</b>, Type: <i>string</i>, default: <i>none</i> 4.99 - 4.100 -<p>The directory where masqmail stores its spool files (and later also 4.101 -other stuff). It <em>must</em> have a subdirectory 4.102 -<i>input</i>. Masqmail needs read and write permissions for this 4.103 -directory. I suggest to use /var/spool/masqmail.</p> 4.104 - 4.105 -<b>log_dir</b>, Type: <i>string</i>, default: <i>none</i> 4.106 - 4.107 -<p>The directory where masqmail puts its log files, these are 4.108 -<i>masqmail.log</i> and <i>debug.log</i>. Masqmail needs write 4.109 -permission.</p> 4.110 - 4.111 -<b>host_name</b>, Type: <i>string</i>, default: <i>none</i> 4.112 - 4.113 -<p>This is used in different places: Masqmail identifies itself in the 4.114 -greeting banner on incoming connections and in the HELO/EHLO command 4.115 -for outgoing connections with this name, it is used in the Received: 4.116 -header and to qualify the sender of a locally originating message.</p> 4.117 - 4.118 -<p>It is <em>not</em> used to find whether an address is local. Use 4.119 -<b>local_hosts</b> for that.</p> 4.120 - 4.121 -<b>local_hosts</b>, Type: <i>list</i>, default: <i>none</i> 4.122 - 4.123 -<p>A semicolon ';' separated list of hostnames which are considered 4.124 -local. Normally you set it to "localhost;foo;foo.bar.com" if your host 4.125 -has the fully qualified domain name 'foo.bar.com'.</p> 4.126 - 4.127 -<b>local_nets</b>, Type: <i>list</i>, default: <i>none</i> 4.128 - 4.129 -<p>A semicolon ';' separated list of hostnames which are on the 4.130 -'local' net. Delivery to these hosts is attempted immediately. You can 4.131 -use patterns with '*', eg. "*.bar.com".</p> 4.132 - 4.133 -<b>listen_addresses</b>, Type: <i>list</i>, default: <i>none</i> 4.134 - 4.135 -<p>A semicolon ';' separated list of interfaces on which connections 4.136 -will be accepted. An interface ist defined by a hostname, optionally 4.137 -followed by a colon ':' and a number for the port. If this is left out, 4.138 -port 25 will be used.</p> 4.139 - 4.140 -<p>You can set this to "localhost:25;foo:25" if your hostname is 'foo'.</p> 4.141 - 4.142 -<b>do_queue</b>, Type: <i>boolean</i>, default: <i>false</i> 4.143 - 4.144 -<p>If this is set, mail will not be delivered immediately when 4.145 -accepted. Same as calling masqmail with the -odq option.</p> 4.146 - 4.147 -<b>connect_route.<name></b>, Type: <i>string</i>, default: <i>none</i> 4.148 - 4.149 -<p>Replace <name> with a name to identify a connection. Set this 4.150 -to a filename for the special <i>route</i> configuration for that 4.151 -connection. You will use that name to call masqmail with the -qo option 4.152 -every time a connection to your ISP is set up.</p> 4.153 - 4.154 -<p>Example: Your ISP has the name <i>FastNet</i>. Then you write the 4.155 -following line in the main configuration:</p> 4.156 - 4.157 -<p><pre>connect_route.FastNet = "/etc/masqmail/fastnet.route"</pre></p> 4.158 - 4.159 -<p>/etc/masqmail/fastnet.route is the route configuration file, see 4.160 -below. As soon as a link to FastNet has been set up, you call masqmail 4.161 --qoFastNet. Masqmail will then read the specified file and send the 4.162 -mails.</p> 4.163 - 4.164 -<b>local_net_route</b>, Type: <i>string</i>, default: <i>none</i> 4.165 - 4.166 -<p>This is similar to <b>connect_route.<name></b> but for the 4.167 -local net. Recipient addresses that are in <b>local_nets</b> will be 4.168 -routed using this route configuration. Main purpose is to define a 4.169 -mail server with <b>mail_host</b> in your local network. In simple 4.170 -environments this can be left unset. If unset, a default route 4.171 -configuration will be used.</p> 4.172 - 4.173 -<b>alias_file</b> 4.174 - 4.175 -<p>Set this to the location of your alias file. If unset, no aliasing 4.176 -will be done.</p> 4.177 - 4.178 -<b>online_detect</b>, Type: <i>string</i>, default: <i>none</i> 4.179 - 4.180 -<p>Defines the method MasqMail uses to detect whether there is 4.181 -currently an online connection. It can have the values <em>file</em> 4.182 -or <em>mserver</em>.</p> 4.183 - 4.184 -<p>When it is set to <em>file</em>, MasqMail first checks for the 4.185 -existence of <b>online_file</b> (see below) and if it exists, it reads 4.186 -it. The content of the file should be the name of the current 4.187 -connection as defined with <b>connect_route.<name></b> (without 4.188 -a trailing newline character).</p> 4.189 - 4.190 -<p>When it is set to <em>mserver</em>, MasqMail connects to the 4.191 -masqdialer server using the value of <b>mserver_iface</b> and asks it 4.192 -whether a connection exists and for the name, which should be the name 4.193 -of the current connection as defined with 4.194 -<b>connect_route.<name></b>.</p> 4.195 - 4.196 -<p>The online status is checked either when masqmail receives a mail 4.197 -with an address outside your LAN or when called with the -qo option 4.198 -(without arguments).</p> 4.199 - 4.200 -<b>online_file</b>, Type: <i>string</i>, default: <i>none</i> 4.201 - 4.202 -<p>This is the name of the file checked for when MasqMail determines 4.203 -whether it is online. The file should only exist when there is 4.204 -currently a connection. Create it in your ip-up script with eg.</p> 4.205 - 4.206 -<p><pre> 4.207 -echo -n <name> > /tmp/connect_route 4.208 -chmod 0644 /tmp/connect_route 4.209 -</pre></p> 4.210 - 4.211 -<p>Do not forget to delete it in your ip-down script.</p> 4.212 - 4.213 -<b>mserver_iface</b>, Type: <i>string</i>, default: <i>none</i> 4.214 - 4.215 -<p>The interface the masqdialer server is listening to. Usually this 4.216 -will be "localhost:224" if mserver is running on the same host as 4.217 -masqmail. But using this option, you can also let masqmail run on 4.218 -another host by setting mserver_iface to another hostname, 4.219 -eg. "foo:224".</p> 4.220 - 4.221 -<b>get.<name></b>, Type: <i>string</i>, default: <i>none</i> 4.222 - 4.223 -<p>Replace <name> with a name to identify a <i>get</i> 4.224 -configuration. Set this to a filename for the <i>get</i> 4.225 -configuration. These files will be used to retrieve mail when called 4.226 -with the -g option.</p> 4.227 - 4.228 -<h4><font color = "#ff0000">Route Configuration</font></h4> 4.229 - 4.230 -<b>mail_host</b>, Type: <i>string</i>, default: <i>none</i> 4.231 - 4.232 -<p>This is preferably the mail server of your ISP. All outgoing 4.233 -messages will be sent to this host which will distribute them to their 4.234 -destinations. If you do not set this mails will be sent 4.235 -directly. Because the mail server is probably 'near' to you, mail 4.236 -transfer will be much faster if you use it.</p> 4.237 - 4.238 -<b>do_correct_helo</b>, Type: <i>boolean</i>, default: <i>false</i> 4.239 - 4.240 -<p>If this is set, masqmail tries to look up your host name as it 4.241 -appears on the internet and sends this in the HELO/EHLO command. Some 4.242 -servers are so picky that they want this. <em>Which is really 4.243 -crazy. It just does not make any sense to lie about ones own identity, 4.244 -because it can always be looked up by the server. Nobody should 4.245 -believe in the name given by HELO/EHLO anyway.</em> If this is not 4.246 -set, <b>host_name</b> will be used.</p> 4.247 - 4.248 -<b>allowed_mail_locals</b>, Type: <i>list</i>, default: <i>none(all)</i> 4.249 - 4.250 -<p>This is a semicolon ';' separated list of local parts which will be 4.251 -allowed to send mail through this connection. If unset and 4.252 -<b>not_allowed_mail_locals</b> is also unset, all users are 4.253 -allowed.</p> 4.254 - 4.255 -<b>not_allowed_mail_locals</b>, Type: <i>list</i>, default: <i>none</i> 4.256 - 4.257 -<p>This is a semicolon ';' separated list of local parts which will be 4.258 -<em>not</em> allowed to send mail through this connection. <em>Local 4.259 -parts in this list will not be allowed to use this route even if they 4.260 -are part of <b>allowed_mail_locals</b> (see above).</em></p> 4.261 - 4.262 -<b>allowed_rcpt_domains</b>, Type: <i>list</i>, default: <i>none(all)</i> 4.263 - 4.264 -<p>A list of recipient domains where mail will be sent to. This is for 4.265 -example useful if you use this route configuration when connected to 4.266 -another LAN via ppp. Patterns containing '?' and '*' can be used.</p> 4.267 - 4.268 -<b>not_allowed_rcpt_domains</b>, Type: <i>list</i>, default: <i>none</i> 4.269 - 4.270 -<p>A list of recipient domains where mail will <em>not</em> be sent 4.271 -to. This is for example useful if you send mail directly (mail_host 4.272 -ist not set) and you know of hosts that will not accept mail from you 4.273 -because they use a dialup list (eg. <a 4.274 -href="http://maps.vix.com/dul/"> maps.vix.com/dul/</a>). If any domain 4.275 -matches <em>both</em> <b>allowed_rcpt_domains</b> and 4.276 -<b>not_allowed_rcpt_domains</b>, mail will <em>not</em> be sent to 4.277 -this domain. Patterns containing '?' and '*' can be used.</p> 4.278 - 4.279 -<b>set_h_from_domain</b>, Type: <i>string</i>, default: <i>none</i> 4.280 - 4.281 -<p>Replace the domain part in 'From:' headers with this value. This 4.282 -may be useful if you use a private, outside unknown address on your 4.283 -local LAN and want this to be replaced by the domain of the address of 4.284 -your email addrsss on the internet. <em>Note that this is different to 4.285 -<b>set_return_path_domain</b>, see below.</em></p> 4.286 - 4.287 -<b>set_h_reply_to_domain</b>, Type: <i>string</i>, default: <i>none</i> 4.288 - 4.289 -<p>Same as <b>set_h_from_domain</b>, but for the 'Reply-To' header.</p> 4.290 - 4.291 -<b>set_return_path_domain</b>, Type: <i>string</i>, default: <i>none</i> 4.292 - 4.293 -<p>Sets the domain part of the envelope from address. Some hosts check 4.294 -whether this is the same as the net the connection is coming from. If 4.295 -not, they reject the mail because they suspect spamming. It should be 4.296 -a <em>valid</em> address, because some mail servers also check 4.297 -that. You can also use this to set it to your usual address on the 4.298 -internet and put a local address only known on your LAN in the 4.299 -configuration of your mailer. <em>Only the <em>domain</em> part will 4.300 -be changed, the local part remains unchanged. Use 4.301 -<b>map_return_path_addresses</b> for rewriting local parts</em>.</p> 4.302 - 4.303 -<b>map_h_from_addresses</b>, Type: <i>list</i>, default: <i>none</i> 4.304 - 4.305 -<p>This is similar to <b>set_h_from_domain</b>, but more flexible. Set 4.306 -this to a list which maps local parts to a full RFC 822 compliant 4.307 -email address, the local parts (the <em>keys</em>) are separated from 4.308 -the addresses (the <em>values</em>) by colons (':').</p> 4.309 - 4.310 -<p>Example:</p> 4.311 - 4.312 -<p><pre> 4.313 -map_h_from_addresses = 4.314 -"john: John Smith <jsmith@mail.academic.edu>; 4.315 -charlie: Charlie Miller <cmiller@mx.commercial.com>" 4.316 -</pre></p> 4.317 - 4.318 -<b>map_h_reply_to_addresses</b>, Type: <i>list</i>, default: <i>none</i> 4.319 - 4.320 -<p>Same as <b>map_h_from_addresses</b>, but for the 'Reply-To:' header.</p> 4.321 - 4.322 -<b>map_return_path_addresses</b>, Type: <i>list</i>, default: <i>none</i> 4.323 - 4.324 -<p>This is similar to <b>set_return_path_domain</b>, but more 4.325 -flexible. Set this to a list which maps local parts to a full RFC 821 4.326 -compliant email address, the local parts (the <em>keys</em>) are 4.327 -separated from the addresses (the <em>values</em>) by colons 4.328 -(':'). Note that this option takes <em>RFC 821</em> addresses 4.329 -while <b>map_h_from_addresses</b> takes <em>RFC 822</em> addresses. The 4.330 -most important difference is that RFC 821 addresses have no full 4.331 -name.</p> 4.332 - 4.333 -<p>Example:</p> 4.334 -<p><pre> 4.335 -map_return_path_addresses = 4.336 -"john: <jsmith@mail.academic.edu>; 4.337 -charlie: <cmiller@mx.commercial.com>" 4.338 -</pre></p> 4.339 - 4.340 -<b>expand_h_sender_domain</b>, Type: <i>boolean</i>, default: <i>true</i> 4.341 - 4.342 -<p>This sets the domain of the sender address as given by the Sender: 4.343 -header to the same domain as in the envelope return path address 4.344 -(which can be set by either <b>set_return_path_domain</b> or 4.345 -<b>map_return_path_addresses</b>). This is for mail clients 4.346 -(eg. Microsoft Outlook) which use this address as the sender 4.347 -address. <em>Though they should use the From: address, see RFC 4.348 -821. </em>If <i>fetchmail</i> encounters an unqualified Sender: 4.349 -address, it will be expanded to the domain of the pop server, which is 4.350 -almost never correct. </p> 4.351 - 4.352 -<b>auth_name</b>, Type: <i>string</i>, default: <i>none</i> 4.353 - 4.354 -<p>Set the authentication type for ESMTP AUTH authentification. 4.355 -Currently only 'cram-md5' is supported.</p> 4.356 - 4.357 -<b>auth_login</b>, Type: <i>string</i>, default: <i>none</i> 4.358 - 4.359 -<p>Your account name for ESMTP AUTH authentification.</p> 4.360 - 4.361 -<b>auth_secret</b>, Type: <i>string</i>, default: <i>none</i> 4.362 - 4.363 -<p>Your secret for ESMTP AUTH authentification.</p> 4.364 - 4.365 -<b>pop_login</b>, Type: <i>string</i>, default: <i>none</i> 4.366 - 4.367 -<p>If your Mail server requires SMTP-after-POP, set this to a 4.368 -<i>get</i> configuration. If you login to the POP server 4.369 -<em>before</em> you send, this is not necessary. See the <a href = 4.370 -"get.html"</a>get configuration</a> for more information.</p> 4.371 - 4.372 - </td></tr> 4.373 - 4.374 - <tr><td> 4.375 - <p> 4.376 - <hr> 4.377 - <address><a href = "mailto:kurth@innominate.de">Oliver Kurth</a></address> 4.378 - Last modified: Tue May 30 15:19:56 CEST 2000 4.379 - <br> 4.380 - This page was created using <a href="http://www.freddyfrog.com/hacks/genpage/">Genpage</a> - Version: 1.0.6 4.381 - </p> 4.382 - 4.383 - </table> 4.384 - </center> 4.385 - 4.386 - </BODY> 4.387 -</HEAD> 4.388 -
5.1 --- a/docs/old-manual/docs/masqmail.8.html Sun Jul 18 22:40:09 2010 +0200 5.2 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 5.3 @@ -1,327 +0,0 @@ 5.4 -<body text="#000000" link="#0000ff" bgcolor="#ffffff"><center><table width="80%"> 5.5 -<tr><td><h1>masqmail</h1> 5.6 -<h2>An offline Mail Transfer Agent</h2> 5.7 - 5.8 - 5.9 -<h2>Synopsis</h2> 5.10 -<b> 5.11 -/usr/sbin/masqmail [-C <em>file</em>] [-odq] [-bd] [-q<em>interval</em>]<br> 5.12 - 5.13 -/usr/sbin/masqmail [-odq] [-bs]<br> 5.14 - 5.15 -/usr/sbin/masqmail [-bp]<br> 5.16 - 5.17 -/usr/sbin/masqmail [-q]<br> 5.18 - 5.19 -/usr/sbin/masqmail [-qo [<em>name</em>]]<br> 5.20 - 5.21 -/usr/sbin/masqmail [-odq] [-g [<em>name</em>]]<br> 5.22 - 5.23 -/usr/sbin/masqmail [-odq] [-go [<em>name</em>]]<br> 5.24 - 5.25 -/usr/sbin/masqmail [-t] [-oi] [-f <em>address</em>] [--] <em>address...</em><br> 5.26 - 5.27 -/usr/sbin/mailq<br> 5.28 - 5.29 -</b> 5.30 - 5.31 - 5.32 -<h2>Description</h2> 5.33 - 5.34 -<p>MasqMail is a mail server designed for hosts that do 5.35 -not have a permanent internet connection eg. a home network or a 5.36 -single host at home. It has special support for connections to 5.37 -different ISPs. It replaces sendmail or other MTAs such as qmail or 5.38 -exim. It can also act as a pop3 client.</p> 5.39 - 5.40 - 5.41 - 5.42 -<h2>Options</h2> 5.43 - 5.44 -<p>Since masqmail is intended to replace sendmail, it uses the same 5.45 -command line options, but not all are implemented. There are also two 5.46 -additional options, which are unique to masqmail (-qo <em>connection</em> and -g) 5.47 -</p> 5.48 - 5.49 - 5.50 -<p><b>--</b></p> 5.51 -<p>Not a 'real' option, it means that all following arguments are to 5.52 -be understood as arguments and not as options even if they begin with a 5.53 -leading dash '-'. Mutt is known to call sendmail with this option.</p> 5.54 - 5.55 - 5.56 - 5.57 -<p><b>-bd</b></p> 5.58 -<p>Run as daemon, accepting connections, usually on port 25 if not 5.59 -configured differently. This is usually used in the startup script at system boot and 5.60 -together with the -q option (see below).</p> 5.61 - 5.62 - 5.63 - 5.64 -<p><b>-bi</b></p> 5.65 -<p>Old sendmail rebuilds its alias database when invoked with this 5.66 -option. Masqmail ignores it. Masqmail reads directly from the file 5.67 -given with alias_file in the config file.</p> 5.68 - 5.69 - 5.70 - 5.71 -<p><b>-bp</b></p> 5.72 -<p>Show the messages in the queue. Same as calling masqmail as 5.73 -'mailq'.</p> 5.74 - 5.75 - 5.76 - 5.77 -<p><b>-bs</b></p> 5.78 -<p>Accept SMTP commands from stdin. Some mailers (eg pine) use this 5.79 -option as an interface. It can also be used to call masqmail from 5.80 -inetd.</p> 5.81 - 5.82 - 5.83 - 5.84 -<p><b>-B <em>arg</em></b></p> 5.85 -<p><em>arg</em> is usually 8BITMIME. Some mailers use this 5.86 -to indicate that the message contains characters > 127. Masqmail is 5.87 -8-bit clean and ignores this, so you do not have to recompile elm, 5.88 -which is very painful ;-). Note though that this violates some 5.89 -conventions: masqmail does not convert 8 bit messages to any 5.90 -MIME format if it encounters a mail server which does not advertise 5.91 -its 8BITMIME capability, masqmail does not advertise this itself. This 5.92 -is the same practice as that of exim (but different to 5.93 -sendmail).</p> 5.94 - 5.95 - 5.96 -<p><b>-bV </b></p> 5.97 -<p>Show version information.</p> 5.98 - 5.99 - 5.100 - 5.101 - 5.102 -<p><b>-C </b><em>filename</em></p> 5.103 -<p>Use another configuration than <em>/etc/masqmail/masqmail.conf</em>. Useful for 5.104 -debugging purposes. If not invoked by a privileged user, masqmail will drop all privileges. 5.105 -</p> 5.106 - 5.107 - 5.108 - 5.109 -<p><b>-d <em>number</em></b></p> 5.110 - 5.111 -<p>Set the debug level. This takes precedence before the value of 5.112 -debug_level in the configuration file. Read the warning in the 5.113 -description of the latter. 5.114 -</p> 5.115 - 5.116 - 5.117 - 5.118 - 5.119 -<p><b>-f [<em>address</em>]</b></p> 5.120 - 5.121 -<p>Set the return path address to <em>address</em>. Only root, the 5.122 -user mail and anyoune in group trusted is allowed to do that.</p> 5.123 - 5.124 - 5.125 - 5.126 - 5.127 -<p><b>-F [<em>string</em>]</b></p> 5.128 - 5.129 -<p>Set the full sender name (in the From: header) 5.130 -to <em>string</em>.</p> 5.131 - 5.132 - 5.133 - 5.134 - 5.135 -<p><b>-g [<em>name</em>]</b></p> 5.136 - 5.137 -<p>Get mail (using pop3 or apop), using the configurations given 5.138 -with get.<em>name</em> in the main configuration. Without <em>name</em>, 5.139 -all get configurations will be used. See also <a href="masqmail.get.5.html">masqmail.get</a></p> 5.140 - 5.141 - 5.142 - 5.143 - 5.144 -<p><b>-go [<em>interval</em>] [<em>name</em>]</b></p> 5.145 - 5.146 -<p>Can be followed by a connection name. Use this option in your 5.147 -script which starts as soon as a link to the internet has been set up 5.148 -(usually ip-up). When masqmail is called with this option, the 5.149 -specified get configuration(s) is(are) read and mail will be 5.150 -retrieved from servers on the internet. 5.151 -The <em>name</em> is defined 5.152 -in the configuration (see <b>online_gets.<em>name</em></b>). 5.153 -</p><p> 5.154 -If called with an interval option (recognized by a digit 5.155 -as the first characater), masqmail starts as a daemon and tries to 5.156 -get mail in these intervals. It checks for the online status first. 5.157 -Example: masqmail -go 5m will retrieve mail 5.158 -all five minutes. 5.159 -</p><p> 5.160 -If called without <em>name</em> the online status is determined with 5.161 -the configured method (see <b>online_detect</b> in config.html). 5.162 -</p> 5.163 - 5.164 - 5.165 - 5.166 - 5.167 -<p><b>-i</b></p> 5.168 -<p>Same as -oi, see below.</p> 5.169 - 5.170 - 5.171 - 5.172 -<p><b>-Mrm <em>list</em></b></p> 5.173 -<p>Remove given messages from the queue. Only allowed for privileged users.</p> 5.174 - 5.175 - 5.176 - 5.177 -<p><b>-oem</b></p> 5.178 -<p>If the -oi ist not also given, always return with a non zero 5.179 -return code. Maybe someone tells me what this is good for...</p> 5.180 - 5.181 - 5.182 - 5.183 -<p><b>-odb</b></p> 5.184 -<p>Deliver in background. Masqmail always does this, which 5.185 -makes this option pretty much useless.</p> 5.186 - 5.187 - 5.188 - 5.189 -<p><b>-odq</b></p> 5.190 -<p>Do not attempt to deliver immediately. Any messages will be queued 5.191 -until the next queue running process picks them up and delivers 5.192 -them. You get the same effect by setting the do_queue option in 5.193 -/etc/masqmail/masqmail.conf.</p> 5.194 - 5.195 - 5.196 - 5.197 -<p><b>-oi</b></p> 5.198 -<p>A dot as a single character in a line does not terminate 5.199 -the message.</p> 5.200 - 5.201 - 5.202 - 5.203 -<p><b>-q [<em>interval</em>]</b></p> 5.204 -<p>If not given with an argument, run a queue process, ie. try to 5.205 -deliver all messages in the queue. Masqmail sends only to those 5.206 -addresses that are on the local net, not to those that are 5.207 -outside. Use -qo for those.</p> 5.208 -<p> 5.209 -If you have configured inetd to start masqmail, you can use this 5.210 -option in a cron job which starts in regular time intervals, to mimic 5.211 -the same effect as starting masqmail with -bd -q30m. 5.212 -</p><p> 5.213 -An argument may be a time interval ie. a numerical value followed 5.214 -by one of the letters. s,m,h,d,w which are interpreted as seconds, 5.215 -minutes, hours, days or weeks respectively. Example: -q30m. Masqmail 5.216 -starts as a daemon and a queue runner process will be started 5.217 -automatically once in this time interval. This is usually used 5.218 -together with -bd (see above). 5.219 -</p> 5.220 - 5.221 - 5.222 - 5.223 - 5.224 -<p><b>-qo [<em>name</em>]</b></p> 5.225 - 5.226 -<p>Can be followed by a connection name. Use this option in your 5.227 -script which starts as soon as a link to the internet has been set up 5.228 -(usually ip-up). When masqmail is called with this option, the 5.229 -specified route configuration is read and the queued mail with 5.230 -destinations on the internet will be sent. The <em>name</em> is defined 5.231 -in the configuration (see <b>online_routes.<em>name</em></b>). 5.232 -</p><p> 5.233 -If called without <em>name</em> the online status is determined with 5.234 -the configured method (see <b>online_detect</b> in config.html) 5.235 -</p> 5.236 - 5.237 - 5.238 - 5.239 - 5.240 -<p><b>-t</b></p> 5.241 -<p>Read recipients from headers. Delete 'Bcc:' headers. If any 5.242 -arguments are given, these are interpreted as recipient addresses and 5.243 -the message will not be sent to these.</p> 5.244 - 5.245 - 5.246 - 5.247 -<p><b>-v</b></p> 5.248 -<p>Log also to stdout. Currently, some log messages are 5.249 -marked as 'write to stdout' and additionally, all messages with 5.250 -priority 'LOG_ALERT' and 'LOG_WARNING' will be written to stdout 5.251 -if this option is given. It is disabled in daemon mode. 5.252 -</p> 5.253 - 5.254 - 5.255 - 5.256 - 5.257 -<h2>Environment for pipes and mdas</h2> 5.258 - 5.259 - 5.260 -<p>For security reasons, before any pipe command from an alias 5.261 -expansion or an mda is called, the environment variables will be 5.262 -completely discarded and newly set up. These are:</p> 5.263 -<p>SENDER, RETURN_PATH - the return path.</p> 5.264 -<p>SENDER_DOMAIN - the domain part of the return path.</p> 5.265 -<p>SENDER_LOCAL - the local part of the return path.</p> 5.266 -<p>RECEIVED_HOST - the host the message was received from (unless local).</p> 5.267 -<p>LOCAL_PART, USER, LOGNAME - the local part of the (original) recipient.</p> 5.268 -<p>MESSAGE_ID - the unique message id. This is not necessarily identical with the Message ID as given in the Message ID: header.</p> 5.269 -<p>QUALIFY_DOMAIN - the domain which will be appended to unqualified addresses.</p> 5.270 - 5.271 - 5.272 - 5.273 - 5.274 -<h2>Files</h2> 5.275 - 5.276 -<p><em>/etc/masqmail/masqmail.conf</em> is the main configuration 5.277 -for masqmail. Depending on the settings in this file, you will also 5.278 -have other configuration files in <em>/etc/masqmail/</em>.</p> 5.279 -<p><em>/etc/aliases</em> is the alias file, if not set differently 5.280 -in <em>/etc/masqmail/masqmail.conf</em>.</p> 5.281 -<p><em>/var/spool/masqmail/</em> is the spool directory where masqmail 5.282 -stores its spooled messages and the uniq pop ids.</p> 5.283 -<p><em>/var/spool/mail/</em> is the directory where locally delivered mail will be put, if not configured differently in <em>masqmail.conf</em>.</p> 5.284 -<p><em>/var/log/masqmail/</em> is the directory where masqmail stores 5.285 -its log mesages. This can also be somewhere else if configured 5.286 -differently by your sysadmin or the package mantainer.</p> 5.287 - 5.288 - 5.289 - 5.290 -<h2>Conforming to</h2> 5.291 - 5.292 -<p>RFC 821, 822, 1869, 1870, 2197, 2554 (SMTP)</p> 5.293 -<p>RFC 1725, 1939 (POP3)</p> 5.294 -<p>RFC 1321 (MD5)</p> 5.295 -<p>RFC 2195 (CRAM-MD5)</p> 5.296 - 5.297 - 5.298 - 5.299 -<h2>Author</h2> 5.300 - 5.301 -<p>masqmail was written by Oliver Kurth 5.302 -<oku@masqmail.cx></p><p>You will find the newest version of 5.303 -masqmail at <a href = "http://masqmail.cx/masqmail/">http://masqmail.cx/masqmail/</a> or search for it 5.304 -in freshmeat (<a href = "http://www.freshmeat.net">http://www.freshmeat.net</a>). There is also a mailing list, 5.305 -you will find information about it at masqmails main site.</p> 5.306 - 5.307 - 5.308 - 5.309 -<h2>Bugs</h2> 5.310 - 5.311 -<p>You should report them to the mailing list.</p> 5.312 - 5.313 - 5.314 - 5.315 -<h2>See also</h2> 5.316 - 5.317 -<p> 5.318 -<a href="masqmail.conf.5.html">masqmail.conf</a>, <a href="masqmail.route.5.html">masqmail.route</a>, <a href="masqmail.get.5.html">masqmail.get</a>, <a href="masqmail.aliases.5.html">masqmail.aliases</a> 5.319 -</p> 5.320 - 5.321 - 5.322 - 5.323 -<h2>Comments</h2> 5.324 - 5.325 -<p>This man page was written using <a href="http://masqmail.cx/xml2man/">xml2man</a> by the same author.</p> 5.326 - 5.327 - 5.328 - 5.329 -</td></tr></table></center> 5.330 -</body>
6.1 --- a/docs/old-manual/docs/masqmail.aliases.5.html Sun Jul 18 22:40:09 2010 +0200 6.2 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 6.3 @@ -1,75 +0,0 @@ 6.4 -<body text="#000000" link="#0000ff" bgcolor="#ffffff"><center><table width="80%"> 6.5 -<tr><td><h1>masqmail.aliases</h1> 6.6 -<h2>masqmail alias file format</h2> 6.7 - 6.8 - 6.9 -<h2>Description</h2> 6.10 - 6.11 -<p>This man page describes the format of the masqmail alias file. Its usual location is <em>/etc/aliases</em>.</p> 6.12 - 6.13 - 6.14 - 6.15 -<h2>File Format</h2> 6.16 - 6.17 -<p>The alias file consists of lines of the form:</p> 6.18 - 6.19 -local_part: item1, item2, ... 6.20 - 6.21 - 6.22 -<p>Items can be surrounded by quotes '"'. If within the quotes other 6.23 -quotes are needed for an address they can be escaped with a leading 6.24 -backslash '\'.</p> 6.25 - 6.26 -<p>A leading '\' indicates that this address shall not be further 6.27 -expanded.</p> 6.28 - 6.29 -<p>A leading pipe symbol '|' indicates that the item shall be treated 6.30 -as a pipe command. The content of the message will then be sent to the 6.31 -standard input of a command. The command will run under the user id 6.32 -and group id masqmail is running as. If quotes are needed, the pipe 6.33 -symbol must appear within the quotes.</p> 6.34 - 6.35 -<p>Loops will be detected, the offending address will be ignored.</p> 6.36 - 6.37 -<p>Aliases will be expanded at delivery time. This means that 6.38 -if there is a message still in the queue and you change any alias 6.39 -which matches one of the recipient addresses, the change will have 6.40 -effect next time a delivery is attemped.</p> 6.41 - 6.42 -<p>There is no need to restart masqmail or run any command when the 6.43 -alias file has been changed.</p> 6.44 - 6.45 - 6.46 - 6.47 -<h2>Author</h2> 6.48 - 6.49 -<p>masqmail was written by Oliver Kurth 6.50 -<oku@masqmail.cx></p><p>You will find the newest version of 6.51 -masqmail at <a href = "http://masqmail.cx/masqmail/">http://masqmail.cx/masqmail/</a> or search for it 6.52 -in freshmeat (<a href = "http://www.freshmeat.net">http://www.freshmeat.net</a>). There is also a mailing list, 6.53 -you will find information about it at masqmails main site.</p> 6.54 - 6.55 - 6.56 - 6.57 -<h2>Bugs</h2> 6.58 - 6.59 -<p>You should report them to the mailing list.</p> 6.60 - 6.61 - 6.62 - 6.63 -<h2>See also</h2> 6.64 - 6.65 -<p> 6.66 -<a href="masqmail.conf.5.html">masqmail.conf</a>, <a href="masqmail.8.html">masqmail</a>, 6.67 -</p> 6.68 - 6.69 - 6.70 - 6.71 -<h2>Comments</h2> 6.72 - 6.73 -<p>This man page was written using <a href="http://masqmail.cx/xml2man/">xml2man</a> by the same author.</p> 6.74 - 6.75 - 6.76 - 6.77 -</td></tr></table></center> 6.78 -</body>
7.1 --- a/docs/old-manual/docs/masqmail.conf.5.html Sun Jul 18 22:40:09 2010 +0200 7.2 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 7.3 @@ -1,569 +0,0 @@ 7.4 -<body text="#000000" link="#0000ff" bgcolor="#ffffff"><center><table width="80%"> 7.5 -<tr><td><h1>masqmail.conf</h1> 7.6 -<h2>masqmail configuration file</h2> 7.7 - 7.8 - 7.9 -<h2>Description</h2> 7.10 - 7.11 -<p>This man page describes the syntax of the main configuration file 7.12 -of masqmail. Its usual location is <em>/etc/masqmail/masqmail.conf</em></p> 7.13 - 7.14 -<p>The configuration consists of lines of the form</p> 7.15 - 7.16 -<p><b>val</b> = <em>expression</em></p> 7.17 - 7.18 -<p>Where <b>val</b> is a variable name and <em>expression</em> a string, 7.19 -which can be quoted with '"'. If the expression is on multiple lines 7.20 -or contains characters other than letters, digits or the characters 7.21 -'.', '-', '_', '/', it must be quoted. You can use quotes inside quotes 7.22 -by escaping them with a backslash.</p> 7.23 - 7.24 -<p>Each val has a type, which can be boolean, numeric, string 7.25 -or list. A boolean variable can be set with one of the values 'on', 7.26 -'yes', and 'true' or 'off', 'no' and 'false'. List items are separated 7.27 -with ';'. For some values patterns (like '*','?') can be used. The 7.28 -spaces before and after the '=' are optional.</p> 7.29 - 7.30 -<p>Most lists (exceptions: <b>local_hosts</b>, 7.31 -<b>local_nets</b>, <b>listen_addresses</b>, <b>online_routes</b> and <b>online_gets</b>) accept 7.32 -files. These will be recognized by a leading slash '/'. The contents 7.33 -of these files will be included at the position of the file name, 7.34 -there can be items or other files before and after the file entry. The 7.35 -format of the files is different though, within these files each entry 7.36 -is on another line. (And not separated by semicolons). This makes it 7.37 -easy to include large lists which are common in different 7.38 -configuration files, so they do not have to appear in every 7.39 -configuration file.</p> 7.40 - 7.41 -<p>Blank lines and lines starting with '#' are ignored.</p> 7.42 - 7.43 - 7.44 - 7.45 - 7.46 -<h2>Options</h2> 7.47 - 7.48 - 7.49 -<p><b>run_as_user = <em>boolean</em></b></p> 7.50 - 7.51 -<p>If this is set, masqmail runs with the user id of the user who 7.52 -invoked it and never changes it. This is for debugging purposes 7.53 -only. If the user is not root, masqmail will not be able to 7.54 -listen on a port < 1024 and will not be able to deliver local mail 7.55 -to others than the user.</p> 7.56 - 7.57 - 7.58 - 7.59 - 7.60 -<p><b>use_syslog = <em>boolean</em></b></p> 7.61 - 7.62 -<p>If this is set, masqmail uses syslogd for logging. It uses facility 7.63 -MAIL. You still have to set <b>log_dir</b> for debug files.</p> 7.64 - 7.65 - 7.66 - 7.67 - 7.68 -<p><b>debug_level = <em>n</em></b></p> 7.69 - 7.70 -<p>Set the debug level. Valid values are 0 to 6, increasing it further 7.71 -makes no difference. Be careful if you set this as high as 5 or higher, 7.72 -the logs may very soon fill your hard drive.</p> 7.73 - 7.74 - 7.75 - 7.76 - 7.77 -<p><b>mail_dir = <em>file</em></b></p> 7.78 - 7.79 -<p>The directory where local mail is stored, 7.80 -usually <em>/var/spool/mail</em> or <em>/var/mail</em>.</p> 7.81 - 7.82 - 7.83 - 7.84 - 7.85 -<p><b>spool_dir = <em>file</em></b></p> 7.86 - 7.87 -<p>The directory where masqmail stores its spool files (and later also 7.88 -other stuff). It must have a subdirectory <em>input</em>. 7.89 -Masqmail needs read and write permissions for this 7.90 -directory. I suggest to use <em>/var/spool/masqmail</em>.</p> 7.91 - 7.92 - 7.93 - 7.94 - 7.95 -<p><b>host_name = <em>string</em></b></p> 7.96 - 7.97 -<p>This is used in different places: Masqmail identifies itself in the 7.98 -greeting banner on incoming connections and in the HELO/EHLO command 7.99 -for outgoing connections with this name, it is used in the Received: 7.100 -header and to qualify the sender of a locally originating message.</p> 7.101 - 7.102 -<p>If the string begins with a slash '/', it it assumed that it is a 7.103 -filename, and the first line of this file will be used. Usually this will 7.104 -be '/etc/mailname' to make masqmail conform to Debian policies.</p> 7.105 - 7.106 -<p>It is not used to find whether an address is local. 7.107 -Use <b>local_hosts</b> for that.</p> 7.108 - 7.109 - 7.110 - 7.111 - 7.112 -<p><b>remote_port = <em>n</em></b></p> 7.113 - 7.114 -<p>The remote port number to be used. This defaults to port 25.</p> 7.115 -<p>This option is deprecated. Use <b>host_name</b> in the route 7.116 -configuration instead. See <a href="masqmail.route.5.html">masqmail.route</a>.</p> 7.117 - 7.118 - 7.119 - 7.120 - 7.121 -<p><b>local_hosts = <em>list</em></b></p> 7.122 - 7.123 -<p>A semicolon ';' separated list of hostnames which are considered 7.124 -local. Normally you set it to "localhost;foo;foo.bar.com" if your host 7.125 -has the fully qualified domain name 'foo.bar.com'.</p> 7.126 - 7.127 - 7.128 - 7.129 - 7.130 -<p><b>local_nets = <em>list</em></b></p> 7.131 - 7.132 -<p>A semicolon ';' separated list of hostnames which are on the 7.133 -'local' net. Delivery to these hosts is attempted immediately. You can 7.134 -use patterns with '*', eg. "*.bar.com".</p> 7.135 - 7.136 - 7.137 - 7.138 - 7.139 -<p><b>local_addresses = <em>list</em></b></p> 7.140 - 7.141 -<p>A semicolon ';' separated list of fully qualified email-addresses 7.142 -which are considered local although their domain name part is not in 7.143 -the list of <b>local_hosts</b>. </p> 7.144 -<p>For example: There are two people working at your 7.145 -LAN: person1@yourdomain and person2@yourdomain. But there are 7.146 -other persons @yourdomain which are NOT local. So you can not put 7.147 -yourdomain to the list of local_hosts. If person1 now wants 7.148 -to write to person2@yourdomain and this mail should not leave the LAN 7.149 -then you can put</p> 7.150 -<p>local_addresses = "person1@yourdomain;person2@yourdomain"</p> 7.151 -<p>to your masqmail.conf.</p> 7.152 - 7.153 - 7.154 - 7.155 - 7.156 -<p><b>not_local_addresses = <em>list</em></b></p> 7.157 - 7.158 -<p>A semicolon ';' separated list of fully qualified email-addresses 7.159 -which are considered not local although their domain name part is in 7.160 -the list of <b>local_hosts</b>. </p> 7.161 -<p>This ist the opposite of the previous case. The majority of addresses 7.162 -of a specific domain are local. But some users are not. With this 7.163 -option you can easily exclude these users.</p> 7.164 -<p>Example:</p> 7.165 -<p>local_hosts = "localhost;myhost;mydomain.net"</p> 7.166 -<p>not_local_addresses = "eric@mydomain.net"</p> 7.167 - 7.168 - 7.169 - 7.170 - 7.171 -<p><b>listen_addresses = <em>list</em></b></p> 7.172 - 7.173 -<p>A semicolon ';' separated list of interfaces on which connections 7.174 -will be accepted. An interface ist defined by a hostname, optionally 7.175 -followed by a colon ':' and a number for the port. If this is left out, 7.176 -port 25 will be used.</p> 7.177 -<p>You can set this to "localhost:25;foo:25" if your hostname is 'foo'.</p> 7.178 -<p>Note that the names are resolved to IP addreses. If your host has 7.179 -different names which resolve to the same IP, use only one of them, 7.180 -otherwise you will get an error message. 7.181 -</p> 7.182 - 7.183 - 7.184 - 7.185 - 7.186 -<p><b>do_save_envelope_to = <em>boolean</em></b></p> 7.187 - 7.188 -<p>If this is set to true, a possibly existing Envelope-to: header in an 7.189 -incoming mail which is received via either pop3 or smtp will be saved as 7.190 -an X-Orig-Envelope-to: header.</p> 7.191 -<p>This is useful if you retrieve mail from a pop3 server with either masqmail 7.192 -or fetchmail, and the server supports Envelope-to: headers, and you want to make use 7.193 -of those with a mail filtering tool, eg. procmail. It cannot be preserved because 7.194 -masqmail sets such a header by itself.</p> 7.195 -<p>Default is false.</p> 7.196 - 7.197 - 7.198 - 7.199 - 7.200 -<p><b>do_relay = <em>boolean</em></b></p> 7.201 - 7.202 -<p>If this is set to false, mail with a return path that is not local and a 7.203 -destination that is also not local will not be accepted via smtp and a 550 7.204 -reply will be given. Default is true.</p> 7.205 -<p>Note that this will not protect you from spammers using open relays, but from 7.206 -users unable to set their address in their mail clients.</p> 7.207 - 7.208 - 7.209 - 7.210 - 7.211 -<p><b>do_queue = <em>boolean</em></b></p> 7.212 - 7.213 -<p>If this is set, mail will not be delivered immediately when 7.214 -accepted. Same as calling masqmail with the <b>-odq</b> option.</p> 7.215 - 7.216 - 7.217 - 7.218 - 7.219 -<p><b>online_routes.<em>name</em> = <em>list</em></b></p> 7.220 - 7.221 - 7.222 -<p>Replace <em>name</em> with a name to identify a connection. Set this 7.223 -to a filename (or a list of filenames) for the special route configuration for that 7.224 -connection. You will use that name to call masqmail with the 7.225 - <b>-qo</b> option every time a connection to your ISP is set 7.226 -up.</p> 7.227 - 7.228 -<p>Example: Your ISP has the name FastNet. Then you write the 7.229 -following line in the main configuration:</p> 7.230 - 7.231 -<p><b>online_routes.FastNet</b> = <em>"/etc/masqmail/fastnet.route"</em></p> 7.232 - 7.233 -<p><em>/etc/masqmail/fastnet.route</em> is the route configuration 7.234 -file, see <a href="masqmail.route.5.html">masqmail.route</a>. As soon as a link to FastNet has been set up, you 7.235 -call masqmail <b>-qo</b> <em>FastNet</em>. Masqmail will then 7.236 -read the specified file and send the mails.</p> 7.237 - 7.238 - 7.239 - 7.240 - 7.241 - 7.242 -<p><b>connect_route.<em>name</em> = <em>list</em></b></p> 7.243 - 7.244 -<p>Old name for <b>online_routes</b>.</p> 7.245 - 7.246 - 7.247 - 7.248 - 7.249 - 7.250 -<p><b>local_net_route = <em>file</em></b></p> 7.251 - 7.252 -<p>This is similar to <b>online_routes.<em>name</em></b> but for the 7.253 -local net. Recipient addresses that are in local_nets will be 7.254 -routed using this route configuration. Main purpose is to define a 7.255 -mail server with mail_host in your local network. In simple 7.256 -environments this can be left unset. If unset, a default route 7.257 -configuration will be used.</p> 7.258 - 7.259 - 7.260 - 7.261 - 7.262 -<p><b>alias_file = <em>file</em></b></p> 7.263 - 7.264 -<p>Set this to the location of your alias file. If unset, no aliasing 7.265 -will be done.</p> 7.266 - 7.267 - 7.268 - 7.269 - 7.270 -<p><b>alias_local_caseless = <em>boolean</em></b></p> 7.271 - 7.272 -<p>If this is set, local parts in the alias file will be matched 7.273 -disregarding upper/lower case.</p> 7.274 - 7.275 - 7.276 - 7.277 - 7.278 -<p><b>pipe_fromline = <em>boolean</em></b></p> 7.279 - 7.280 -<p>If this is set, a from line will be prepended to the output stream whenever 7.281 -a pipe command is called after an alias expansion. Default is false.</p> 7.282 - 7.283 - 7.284 - 7.285 - 7.286 -<p><b>pipe_fromhack = <em>boolean</em></b></p> 7.287 - 7.288 -<p>If this is set, each line beginning with 'From ' is replaced with '>From ' whenever 7.289 -a pipe command is called after an alias expansion. You probably want this if you have 7.290 -set <b>pipe_fromline</b> above. Default is false.</p> 7.291 - 7.292 - 7.293 - 7.294 - 7.295 -<p><b>mbox_default = <em>string</em></b></p> 7.296 - 7.297 -<p>The default local delivery method. Can be one of mbox, mda or 7.298 -maildir (the latter only if maildir support is enabled at compile 7.299 -time). Default is mbox. You can override this for each user by using 7.300 -the <b>mbox_users</b>, <b>mda_users</b> or <b>maildir_users</b> options 7.301 -(see below). 7.302 -</p> 7.303 - 7.304 - 7.305 - 7.306 - 7.307 -<p><b>mbox_users = <em>list</em></b></p> 7.308 - 7.309 -<p>A list of users which wish delivery to an mbox style mail folder.</p> 7.310 - 7.311 - 7.312 - 7.313 - 7.314 -<p><b>mda_users = <em>list</em></b></p> 7.315 - 7.316 -<p>A list of users which wish local delivery to an mda. You have to 7.317 -set <b>mda</b> (see below) as well.</p> 7.318 - 7.319 - 7.320 - 7.321 - 7.322 -<p><b>maildir_users = <em>list</em></b></p> 7.323 - 7.324 -<p>A list of users which wish delivery to a qmail style maildir. The 7.325 -path to maildir is ~/Maildir/. The maildir will be created if it 7.326 -does not exist.</p> 7.327 - 7.328 - 7.329 - 7.330 - 7.331 -<p><b>mda = <em>expand string</em></b></p> 7.332 - 7.333 -<p>If you want local delivery to be transferred to an mda (Mail 7.334 -Delivery Agent), set this to a command. The argument will be expanded 7.335 -on delivery time, you can use variables beginning with a '$' sign, 7.336 -optionally enclosed in curly braces. Variables you can use are:</p> 7.337 -<p>uid - the unique message id. This is not necessarily identical with 7.338 -the Message ID as given in the Message ID: header.</p> 7.339 -<p>received_host - the host the mail was received from</p> 7.340 -<p>ident - the ident, this is either the ident delivered by the ident 7.341 -protocol or the user id of the sender if the message was received locally.</p> 7.342 -<p>return_path_local - the local part of the return path (sender).</p> 7.343 -<p>return_path_domain - the domain part of the return path (sender).</p> 7.344 -<p>return_path - the complete return path (sender).</p> 7.345 -<p>rcpt_local - the local part of the recipient.</p> 7.346 -<p>rcpt_domain - the domain part of the recipient.</p> 7.347 -<p>rcpt - the complete recipient address.</p> 7.348 -<p>Example:</p><p>mda="/usr/bin/procmail -Y -d ${rcpt_local}"</p> 7.349 -<p>For the mda, as for pipe commands, a few environment variables will 7.350 -be set as well. See <a href="masqmail.8.html">masqmail</a>. To use environment variables for the mda, 7.351 -the '$' sign has to be escaped with a backslash, otherwise they will 7.352 -be tried to be expanded with the internal variables.</p> 7.353 - 7.354 - 7.355 - 7.356 - 7.357 - 7.358 -<p><b>mda_fromline = <em>boolean</em></b></p> 7.359 - 7.360 -<p>If this is set, a from line will be prepended to the output stream whenever 7.361 -a message is delivered to an mda. Default is false.</p> 7.362 - 7.363 - 7.364 - 7.365 - 7.366 -<p><b>mda_fromhack = <em>boolean</em></b></p> 7.367 - 7.368 -<p>If this is set, each line beginning with 'From ' is replaced with '>From ' whenever 7.369 -a message is delivered to an mda. You probably want this if you have 7.370 -set <b>mda_fromline</b> above. Default is false.</p> 7.371 - 7.372 - 7.373 - 7.374 - 7.375 -<p><b>online_detect = <em>string</em></b></p> 7.376 - 7.377 -<p>Defines the method MasqMail uses to detect whether there is 7.378 -currently an online connection. It can have the 7.379 -values <b>file</b>, <b>pipe</b> or <b>mserver</b>.</p> 7.380 - 7.381 -<p>When it is set to <b>file</b>, MasqMail first checks for the 7.382 -existence of <b>online_file</b> (see below) and if it exists, it reads 7.383 -it. The content of the file should be the name of the current 7.384 -connection as defined with <b>connect_route.<em>name</em></b> (without 7.385 -a trailing newline character).</p> 7.386 - 7.387 -<p>When it is set to <b>pipe</b>, MasqMail calls the executable given by 7.388 -the <b>online_pipe</b> option (see below) and reads the current online 7.389 -status from its standard output.</p> 7.390 - 7.391 -<p>When it is set to <b>mserver</b>, MasqMail connects to the 7.392 -masqdialer server using the value of <b>mserver_iface</b> and asks it 7.393 -whether a connection exists and for the name, which should be the name 7.394 -of the current connection as defined with <b>connect_route.<em>name</em></b>.</p> 7.395 - 7.396 -<p>No matter how MasqMail detects the online status, only messages 7.397 -that are accepted at online time will be delivered using the 7.398 -connection. The spool still has to be emptied with masqmail <b>-qo</b> 7.399 -<em>connection</em>.</p> 7.400 - 7.401 - 7.402 - 7.403 - 7.404 -<p><b>online_file = <em>file</em></b></p> 7.405 - 7.406 -<p>This is the name of the file checked for when MasqMail determines 7.407 -whether it is online. The file should only exist when there is 7.408 -currently a connection. Create it in your ip-up script with eg.</p> 7.409 - 7.410 -<p>echo -n <name> > /tmp/connect_route</p> 7.411 -<p>chmod 0644 /tmp/connect_route</p> 7.412 - 7.413 -<p>Do not forget to delete it in your ip-down script.</p> 7.414 - 7.415 - 7.416 - 7.417 - 7.418 -<p><b>online_pipe = <em>file</em></b></p> 7.419 - 7.420 -<p>This is the name of the executable which will be called to determine 7.421 -the online status. This executable should just print the name oif the current 7.422 -connection to the standard output and return a zero status code. masqmail assumes 7.423 -it is offline if the script returns with a non zero status. Simple example:</p> 7.424 - 7.425 -<p>#!/bin/sh</p> 7.426 -<p></p> 7.427 -<p>[ -e /tmp/connect_route ] || exit 1</p> 7.428 -<p>cat /tmp/connect_route</p> 7.429 -<p>exit 0</p> 7.430 - 7.431 -<p>Of course, instead of the example above you could as well use <b>file</b> as 7.432 -the online detection method, but you can do something more sophisticated.</p> 7.433 - 7.434 - 7.435 - 7.436 - 7.437 -<p><b>mserver_iface = <em>interface</em></b></p> 7.438 - 7.439 -<p>The interface the masqdialer server is listening to. Usually this 7.440 -will be "localhost:224" if mserver is running on the same host as 7.441 -masqmail. But using this option, you can also let masqmail run on 7.442 -another host by setting <b>mserver_iface</b> to another hostname, 7.443 -eg. "foo:224".</p> 7.444 - 7.445 - 7.446 - 7.447 - 7.448 -<p><b>get.<em>name</em> = <em>file</em></b></p> 7.449 - 7.450 -<p>Replace <em>name</em> with a name to identify a get 7.451 -configuration. Set this to a filename for the get configuration. These 7.452 -files will be used to retrieve mail when called with the -g option.</p> 7.453 - 7.454 - 7.455 - 7.456 - 7.457 -<p><b>online_gets.<em>name</em> = <em>list</em></b></p> 7.458 - 7.459 -<p>Replace <em>name</em> with a name to identify an online 7.460 -configuration. Set this to a filename (or a list of filenames) for the get configuration. These 7.461 -files will be used to retrieve mail when called with the -go option.</p> 7.462 - 7.463 - 7.464 - 7.465 - 7.466 -<p><b>ident_trusted_nets = <em>list</em></b></p> 7.467 - 7.468 -<p><em>list</em> is a list of networks of the form a.b.c.d/e 7.469 -(eg. 192.168.1.0/24), from which the ident given by the ident protocol 7.470 -will be trusted, so a user can delete his mail from the queue if the 7.471 -ident is identical to his login name.</p> 7.472 - 7.473 - 7.474 - 7.475 - 7.476 -<p><b>errmsg_file = <em>file</em></b></p> 7.477 - 7.478 -<p>Set this to a template which will be used to generate delivery failure 7.479 -reports. Variable parts within the template begin with a dollar sign and 7.480 -are identical to those which can be used as arguments for the mda command, 7.481 -see <b>mda</b> above. Additional information can be included with 7.482 -@failed_rcpts, @msg_headers and @msg_body, these must be at the 7.483 -beginning of a line and will be replaced with the list of the failed recipients, 7.484 -the message headers and the message body of the failed message.</p> 7.485 -<p>Default is /usr/share/masqmail/tpl/failmsg.tpl.</p> 7.486 - 7.487 - 7.488 - 7.489 - 7.490 -<p><b>warnmsg_file = <em>file</em></b></p> 7.491 - 7.492 -<p>Set this to a template which will be used to generate delivery warning 7.493 -reports. It uses the same mechanisms for variables as <b>errmsg_file</b>, 7.494 -see above. 7.495 -</p> 7.496 -<p>Default is /usr/share/masqmail/tpl/warnmsg.tpl.</p> 7.497 - 7.498 - 7.499 - 7.500 - 7.501 -<p><b>warn_intervals</b> = <em>list</em></p> 7.502 - 7.503 -<p>Set this to a list of time intervals, at which delivery warnings (starting 7.504 -with the receiving time of the message) shall be generated.</p> 7.505 -<p>A warning will only be generated just after an attempt to deliver the 7.506 -mail and if that attempt failed temporarily. So a warning may be generated after 7.507 -a longer time, if there was no attempt before.</p> 7.508 -<p>Default is "1h;4h;8h;1d;2d;3d"</p> 7.509 - 7.510 - 7.511 - 7.512 - 7.513 -<p><b>max_defer_time</b> = <em>time</em></p> 7.514 - 7.515 -<p>This is the maximum time, in which a temporarily failed mail will be kept 7.516 -in the spool. When this time is exceeded, it will be handled as a delivery failure, 7.517 -and the message will be bounced.</p> 7.518 -<p>The excedence of this time will only be noticed if the message was actually 7.519 -tried to be delivered. If, for example, the message can only be delivered when 7.520 -online, but you have not been online for that time, no bounce will be generated.</p> 7.521 -<p>Default is 4d (4 days)</p> 7.522 - 7.523 - 7.524 - 7.525 - 7.526 -<p><b>log_user = <em>name</em></b></p> 7.527 - 7.528 -<p>Replace <em>name</em> with a valid local or remote mail address.</p> 7.529 -<p>If this option is not empty, then a copy of every mail, 7.530 -that passes trough the masqmail system will also be sent to the 7.531 -given mail address.</p> 7.532 -<p>For example you can feed your mails into a program like hypermail for 7.533 -archiving purpose by placing an appropriate pipe command in masqmail.alias</p> 7.534 - 7.535 - 7.536 - 7.537 - 7.538 - 7.539 -<h2>Author</h2> 7.540 - 7.541 -<p>masqmail was written by Oliver Kurth 7.542 -<oku@masqmail.cx></p><p>You will find the newest version of 7.543 -masqmail at <a href = "http://masqmail.cx/masqmail/">http://masqmail.cx/masqmail/</a> or search for it 7.544 -in freshmeat (<a href = "http://www.freshmeat.net">http://www.freshmeat.net</a>). There is also a mailing list, 7.545 -you will find information about it at masqmails main site.</p> 7.546 - 7.547 - 7.548 - 7.549 -<h2>Bugs</h2> 7.550 - 7.551 -<p>You should report them to the mailing list.</p> 7.552 - 7.553 - 7.554 - 7.555 -<h2>See also</h2> 7.556 - 7.557 -<p> 7.558 -<a href="masqmail.8.html">masqmail</a>, <a href="masqmail.route.5.html">masqmail.route</a>, <a href="masqmail.get.5.html">masqmail.get</a> 7.559 -</p> 7.560 - 7.561 - 7.562 - 7.563 - 7.564 -<h2>Comments</h2> 7.565 - 7.566 -<p>This man page was written using <a href="http://masqmail.cx/xml2man/">xml2man</a> by the same 7.567 -author.</p> 7.568 - 7.569 - 7.570 - 7.571 -</td></tr></table></center> 7.572 -</body>
8.1 --- a/docs/old-manual/docs/masqmail.get.5.html Sun Jul 18 22:40:09 2010 +0200 8.2 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 8.3 @@ -1,175 +0,0 @@ 8.4 -<body text="#000000" link="#0000ff" bgcolor="#ffffff"><center><table width="80%"> 8.5 -<tr><td><h1>masqmail.get</h1> 8.6 -<h2>masqmail get configuration file</h2> 8.7 - 8.8 - 8.9 -<h2>Description</h2> 8.10 - <p>This man page describes the options available for the 8.11 -masqmail get configuration.</p> 8.12 - 8.13 - 8.14 - 8.15 - 8.16 -<h2>Options</h2> 8.17 - 8.18 - 8.19 - 8.20 -<p><b>protocol</b> = <em>string</em></p> 8.21 - 8.22 -<p>The protocol with which you retrieve your mail. Currently only 8.23 -'pop3' and 'apop' are supported. There is no default.</p> 8.24 - 8.25 - 8.26 - 8.27 - 8.28 -<p><b>server</b> = <em>string</em></p> 8.29 - 8.30 -<p>The server you get your mail from.</p> 8.31 - 8.32 - 8.33 - 8.34 - 8.35 -<p><b>resolve_list</b> = <em>list</em></p> 8.36 - 8.37 -<p>Specify the method how the domain of the server is resolved. Possible values are 8.38 -dns_mx, dns_a, byname. For 'dns_mx', the domain is assumed to be an MX 8.39 -pointer to a list of host names, these will be tried each in order 8.40 -(lowest preference value first, equal preference values in random 8.41 -order). For 'dns_a', the domain is assumed to be an A pointer. For 8.42 -'byname', the library function <b>gethostbyname (3)</b> will be used.</p> 8.43 -<p>The default is "dns_a;byname". It does not make much sense here to use 'dns_mx'.</p> 8.44 - 8.45 - 8.46 - 8.47 - 8.48 -<p><b>user</b> = <em>string</em></p> 8.49 - 8.50 -<p>Your login name.</p> 8.51 - 8.52 - 8.53 - 8.54 - 8.55 -<p><b>pass</b> = <em>string</em></p> 8.56 - 8.57 -<p>Your password.</p> 8.58 - 8.59 - 8.60 - 8.61 - 8.62 -<p><b>address</b> = <em>address</em></p> 8.63 - 8.64 -<p>The address where the retrieved mail should be sent to. It can be 8.65 -any address, but you probably want to set this to a local address on 8.66 -your LAN.</p> 8.67 - 8.68 - 8.69 - 8.70 - 8.71 -<p><b>return_path</b> = <em>address</em></p> 8.72 - 8.73 -<p>If set, masqmail sets the return path to this address. Bounces 8.74 -generated during further delivery will be sent to this address. If 8.75 -unset, masqmail looks for the Return-Path: header in the mail, if 8.76 -this does not exist it uses the From: address and if this fails, 8.77 -postmaster will be used. 8.78 -</p><p> 8.79 -It is in most cases not useful to set this to the same address as 8.80 -the 'address' option as this may generate multiple bounces. 8.81 -postmaster is recommended.</p> 8.82 - 8.83 - 8.84 - 8.85 - 8.86 -<p><b>do_keep</b> = <em>boolean</em></p> 8.87 - 8.88 -<p>If you want to keep your mail on the server after you retrieved it, 8.89 -set this to true. It is recommended that you also set do_uidl, 8.90 -otherwise you will get the mail again each time you connect to the 8.91 -server. Masqmail does not check any headers before it retrieves mail, 8.92 -which may mark it as already fetched. Note that this behaviour is 8.93 -different to that of fetchmail. The default is false.</p> 8.94 - 8.95 - 8.96 - 8.97 - 8.98 -<p><b>do_uidl</b> = <em>boolean</em></p> 8.99 - 8.100 -<p>If set, MasqMail keeps a list of unique IDs of mails already 8.101 -fetched, so that they will not be retrieved again. Default is false.</p> 8.102 - 8.103 - 8.104 - 8.105 - 8.106 -<p><b>do_uidl_dele</b> = <em>boolean</em></p> 8.107 - 8.108 -<p>If set, and <b>do_uidl</b> is also set, MasqMail sends a delete (DELE) 8.109 -command to the server for each message uid in the uid listing at the 8.110 -beginning of the session. This prevents mail to be left on the server if 8.111 -masqmail gets interrupted during a session before it can send the QUIT 8.112 -command to the server. Default is false. 8.113 -</p> 8.114 - 8.115 - 8.116 - 8.117 - 8.118 -<p><b>max_size</b> = <em>numeric</em></p> 8.119 - 8.120 -<p>If set to a value > 0, only messages smaller than this in bytes will be 8.121 -retrieved. The default is 0.</p> 8.122 - 8.123 - 8.124 - 8.125 - 8.126 -<p><b>max_count</b> = <em>numeric</em></p> 8.127 - 8.128 -<p>If set to a value > 0, only <b>max_count</b> messages will be retrieved. 8.129 -The default is 0.</p> 8.130 - 8.131 - 8.132 - 8.133 - 8.134 -<p><b>wrapper</b> = <em>command</em></p> 8.135 - 8.136 -<p>If set, instead of opening a connection to a remote server, <em>command</em> will 8.137 -be called and all traffic will be piped to its 8.138 -stdin and from its stdout. Purpose is to tunnel ip traffic, eg. for ssl.</p> 8.139 -<p>Example for ssl tunneling:</p> 8.140 -<p>wrapper="/usr/bin/openssl s_client -quiet -connect pop.gmx.net:995 2>/dev/null"</p> 8.141 - 8.142 - 8.143 - 8.144 - 8.145 - 8.146 -<h2>Author</h2> 8.147 - 8.148 -<p>masqmail was written by Oliver Kurth 8.149 -<oku@masqmail.cx></p><p>You will find the newest version of 8.150 -masqmail at <a href = "http://masqmail.cx/masqmail/">http://masqmail.cx/masqmail/</a> or search for it 8.151 -in freshmeat (<a href = "http://www.freshmeat.net">http://www.freshmeat.net</a>). There is also a mailing list, 8.152 -you will find information about it at masqmails main site.</p> 8.153 - 8.154 - 8.155 - 8.156 -<h2>Bugs</h2> 8.157 - 8.158 -<p>You should report them to the mailing list.</p> 8.159 - 8.160 - 8.161 - 8.162 -<h2>See also</h2> 8.163 - 8.164 -<p> 8.165 -<a href="masqmail.8.html">masqmail</a>, <a href="masqmail.route.5.html">masqmail.route</a>, <a href="masqmail.conf.5.html">masqmail.conf</a> 8.166 -</p> 8.167 - 8.168 - 8.169 - 8.170 -<h2>Comments</h2> 8.171 - 8.172 -<p>This man page was written using <a href="http://masqmail.cx/xml2man/">xml2man</a> by the same 8.173 -author.</p> 8.174 - 8.175 - 8.176 - 8.177 -</td></tr></table></center> 8.178 -</body>
9.1 --- a/docs/old-manual/docs/masqmail.route.5.html Sun Jul 18 22:40:09 2010 +0200 9.2 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 9.3 @@ -1,385 +0,0 @@ 9.4 -<body text="#000000" link="#0000ff" bgcolor="#ffffff"><center><table width="80%"> 9.5 -<tr><td><h1>masqmail.route</h1> 9.6 -<h2>masqmail route configuration file</h2> 9.7 - 9.8 - 9.9 -<h2>Description</h2> 9.10 - 9.11 -<p>This man page describes the syntax of the route configuration files 9.12 -of <a href="masqmail.8.html">masqmail</a>. Their usual locations are in <em>/etc/masqmail/</em>.</p> 9.13 - 9.14 - 9.15 - 9.16 -<h2>Options</h2> 9.17 - 9.18 - 9.19 - 9.20 -<p><b>protocol</b> = <em>string</em></p> 9.21 - 9.22 -<p><em>string</em> can be one of 'smtp' or 'pipe', default is 9.23 -'smtp'. If set to 'smtp', mail will be sent with the SMTP protocol to 9.24 -its destination. If set to 'pipe', you also have to set 'pipe' 9.25 -to a command, the message will then be piped to a program. See option 'pipe' below.</p> 9.26 - 9.27 - 9.28 - 9.29 - 9.30 -<p><b>mail_host</b> = <em>string</em></p> 9.31 - 9.32 -<p>This is preferably the mail server of your ISP. All outgoing 9.33 -messages will be sent to this host which will distribute them to their 9.34 -destinations. If you do not set this mails will be sent 9.35 -directly. Because the mail server is probably 'near' to you, mail 9.36 -transfer will be much faster if you use it.</p> 9.37 -<p>You can optionally give a port number following the host name 9.38 -and a colon, eg mail_host="mail.foo.com:25".</p> 9.39 - 9.40 - 9.41 - 9.42 - 9.43 -<p><b>resolve_list</b> = <em>list</em></p> 9.44 - 9.45 -<p>Specify the method how the domain of the server is resolved. Possible values are 9.46 -dns_mx, dns_a, byname. For 'dns_mx', the domain is assumed to be an MX 9.47 -pointer to a list of host names, these will be tried each in order 9.48 -(lowest preference value first, equal preference values in random 9.49 -order). For 'dns_a', the domain is assumed to be an A pointer. For 9.50 -'byname', the library function <b>gethostbyname (3)</b> will be used.</p> 9.51 -<p>The default is "dns_mx;dns_a;byname".</p> 9.52 - 9.53 - 9.54 - 9.55 - 9.56 -<p><b>connect_error_fail</b> = <em>boolean</em></p> 9.57 - 9.58 -<p>If this is set, a connection error will cause a mail delivery to 9.59 -fail, ie. it will be bounced. If it is unset, it will just be defered.</p> 9.60 -<p>Default is false. The reason for this is that masqmail is designed 9.61 -for non permanent internet connections, where such errors may occur 9.62 -quite often, and a bounce would be annoying.</p> 9.63 -<p>For the default local_net route is is set to true.</p> 9.64 - 9.65 - 9.66 - 9.67 - 9.68 -<p><b>helo_name</b> = <em>string</em></p> 9.69 - 9.70 -<p>Set the name given with the HELO/EHLO command. If this is not 9.71 -set, <b>host_name</b> from <em>masqmail.conf</em> will be used, if 9.72 -the <b>do_correct_helo</b> option (see below) is unset.</p> 9.73 - 9.74 - 9.75 - 9.76 - 9.77 -<p><b>do_correct_helo</b> = <em>boolean</em></p> 9.78 - 9.79 -<p>If this is set, masqmail tries to look up your host name as it 9.80 -appears on the internet and sends this in the HELO/EHLO command. Some 9.81 -servers are so picky that they want this. Which is really 9.82 -crazy. It just does not make any sense to lie about ones own identity, 9.83 -because it can always be looked up by the server. Nobody should 9.84 -believe in the name given by HELO/EHLO anyway. If this is not 9.85 -set, <b>host_name</b> from <em>masqmail.conf</em> or as given with 9.86 -the <b>helo_name</b> (see above) will be used.</p> 9.87 - 9.88 - 9.89 - 9.90 - 9.91 -<p><b>do_pipelining</b> = <em>boolean</em></p> 9.92 - 9.93 -<p>If this is set to false, masqmail will not use ESMTP PIPELINING, even 9.94 -if the server announces that it is able to cope with it. Default is true.</p> 9.95 -<p>You do not want to set this to false unless the mail setup on the 9.96 -remote server side is really broken. Keywords: wingate.</p> 9.97 - 9.98 - 9.99 - 9.100 - 9.101 -<p><b>allowed_mail_locals</b> = <em>list</em></p> 9.102 - 9.103 -<p>This is a semicolon ';' separated list of local parts which will be 9.104 -allowed to send mail through this connection. If unset 9.105 -and <b>not_allowed_mail_locals</b> is also unset, all users are 9.106 -allowed.</p> 9.107 - 9.108 - 9.109 - 9.110 - 9.111 -<p><b>not_allowed_mail_locals</b> = <em>list</em></p> 9.112 - 9.113 -<p>This is a semicolon ';' separated list of local parts which will be 9.114 -not allowed to send mail through this connection. Local 9.115 -parts in this list will not be allowed to use this route even if they 9.116 -are part of <b>allowed_mail_locals</b> (see above).</p> 9.117 - 9.118 - 9.119 - 9.120 - 9.121 -<p><b>allowed_return_paths</b> = <em>list</em></p> 9.122 - 9.123 -<p>This is a semicolon ';' separated list of addresses. Messages which 9.124 -have one one of these addresses as the return path will be used using 9.125 -this route (if not also in <b>not_allowed_return_paths</b> or an item 9.126 -in <b>not_allowed_mail_locals</b> matches).</p> 9.127 -<p>Patterns containing '?' and '*' can be used. The special item "<>" matches 9.128 -the null sender address (eg. failure notices or delivery notifications).</p> 9.129 - 9.130 - 9.131 - 9.132 - 9.133 -<p><b>not_allowed_return_paths</b> = <em>list</em></p> 9.134 - 9.135 -<p>This is a semicolon ';' separated list of addresses. Messages which 9.136 -have one one of these addresses as the return path will not be used using 9.137 -this route (even if also in <b>allowed_return_paths</b> or an item 9.138 -in <b>allowed_mail_locals</b> matches).</p> 9.139 -<p>Patterns containing '?' and '*' can be used. The special item "<>" matches 9.140 -the null sender address (eg. failure notices or delivery notifications).</p> 9.141 - 9.142 - 9.143 - 9.144 - 9.145 -<p><b>allowed_rcpt_domains</b> = <em>list</em></p> 9.146 - 9.147 -<p>A list of recipient domains where mail will be sent to. This is for 9.148 -example useful if you use this route configuration when connected to 9.149 -another LAN via ppp. Patterns containing '?' and '*' can be used.</p> 9.150 - 9.151 - 9.152 - 9.153 - 9.154 -<p><b>not_allowed_rcpt_domains</b> = <em>list</em></p> 9.155 - 9.156 -<p>A list of recipient domains where mail will not be sent 9.157 -to. This is for example useful if you send mail directly (<b>mail_host</b> is 9.158 -not set) and you know of hosts that will not accept mail from you 9.159 -because they use a dialup list (eg. <a href = "http://maps.vix.com/dul/">http://maps.vix.com/dul/</a>. If any domain 9.160 -matches both <b>allowed_rcpt_domains</b> and <b>not_allowed_rcpt_domains</b>, 9.161 -mail will not be sent to this domain. Patterns containing '?' and '*' can be used.</p> 9.162 - 9.163 - 9.164 - 9.165 - 9.166 -<p><b>set_h_from_domain</b> = <em>string</em></p> 9.167 - 9.168 -<p>Replace the domain part in 'From:' headers with this value. This 9.169 -may be useful if you use a private, outside unknown address on your 9.170 -local LAN and want this to be replaced by the domain of the address of 9.171 -your email addrsss on the internet. Note that this is different to <b> 9.172 -set_return_path_domain</b>, see below.</p> 9.173 - 9.174 - 9.175 - 9.176 - 9.177 -<p><b>set_return_path_domain</b> = <em>string</em></p> 9.178 - 9.179 -<p>Sets the domain part of the envelope from address. Some hosts check 9.180 -whether this is the same as the net the connection is coming from. If 9.181 -not, they reject the mail because they suspect spamming. It should be 9.182 -a valid address, because some mail servers also check 9.183 -that. You can also use this to set it to your usual address on the 9.184 -internet and put a local address only known on your LAN in the 9.185 -configuration of your mailer. Only the domain part will 9.186 -be changed, the local part remains unchanged. Use <b> 9.187 -map_return_path_addresses</b> for rewriting local parts.</p> 9.188 - 9.189 - 9.190 - 9.191 - 9.192 -<p><b>map_h_from_addresses</b> = <em>list</em></p> 9.193 - 9.194 -<p>This is similar to <b>set_h_from_domain</b>, but more flexible. Set 9.195 -this to a list which maps local parts to a full RFC 822 compliant 9.196 -email address, the local parts (the keys) are separated from 9.197 -the addresses (the values) by colons (':').</p> 9.198 - 9.199 -<p>Example:</p> 9.200 - 9.201 -<p>map_h_from_addresses = "john: John Smith <jsmith@mail.academic.edu>; 9.202 -charlie: Charlie Miller <cmiller@mx.commercial.com>"</p> 9.203 -<p>You can use patterns, eg. * as keys.</p> 9.204 - 9.205 - 9.206 - 9.207 - 9.208 -<p><b>map_h_reply_to_addresses</b> = <em>list</em></p> 9.209 - 9.210 -<p>Same as <b>map_h_from_addresses</b>, but for the 'Reply-To:' header.</p> 9.211 - 9.212 - 9.213 - 9.214 - 9.215 -<p><b>map_h_mail_followup_to_addresses</b> = <em>list</em></p> 9.216 - 9.217 -<p>Same as <b>map_h_from_addresses</b>, but for the 'Mail-Followup-To:' 9.218 -header. Useful when replying to mailing lists.</p> 9.219 - 9.220 - 9.221 - 9.222 - 9.223 -<p><b>map_return_path_addresses</b> = <em>list</em></p> 9.224 - 9.225 -<p>This is similar to <b>set_return_path_domain</b>, but more 9.226 -flexible. Set this to a list which maps local parts to a full RFC 821 9.227 -compliant email address, the local parts (the keys) are 9.228 -separated from the addresses (the values) by colons 9.229 -(':'). Note that this option takes RFC 821 addresses 9.230 -while <b>map_h_from_addresses</b> takes RFC 822 addresses. The 9.231 -most important difference is that RFC 821 addresses have no full 9.232 -name.</p> 9.233 - 9.234 -<p>Example:</p> 9.235 -<p> 9.236 -map_return_path_addresses = 9.237 -"john: <jsmith@mail.academic.edu>; 9.238 -charlie: <cmiller@mx.commercial.com>" 9.239 -</p> 9.240 -<p>You can use patterns, eg. * as keys.</p> 9.241 - 9.242 - 9.243 - 9.244 - 9.245 -<p><b>expand_h_sender_address</b> = <em>boolean</em></p> 9.246 - 9.247 -<p>This sets the domain of the sender address as given by the Sender: 9.248 -header to the same address as in the envelope return path address 9.249 -(which can be set by either <b>set_return_path_domain</b> or <b>map_return_path_addresses</b>). 9.250 -This is for mail clients (eg. Microsoft Outlook) which use this address as the sender 9.251 -address. Though they should use the From: address, see RFC 9.252 -821. If <a href="http://www.fetchmail.org">fetchmail</a> encounters an unqualified Sender: 9.253 -address, it will be expanded to the domain of the pop server, which is 9.254 -almost never correct. Default is true.</p> 9.255 - 9.256 - 9.257 - 9.258 - 9.259 -<p><b>expand_h_sender_domain</b> = <em>boolean</em></p> 9.260 - 9.261 -<p>Like <b>expand_h_sender_address</b>, but sets the domain only. 9.262 -Deprecated, will be removed in a later version.</p> 9.263 - 9.264 - 9.265 - 9.266 - 9.267 -<p><b>last_route</b> = <em>boolean</em></p> 9.268 - 9.269 -<p>If this is set, a mail which would have been delivered using this 9.270 -route, but has failed temporarily, will not be tried to be delivered 9.271 -using the next route.</p> 9.272 -<p>If you have set up a special route with filters using the lists 9.273 -'allowed_rcpt_domains', 'allowed_return_paths', and 9.274 -'allowed_mail_locals' or their complements (not_), and the mail 9.275 -passing these rules should be delivered using this route only, you 9.276 -should set this to 'true'. Otherwise the mail would be passed to the 9.277 -next route (if any), unless that route has rules which prevent 9.278 -that.</p> 9.279 -<p>Default is false.</p> 9.280 - 9.281 - 9.282 - 9.283 - 9.284 -<p><b>auth_name</b> = <em>string</em></p> 9.285 - 9.286 -<p>Set the authentication type for ESMTP AUTH authentification. 9.287 -Currently only 'cram-md5' and 'login' are supported.</p> 9.288 - 9.289 - 9.290 - 9.291 - 9.292 -<p><b>auth_login</b> = <em>string</em></p> 9.293 - 9.294 -<p>Your account name for ESMTP AUTH authentification.</p> 9.295 - 9.296 - 9.297 - 9.298 - 9.299 -<p><b>auth_secret</b> = <em>string</em></p> 9.300 - 9.301 -<p>Your secret for ESMTP AUTH authentification.</p> 9.302 - 9.303 - 9.304 - 9.305 - 9.306 -<p><b>pop3_login</b> = <em>file</em></p> 9.307 - 9.308 -<p>If your Mail server requires SMTP-after-POP, set this to a 9.309 -get configuration (see <a href="masqmail.get.5.html">masqmail.get</a>). 9.310 -If you login to the POP server 9.311 -before you send, this is not necessary.</p> 9.312 - 9.313 - 9.314 - 9.315 - 9.316 -<p><b>wrapper</b> = <em>command</em></p> 9.317 - 9.318 -<p>If set, instead of opening a connection to a remote server, <em>command</em> will 9.319 -be called and all traffic will be piped to its 9.320 -stdin and from its stdout. Purpose is to tunnel ip traffic, eg. for ssl.</p> 9.321 -<p>Example for ssl tunneling:</p> 9.322 -<p>wrapper="/usr/bin/openssl s_client -quiet -connect pop.gmx.net:995 2>/dev/null"</p> 9.323 - 9.324 - 9.325 - 9.326 - 9.327 -<p><b>pipe</b> = <em>command</em></p> 9.328 - 9.329 -<p>If set, and protocol is set to 'pipe', <em>command</em> will be 9.330 -called and the message will be piped to its stdin. Purpose is to use 9.331 -gateways to uucp, fax, sms or whatever else.</p> 9.332 -<p>You can use variables to give as arguments to the command, these 9.333 -are the same as for the mda in the main configuration, see <a href="masqmail.conf.5.html">masqmail.conf</a>.</p> 9.334 - 9.335 - 9.336 - 9.337 - 9.338 -<p><b>pipe_fromline = <em>boolean</em></b></p> 9.339 - 9.340 -<p>If this is set, and protocol is set to 'pipe', a from line will be prepended to the output stream whenever 9.341 -a pipe command is called. Default is false.</p> 9.342 - 9.343 - 9.344 - 9.345 - 9.346 -<p><b>pipe_fromhack = <em>boolean</em></b></p> 9.347 - 9.348 -<p>If this is set, and protocol is set to 'pipe', each line beginning with 'From ' 9.349 -is replaced with '>From ' whenever a pipe command is called. You probably want this if you have 9.350 -set <b>pipe_fromline</b> above. Default is false.</p> 9.351 - 9.352 - 9.353 - 9.354 - 9.355 - 9.356 -<h2>Author</h2> 9.357 - 9.358 -<p>masqmail was written by Oliver Kurth 9.359 -<oku@masqmail.cx></p><p>You will find the newest version of 9.360 -masqmail at <a href = "http://masqmail.cx/masqmail/">http://masqmail.cx/masqmail/</a> or search for it 9.361 -in freshmeat (<a href = "http://www.freshmeat.net">http://www.freshmeat.net</a>). There is also a mailing list, 9.362 -you will find information about it at masqmails main site.</p> 9.363 - 9.364 - 9.365 - 9.366 -<h2>Bugs</h2> 9.367 - 9.368 -<p>You should report them to the mailing list.</p> 9.369 - 9.370 - 9.371 - 9.372 -<h2>See also</h2> 9.373 - 9.374 -<p> 9.375 -<a href="masqmail.8.html">masqmail</a>, <a href="masqmail.conf.5.html">masqmail.conf</a>, <a href="masqmail.get.5.html">masqmail.get</a> 9.376 -</p> 9.377 - 9.378 - 9.379 - 9.380 -<h2>Comments</h2> 9.381 - 9.382 -<p>This man page was written using <a href="http://masqmail.cx/xml2man/">xml2man</a> by the same 9.383 -author.</p> 9.384 - 9.385 - 9.386 - 9.387 -</td></tr></table></center> 9.388 -</body>
10.1 --- a/docs/old-manual/faq.html Sun Jul 18 22:40:09 2010 +0200 10.2 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 10.3 @@ -1,189 +0,0 @@ 10.4 -<HTML> 10.5 -<HEAD> 10.6 -<TITLE>MasqMail - Manual 10.7 -</TITLE> 10.8 -</HEAD> 10.9 - <BODY TEXT="#000000" LINK="#0000ff" BGCOLOR="#ffffff"> 10.10 - 10.11 - <center> 10.12 - <table width="80%"> 10.13 - <tr><td> 10.14 - <table width="100%" bgcolor="#0000aa" cellspacing=0 cellpadding=0> 10.15 - <tr> 10.16 - <td> 10.17 - <a href="manual.html"> 10.18 - <img width="20" src = "../images/u_arrow.gif" alt = "manual"> 10.19 - </a> 10.20 - </td> 10.21 - <td align=center width="100%"><font size="6" color = "#ffffff">Frequently Asked Questions</font></td> 10.22 - <td> 10.23 - <a href="./config.html"> 10.24 - <img width="20" src = "../images/l_arrow.gif" alt = "Configuration"> 10.25 - </a> 10.26 - </td> 10.27 - </tr> 10.28 - </table> 10.29 - 10.30 - 10.31 - Some of these questions were never asked, but I thought they will be 10.32 - some time. Some <em>were</em> asked. 10.33 - 10.34 - <h4>General Questions</h4> 10.35 - <ul> 10.36 - <li><a href="#1_0">1.0: When do I need MasqMail?</a></li> 10.37 - <li><a href="#1_1">1.1: When do I <em>not</em> need MasqMail?</a></li> 10.38 - <li><a href="#1_2">1.2: Can I retrieve mail with MasqMail?</a></li> 10.39 - <li><a href="#1_3">1.3: Is there a mailing list for MasqMail?</a></li> 10.40 - </ul> 10.41 - 10.42 - <h4>Setup</h4> 10.43 - <ul> 10.44 - <li><a href="#2_0">2.0: After starting masmail, I get the following 10.45 - message: "could not gain root privileges. Is the setuid bit set?"</a></li> 10.46 - <li><a href="#2_1">2.1: After starting masmail, I get the following 10.47 - message: "bind: (terminating): Address already in use"</a></li> 10.48 - </ul> 10.49 - 10.50 - <h4>Header Rewriting</h4> 10.51 - <ul> 10.52 - <li><a href="#3_0">3.0: My friends told me that they do not see my 10.53 - full name in their inbox, although it is configured in my mail 10.54 - client.</a></li> 10.55 - </ul> 10.56 - 10.57 - <h4>Delivering Online</h4> 10.58 - <ul> 10.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> 10.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> 10.61 - </ul> 10.62 - 10.63 - <h4>Bugs</h4> 10.64 - <ul> 10.65 - <li><a href="#5_0">5.0: I found a bug.</a></li> 10.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> 10.67 - </ul> 10.68 - 10.69 - <a name="1_0"> <h4>1.0: When do I need MasqMail?</h4></a> 10.70 - 10.71 - <p> You do not <em>need</em> it. But it makes sending mails via a 10.72 - dialup connection a lot easier.</p> 10.73 - 10.74 - <p>It is useful if you dial to the internet from time to time via a 10.75 - modem and connect to different providers, each one with a different 10.76 - configuration. Other MTAs are not flexible enough if you have to send 10.77 - mails via different mail servers for each provider. With MasqMail you 10.78 - can configure a different one for each provider and even set your 10.79 - return addresses differently.</p> 10.80 - 10.81 - <p>It is also useful if you have a LAN with a gateway which is 10.82 - connected to the internet via a modem because you can rewrite your 10.83 - address depending on whether the recipients are <em>inside</em> or 10.84 - <em>outside</em> your LAN. So responses and delivery failures on your 10.85 - LAN will be sent to you without leaving it, while those outside will 10.86 - be delivered to your address outside. (But it does not yet send 10.87 - delivery failures itself yet.)</p> 10.88 - 10.89 - <p>MasqMail is also often used on notebooks.</p> 10.90 - 10.91 - <a name="1_1"><h4>1.1: When do I <em>not</em> need MasqMail?</h4></a> 10.92 - 10.93 - <p>The use of MasqMail is <em>strongly</em> discouraged if you have a 10.94 - permanent connection to the internet without a firewall. First because 10.95 - it does not have the ability to block relaying (it relays every mail) 10.96 - and second because there are no capabilities to protect against 10.97 - SPAM. You will not take advantages of its features anyway.</p> 10.98 - 10.99 - <a name="1_2"><h4>1.2: Can I retrieve mail with MasqMail?</h4></a> 10.100 - 10.101 - <p>Yes, for version >= 0.1.0 you can retrieve mail via the POP3 and 10.102 - APOP protocol from single drop mailboxes (in case you do not know 10.103 - about single/mutidrop, you probaby use single drop mailboxes).</p> 10.104 - 10.105 - <p>You can also use fetchmail or other pop/imap clients to feed 10.106 - it.</p> 10.107 - 10.108 - <a name="1_3"><h4>1.3: Is there a mailing list for MasqMail?</h4></a> 10.109 - 10.110 - <p>Yes, there is! See <a href="http://www.innominate.org/mailman/listinfo/masqmail">here</a>.</p> 10.111 - 10.112 - <a name="2_0"><h4>2.0: After starting masmail, I get the following 10.113 - message: "could not gain root privileges. Is the setuid bit set?"</h4></a> 10.114 - 10.115 - <p>Set the set-user-id-bit with chmod u+s /usr/sbin/masqmail.</p> 10.116 - 10.117 - <a name="2_1"><h4>2.1: After starting masmail, I get the following 10.118 - message: "bind: (terminating): Address already in use"</h4></a> 10.119 - 10.120 - <p>This means that there is already a process listening on a port, 10.121 - usually 25. You either have another MTA running in background 10.122 - (sendmail, exim, etc...) or another instance of masqmail.</p> 10.123 - 10.124 - <p>It may also mean that the ports you configured MM to listen to 10.125 - (with 'listen_addresses') are on the same IP address, eg. you may have 10.126 - set your hostname to 127.0.0.1 and try to listen on localhost and your 10.127 - host name. In this case either set your hostname to another IP address 10.128 - or delete one of the conflicting entries.</p> 10.129 - 10.130 - <a name="3_0"><h4>3.0: My friends told me that they do not see my full 10.131 - name in their inbox, although it is configured in my mail 10.132 - client.</h4></a> 10.133 - 10.134 - <p>You probably used the <b>map_h_from_addresses</b> feature in the 10.135 - route configuration and forgot to set your real name. The syntax 10.136 - is:</p> 10.137 - 10.138 - <pre> 10.139 -map_h_from_addresses = "charlie:Charlie Miller <cmiller@foo.com>"; 10.140 - </pre> 10.141 - 10.142 - <p>Do not forget the <em>Charlie Miller</em>.</p> 10.143 - 10.144 - <a name="4_0"><h4>4.0: With connection method <em>file</em>, I get the 10.145 - following message in the log file: "Could not open /tmp/connect_route: 10.146 - Permission denied".</h4></a> 10.147 - 10.148 - <p>In your ip-up script, you have to set read permission to the user 10.149 - masqmail runs as. After you write the file with the connection name, 10.150 - set read permission to all with chmod ugo+r <em>file</em>. 10.151 - 10.152 - <a name="4_1"><h4>4.1: With connection methed <em>file</em>, I get the 10.153 - following message in the log file: "route with name <em>name</em> not 10.154 - found.".</h4></a> 10.155 - 10.156 - <p>Check whether the name in the file is really identical to name you 10.157 - gave to the route configuration (case sensitive!). Maybe there is a 10.158 - linefeed after the name in the file. Write it with echo -n.</p> 10.159 - 10.160 - <a name="5_0"><h4>5.0: I found a bug.</h4></a> 10.161 - 10.162 - <p>Make sure you are using the newest version, in case of doubt search 10.163 - it in <a href="http://www.freshmeat.net">freshmeat</a>. If you do, tell 10.164 - <a href = "mailto:Oliver Kurth <kurth@innominate.de>">me</a>. See 10.165 - also the section <a href="index.html#bugs">bugs</a> on the <a 10.166 - href="index.html">main</a> page.</p> 10.167 - 10.168 - <a name="5_1"><h4>5.1: I think I found a bug, but I am not sure 10.169 - whether I configured MasqMail incorrectly.</h4></a> 10.170 - 10.171 - <p>Don't care. Tell <a href = "mailto:Oliver Kurth 10.172 - <kurth@innominate.de>">me</a>. Or write to the <a 10.173 - href="http://www.innominate.org/mailman/listinfo/masqmail">mailing 10.174 - list</a>.</p> 10.175 - 10.176 - </td></tr> 10.177 - 10.178 - <tr><td> 10.179 - <p> 10.180 - <hr> 10.181 - <address><a href = "mailto:kurth@innominate.de">Oliver Kurth</a></address> 10.182 - Last modified: Tue May 30 15:19:56 CEST 2000 10.183 - <br> 10.184 - This page was created using <a href="http://www.freddyfrog.com/hacks/genpage/">Genpage</a> - Version: 1.0.6 10.185 - </p> 10.186 - 10.187 - </table> 10.188 - </center> 10.189 - 10.190 - </BODY> 10.191 -</HEAD> 10.192 -
11.1 --- a/docs/old-manual/install.html Sun Jul 18 22:40:09 2010 +0200 11.2 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 11.3 @@ -1,219 +0,0 @@ 11.4 - 11.5 - 11.6 - 11.7 - 11.8 - 11.9 - 11.10 - 11.11 - 11.12 -<HTML> 11.13 -<HEAD> 11.14 -<TITLE>MasqMail - Manual 11.15 -</TITLE> 11.16 -</HEAD> 11.17 - <BODY TEXT="#000000" LINK="#0000ff" BGCOLOR="#ffffff"> 11.18 - 11.19 - <center> 11.20 - <table width="80%"> 11.21 - <tr><td> 11.22 - <table width="100%" bgcolor="#0000aa" cellspacing=0 cellpadding=0> 11.23 -<tr> 11.24 - <td> 11.25 - <a href="manual.html"> 11.26 - <img width="20" src = "../images/u_arrow.gif" alt = "manual"> 11.27 - </a> 11.28 - </td> 11.29 -<td align=center width="100%"><font size="6" color = "#ffffff">Installation</font></td> 11.30 -<td> 11.31 - <a href="./options.html"> 11.32 - <img width="20" src = "../images/r_arrow.gif" alt = "Options"> 11.33 - </a> 11.34 -</td> 11.35 -</tr> 11.36 -</table> 11.37 - 11.38 - 11.39 -<p>You need a user and a group for masqmail to run, I suggest user 11.40 -'mail' and group 'trusted'. Say:</p> 11.41 - 11.42 -<pre> 11.43 -groupadd -g 42 trusted 11.44 -useradd -u 42 -g 42 -d / -s /bin/sh -c "Mail Transfer Agent" mail 11.45 -</pre> 11.46 - 11.47 -<p>If you use other names than <i>mail</i> and <i>trusted</i> use the options 11.48 -described below for configure. The 42 is just a suggestion, you can 11.49 -use any number you like, but preferably one < 100. It does not have 11.50 -to be the same for the user 'mail' and the group 'trusted'.</p> 11.51 - 11.52 -<p>Compliling is a matter of the usual procedure:</p> 11.53 - 11.54 -In the source directory, after unpacking do:<br> 11.55 - 11.56 -<pre> 11.57 -./configure 11.58 -make 11.59 -make install 11.60 -</pre> 11.61 - 11.62 -<p>Optionally, after you have called make, you can make some tests in 11.63 -the tests directory. Read the README in that directory for 11.64 -instructions.</p> 11.65 - 11.66 -<h4>Additional options for configure:</h4> 11.67 - 11.68 -<p> 11.69 -<b>--with-user=USER</b> sets the user as which MasqMail will run. Default is 11.70 -<i>mail</i>. USER has to exist before you 'make install'. 11.71 -</p><p> 11.72 -<b>--with-group=GROUP</b> sets the group as which MasqMail will run. Default 11.73 -is <i>trusted</i>. GROUP has to exist before you 'make install'. 11.74 -</p><p> 11.75 -<b>--with-logdir=LOGDIR</b> sets the directory where MasqMail stores its log 11.76 -files. It will be created if it does not exist. Default is /var/masqmail/. 11.77 -</p><p> 11.78 -<b>--with-spooldir=SPOOLDIR</b> sets the directory where MasqMail stores its 11.79 -spool files. It will be created if it does not exist. Default is 11.80 -/var/spool/masqmail/. 11.81 -</p><p> 11.82 -<b>--enable-auth</b> enables ESMTP AUTH support (disabled by default) 11.83 -</p><p> 11.84 -<b>--disable-pop3</b> disables pop3 support (enabled by default) 11.85 -</p> 11.86 - 11.87 -<h4>After make install</h4> 11.88 - 11.89 -<p> 11.90 -You can also use these instructions to omit 'make install' if you do 11.91 -not want to use it. 11.92 -</p><p> 11.93 -Check that 'make install' worked correctly. The following command: 11.94 -</p><p><pre> 11.95 -ls -ld /usr/sbin/masqmail /var/masqmail/ /var/spool/masqmail /var/spool/masqmail/input 11.96 -</pre></p><p> 11.97 -should give output similar to 11.98 -</p><p> 11.99 -<pre> 11.100 --rwsr-xr-x 1 root root 86955 Oct 14 14:27 /usr/sbin/masqmail 11.101 -drwxr-xr-x 2 mail trusted 1024 Oct 14 14:29 /var/masqmail/ 11.102 -drwxr-xr-x 3 mail trusted 1024 Oct 14 14:27 /var/spool/masqmail 11.103 -drwxr-xr-x 2 mail trusted 1024 Oct 14 18:32 /var/spool/masqmail/input 11.104 -drwxr-xr-x 2 mail trusted 1024 Oct 14 18:32 /var/spool/masqmail/popuidl 11.105 -</pre> 11.106 -</p> 11.107 -<p> 11.108 -(important is the set-user-id bit for /usr/sbin/masqmail and the 11.109 -ownership of all items). 11.110 -</p> 11.111 - 11.112 -<p>Edit the configuration files. You can use the files from the 11.113 -examples directory as a template. Copy masqmail.conf to 11.114 -/etc/maqmail.conf, the others to the location given in 11.115 -masqmail.conf.</p> 11.116 - 11.117 -<p>If you already have an MTA (eg. sendmail) installed, move that to 11.118 -another location:</p> 11.119 - 11.120 -mv /usr/sbin/sendmail /usr/sbin/sendmail.orig<br> 11.121 - 11.122 -<p>Then make a link to the new MTA:</p> 11.123 - 11.124 -<pre> 11.125 -ln -s /usr/sbin/masqmail /usr/sbin/sendmail 11.126 -</pre> 11.127 - 11.128 -<p>Now every mailer that used to call sendmail will now call 11.129 -masqmail. You can now kill your old sendmail if it is running and 11.130 -start masqmail. Usually this is done with the startup scripts. For 11.131 -SuSE this would be (as root):</p> 11.132 - 11.133 -<pre> 11.134 -/sbin/init.d/sendmail stop 11.135 -/sbin/init.d/sendmail start 11.136 -</pre> 11.137 - 11.138 -<p>or shorter:</p> 11.139 - 11.140 -<pre> 11.141 -/sbin/init.d/sendmail restart<br> 11.142 -</pre> 11.143 - 11.144 -<p>You can also start it with:</p> 11.145 - 11.146 -<pre> 11.147 -/usr/sbin/sendmail -bd -q30m<br> 11.148 -</pre> 11.149 - 11.150 -<p>You can also let it be called from inetd (with the -bs option), but 11.151 -this is untested.</p> 11.152 - 11.153 -<h4>Configuring for online delivery</h4> 11.154 - 11.155 -<p>Now you have to set up the online configuration. The trick is to 11.156 -tell your ip-up script the connection name. You could use the IP 11.157 -number of the far side of the ppp link, but this is a pain and may 11.158 -change each time. But you can give it an additional argument via pppd 11.159 -with ipparam. Somewhere in your dial up script you have a line similar 11.160 -to:</p> 11.161 - 11.162 -<pre> 11.163 -/usr/sbin/pppd /dev/ttyS1 connect "/usr/sbin/chat -t 90 -f 11.164 -${CHATFILE}" -d -d -d user user@somewhere file ${OPTIONS} 11.165 -</pre> 11.166 - 11.167 -<p>Just add 'ipparam FastNet' in the command line for pppd if your ISP 11.168 -has the name FastNet. The ip-up script will then get 'FastNet' as a 11.169 -sixth parameter. In your ip-up script you can then call masqmail with</p> 11.170 - 11.171 -<pre> 11.172 -/usr/sbin/masqmail -qo $6 11.173 -</pre> 11.174 - 11.175 -<p>instead of 'sendmail -q', if you had that in the script 11.176 -before. Masqmail will then read the route configuration specified for 11.177 -the connection name 'FastNet' and deliver the mail destined to the 11.178 -internet. See the <a href="config.html">configuration manual</a> on how 11.179 -to write a route configuration or use one of the examples as a 11.180 -template. <em>I do not know how do configure that for an ISDN adapter, 11.181 -but I am sure you will find something similar in the man 11.182 -pages.</em></p> 11.183 - 11.184 -<p>If you want mail that is received by masqmail from your local 11.185 -net to be delivered immediately using the route configuration, you 11.186 -have two possibilities:<p> 11.187 - 11.188 -<p> 11.189 -<ul> 11.190 - 11.191 -<li>if you are using the masqdialer system, you just have to set the 11.192 -variables <b>online_detect</b> to <i>mserver</i> and 11.193 -<b>mserver_iface</b> to the interface mserver is listening to.</li> 11.194 - 11.195 -<li>otherwise you have to add two commands in your ip-up script:<br> 11.196 -echo -n $6 > /tmp/connect_route<br> chmod 644 /tmp/connect_route<br> 11.197 -and you have to remove the file <i>/tmp/connect_route</i> in your 11.198 -ip-down script:<br> rm /tmp/connect_route.<br> Then you have to set 11.199 -<b>online_detect</b> to <i>file</i> and <b>online_file</b> to 11.200 -<i>/tmp/connect_route</i>. </li> 11.201 - 11.202 -</ul> 11.203 -</p> 11.204 - 11.205 -<p>See the route documentation for more.</p> 11.206 - </td></tr> 11.207 - 11.208 - <tr><td> 11.209 - <p> 11.210 - <hr> 11.211 - <address><a href = "mailto:kurth@innominate.de">Oliver Kurth</a></address> 11.212 - Last modified: Tue May 30 15:19:56 CEST 2000 11.213 - <br> 11.214 - This page was created using <a href="http://www.freddyfrog.com/hacks/genpage/">Genpage</a> - Version: 1.0.6 11.215 - </p> 11.216 - 11.217 - </table> 11.218 - </center> 11.219 - 11.220 - </BODY> 11.221 -</HEAD> 11.222 -
12.1 --- a/docs/old-manual/manual.html Sun Jul 18 22:40:09 2010 +0200 12.2 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 12.3 @@ -1,45 +0,0 @@ 12.4 -<HTML> 12.5 - <HEAD> 12.6 - <TITLE>MasqMail - Manual 12.7 - </TITLE> 12.8 - </HEAD> 12.9 - <BODY TEXT="#000000" LINK="#0000ff" BGCOLOR="#ffffff"> 12.10 - 12.11 - <center> 12.12 - <table width="80%"> 12.13 - <tr><td> 12.14 - <table width="100%" bgcolor="#0000aa" cellspacing=0 cellpadding=0> 12.15 - <tr> 12.16 - <td> 12.17 - <a href="index.html"> 12.18 - <img width="20" src = "../images/u_arrow.gif" alt = "index"> 12.19 - </a> 12.20 - </td> 12.21 - <td align=center width="100%"><font size="6" color = "#ffffff">Manual</font></td> 12.22 - </tr> 12.23 - </table> 12.24 - 12.25 - 12.26 - <a href = "install.html">Installation</a><br> 12.27 - <a href = "faq.html">Frequently Asked Questions</a><br> 12.28 - <br> 12.29 - <a href = "docs/masqmail.8.html">Command line options</a><br> 12.30 - <a href = "docs/masqmail.conf.5.html">Configuration</a><br> 12.31 - <a href = "docs/masqmail.route.5.html">Routes</a><br> 12.32 - <a href = "docs/masqmail.aliases.5.html">Alias File Format</a><br> 12.33 - <a href = "docs/masqmail.get.5.html">Mail Get Configuration</a><br> 12.34 - </td></tr> 12.35 - 12.36 - <tr><td> 12.37 - <p> 12.38 - <hr> 12.39 - <address><a href = "mailto:oku@masqmail.cx">Oliver Kurth</a></address> 12.40 - Last modified: Fri, 28 Jul 2000 09:13:20 +0200 12.41 - </p> 12.42 - 12.43 - </table> 12.44 - </center> 12.45 - 12.46 - </BODY> 12.47 -</HEAD> 12.48 -
13.1 --- a/docs/old-manual/options.html Sun Jul 18 22:40:09 2010 +0200 13.2 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 13.3 @@ -1,181 +0,0 @@ 13.4 - 13.5 - 13.6 - 13.7 - 13.8 - 13.9 - 13.10 - 13.11 - 13.12 -<HTML> 13.13 -<HEAD> 13.14 -<TITLE>MasqMail - Manual 13.15 -</TITLE> 13.16 -</HEAD> 13.17 - <BODY TEXT="#000000" LINK="#0000ff" BGCOLOR="#ffffff"> 13.18 - 13.19 - <center> 13.20 - <table width="80%"> 13.21 - <tr><td> 13.22 - <table width="100%" bgcolor="#0000aa" cellspacing=0 cellpadding=0> 13.23 -<tr> 13.24 - <td> 13.25 - <a href="manual.html"> 13.26 - <img width="20" src = "../images/u_arrow.gif" alt = "manual"> 13.27 - </a> 13.28 - </td> 13.29 -<td align=center width="100%"><font size="6" color = "#ffffff">Options</font></td> 13.30 -<td> 13.31 - <a href="./install.html"> 13.32 - <img width="20" src = "../images/l_arrow.gif" alt = "Installation"> 13.33 - </a> 13.34 -</td> 13.35 -<td> 13.36 - <a href="./alias.html"> 13.37 - <img width="20" src = "../images/r_arrow.gif" alt = "Alias Format"> 13.38 - </a> 13.39 -</td> 13.40 -</tr> 13.41 -</table> 13.42 - 13.43 - 13.44 -<p>Since masqmail is intended to replace sendmail, it uses the same 13.45 -command line options, but not all are implemented. There are also two 13.46 -additional options, which are unique to masqmail (-qo 13.47 -<connection> and -g) </p> 13.48 - 13.49 -<b>-- </b>option:<br> 13.50 - 13.51 -<p>Not a 'real' option, it means that all following arguments are to 13.52 -be understood as arguments and not as options even if they begin with a 13.53 -leading dash '-'. Mutt is known to call sendmail with this option.</p> 13.54 - 13.55 -<b>-bd </b>option (daemon):<br> 13.56 - 13.57 -<p>Run as daemon, accepting connections, usually on port 25 if not 13.58 -configured differently. This is usually used in the startup script and 13.59 -together with the -q option (see below).</p> 13.60 - 13.61 -<b>-bi </b>option:<br> 13.62 - 13.63 -<p>Old sendmail rebuilds its alias database when invoked with this 13.64 -option. Masqmail ignores it. Masqmail reads directly from the file 13.65 -given with <b>alias_file</b> in the config file.</p> 13.66 - 13.67 -<b>-bp </b>option:<br> 13.68 - 13.69 -<p>Show the messages in the queue. Same as calling masqmail as 13.70 -'mailq'.</p> 13.71 - 13.72 -<b>-bs </b>option:<br> 13.73 - 13.74 -<p>Accept SMTP commands from stdin. Some mailers (eg pine) use this 13.75 -option as an interface. It can also be used to call masqmail from 13.76 -inetd, according to Tomislav Filipcic this works.</p> 13.77 - 13.78 -<b>-B<arg></b>option:<br> 13.79 - 13.80 -<p>arg is usually 8BITMIME. Some mailers use this to indicate that the 13.81 -message contains characters > 127. Masqmail is 8-bit clean and 13.82 -ignores this, so you do not have to recompile elm, which is very 13.83 -painful ;-). Note though that this violates some conventions: masqmail 13.84 -<em>does not</em> convert 8 bit messages to any MIME format if it 13.85 -encounters a mail server which does not advertise its 8BITMIME capability, 13.86 -masqmail does not advertise this itself. This is the same practice as 13.87 -that of exim (but different to sendmail).</p> 13.88 - 13.89 -<p>This <em>may</em> change in the future, but do not rely on it.</p> 13.90 - 13.91 -<b>-C<filename></b>option:<br> 13.92 - 13.93 -<p>Use another configuration than /etc/masqmail.conf. Useful for 13.94 -debugging purposes.</p> 13.95 - 13.96 -<b>-d <number> </b>option:<br> 13.97 - 13.98 -<p>Set the debug level. This takes precedence before the value of 13.99 -<b>debug_level</b> in the configuration file. Read the warning in the 13.100 -description of the latter.</p> 13.101 - 13.102 -<b>-g </b>option:<br> 13.103 - 13.104 -<p>Get mail, using the configurations given with 13.105 -<b>get.<name></b> in the main configuration.</p> 13.106 - 13.107 -<b>-i </b>option:<br> 13.108 - 13.109 -<p>Same as <b>-oi</b>, see below.</p> 13.110 - 13.111 -<b>-oem </b>option:<br> 13.112 - 13.113 -<p>If the <b>-oi</b> ist not also given, always return with a non zero 13.114 -return code. Maybe someone tells me what this is good for... </p> 13.115 - 13.116 -<b>-odb </b>option:<br> 13.117 - 13.118 -<p>Deliver in background. Masqmail always does this.</p> 13.119 - 13.120 -<b>-odq </b>option:<br> 13.121 - 13.122 -<p>Do not attempt to deliver immediately. Any messages will be queued 13.123 -until the next queue running process picks them up and delivers 13.124 -them. You get the same effect by setting the <i>do_queue</i> option in 13.125 -/etc/masqmail.conf.</p> 13.126 - 13.127 -<b>-oi </b>option:<br> 13.128 - 13.129 -<p>A dot as a single character in a line does <em>not</em> terminate 13.130 -the message.</p> 13.131 - 13.132 -<b>-q </b>option:<br> 13.133 - 13.134 -<p>If not given with an argument, run a queue process, ie. try to 13.135 -deliver all messages in the queue. Masqmail sends only to those 13.136 -addresses that are on the <em>local</em> net, not to those that are 13.137 -outside. Use -qo <connection> for those.</p> 13.138 - 13.139 -<p>If you have configured inetd to start masqmail, you can use this 13.140 -option in a cron job which starts in regular time intervals, to mimic 13.141 -the same effect as starting masqmail with -bd -q30m.</p> 13.142 - 13.143 -<p>An argument may be a time interval ie. a numerical value followed 13.144 -by one of the letters. s,m,h,d,w which are interpreted as seconds, 13.145 -minutes, hours, days or weeks respectively. Example: -q30m. Masqmail 13.146 -starts as a daemon and a queue runner process will be started 13.147 -automatically once in this time interval. This is usually used 13.148 -together with -bd (see above).</p> 13.149 - 13.150 -<b>-qo<name> </b>option:<br> 13.151 - 13.152 -<p>Can be followed by a connection name. Use this option in your 13.153 -script which starts as soon as a link to the internet has been set up 13.154 -(usually ip-up). When masqmail is called with this option, the 13.155 -specified route configuration is read and the queued mail with 13.156 -destinations on the internet will be sent. The <b>name</b> is defined 13.157 -in the configuration (see <b>connect_route.<name></b>).</p> 13.158 - 13.159 -<p>If called without <name>, the online status is determined with 13.160 -the configured method (see <b>online_detect</b> in <a 13.161 -href="config.html">config.html</a>)</p> 13.162 - 13.163 -<b>-t </b>option:<br> 13.164 - 13.165 -<p>Read recipients from headers. Delete 'Bcc:' headers. If any 13.166 -arguments are given, these are interpreted as recipient addresses and 13.167 -the message will <em>not</em> be sent to these.</p> 13.168 - </td></tr> 13.169 - 13.170 - <tr><td> 13.171 - <p> 13.172 - <hr> 13.173 - <address><a href = "mailto:kurth@innominate.de">Oliver Kurth</a></address> 13.174 - Last modified: Tue May 30 15:19:56 CEST 2000 13.175 - <br> 13.176 - This page was created using <a href="http://www.freddyfrog.com/hacks/genpage/">Genpage</a> - Version: 1.0.6 13.177 - </p> 13.178 - 13.179 - </table> 13.180 - </center> 13.181 - 13.182 - </BODY> 13.183 -</HEAD> 13.184 -