masqmail-0.2
diff docs/old-manual/docs/masqmail.get.5.html @ 56:f6a6f55b7b9e
added old manual from the old website
it is dated May/July 2000
author | meillo@marmaro.de |
---|---|
date | Sat, 29 May 2010 21:51:13 +0200 |
parents | |
children |
line diff
1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 1.2 +++ b/docs/old-manual/docs/masqmail.get.5.html Sat May 29 21:51:13 2010 +0200 1.3 @@ -0,0 +1,175 @@ 1.4 +<body text="#000000" link="#0000ff" bgcolor="#ffffff"><center><table width="80%"> 1.5 +<tr><td><h1>masqmail.get</h1> 1.6 +<h2>masqmail get configuration file</h2> 1.7 + 1.8 + 1.9 +<h2>Description</h2> 1.10 + <p>This man page describes the options available for the 1.11 +masqmail get configuration.</p> 1.12 + 1.13 + 1.14 + 1.15 + 1.16 +<h2>Options</h2> 1.17 + 1.18 + 1.19 + 1.20 +<p><b>protocol</b> = <em>string</em></p> 1.21 + 1.22 +<p>The protocol with which you retrieve your mail. Currently only 1.23 +'pop3' and 'apop' are supported. There is no default.</p> 1.24 + 1.25 + 1.26 + 1.27 + 1.28 +<p><b>server</b> = <em>string</em></p> 1.29 + 1.30 +<p>The server you get your mail from.</p> 1.31 + 1.32 + 1.33 + 1.34 + 1.35 +<p><b>resolve_list</b> = <em>list</em></p> 1.36 + 1.37 +<p>Specify the method how the domain of the server is resolved. Possible values are 1.38 +dns_mx, dns_a, byname. For 'dns_mx', the domain is assumed to be an MX 1.39 +pointer to a list of host names, these will be tried each in order 1.40 +(lowest preference value first, equal preference values in random 1.41 +order). For 'dns_a', the domain is assumed to be an A pointer. For 1.42 +'byname', the library function <b>gethostbyname (3)</b> will be used.</p> 1.43 +<p>The default is "dns_a;byname". It does not make much sense here to use 'dns_mx'.</p> 1.44 + 1.45 + 1.46 + 1.47 + 1.48 +<p><b>user</b> = <em>string</em></p> 1.49 + 1.50 +<p>Your login name.</p> 1.51 + 1.52 + 1.53 + 1.54 + 1.55 +<p><b>pass</b> = <em>string</em></p> 1.56 + 1.57 +<p>Your password.</p> 1.58 + 1.59 + 1.60 + 1.61 + 1.62 +<p><b>address</b> = <em>address</em></p> 1.63 + 1.64 +<p>The address where the retrieved mail should be sent to. It can be 1.65 +any address, but you probably want to set this to a local address on 1.66 +your LAN.</p> 1.67 + 1.68 + 1.69 + 1.70 + 1.71 +<p><b>return_path</b> = <em>address</em></p> 1.72 + 1.73 +<p>If set, masqmail sets the return path to this address. Bounces 1.74 +generated during further delivery will be sent to this address. If 1.75 +unset, masqmail looks for the Return-Path: header in the mail, if 1.76 +this does not exist it uses the From: address and if this fails, 1.77 +postmaster will be used. 1.78 +</p><p> 1.79 +It is in most cases not useful to set this to the same address as 1.80 +the 'address' option as this may generate multiple bounces. 1.81 +postmaster is recommended.</p> 1.82 + 1.83 + 1.84 + 1.85 + 1.86 +<p><b>do_keep</b> = <em>boolean</em></p> 1.87 + 1.88 +<p>If you want to keep your mail on the server after you retrieved it, 1.89 +set this to true. It is recommended that you also set do_uidl, 1.90 +otherwise you will get the mail again each time you connect to the 1.91 +server. Masqmail does not check any headers before it retrieves mail, 1.92 +which may mark it as already fetched. Note that this behaviour is 1.93 +different to that of fetchmail. The default is false.</p> 1.94 + 1.95 + 1.96 + 1.97 + 1.98 +<p><b>do_uidl</b> = <em>boolean</em></p> 1.99 + 1.100 +<p>If set, MasqMail keeps a list of unique IDs of mails already 1.101 +fetched, so that they will not be retrieved again. Default is false.</p> 1.102 + 1.103 + 1.104 + 1.105 + 1.106 +<p><b>do_uidl_dele</b> = <em>boolean</em></p> 1.107 + 1.108 +<p>If set, and <b>do_uidl</b> is also set, MasqMail sends a delete (DELE) 1.109 +command to the server for each message uid in the uid listing at the 1.110 +beginning of the session. This prevents mail to be left on the server if 1.111 +masqmail gets interrupted during a session before it can send the QUIT 1.112 +command to the server. Default is false. 1.113 +</p> 1.114 + 1.115 + 1.116 + 1.117 + 1.118 +<p><b>max_size</b> = <em>numeric</em></p> 1.119 + 1.120 +<p>If set to a value > 0, only messages smaller than this in bytes will be 1.121 +retrieved. The default is 0.</p> 1.122 + 1.123 + 1.124 + 1.125 + 1.126 +<p><b>max_count</b> = <em>numeric</em></p> 1.127 + 1.128 +<p>If set to a value > 0, only <b>max_count</b> messages will be retrieved. 1.129 +The default is 0.</p> 1.130 + 1.131 + 1.132 + 1.133 + 1.134 +<p><b>wrapper</b> = <em>command</em></p> 1.135 + 1.136 +<p>If set, instead of opening a connection to a remote server, <em>command</em> will 1.137 +be called and all traffic will be piped to its 1.138 +stdin and from its stdout. Purpose is to tunnel ip traffic, eg. for ssl.</p> 1.139 +<p>Example for ssl tunneling:</p> 1.140 +<p>wrapper="/usr/bin/openssl s_client -quiet -connect pop.gmx.net:995 2>/dev/null"</p> 1.141 + 1.142 + 1.143 + 1.144 + 1.145 + 1.146 +<h2>Author</h2> 1.147 + 1.148 +<p>masqmail was written by Oliver Kurth 1.149 +<oku@masqmail.cx></p><p>You will find the newest version of 1.150 +masqmail at <a href = "http://masqmail.cx/masqmail/">http://masqmail.cx/masqmail/</a> or search for it 1.151 +in freshmeat (<a href = "http://www.freshmeat.net">http://www.freshmeat.net</a>). There is also a mailing list, 1.152 +you will find information about it at masqmails main site.</p> 1.153 + 1.154 + 1.155 + 1.156 +<h2>Bugs</h2> 1.157 + 1.158 +<p>You should report them to the mailing list.</p> 1.159 + 1.160 + 1.161 + 1.162 +<h2>See also</h2> 1.163 + 1.164 +<p> 1.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> 1.166 +</p> 1.167 + 1.168 + 1.169 + 1.170 +<h2>Comments</h2> 1.171 + 1.172 +<p>This man page was written using <a href="http://masqmail.cx/xml2man/">xml2man</a> by the same 1.173 +author.</p> 1.174 + 1.175 + 1.176 + 1.177 +</td></tr></table></center> 1.178 +</body>