Mercurial > 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 wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/old-manual/docs/masqmail.get.5.html Sat May 29 21:51:13 2010 +0200 @@ -0,0 +1,175 @@ +<body text="#000000" link="#0000ff" bgcolor="#ffffff"><center><table width="80%"> +<tr><td><h1>masqmail.get</h1> +<h2>masqmail get configuration file</h2> + + +<h2>Description</h2> + <p>This man page describes the options available for the +masqmail get configuration.</p> + + + + +<h2>Options</h2> + + + +<p><b>protocol</b> = <em>string</em></p> + +<p>The protocol with which you retrieve your mail. Currently only +'pop3' and 'apop' are supported. There is no default.</p> + + + + +<p><b>server</b> = <em>string</em></p> + +<p>The server you get your mail from.</p> + + + + +<p><b>resolve_list</b> = <em>list</em></p> + +<p>Specify the method how the domain of the server is resolved. Possible values are +dns_mx, dns_a, byname. For 'dns_mx', the domain is assumed to be an MX +pointer to a list of host names, these will be tried each in order +(lowest preference value first, equal preference values in random +order). For 'dns_a', the domain is assumed to be an A pointer. For +'byname', the library function <b>gethostbyname (3)</b> will be used.</p> +<p>The default is "dns_a;byname". It does not make much sense here to use 'dns_mx'.</p> + + + + +<p><b>user</b> = <em>string</em></p> + +<p>Your login name.</p> + + + + +<p><b>pass</b> = <em>string</em></p> + +<p>Your password.</p> + + + + +<p><b>address</b> = <em>address</em></p> + +<p>The address where the retrieved mail should be sent to. It can be +any address, but you probably want to set this to a local address on +your LAN.</p> + + + + +<p><b>return_path</b> = <em>address</em></p> + +<p>If set, masqmail sets the return path to this address. Bounces +generated during further delivery will be sent to this address. If +unset, masqmail looks for the Return-Path: header in the mail, if +this does not exist it uses the From: address and if this fails, +postmaster will be used. +</p><p> +It is in most cases not useful to set this to the same address as +the 'address' option as this may generate multiple bounces. +postmaster is recommended.</p> + + + + +<p><b>do_keep</b> = <em>boolean</em></p> + +<p>If you want to keep your mail on the server after you retrieved it, +set this to true. It is recommended that you also set do_uidl, +otherwise you will get the mail again each time you connect to the +server. Masqmail does not check any headers before it retrieves mail, +which may mark it as already fetched. Note that this behaviour is +different to that of fetchmail. The default is false.</p> + + + + +<p><b>do_uidl</b> = <em>boolean</em></p> + +<p>If set, MasqMail keeps a list of unique IDs of mails already +fetched, so that they will not be retrieved again. Default is false.</p> + + + + +<p><b>do_uidl_dele</b> = <em>boolean</em></p> + +<p>If set, and <b>do_uidl</b> is also set, MasqMail sends a delete (DELE) +command to the server for each message uid in the uid listing at the +beginning of the session. This prevents mail to be left on the server if +masqmail gets interrupted during a session before it can send the QUIT +command to the server. Default is false. +</p> + + + + +<p><b>max_size</b> = <em>numeric</em></p> + +<p>If set to a value > 0, only messages smaller than this in bytes will be +retrieved. The default is 0.</p> + + + + +<p><b>max_count</b> = <em>numeric</em></p> + +<p>If set to a value > 0, only <b>max_count</b> messages will be retrieved. +The default is 0.</p> + + + + +<p><b>wrapper</b> = <em>command</em></p> + +<p>If set, instead of opening a connection to a remote server, <em>command</em> will +be called and all traffic will be piped to its +stdin and from its stdout. Purpose is to tunnel ip traffic, eg. for ssl.</p> +<p>Example for ssl tunneling:</p> +<p>wrapper="/usr/bin/openssl s_client -quiet -connect pop.gmx.net:995 2>/dev/null"</p> + + + + + +<h2>Author</h2> + +<p>masqmail was written by Oliver Kurth +<oku@masqmail.cx></p><p>You will find the newest version of +masqmail at <a href = "http://masqmail.cx/masqmail/">http://masqmail.cx/masqmail/</a> or search for it +in freshmeat (<a href = "http://www.freshmeat.net">http://www.freshmeat.net</a>). There is also a mailing list, +you will find information about it at masqmails main site.</p> + + + +<h2>Bugs</h2> + +<p>You should report them to the mailing list.</p> + + + +<h2>See also</h2> + +<p> +<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> +</p> + + + +<h2>Comments</h2> + +<p>This man page was written using <a href="http://masqmail.cx/xml2man/">xml2man</a> by the same +author.</p> + + + +</td></tr></table></center> +</body>