masqmail-0.2

view docs/old-manual/docs/masqmail.get.5.html @ 72:ad034b57f3b2

fixed Debian bug 536060 (log files are closed after SIGHUP receival) Explanation: When run in daemon mode, first the log files are opened. They get assigned to the file descriptors 3 and 4 usually. Then std{in,out,err} are closed. When SIGHUP comes in, all open files are closes and masqmail reexecutes itself. The new masqmail instance opens the log files at fd 0 and 1 now, but std{in,out,err} are closed afterwards, thus the log files are closed. The fix is to close the log files before std{in,out,err} are closed, in case the log files have higher fds. After std{in,out,err} were closed, the log files get opened again, now. See also: http://bugs.debian.org/536060
author meillo@marmaro.de
date Wed, 16 Jun 2010 10:32:20 +0200
parents
children
line source
1 <body text="#000000" link="#0000ff" bgcolor="#ffffff"><center><table width="80%">
2 <tr><td><h1>masqmail.get</h1>
3 <h2>masqmail get configuration file</h2>
6 <h2>Description</h2>
7 <p>This man page describes the options available for the
8 masqmail get configuration.</p>
13 <h2>Options</h2>
17 <p><b>protocol</b> = <em>string</em></p>
19 <p>The protocol with which you retrieve your mail. Currently only
20 'pop3' and 'apop' are supported. There is no default.</p>
25 <p><b>server</b> = <em>string</em></p>
27 <p>The server you get your mail from.</p>
32 <p><b>resolve_list</b> = <em>list</em></p>
34 <p>Specify the method how the domain of the server is resolved. Possible values are
35 dns_mx, dns_a, byname. For 'dns_mx', the domain is assumed to be an MX
36 pointer to a list of host names, these will be tried each in order
37 (lowest preference value first, equal preference values in random
38 order). For 'dns_a', the domain is assumed to be an A pointer. For
39 'byname', the library function <b>gethostbyname (3)</b> will be used.</p>
40 <p>The default is "dns_a;byname". It does not make much sense here to use 'dns_mx'.</p>
45 <p><b>user</b> = <em>string</em></p>
47 <p>Your login name.</p>
52 <p><b>pass</b> = <em>string</em></p>
54 <p>Your password.</p>
59 <p><b>address</b> = <em>address</em></p>
61 <p>The address where the retrieved mail should be sent to. It can be
62 any address, but you probably want to set this to a local address on
63 your LAN.</p>
68 <p><b>return_path</b> = <em>address</em></p>
70 <p>If set, masqmail sets the return path to this address. Bounces
71 generated during further delivery will be sent to this address. If
72 unset, masqmail looks for the Return-Path: header in the mail, if
73 this does not exist it uses the From: address and if this fails,
74 postmaster will be used.
75 </p><p>
76 It is in most cases not useful to set this to the same address as
77 the 'address' option as this may generate multiple bounces.
78 postmaster is recommended.</p>
83 <p><b>do_keep</b> = <em>boolean</em></p>
85 <p>If you want to keep your mail on the server after you retrieved it,
86 set this to true. It is recommended that you also set do_uidl,
87 otherwise you will get the mail again each time you connect to the
88 server. Masqmail does not check any headers before it retrieves mail,
89 which may mark it as already fetched. Note that this behaviour is
90 different to that of fetchmail. The default is false.</p>
95 <p><b>do_uidl</b> = <em>boolean</em></p>
97 <p>If set, MasqMail keeps a list of unique IDs of mails already
98 fetched, so that they will not be retrieved again. Default is false.</p>
103 <p><b>do_uidl_dele</b> = <em>boolean</em></p>
105 <p>If set, and <b>do_uidl</b> is also set, MasqMail sends a delete (DELE)
106 command to the server for each message uid in the uid listing at the
107 beginning of the session. This prevents mail to be left on the server if
108 masqmail gets interrupted during a session before it can send the QUIT
109 command to the server. Default is false.
110 </p>
115 <p><b>max_size</b> = <em>numeric</em></p>
117 <p>If set to a value > 0, only messages smaller than this in bytes will be
118 retrieved. The default is 0.</p>
123 <p><b>max_count</b> = <em>numeric</em></p>
125 <p>If set to a value > 0, only <b>max_count</b> messages will be retrieved.
126 The default is 0.</p>
131 <p><b>wrapper</b> = <em>command</em></p>
133 <p>If set, instead of opening a connection to a remote server, <em>command</em> will
134 be called and all traffic will be piped to its
135 stdin and from its stdout. Purpose is to tunnel ip traffic, eg. for ssl.</p>
136 <p>Example for ssl tunneling:</p>
137 <p>wrapper="/usr/bin/openssl s_client -quiet -connect pop.gmx.net:995 2>/dev/null"</p>
143 <h2>Author</h2>
145 <p>masqmail was written by Oliver Kurth
146 <oku@masqmail.cx></p><p>You will find the newest version of
147 masqmail at <a href = "http://masqmail.cx/masqmail/">http://masqmail.cx/masqmail/</a> or search for it
148 in freshmeat (<a href = "http://www.freshmeat.net">http://www.freshmeat.net</a>). There is also a mailing list,
149 you will find information about it at masqmails main site.</p>
153 <h2>Bugs</h2>
155 <p>You should report them to the mailing list.</p>
159 <h2>See also</h2>
161 <p>
162 <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>
163 </p>
167 <h2>Comments</h2>
169 <p>This man page was written using <a href="http://masqmail.cx/xml2man/">xml2man</a> by the same
170 author.</p>
174 </td></tr></table></center>
175 </body>