masqmail-0.2

view docs/old-manual/options.html @ 92:10d00e3235f2

updated docs (online_file, mserver_iface) - the default location of the online_file is /var/run/masqmail/masqmail-route - the online file can and should (!) end with a newline (this once was different) - marked the online detect method `mserver' as obsolete
author meillo@marmaro.de
date Mon, 21 Jun 2010 10:04:36 +0200
parents
children
line source
9 <HTML>
10 <HEAD>
11 <TITLE>MasqMail - Manual
12 </TITLE>
13 </HEAD>
14 <BODY TEXT="#000000" LINK="#0000ff" BGCOLOR="#ffffff">
16 <center>
17 <table width="80%">
18 <tr><td>
19 <table width="100%" bgcolor="#0000aa" cellspacing=0 cellpadding=0>
20 <tr>
21 <td>
22 <a href="manual.html">
23 <img width="20" src = "../images/u_arrow.gif" alt = "manual">
24 </a>
25 </td>
26 <td align=center width="100%"><font size="6" color = "#ffffff">Options</font></td>
27 <td>
28 <a href="./install.html">
29 <img width="20" src = "../images/l_arrow.gif" alt = "Installation">
30 </a>
31 </td>
32 <td>
33 <a href="./alias.html">
34 <img width="20" src = "../images/r_arrow.gif" alt = "Alias Format">
35 </a>
36 </td>
37 </tr>
38 </table>
41 <p>Since masqmail is intended to replace sendmail, it uses the same
42 command line options, but not all are implemented. There are also two
43 additional options, which are unique to masqmail (-qo
44 &lt;connection&gt; and -g) </p>
46 <b>-- </b>option:<br>
48 <p>Not a 'real' option, it means that all following arguments are to
49 be understood as arguments and not as options even if they begin with a
50 leading dash '-'. Mutt is known to call sendmail with this option.</p>
52 <b>-bd </b>option (daemon):<br>
54 <p>Run as daemon, accepting connections, usually on port 25 if not
55 configured differently. This is usually used in the startup script and
56 together with the -q option (see below).</p>
58 <b>-bi </b>option:<br>
60 <p>Old sendmail rebuilds its alias database when invoked with this
61 option. Masqmail ignores it. Masqmail reads directly from the file
62 given with <b>alias_file</b> in the config file.</p>
64 <b>-bp </b>option:<br>
66 <p>Show the messages in the queue. Same as calling masqmail as
67 'mailq'.</p>
69 <b>-bs </b>option:<br>
71 <p>Accept SMTP commands from stdin. Some mailers (eg pine) use this
72 option as an interface. It can also be used to call masqmail from
73 inetd, according to Tomislav Filipcic this works.</p>
75 <b>-B&lt;arg&gt;</b>option:<br>
77 <p>arg is usually 8BITMIME. Some mailers use this to indicate that the
78 message contains characters &gt; 127. Masqmail is 8-bit clean and
79 ignores this, so you do not have to recompile elm, which is very
80 painful ;-). Note though that this violates some conventions: masqmail
81 <em>does not</em> convert 8 bit messages to any MIME format if it
82 encounters a mail server which does not advertise its 8BITMIME capability,
83 masqmail does not advertise this itself. This is the same practice as
84 that of exim (but different to sendmail).</p>
86 <p>This <em>may</em> change in the future, but do not rely on it.</p>
88 <b>-C&lt;filename&gt;</b>option:<br>
90 <p>Use another configuration than /etc/masqmail.conf. Useful for
91 debugging purposes.</p>
93 <b>-d &lt;number&gt; </b>option:<br>
95 <p>Set the debug level. This takes precedence before the value of
96 <b>debug_level</b> in the configuration file. Read the warning in the
97 description of the latter.</p>
99 <b>-g </b>option:<br>
101 <p>Get mail, using the configurations given with
102 <b>get.&lt;name&gt;</b> in the main configuration.</p>
104 <b>-i </b>option:<br>
106 <p>Same as <b>-oi</b>, see below.</p>
108 <b>-oem </b>option:<br>
110 <p>If the <b>-oi</b> ist not also given, always return with a non zero
111 return code. Maybe someone tells me what this is good for... </p>
113 <b>-odb </b>option:<br>
115 <p>Deliver in background. Masqmail always does this.</p>
117 <b>-odq </b>option:<br>
119 <p>Do not attempt to deliver immediately. Any messages will be queued
120 until the next queue running process picks them up and delivers
121 them. You get the same effect by setting the <i>do_queue</i> option in
122 /etc/masqmail.conf.</p>
124 <b>-oi </b>option:<br>
126 <p>A dot as a single character in a line does <em>not</em> terminate
127 the message.</p>
129 <b>-q </b>option:<br>
131 <p>If not given with an argument, run a queue process, ie. try to
132 deliver all messages in the queue. Masqmail sends only to those
133 addresses that are on the <em>local</em> net, not to those that are
134 outside. Use -qo &lt;connection&gt; for those.</p>
136 <p>If you have configured inetd to start masqmail, you can use this
137 option in a cron job which starts in regular time intervals, to mimic
138 the same effect as starting masqmail with -bd -q30m.</p>
140 <p>An argument may be a time interval ie. a numerical value followed
141 by one of the letters. s,m,h,d,w which are interpreted as seconds,
142 minutes, hours, days or weeks respectively. Example: -q30m. Masqmail
143 starts as a daemon and a queue runner process will be started
144 automatically once in this time interval. This is usually used
145 together with -bd (see above).</p>
147 <b>-qo&lt;name&gt; </b>option:<br>
149 <p>Can be followed by a connection name. Use this option in your
150 script which starts as soon as a link to the internet has been set up
151 (usually ip-up). When masqmail is called with this option, the
152 specified route configuration is read and the queued mail with
153 destinations on the internet will be sent. The <b>name</b> is defined
154 in the configuration (see <b>connect_route.&lt;name&gt;</b>).</p>
156 <p>If called without &lt;name&gt, the online status is determined with
157 the configured method (see <b>online_detect</b> in <a
158 href="config.html">config.html</a>)</p>
160 <b>-t </b>option:<br>
162 <p>Read recipients from headers. Delete 'Bcc:' headers. If any
163 arguments are given, these are interpreted as recipient addresses and
164 the message will <em>not</em> be sent to these.</p>
165 </td></tr>
167 <tr><td>
168 <p>
169 <hr>
170 <address><a href = "mailto:kurth@innominate.de">Oliver Kurth</a></address>
171 Last modified: Tue May 30 15:19:56 CEST 2000
172 <br>
173 This page was created using <a href="http://www.freddyfrog.com/hacks/genpage/">Genpage</a> - Version: 1.0.6
174 </p>
176 </table>
177 </center>
179 </BODY>
180 </HEAD>