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>